Changes between Version 8 and Version 16 of Ticket #152

11/21/16 11:46:33 (2 years ago)


  • Ticket #152 – Description

    v8 v16  
    33The proposal is to make it clear that use of `where` for non-spatial dimensions is allowed by adding examples in section 7. It is also necessary to provide these examples to clarify the subtle differences implied by different formulations of the `cell_methods` statement.
    5 == Clarification at start of section 7.3.3 ==
     5== Replace text of section 7.3.3 ==
     7By default, the statistical method indicated by cell_methods is assumed to have been evaluated over the entire horizontal area of the cell. Sometimes, however, it is useful to limit consideration to only a portion of a cell (e.g. a mean over the sea-ice area). The portion concerned is constant in time in some cases, but it could be time-varying. Grid cell “portions” that can be considered are only those permitted to be associated with the   `standard_name` of `area_type`. There are two options for indicating when a quantity represents a portion of a cell.
     9The first method can be used for the common case that the cell_method applies to a single area-type. In this case, the cell_methods attribute may include a string of the form `name: method where type`. Here name could, for example, be area and type may be any of the strings permitted for a variable with a standard_name of area_type. As an example, if the method is `area: mean where sea_ice`, then the data would represent a mean over only the sea ice portion of the grid cell. When this first option is adopted, none of the variables in the netCDF file should be given a name identical to the string that names the `area_type`.  This restriction is imposed so that it will be clear that the metadata should not be interpreted following the second option (described in the next paragraph), which takes precedence.
     10The second method for indicating that a statistic applies to only a portion of a cell is more general because it can reference multiple area-types.  This may be needed when a variable has a dimension that ranges across various area types.  In this case, the cell_methods entry is of the form `name: method where typevar`. Here `typevar` is a string-valued auxiliary coordinate variable or string-valued scalar coordinate variable (see Section 6.1, "Labels") with a `standard_name` of `area_type`. The variable `typevar` contains the name(s) of the selected portion(s) of the grid cell to which the method is applied. This method provides a convenient way to store output from land surface models, for example, since they deal with many area types within each surface gridbox (e.g., vegetation, bare_ground, snow, etc.).
     12== Clarification at start of section 7.3.3 (not needed if above is accepted) ==
    714''Add a clarification after this sentence in the first paragraph of 7.3.3 "Sometimes, however, it is useful to limit consideration to only a portion of a cell (e.g. a mean over the sea-ice area)", to introduce the idea of time-varying area fractions:''