Changes between Initial Version and Version 1 of onScalarCoordinates


Ignore:
Timestamp:
07/03/13 07:30:28 (6 years ago)
Author:
markh
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • onScalarCoordinates

    v1 v1  
     1= On Scalar Coordinates =
     2
     3This page illustrates differences between tickets #104 and #105 for data creators using Scalar Coordinate Variables.
     4
     5
     6
     7In the examples, all variables are linked to a data variable, either as a coordinate variable or via the coordinates attribute, I have omitted this encoding to keep the table clearer.
     8
     9The right hand column shows a number of current uses of scalar coordinates we have encountered in software creating CF NetCDF datasets.  All of these examples become invalid if #104 is implemented but remain valid if #105 is implemented.
     10
     11The left hand column indicates how we would have to change the current operations and output if #104 is accepted as a change to CF. In many cases decisions have to be made about which structure to encode which are currently not deemed necessary.  In particular, these decisions are not currently made when the data set is written.  The choice of appropriate structure is very case dependent.
     12
     13The proposed change #104 adds significant complexity to the data writing process, imposing decisions on data creators which they are not currently making as they are not deemed necessary in the cases illustrated below.
     14
     15In all these cases #104 is driving a change in my behaviour as a data creator, where as #105 is enabling me to carry on as I currently work, whilst clarifying the interpretation.
     16
     17{{{
     18#!rst
     19
     20
     21
     22+----------------------------------------------+------------------------+
     23|                  #104                        |      #105              |
     24|                                              |                        |
     25|                                              |  and current use       |
     26|                                              |                        |
     27|                                              |                        |
     28|                                              |                        |
     29|                                              |                        |
     30+----------------------------------------------+------------------------+
     31|                                                                       |
     32|This simple example shows how a parametrised vertical coordinate may   |
     33|be encoded correctly.                                                  |
     34|                                                                       |
     35|                                                                       |
     36|                                                                       |
     37|                                                                       |
     38+----------------------------------------------+------------------------+
     39|                                              |                        |
     40|dimensions:                                   |dimensions:             |
     41|  model_level = 1 ;                           |                        |
     42|                                              |                        |
     43|variables:                                    |variables:              |
     44|  model_level(model_level);                   |  model_level ;         |
     45|                                              |                        |
     46|  sigma(model_level);                         |  sigma ;               |
     47|                                              |                        |
     48|  delta(model_level);                         |  delta ;               |
     49+----------------------------------------------+------------------------+
     50|This example illustrates that for forecasting times the situation is   |
     51|significantly complicated: a decision has to be made by the data       |
     52|creator which is not currently made about the inter-relationship       |
     53|between the times.                                                     |
     54|                                                                       |
     55|It is not clear at the time of writing the data which configuration is |
     56|appropriate, all three are plausible interpretations, but one is not   |
     57|allowed by CF.                                                         |
     58|                                                                       |
     59|As a data producer I do not think I should have to make this decision  |
     60|to write my data.                                                      |
     61+----------------------------------------------+------------------------+
     62|dimensions:                                   |dimensions              |
     63|  time = 1 ;                                  |                        |
     64|                                              |variables:              |
     65|  forecast_reftime = 1 ;                      |  time ;                |
     66|                                              |                        |
     67|variables:                                    |  forecast_period ;     |
     68|  time(time) ;                                |                        |
     69|                                              |  forecast_reftime      |
     70|  forecast_reftime(forecast_reftime) ;        |                        |
     71|                                              |                        |
     72|  forecast_period(time, forecast_reftime) ;   |                        |
     73+----------------------------------------------+                        |
     74|dimensions:                                   |                        |
     75|  time = 1 ;                                  |                        |
     76|                                              |                        |
     77|  forecast_period = 1 ;                       |                        |
     78|                                              |                        |
     79|variables:                                    |                        |
     80|  time(time) ;                                |                        |
     81|                                              |                        |
     82|  forecast_period(forecast_period) ;          |                        |
     83|                                              |                        |
     84|  forecast_reftime(time, forecast_period) ;   |                        |
     85+----------------------------------------------+                        |
     86|not allowed (see #100)                        |                        |
     87|                                              |                        |
     88|dimensions:                                   |                        |
     89|  forecast_period = 1 ;                       |                        |
     90|                                              |                        |
     91|  forecast_reftime = 1 ;                      |                        |
     92|                                              |                        |
     93|variables:                                    |                        |
     94|  forecast_period(forecast_period) ;          |                        |
     95|                                              |                        |
     96|  forecast_reftime(forecast_reftime) ;        |                        |
     97|                                              |                        |
     98|  time(forecast_period, forecast_reftime) ;   |                        |
     99+----------------------------------------------+------------------------+
     100|In multi-model analyses a range of factors combine to define where in  |
     101|the experimental design space a particular data subset exists.         |
     102|                                                                       |
     103|Each potential member of the multi-model collection is defined         |
     104|independently.  How groups of these may be structured is governed by   |
     105|the group members, their characterisitcs and the data.                 |
     106|                                                                       |
     107|The data creator should not have to define a set of inter-relationships|
     108|at the point of data writing, there are no valid ways of doing this to |
     109|meet all needs , no unique answer.                                     |
     110|                                                                       |
     111|#105 recognises these characteristics as emergent properties, not      |
     112|defined at the time of writing each data set.                          |
     113+----------------------------------------------+------------------------+
     114|dimensions:                                   |dimensions:             |
     115|  multi-model = 1 ;                           |                        |
     116|                                              |                        |
     117|variables:                                    |variables:              |
     118|  ensemble(multi-model) ;                     |  ensemble ;            |
     119|                                              |                        |
     120|  institute(multi-model)                      |  institute ;           |
     121|                                              |                        |
     122|  model(multi-model) ;                        |  model ;               |
     123|                                              |                        |
     124|  configuration(multi-model) ;                |  configuration ;       |
     125|                                              |                        |
     126|  exp_param1(multi-model) ;                   |  exp_param1 ;          |
     127|                                              |                        |
     128|  exp_param2(multi-model) ;                   |  exp_param2 ;          |
     129|                                              |                        |
     130|  exp_param3(multi-model) ;                   |  exp_param3 ;          |
     131+----------------------------------------------+                        |
     132|dimensions:                                   |                        |
     133|  ensemble = 1 ;                              |                        |
     134|                                              |                        |
     135|  model_member = 1 ;                          |                        |
     136|                                              |                        |
     137|  configuration = 1 ;                         |                        |
     138|                                              |                        |
     139|  params = 1 ;                                |                        |
     140|                                              |                        |
     141|variables:                                    |                        |
     142|  ensemble(ensemble) ;                        |                        |
     143|                                              |                        |
     144|  institute(model-member) ;                   |                        |
     145|                                              |                        |
     146|  model(model-member) ;                       |                        |
     147|                                              |                        |
     148|  configuration(configuration)                |                        |
     149|                                              |                        |
     150|  exp_param1(params)                          |                        |
     151|                                              |                        |
     152|  exp_param2(params)                          |                        |
     153|                                              |                        |
     154|  exp_param3(params)                          |                        |
     155+----------------------------------------------+                        |
     156|dimensions:                                   |                        |
     157|  ensemble = 1 ;                              |                        |
     158|                                              |                        |
     159|  model_member = 1 ;                          |                        |
     160|                                              |                        |
     161|  configuration = 1 ;                         |                        |
     162|                                              |                        |
     163|  param1 = 1 ;                                |                        |
     164|                                              |                        |
     165|  param2 = 1 ;                                |                        |
     166|                                              |                        |
     167|  param3 = 1 ;                                |                        |
     168|                                              |                        |
     169|variables:                                    |                        |
     170|  ensemble(ensemble) ;                        |                        |
     171|                                              |                        |
     172|  institute(model-member) ;                   |                        |
     173|                                              |                        |
     174|  model(model-member) ;                       |                        |
     175|                                              |                        |
     176|  configuration(configuration)                |                        |
     177|                                              |                        |
     178|  exp_param1(param1)                          |                        |
     179|                                              |                        |
     180|  exp_param2(param2)                          |                        |
     181|                                              |                        |
     182|  exp_param3(param3)                          |                        |
     183+----------------------------------------------+                        |
     184|numerous further combination options are      |                        |
     185|plausible                                     |                        |
     186+----------------------------------------------+------------------------+
     187|When single labels are used as coordinates the interpretation of scalar|
     188|as defined by 104 forces the first interpretation.  If this is not the |
     189|desired interpretation the data creator must make further decisions    |
     190|about how the labels are to be interpreted.                            |
     191|                                                                       |
     192|                                                                       |
     193|                                                                       |
     194|                                                                       |
     195|                                                                       |
     196+----------------------------------------------+------------------------+
     197|dimensions:                                   |dimensions:             |
     198|  label_1 = 1 ;                               |                        |
     199|  label_2 = 1 ;                               |variables:              |
     200|  label_3 = 1 ;                               |  label_1 ;             |
     201|                                              |                        |
     202|variables:                                    |  label_2 ;             |
     203|  label_1(label_1) ;                          |                        |
     204|  label_2(label_2) ;                          |  label_3 ;             |
     205|  label_3(label_3) ;                          |                        |
     206+----------------------------------------------+                        |
     207|dimensions:                                   |                        |
     208|  experiment = 1 ;                            |                        |
     209|                                              |                        |
     210|variables:                                    |                        |
     211|  label_1(experiment) ;                       |                        |
     212|                                              |                        |
     213|  label_2(experiment) ;                       |                        |
     214|                                              |                        |
     215|  label_3(experiment) ;                       |                        |
     216+----------------------------------------------+                        |
     217|dimensions:                                   |                        |
     218|  label_1 = 1 ;                               |                        |
     219|                                              |                        |
     220|  label_2 = 1 ;                               |                        |
     221|                                              |                        |
     222|variables:                                    |                        |
     223|  label_1(label_1) ;                          |                        |
     224|                                              |                        |
     225|  label_2(label_2) ;                          |                        |
     226|                                              |                        |
     227|  label_3(label_2) ;                          |                        |
     228+----------------------------------------------+                        |
     229|dimensions:                                   |                        |
     230|  label_1 = 1 ;                               |                        |
     231|                                              |                        |
     232|  label_2 = 1 ;                               |                        |
     233|                                              |                        |
     234|variables:                                    |                        |
     235|  label_1(label_1) ;                          |                        |
     236|                                              |                        |
     237|  label_2(label_1) ;                          |                        |
     238|                                              |                        |
     239|  label_3(label_2) ;                          |                        |
     240+----------------------------------------------+------------------------+
     241
     242}}}
     243
     244There are no examples of Discrete Sampling Geometries in this table, as #104 states: 'The interpretation of scalar coordinate variables in Section 9 may be different from the above, and this may require further clarification if the above is agreed'.
     245
     246In the absence of this clarification the only comment I can make about Scalar Coordinate Variables and Discrete Sampling Geometries is that #105 does not require further clarification, it is consistent with Section 9 of the Conventions document.