...
SPECS file content and format, data structure and metadata
CMIP6 Data Request: MIP variables search
| Info | |||
|---|---|---|---|
| |||
Along this document some issues are still at some level under discussion. To mark this that it has been followed the following color coding is usedscheme
|
Encoding Guide
Global attributes
...
| Attribute Name | Value | Examples | Comment |
|---|---|---|---|
| Conventions | CF_convention_string C3S-0.1 [Other convention] :... | "CF-1.6 C3S-0.1" | Multiple conventions may be included (separated by blank spaces) |
| title | A controlled vocabulary will be provided CF: Free text ACDD (highly recommended) | "IPSL-CM5A-LR model output prepared for CMIP5 RCP4.5" | A short phrase or sentence describing the dataset. In many discovery systems, the title will be displayed in the results list from a search, and therefore should be human readable and reasonable to display in a list of such names |
| references | URIs (such as a URL or DOI) for papers or other references. A valid doi is recommended CF: Free text | "doi:10.5194/gmd-8-1509-2015" | Published or web-based references that describe the data or methods used to produce it. |
| source | A methodology to build this attribute will be provided |
| The method of production of the original data. If it was model-generated, source should name the model and its version, as specifically as it could be useful |
| institution | A controlled vocabulary will be provided CF: Free text
| "Met Office" | Specifies where the original data was produced. The name of the institution principally responsible for originating this data. |
| contact | Copernicus User Support URI should be used CF: Free text | "http://copernicus-support.ecmwf.int" |
|
| project | "C3S Seasonal Forecast" should be used CF: Free text
| "C3S Seasonal Forecast" | |
| creation_date | SPECS: YYYY-MM-DDThh:mm:ss<zone> ISO 8601:2004 extended format | "2011-06-24T02:53:46Z" | The date on which this version of the data was created. Modification of values implies a new version, hence this would be assigned the date of the most recent values modification. Metadata changes are not considered when assigning the creation_date NOTE: The ACDD 1.3 names this attribute as "date_create |
| comment | Free text |
| Miscellaneous information about the data, not captured elsewhere. |
| forecast_type | "forecast" or "hindcast" | "forecast" | To identify the type of data
|
| history | Each line should begin with a timestamp indicating the date and time of day when the program was executed CF: Free Text |
| To record relevant information, such as the command history which led to this file being produced. Provides an audit trail for modifications to the original data.
|
commit, iso_lineage or lineage | Free text (ISO Lineage model 19115-2) | "Produced using CDS Toolbox v1.0" | Trace of the tools/scripts used. Either this attribute or the "history" attribute needs to include information about the versioning of the software used to create the data. This is related with some of the EQC activities (WP4 of QA4SEAS). ISO 19115-2 defines a linage model where this is been considered. |
| summary | The content will be provided ACDD (highly recommended): Text, defined phrase | A short paragraph describing the dataset | |
| keywords | The content will be provided ACDD (highly recommended) : text, controlled vocabulary | A comma separated list of key words and phrases. | |
| forecast_reference_time | SPECS: YYYY-MM-DDThh:mm:ssZ NOTE: This is ISO 8601:2004 extended format, but time zone is required to be UTC | "2011-06-01T00:00:00Z" | time of the analysis from which the forecast was made
|
...
| Bounds Name | Dimensions | Comments |
|---|---|---|
| time_bounds | time, bounds |
e.g.
[0,24] is that convention always valid? |
| leadtime_bounds | ||
| lat_bounds | lat, bounds | Values (1x1deg grid) prescribed: [-90., 89.], [-89., -88.], ... [89., 90.] |
| lon_bounds | lon, bounds | Values (1x1deg grid) prescribed: [0., 1.], [1., 2.], ... [359., 360.] |
| depth_bounds | depth,bounds | Should define the full vertical extent of the soil model layers |
| plev_bounds | ||
Grid mapping
As described in section 5.6 Grid Mappings and Projections of CF convention.
| Info |
|---|
When the coordinate variables for a horizontal grid are longitude and latitude, a grid mapping variable with grid_mapping_name of latitude_longitude may be used to specify the ellipsoid and prime meridian. |
Different name (e.g. CRS as in CF examples) |
Variables
| Generic issues about attributes of data variables | |
| attribute(s) | Notes |
_FillValue missing_value
| should both of them be used? what values? |
| grid_mapping | name of grid_mapping variable |
| coordinates | include all the auxiliary coordinates, coordinates and dimensions |
Static Fields
| attributes | |||||||
| name (CMIP5) | dimensions | standard_name | long_name (CMIP5) | units | coordinates | grid_mapping | NOTES |
|---|---|---|---|---|---|---|---|
| sftlf | lat,lon | land_area_fraction | "Land Area Fraction" | 1 | "lat lon"
| latitude_longitude | |
| orog | lat,lon | surface_altitude | "Surface Altitude" | m | "lat lon" | latitude_longitude | |
...
| attributes | ||||||||
| name (CMIP5/6&C3S) | dimensions | standard_name | long_name (CMIP5/6&C3S) | units | coordinates | cell_methods | grid_mapping | NOTES |
|---|---|---|---|---|---|---|---|---|
| psl | time,lat,lon | air_pressure_at_sea_level | "Sea Level Pressure" | Pa | "time: point" C3S: required CF: recommended | latitude_longitude | ||
| clt | time,lat,lon | cloud_area_fraction | "Total Cloud Fraction" | 1 | "time: point" C3S: required CF: recommended | latitude_longitude | ||
| tsl | time,lat,lon | soil_temperature | "Temperature of Soil" | K | "time: point" C3S: required CF: recommended | latitude_longitude | ||
| tso | time,lat,lon | sea_surface_temperature | "Sea Surface Temperature" | K | "time: point" C3S: required CF: recommended | latitude_longitude | ||
sitemptop
N/A in CMIP | time,lat,lon | sea_ice_temperature | "Surface temperature of sea ice" N/A in CMIP | K | "time: point" C3S: required CF: recommended | latitude_longitude | ||
| sic | time,lat,lon | sea_ice_area_fraction | "Sea Ice Area Fraction" | 1 | "time: point" C3S: required CF: recommended | latitude_longitude | ||
N/A in CMIP | time,depth,lat,lon | mass_content_of_water_in_soil_layer |
N/A in CMIP | kg m-2 | "time: point" C3S: required CF: recommended | latitude_longitude | ||
lwesnw
N/A in CMIP | time,lat,lon | lwe_thickness_of_surface_snow_amount | "Liquid Water Equivalent of Surface Snow Amount" N/A in CMIP | m | "time: point" C3S: required CF: recommended | latitude_longitude | ||
rhosn
N/A in CMIP | time,lat,lon | snow_density | "Snow density"
N/A in CMIP | kg m-3 | "time: point" C3S: required CF: recommended | latitude_longitude | ||
lweprs
N/A in CMIP | time,lat,lon | lwe_thickness_of_stratiform_precipitation_amount | "Liquid Water Equivalent of Stratiform Precipitation Amount"
N/A in CMIP | m | "time: sum" C3S: required CF: recommended | latitude_longitude | ||
lweprc
N/A in CMIP | time,lat,lon | lwe_thickness_of_convective_precipitation_amount | "Liquid Water Equivalent of Convective Precipitation Amount"
N/A in CMIP | m | "time: sum" C3S: required CF: recommended | latitude_longitude | ||
lwepr
N/A in CMIP | time,lat,lon | lwe_thickness_of_precipitation_amount | "Liquid Water Equivalent of Total Precipitation Amount"
N/A in CMIP | m | "time: sum" C3S: required CF: recommended | latitude_longitude | ||
| lweprsn
N/A in CMIP | time,lat,lon | lwe_thickness_of_snowfall_amount | "Liquid Water Equivalent of Snowfall Amount"
N/A in CMIP | m | "time: sum" C3S: required CF: recommended | latitude_longitude | ||
| hfss | time,lat,lon | surface_upward_sensible_heat_flux | "Surface Upward Sensible Heat Flux" | W m-2 | "time: mean (interval: <value> <unit>)" C3S: interval is required. CF: interval is optional | latitude_longitude | ||
| hfls | time,lat,lon | surface_upward_latent_heat_flux | "Surface Upward Latent Heat Flux" | W m-2 | "time: mean (interval: <value> <unit>)" C3S: interval is required. CF: interval is optional | latitude_longitude | ||
| rsds | time,lat,lon | surface_downwelling_shortwave_flux_in_air | "Surface Downwelling Shortwave Radiation" | W m-2 | "time: mean (interval: <value> <unit>)" C3S: interval is required. CF: interval is optional | latitude_longitude | ||
| rss | time,lat,lon | surface_net_downward_shortwave_flux | "Net Shortwave Surface Radiation" | W m-2 | "time: mean (interval: <value> <unit>)" C3S: interval is required. CF: interval is optional | latitude_longitude | ||
| rls | time,lat,lon | surface_net_downward_longwave_flux | "Net Longwave Surface Radiation" | W m-2 | "time: mean (interval: <value> <unit>)" C3S: interval is required. CF: interval is optional | latitude_longitude | ||
rst
N/A in CMIP | time,lat,lon | toa_net_downward_shortwave_flux | "TOA Net Shortwave Radiation" N/A in CMIP | W m-2 | "time: mean (interval: <value> <unit>)" C3S: interval is required. CF: interval is optional | latitude_longitude | ||
rlt
N/A in CMIP | time,lat,lon | toa_net_downward_longwave_flux | "TOA Net Longwave Radiation" N/A in CMIP | W m-2 | "time: mean (interval: <value> <unit>)" C3S: interval is r equired. CF: interval is optional | latitude_longitude | ||
| rsdt | time,lat,lon | toa_incoming_shortwave_flux | "TOA Incident Shortwave Radiation" | W m-2 | "time: mean (interval: <value> <unit>)" C3S: interval is required. CF: interval is optional | latitude_longitude | ||
| tauu | time,lat,lon | surface_downward_eastward_stress | "Surface Downward Eastward Wind Stress" | Pa | "time: mean (interval: <value> <unit>)" C3S: interval is required. CF: interval is optional | latitude_longitude | ||
| tauv | time,lat,lon | surface_downward_northward_stress | "Surface Downward Northward Wind Stress" | Pa | "time: mean (interval: <value> <unit>)" C3S: interval is required. CF: interval is optional | latitude_longitude | ||
lwee
N/A in CMIP | time,lat,lon | lwe_thickness_of_water_evaporation_amount | "Liquid Water Equivalent of Evaporation Amount" N/A in CMIP | m | "time: sum" C3S: required CF: recommended | latitude_longitude | ||
N/A in CMIP | time,lat,lon | runoff_amount |
N/A in CMIP | kg m-2 | "time: sum" C3S: required CF: recommended | latitude_longitude | ||
N/A in CMIP | time,lat,lon | surface_runoff_amount |
N/A in CMIP | kg m-2 | "time: sum" C3S: required CF: recommended | latitude_longitude | ||
N/A in CMIP | time,lat,lon | subsurface_runoff_amount |
N/A in CMIP | kg m-2 | "time: sum" C3S: required CF: recommended | latitude_longitude | ||
...
| attributes | ||||||||
| name (CMIP5) | dimensions | standard_name | long_name (CMIP5) | units | coordinates | cell_methods | grid_mapping | NOTES |
|---|---|---|---|---|---|---|---|---|
| zg | time,plev,lat,lon | geopotential_height | "Geopotential Height" | m | "time: point" C3S: required CF: recommended | latitude_longitude | ||
| ta | time,plev,lat,lon | air_temperature | "Air Temperature" | K | "time: point" C3S: required CF: recommended | latitude_longitude | ||
| hus | time,plev,lat,lon | specific_humidity | "Specific Humidity" | 1 | "time: point" C3S: required CF: recommended | latitude_longitude | ||
N/A in CMIP | time,plev,lat,lon | atmosphere_relative_vorticity |
N/A in CMIP | s-1 | "time: point" C3S: required CF: recommended | latitude_longitude | ||
N/A in CMIP | time,plev,lat,lon | divergence_of_wind |
N/A in CMIP | s-1 | "time: point" C3S: required CF: recommended | latitude_longitude | ||
| ua | time,plev,lat,lon | x_wind | "Eastward Wind" | m s-1 | "time: point" C3S: required CF: recommended | latitude_longitude | ||
| va | time,plev,lat,lon | y_wind | "Northward Wind" | m s-1 | "time: point" C3S: required CF: recommended | latitude_longitude | ||