https://wiki.esipfed.org/w/api.php?action=feedcontributions&user=Ajelenak&feedformat=atomEarth Science Information Partners (ESIP) - User contributions [en]2024-03-29T00:27:17ZUser contributionsMediaWiki 1.35.14https://wiki.esipfed.org/w/index.php?title=DataCite_Test&diff=50277DataCite Test2015-07-08T23:42:33Z<p>Ajelenak: Fix <div> identifier</p>
<hr />
<div>The DataCite Metadata Schema is a list of metadata elements chosen for the accurate and consistent identification of a resource for citation and retrieval purposes, along with recommended use instructions. The resource that is being identified can be of any kind, but it is typically a dataset. We use the term "dataset" in its broadest sense. We mean it to include not only numerical data, but any other research data outputs.<br />
<div id="sc23">==DataCite Metadata Schema for the Publication and Citation of Research Data - Mandatory==<br />
<i xmlns:xsl="http://www.w3.org/1999/XSL/Transform">Source: </i> [http://schema.datacite.org/meta/kernel-3.1/doc/DataCite-MetadataKernel_v3.1.pdf The DataCite Metadata Schema]<br />
<br />
<br />
<br />
<table xmlns:xsl="http://www.w3.org/1999/XSL/Transform" width="95%" border="1" cellpadding="3" cellspacing="3" style="border-collapse: collapse;" id="ACDD_highlyRecommended"><tr><th width="15%">Concept</th><th width="25%">Description</th><th width="60%">Dialect (Fit) Paths</th></tr><tr><td>[[Concepts_Glossary#Resource_Title|Resource Title]]</td><td>A short description of the resource. A cha cha cha The title should be descriptive enough so that when a user is presented with a list of titles the general content of the data set can be determined.</td><td style="word-break:break-all;"><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:citation/adiwg:citeinfo/adiwg:title<br><b>DIF</b> /dif:DIF/dif:Entry_Title<br><b>DIF</b> /dif:DIF/dif:Data_Set_Citation/dif:Dataset_Title<br><b>DCAT</b> /dct:title<br><b>Dryad</b> dcterms:title<br><b>ECHO</b> /*/echo:ShortName&gt;/*/echo:LongName<br><b>ECS</b> /*/ecs:ShortName &gt; /*/ecs:LongName<br><b>EML</b> /eml:dataset/eml:title/eml:text<br><b>FGDC</b> /fgdc:metadata/fgdc:idinfo/fgdc:citation/fgdc:citeinfo/fgdc:title<br><b>HDF5.1</b> /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Attribute[@Name='title']/hdf5:Data/hdf5:DataFromFile<br><b>HDF5.1</b> /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Group[@Name='METADATA']/hdf5:Group[@Name='COLLECTIONMETADATA']/hdf5:Attribute[@Name='LongName']/hdf5:Data/hdf5:DataFromFile<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:title/gco:CharacterString<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:identificationInfo/*/mri:citation/cit:CI_Citation/cit:title/gco:CharacterString<br><b>UMM</b> /umm:UMM/umm:CollectionCitation/umm:Title<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceIdentification/ows:Title<br><b>SERF</b> /serf:SERF/serf:Entry_Title<br><b>THREDDS</b> /thredds:catalog/thredds:dataset/@name<br><b>THREDDS</b> /thredds:catalog/thredds:dataset/thredds:metadata/dc:title<br><b>THREDDS</b> //thredds:dataset[1]/@name<br><b>netCDF</b> /nc:netcdf/nc:attribute[@nc:name=title]/@nc:value<br></td></tr><tr><td>[[Concepts_Glossary#Abstract|Abstract]]</td><td>A paragraph describing the resource.<br><br><i>Note: This concept is called "Desciption" in Catalog Services for the Web.</i></td><td style="word-break:break-all;"><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:descript/adiwg:abstract<br><b>DIF</b> /dif:DIF/dif:Summary/dif:Abstract<br><b>DCAT</b> /dct:description<br><b>Dryad</b> dcterms:description<br><b>ECHO</b> /*/echo:Description<br><b>ECS</b> /*/ecs:CollectionDescription<br><b>EML</b> /eml:dataset/eml:abstract/eml:descendant<br><b>FGDC</b> /fgdc:metadata/fgdc:idinfo/fgdc:descript/fgdc:abstract<br><b>HDF5.1</b> /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Attribute[@Name='summary']/hdf5:Data/hdf5:DataFromFile<br><b>HDF5.1</b> /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Group[@Name='METADATA']/hdf5:Group[@Name='COLLECTIONMETADATA']/hdf5:Attribute[@Name='CollectionDescription']/hdf5:Data/hdf5:DataFromFile<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:abstract/gco:CharacterString<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:identificationInfo/*/mri:abstract/gco:CharacterString<br><b>UMM</b> /umm:UMM/umm:Summary<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceIdentification/ows:Abstract<br><b>SERF</b> /serf:SERF/serf:Summary/serf:Abstract<br><b>THREDDS</b> //thredds:dataset/thredds:documentation[@type='abstract']<br><b>THREDDS</b> //thredds:metadata/thredds:documentation[@type='abstract']<br><b>netCDF</b> /nc:netcdf/nc:attribute[@nc:name='summary']/@nc:value<br></td></tr><tr><td>[[Concepts_Glossary#Theme_Keyword|Theme Keyword]]</td><td>A word or phrase that describes some aspect of a resource. Can be one of several types.<br><br><i>Note: The general identification keywords usually have a type of "theme" and are refered to as "theme keywords". Other types and vocabularies are used for other information. Service Entry Resource Format (SERF) requires a Science and a Service GCMD Keyword. This concept is called Subject in the CSW Specification.</i></td><td style="word-break:break-all;"><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:keywords/adiwg:theme/adiwg:themekey<br><b>DIF</b> (1) /dif:DIF/dif:Parameters/dif:Category<br><b>DIF</b> (1) /dif:DIF/dif:Parameters/dif:Topic<br><b>DIF</b> (1) /dif:DIF/dif:Parameters/dif:Term<br><b>DIF</b> (1) /dif:DIF/dif:Parameters/dif:Variable_Level_1<br><b>DIF</b> (1) /dif:DIF/dif:Parameters/dif:Variable_Level_2<br><b>DIF</b> (1) /dif:DIF/dif:Parameters/dif:Variable_Level_3<br><b>DIF</b> (1) /dif:DIF/dif:Parameters/dif:Detailed_Variable<br><b>DCAT</b> /dct:keyword<br><b>Dryad</b> dcterms:subject<br><b>ECHO</b> (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:CategoryKeyword<br><b>ECHO</b> (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:TopicKeyword<br><b>ECHO</b> (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:TermKeyword<br><b>ECHO</b> (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel1Keyword/echo:Value<br><b>ECHO</b> (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel2Keyword/echo:Value<br><b>ECHO</b> (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel3Keyword<br><b>ECHO</b> (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:DetailedVariableKeyword<br><b>ECS</b> (1) /*/ecs:DisciplineTopicParameters/ecs:DisciplineKeyword<br><b>ECS</b> (1) /*/ecs:DisciplineTopicParameters/ecs:TopicKeyword<br><b>ECS</b> (1) /*/ecs:DisciplineTopicParameters/ecs:TermKeyword<br><b>ECS</b> (1) /*/ecs:DisciplineTopicParameters/ecs:VariableKeyword<br><b>EML</b> (1) /eml:dataset/eml:keywordSet/eml:keyword/eml:text<br><b>FGDC</b> /fgdc:metadata/fgdc:idinfo/fgdc:keywords/fgdc:theme/fgdc:themekey<br><b>HDF5.1</b> (1) /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Attribute[@Name='keywords']/hdf5:Data/hdf5:DataFromFile<br><b>HDF5.1</b> (1) /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Group[@Name='METADATA']/hdf5:Group[@Name='COLLECTIONMETADATA']/hdf5:Group[@Name='DisciplineTopicParameters']/hdf5:Group/hdf5:Attribute[@Name='ECSDisciplineKeyword']/hdf5:Data/hdf5:DataFromFile<br><b>HDF5.1</b> (1) /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Group[@Name='METADATA']/hdf5:Group[@Name='COLLECTIONMETADATA']/hdf5:Group[@Name='DisciplineTopicParameters']/hdf5:Group/hdf5:Attribute[@Name='ECSTermKeyword']/hdf5:Data/hdf5:DataFromFile<br><b>HDF5.1</b> (1) /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Group[@Name='METADATA']/hdf5:Group[@Name='COLLECTIONMETADATA']/hdf5:Group[@Name='DisciplineTopicParameters']/hdf5:Group/hdf5:Attribute[@Name='ECSTopicKeyword']/hdf5:Data/hdf5:DataFromFile<br><b>HDF5.1</b> (1) /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Group[@Name='METADATA']/hdf5:Group[@Name='COLLECTIONMETADATA']/hdf5:Group[@Name='DisciplineTopicParameters']/hdf5:Group/hdf5:Attribute[@Name='ECSVariableKeyword']/hdf5:Data/hdf5:DataFromFile<br><b>HDF5.1</b> (1) /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Group[@Name='METADATA']/hdf5:Group[@Name='COLLECTIONMETADATA']/hdf5:Group[@Name='DisciplineTopicParameters']/hdf5:Group/hdf5:Group[@Name='ECSParameter']/hdf5:Attribute[@Name='ECSParameterKeyword']/hdf5:Data/hdf5:DataFromFile<br><b>ISO</b> (1) /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords[gmd:type/gmd:MD_KeywordTypeCode=[normalize-space()="theme"]]/gmd:keyword/gco:CharacterString<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:identificationInfo/*/mri:descriptiveKeywords/mri:MD_Keywords[mri:type/mri:MD_KeywordTypeCode=[normalize-space()="theme"]]/mri:keyword/gco:CharacterString<br><b>UMM</b> (1) /umm:UMM/umm:ScienceKeywords/umm:Category<br><b>UMM</b> (1) /umm:UMM/umm:ScienceKeywords/umm:Topic<br><b>UMM</b> (1) /umm:UMM/umm:ScienceKeywords/umm:Term<br><b>UMM</b> (1) /umm:UMM/umm:ScienceKeywords/umm:VariableLevel1/umm:Value<br><b>UMM</b> (1) /umm:UMM/umm:ScienceKeywords/umm:VariableLevel1/umm:VariableLevel2/umm:Value<br><b>UMM</b> (1) /umm:UMM/umm:ScienceKeywords/umm:VariableLevel1/umm:VariableLevel2/umm:VariableLevel3/umm:Value<br><b>UMM</b> (1) /umm:UMM/umm:ScienceKeywords/umm:DetailedVariable<br><b>OGC-SOS</b> (1) /sos:Capabilities/ows:ServiceIdentification/ows:Keywords[ows:Type='theme']/ows:Keyword<br><b>SERF</b> /serf:SERF/serf:Keyword<br><b>THREDDS</b> (1) //thredds:metadata/thredds:keyword<br><b>THREDDS</b> (1) //thredds:dataset/thredds:keyword<br><b>netCDF</b> (1) /nc:netcdf/nc:attribute[@nc:name=keywords]/@nc:value<br></td></tr></table></div><br />
<br />
<br />
''xPath Note:'' The xPaths included in this table use several wildcards. // means any path, so //gmd:CI_ResponsibleParty indicates a gmd:CI_ResponsibleParty anywhere in an XML file. /*/ indicates a single level with several possible elements. This usually indicates one of several concrete realizations of an abstract object. For example /*/gmd:identificationInfo could be gmd:MD_Metadata/gmd:identificationInfo or gmi:MI_Metadata/gmd:identificationInfo and gmd:identificationInfo/*/gmd:descriptiveKeywords could be gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords or gmd:identificationInfo/srv:SV_ServiceIdentification/gmd:descriptiveKeywords.<br />
''Fit:'' The fit of the dialect path with the concept is estimated on a scale of 1 = excellent two-way fit, 2 = one-way fit or some other problem, 3 - extension required.<br />
<br />
==DataCite Metadata Schema for the Publication and Citation of Research Data - Recommended==<br />
The DataCite Metadata Schema is a list of core metadata properties chosen for the accurate and consistent identification of a resource for citation and retrieval purposes, along with recommended use instructions. The resource that is being identified can be of any kind, but it is typically a dataset. We use the term ‘dataset’ in its broadest sense. We mean it to include not only numerical data, but any other research data outputs.<br />
<i xmlns:xsl="http://www.w3.org/1999/XSL/Transform">Source: </i> [http://schema.datacite.org/meta/kernel-3.1/doc/DataCite-MetadataKernel_v3.1.pdf The DataCite Metadata Schema]<table id="sc24" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" width="95%" border="1" cellpadding="3" cellspacing="3" style="border-collapse: collapse;"><tr><th width="15%">Concept</th><th width="25%">Description</th><th width="60%">Dialect (Fit) Paths</th></tr><tr><td>[[Concepts_Glossary#Keyword|Keyword]]</td><td>A word or phrase that describes some aspect of a resource. Can be one of several types.<br><br><i>Note: The general identification keywords usually have a type of "theme" and are refered to as "theme keywords". Other types and vocabularies are used for other information. Service Entry Resource Format (SERF) requires a Science and a Service GCMD Keyword. This concept is called Subject in the CSW Specification.</i></td><td style="word-break:break-all;"><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:keywords/adiwg:theme/adiwg:themekey<br><b>DIF</b> (1) /dif:DIF/dif:Parameters/dif:Category<br><b>DIF</b> (1) /dif:DIF/dif:Parameters/dif:Topic<br><b>DIF</b> (1) /dif:DIF/dif:Parameters/dif:Term<br><b>DIF</b> (1) /dif:DIF/dif:Parameters/dif:Variable_Level_1<br><b>DIF</b> (1) /dif:DIF/dif:Parameters/dif:Variable_Level_2<br><b>DIF</b> (1) /dif:DIF/dif:Parameters/dif:Variable_Level_3<br><b>DIF</b> (1) /dif:DIF/dif:Parameters/dif:Detailed_Variable<br><b>DCAT</b> /dct:keyword<br><b>Dryad</b> dcterms:subject<br><b>ECHO</b> (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:CategoryKeyword<br><b>ECHO</b> (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:TopicKeyword<br><b>ECHO</b> (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:TermKeyword<br><b>ECHO</b> (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel1Keyword/echo:Value<br><b>ECHO</b> (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel2Keyword/echo:Value<br><b>ECHO</b> (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:VariableLevel3Keyword<br><b>ECHO</b> (1) /*/echo:ScienceKeywords/echo:ScienceKeyword/echo:DetailedVariableKeyword<br><b>ECS</b> (1) /*/ecs:DisciplineTopicParameters/ecs:DisciplineKeyword<br><b>ECS</b> (1) /*/ecs:DisciplineTopicParameters/ecs:TopicKeyword<br><b>ECS</b> (1) /*/ecs:DisciplineTopicParameters/ecs:TermKeyword<br><b>ECS</b> (1) /*/ecs:DisciplineTopicParameters/ecs:VariableKeyword<br><b>EML</b> (1) /eml:dataset/eml:keywordSet/eml:keyword/eml:text<br><b>FGDC</b> (1) /fgdc:metadata/fgdc:idinfo/fgdc:keywords/fgdc:theme/fgdc:themekey<br><b>HDF5.1</b> (1) /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Attribute[@Name='keywords']/hdf5:Data/hdf5:DataFromFile<br><b>HDF5.1</b> (1) /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Group[@Name='METADATA']/hdf5:Group[@Name='COLLECTIONMETADATA']/hdf5:Group[@Name='DisciplineTopicParameters']/hdf5:Group/hdf5:Attribute[@Name='ECSDisciplineKeyword']/hdf5:Data/hdf5:DataFromFile<br><b>HDF5.1</b> (1) /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Group[@Name='METADATA']/hdf5:Group[@Name='COLLECTIONMETADATA']/hdf5:Group[@Name='DisciplineTopicParameters']/hdf5:Group/hdf5:Attribute[@Name='ECSTermKeyword']/hdf5:Data/hdf5:DataFromFile<br><b>HDF5.1</b> (1) /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Group[@Name='METADATA']/hdf5:Group[@Name='COLLECTIONMETADATA']/hdf5:Group[@Name='DisciplineTopicParameters']/hdf5:Group/hdf5:Attribute[@Name='ECSTopicKeyword']/hdf5:Data/hdf5:DataFromFile<br><b>HDF5.1</b> (1) /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Group[@Name='METADATA']/hdf5:Group[@Name='COLLECTIONMETADATA']/hdf5:Group[@Name='DisciplineTopicParameters']/hdf5:Group/hdf5:Attribute[@Name='ECSVariableKeyword']/hdf5:Data/hdf5:DataFromFile<br><b>HDF5.1</b> (1) /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Group[@Name='METADATA']/hdf5:Group[@Name='COLLECTIONMETADATA']/hdf5:Group[@Name='DisciplineTopicParameters']/hdf5:Group/hdf5:Group[@Name='ECSParameter']/hdf5:Attribute[@Name='ECSParameterKeyword']/hdf5:Data/hdf5:DataFromFile<br><b>ISO</b> (1) /*/gmd:identificationInfo/*/gmd:descriptiveKeywords/gmd:MD_Keywords[gmd:type/gmd:MD_KeywordTypeCode='theme']/gmd:keyword/gco:CharacterString<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:identificationInfo/*/mri:descriptiveKeywords/mri:MD_Keywords[mri:type/mri:MD_KeywordTypeCode='theme']/mri:keyword/gco:CharacterString<br><b>UMM</b> (1) /umm:UMM/umm:ScienceKeywords/umm:Category<br><b>UMM</b> (1) /umm:UMM/umm:ScienceKeywords/umm:Topic<br><b>UMM</b> (1) /umm:UMM/umm:ScienceKeywords/umm:Term<br><b>UMM</b> (1) /umm:UMM/umm:ScienceKeywords/umm:VariableLevel1/umm:Value<br><b>UMM</b> (1) /umm:UMM/umm:ScienceKeywords/umm:VariableLevel1/umm:VariableLevel2/umm:Value<br><b>UMM</b> (1) /umm:UMM/umm:ScienceKeywords/umm:VariableLevel1/umm:VariableLevel2/umm:VariableLevel3/umm:Value<br><b>UMM</b> (1) /umm:UMM/umm:ScienceKeywords/umm:DetailedVariable<br><b>OGC-SOS</b> (1) /sos:Capabilities/ows:ServiceIdentification/ows:Keywords[ows:Type='theme']/ows:Keyword<br><b>SERF</b> /serf:SERF/serf:Keyword<br><b>THREDDS</b> (1) //thredds:metadata/thredds:keyword<br><b>THREDDS</b> (1) //thredds:dataset/thredds:keyword<br><b>netCDF</b> (1) /nc:netcdf/nc:attribute[@nc:name=keywords]/@nc:value<br></td></tr><tr><td>[[Concepts_Glossary#Contributor_Name|Contributor Name]]</td><td>Contributor to the resource</td><td style="word-break:break-all;"><b>ISO</b> /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty[gmd:role/gmd:CI_RoleCode = 'manyOptions']/gmd:CI_Individual/gmd:name/gco:CharacterString<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:identificationInfo/*/mri:citation/cit:CI_Citation/cit:citedResponsibleParty/cit:CI_Responsibility[cit:role/cit:CI_RoleCode='manyOptions']/cit:party/cit:CI_Individual/cit:name/gco:CharacterString<br><b>THREDDS</b> /thredds:catalog/thredds:metadata/thredds:contributor<br><b>THREDDS</b> /thredds:catalog/thredds:dataset/thredds:contributor<br><b>netCDF</b> /nc:netcdf/nc:attribute[@nc:name=creator_name]/@nc:value<br><b>netCDF</b> /nc:netcdf/nc:attribute[@nc:name=contributor_name]/@nc:value<br></td></tr><tr><td>[[Concepts_Glossary#Contributor_Role|Contributor Role]]</td><td>The role of any individuals or institutions that contributed to the creation of the data.</td><td style="word-break:break-all;"><b>ISO</b> /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:citedResponsibleParty/gmd:CI_ResponsibleParty/gmd:role/gmd:CI_RoleCode<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:identificationInfo/*/mri:citation/cit:CI_Citation/cit:citedResponsibleParty/cit:CI_Responsibility/cit:role/cit:CI_RoleCode<br><b>THREDDS</b> /thredds:catalog/thredds:dataset/thredds:contributor/@role<br><b>THREDDS</b> /thredds:catalog/thredds:metadata/thredds:contributor/@role<br><b>netCDF</b> /nc:netcdf/nc:attribute[@nc:name=contributor_role]/@nc:value<br></td></tr><tr><td>[[Concepts_Glossary#Resource_Type|Resource Type]]</td><td>A resource code identifying the type of resource e.g. dataset, a collection, an application (see MD_ScopeCode) which the metadata describes.</td><td style="word-break:break-all;"><b>ISO</b> /gmd:MD_Metadata/gmd:hierarchyLevel/gmd:MD_ScopeCode<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:metadataScope/mdb:MD_MetadataScope/mdb:resourceScope/mcc:MD_ScopeCode<br></td></tr><tr><td>[[Concepts_Glossary#Related_Resource_Identifier|Related Resource Identifier]]</td><td>Identifier for a resource related to the resource being described.</td><td style="word-break:break-all;"><b>ECHO</b> (1) /*/echo:ShortName<br><b>ECHO</b> (1) /*/echo:Spatial/echo:HorizontalSpatialDomain/echo:ZoneIdentifier<br><b>ECHO</b> (1) /*/echo:ProcessingLevelId<br><b>ECHO</b> (1) /*/echo:Campaigns/echo:Campaign/echo:ShortName | /*/echo:Campaigns/echo:Campaign/echo:LongName<br><b>ECHO</b> (1) /*/echo:Platforms/echo:Platform/echo:ShortName | /*/echo:Platforms/echo:Platform/echo:LongName<br><b>ECHO</b> (1) /*/echo:Platforms/echo:Platform/echo:Instruments/echo:Instrument/echo:ShortName | /echo:*/echo:Platforms/echo:Platform/echo:Instruments/echo:Instrument/echo:LongName<br><b>ECHO</b> (1) /*/echo:Platforms/echo:Platform/echo:Instruments/echo:Instrument/echo:Sensors/echo:Sensor/echo:ShortName | /*/echo:Platforms/echo:Platform/echo:Instruments/echo:Instrument/echo:Sensors/echo:Sensor/echo:LongName<br><b>ECHO</b> (1) /*/echo:AssociatedDIFs/echo:DIF/echo:EntryId<br><b>ISO</b> (1) /*/gmd:identificationInfo/*/gmd:aggregationInfo/gmd:MD_AggregateInformation/gmd:aggregateDataSetIdentifier/gmd:MD_Identifier/gmd:code/gco:CharacterString<br><b>ISO</b> (1) /*/gmd:identificationInfo/*/gmd:extent/gmd:EX_Extent/gmd:geographicElement/gmd:EX_GeographicDescription/gmd:geographicIdentifier/gmd:MD_Identifier/gmd:code/gco:CharacterString<br><b>ISO</b> (1) /*/gmd:identificationInfo/*/gmd:processingLevel/gmd:MD_Identifier/gmd:code/gco:CharacterString<br><b>ISO</b> (1) /*/gmd:dataQualityInfo/gmd:DQ_DataQuality/gmd:report/gmd:DQ_AccuracyOfATimeMeasurement/gmd:measureIdentification/gmd:MD_Identifier/gmd:code/gco:CharacterString<br><b>ISO</b> (1) /gmi:MI_Metadata/gmi:acquisitionInformation/eos:EOS_AcquisitionInformation/gmi:operation/gmi:MI_Operation/gmi:identifier/gmd:MD_Identifier/gmd:code/gco:CharacterString<br><b>ISO</b> (1) /gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:platform/gmi:MI_Platform/gmi:identifier/gmd:MD_Identifier/gmd:code/gco:CharacterString<br><b>ISO</b> (1) /gmi:MI_Metadata/gmi:acquisitionInformation/gmi:MI_AcquisitionInformation/gmi:instrument/gmi:MI_Instrument/gmi:identifier/gmd:MD_Identifier/gmd:code/gco:CharacterString<br><b>ISO</b> /gmi:MI_Metadata/gmi:acquisitionInformation/eos:EOS_AcquisitionInformation/eos:sensor/eos:EOS_Sensor/eos:identifier/gmd:MD_Identifier/gmd:code/gco:CharacterString<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:identificationInfo/*/mri:associatedResource/mri:MD_AssociatedResource/mri:name/cit:CI_Citation/cit:identifier/mcc:MD_Identifier/mcc:code/gco:CharacterString<br></td></tr><tr><td>[[Concepts_Glossary#Abstract|Abstract]]</td><td>A paragraph describing the resource.<br><br><i>Note: This concept is called "Desciption" in Catalog Services for the Web.</i></td><td style="word-break:break-all;"><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:descript/adiwg:abstract<br><b>DIF</b> /dif:DIF/dif:Summary/dif:Abstract<br><b>DCAT</b> /dct:description<br><b>Dryad</b> dcterms:description<br><b>ECHO</b> /*/echo:Description<br><b>ECS</b> /*/ecs:CollectionDescription<br><b>EML</b> /eml:dataset/eml:abstract/eml:descendant<br><b>FGDC</b> /fgdc:metadata/fgdc:idinfo/fgdc:descript/fgdc:abstract<br><b>HDF5.1</b> /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Attribute[@Name='summary']/hdf5:Data/hdf5:DataFromFile<br><b>HDF5.1</b> /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Group[@Name='METADATA']/hdf5:Group[@Name='COLLECTIONMETADATA']/hdf5:Attribute[@Name='CollectionDescription']/hdf5:Data/hdf5:DataFromFile<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:abstract/gco:CharacterString<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:identificationInfo/*/mri:abstract/gco:CharacterString<br><b>UMM</b> /umm:UMM/umm:Summary<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceIdentification/ows:Abstract<br><b>SERF</b> /serf:SERF/serf:Summary/serf:Abstract<br><b>THREDDS</b> //thredds:dataset/thredds:documentation[@type='abstract']<br><b>THREDDS</b> //thredds:metadata/thredds:documentation[@type='abstract']<br><b>netCDF</b> /nc:netcdf/nc:attribute[@nc:name='summary']/@nc:value<br></td></tr><tr><td>[[Concepts_Glossary#Spatial_Extent|Spatial Extent]]</td><td>The spatial extent of the resource.</td><td style="word-break:break-all;"><b>ECHO</b> /*/Spatial/HorizontalSpatialDomain/Geometry<br><b>ISO</b> /*/mri:MD_DataIdentification/mri:extent/gex:EX_Extent/gex:geographicElement/gex:EX_GeographicBoundingBox<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:extent/gex:EX_Extent/gex:geographicElement/gex:EX_GeographicBoundingBox<br></td></tr></table><br />
''xPath Note:'' The xPaths included in this table use several wildcards. // means any path, so //gmd:CI_ResponsibleParty indicates a gmd:CI_ResponsibleParty anywhere in an XML file. /*/ indicates a single level with several possible elements. This usually indicates one of several concrete realizations of an abstract object. For example /*/gmd:identificationInfo could be gmd:MD_Metadata/gmd:identificationInfo or gmi:MI_Metadata/gmd:identificationInfo and gmd:identificationInfo/*/gmd:descriptiveKeywords could be gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords or gmd:identificationInfo/srv:SV_ServiceIdentification/gmd:descriptiveKeywords.<br />
''Fit:'' The fit of the dialect path with the concept is estimated on a scale of 1 = excellent two-way fit, 2 = one-way fit or some other problem, 3 - extension required.<br />
<br />
==DataCite Metadata Schema for the Publication and Citation of Research Data - Optional==<br />
The DataCite Metadata Schema is a list of core metadata properties chosen for the accurate and consistent identification of a resource for citation and retrieval purposes, along with recommended use instructions. The resource that is being identified can be of any kind, but it is typically a dataset. We use the term ‘dataset’ in its broadest sense. We mean it to include not only numerical data, but any other research data outputs.<br />
<i xmlns:xsl="http://www.w3.org/1999/XSL/Transform">Source: </i> [http://schema.datacite.org/meta/kernel-3.1/doc/DataCite-MetadataKernel_v3.1.pdf The DataCite Metadata Schema]<table id="sc25" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" width="95%" border="1" cellpadding="3" cellspacing="3" style="border-collapse: collapse;"><tr><th width="15%">Concept</th><th width="25%">Description</th><th width="60%">Dialect (Fit) Paths</th></tr><tr><td>[[Concepts_Glossary#Resource_Language|Resource Language]]</td><td>The language of the resource.</td><td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Data_Set_Language<br><b>DCAT</b> /dct:Language<br><b>ISO</b> /*/gmd:identificationInfo/gmd:MD_DataIdentification/gmd:language/gco:CharacterString<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:defaultLocale/lan:PT_Locale/lan:language/lan:LanguageCode<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:otherLocale/lan:PT_Locale/lan:language/lan:LanguageCode<br><b>SERF</b> /serf:SERF/serf:Service_Language<br></td></tr><tr><td>[[Concepts_Glossary#Resource_Identifier|Resource Identifier]]</td><td>Identifier for the resource described by the metadata</td><td style="word-break:break-all;"><b>ADIwg</b> /adiwg:project/adiwg:idinfo/adiwg:ids/adiwg:projguid<br><b>DIF</b> /dif:DIF/dif:Data_Set_Citation/dif:Dataset_DOI<br><b>DCAT</b> /dct:identifier<br><b>ECHO</b> /*/echo:DataSetId<br><b>ECHO</b> (1) /*/echo:ShortName | /*/echo:LongName<br><b>ECS</b> /ecs:LocalGranuleID<br><b>HDF5.1</b> /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Group[@Name='METADATA']/hdf5:Group[@Name='INVENTORYMETADATA']/hdf5:Group[@Name='ProductSpecificMetadata']/hdf5:Attribute[@Name='identifier_file_uuid']/hdf5:Data/hdf5:DataFromFile<br><b>HDF5.1</b> /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Attribute[@Name='identifier_file_uuid']/hdf5:Data/hdf5:DataFromFile<br><b>ISO</b> /*/gmd:identificationInfo/*/gmd:citation/gmd:CI_Citation/gmd:identifier/gmd:MD_Identifier/gmd:code/gco:CharacterString<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:identificationInfo/*/mri:citation/cit:CI_Citation/cit:identifier/mcc:MD_Identifier/mcc:code/gco:CharacterString<br><b>THREDDS</b> /thredds:catalog/thredds:dataset/@ID<br><b>netCDF</b> /nc:netcdf/nc:attribute[@nc:name=id]/@nc:value<br></td></tr><tr><td>[[Concepts_Glossary#Transfer_Size|Transfer Size]]</td><td>The size of the digital resource</td><td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Distribution/dif:Distribution_Size<br><b>ECHO</b> /echo:Granule/echo:DataGranule/echo:SizeMBDataGranule<br><b>ECS</b> /ecs:SizeMBECSDataGranule<br><b>ISO</b> /gmd:MD_Metadata/gmd:distributionInfo/gmd:MD_Distribution/gmd:distributionFormat/gmd:MD_Format/gmd:formatDistributor/gmd:MD_Distributor/gmd:distributorTransferOptions/gmd:MD_DigitalTransferOptions/gmd:transferSize/gco:Real<br><b>ISO</b> /gmd:MD_Metadata/gmd:distributionInfo/gmd:MD_Distribution/gmd:distributor/gmd:MD_Distributor/gmd:distributorTransferOptions/gmd:MD_DigitalTransferOptions/gmd:transferSize/gco:Real<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:distributionInfo/mrd:MD_Distribution/mrd:distributionFormat/mrd:MD_Format/mrd:formatDistributor/mrd:MD_Distributor/mrd:distributorTransferOptions/mrd:MD_DigitalTransferOptions/mrd:transferSize/gco:Real<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:distributionInfo/mrd:MD_Distribution/mrd:distributor/mrd:MD_Distributor/mrd:distributorTransferOptions/mrd:MD_DigitalTransferOptions/mrd:transferSize/gco:Real<br></td></tr><tr><td>[[Concepts_Glossary#Resource_Format|Resource Format]]</td><td>The physical or digital manifestation of the resource</td><td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Distribution/dif:Distribution_Format<br><b>DCAT</b> /dct:format<br><b>ECHO</b> /*/echo:DataFormat<br><b>ECS</b> /ecs:PrimaryCSDT<br><b>HDF5.1</b> /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Attribute[@Name='HDFVersion']/hdf5:Data/hdf5:DataFromFile<br><b>HDF5.1</b> /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Group[@Name='METADATA']/hdf5:Attribute[@Name='HDFVersion']/hdf5:Data/hdf5:DataFromFile<br><b>ISO</b> /*/gmd:distributionInfo/gmd:MD_Distribution/gmd:distributor/gmd:MD_Distributor/gmd:distributorFormat/gmd:MD_Format/gmd:name/gco:CharacterString<br><b>ISO</b> /*/gmd:distributionInfo/gmd:MD_Distribution/gmd:distributionFormat/gmd:MD_Format/gmd:name/gco:CharacterString<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:distributionInfo/mrd:MD_Distribution/mrd:distributionFormat/mrd:MD_Format<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:distributionInfo/mrd:MD_Distribution/mrd:distributor/mrd:MD_Distributor/mrd:distributorFormat/mrd:MD_Format<br><b>SERF</b> /serf:SERF/serf:Distribution/serf:Distribution_Format<br></td></tr><tr><td>[[Concepts_Glossary#Version|Version]]</td><td>Version of the cited resource</td><td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Data_Set_Citation/dif:Dataset_Version<br><b>DIF</b> /dif:DIF/dif:Reference/dif:Edition<br><b>ECHO</b> /*/echo:VersionId<br><b>ECS</b> /*/ecs:VersionId<br><b>HDF5.1</b> /hdf5:HDF5-File/hdf5:RootGroup/hdf5:Group[@Name='METADATA']/hdf5:Group[@Name='COLLECTIONMETADATA']/hdf5:Attribute[@Name='VersionID']/hdf5:Data/hdf5:DataFromFile<br><b>ISO</b> /*/gmd:MD_DataIdentification/gmd:citation/gmd:CI_Citation/gmd:edition/gco:CharacterString<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:identificationInfo/mri:MD_DataIdentification/mri:citation/cit:CI_Citation/cit:edition/gco:CharacterString<br></td></tr><tr><td>[[Concepts_Glossary#Rights|Rights]]</td><td>Information about rights held in and over the resource</td><td style="word-break:break-all;"><b>ISO</b> /*/gmd:identificationInfo/*/gmd:resourceConstraints/gmd:MD_LegalConstraints<br><b>ISO-1</b> /mdb:MD_Metadata/mdb:identificationInfo/*/mri:resourceConstraints/mco:MD_LegalConstraints<br></td></tr></table><br />
''xPath Note:'' The xPaths included in this table use several wildcards. // means any path, so //gmd:CI_ResponsibleParty indicates a gmd:CI_ResponsibleParty anywhere in an XML file. /*/ indicates a single level with several possible elements. This usually indicates one of several concrete realizations of an abstract object. For example /*/gmd:identificationInfo could be gmd:MD_Metadata/gmd:identificationInfo or gmi:MI_Metadata/gmd:identificationInfo and gmd:identificationInfo/*/gmd:descriptiveKeywords could be gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords or gmd:identificationInfo/srv:SV_ServiceIdentification/gmd:descriptiveKeywords.<br />
''Fit:'' The fit of the dialect path with the concept is estimated on a scale of 1 = excellent two-way fit, 2 = one-way fit or some other problem, 3 - extension required.</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=45405NetCDF-CF File Examples for Satellite Swath Data2014-01-29T00:41:30Z<p>Ajelenak: /* Templates for Multiband Imagery (Level 1) Data */</p>
<hr />
<div>[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]<br />
[[Category:Climate Forecast Conventions]]<br />
__FORCETOC__<br />
<br />
==GHRSST Level 2 Data==<br />
''Contributor: Ed Armstrong (NASA JPL)''<br />
<br />
The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
<br />
==Templates for Multiband Imagery (Level 1) Data==<br />
''Contributor: Aleksandar Jelenak (The HDF Group)''<br />
<br />
These templates can be used for storing satellite swath multiband (a.k.a. Level 1) geolocated and calibrated data. The templates have been inspired by a [http://mailman.cgd.ucar.edu/pipermail/cf-metadata/2013/056398.html discussion] on the CF metadata mailing list and the resulting CF trac [https://cf-pcmdi.llnl.gov/trac/ticket/100 ticket] to allow non-spatiotemporal coordinates.<br />
<br />
The following two templates differ in the type of variable, named <tt>band</tt> in both, that serves as the spectral coordinate. The first template uses a numerical coordinate variable whereas the second a string-valued auxiliary coordinate variable. The first template is applicable to data acquired by optical imagers. The second template is aimed at data from microwave instruments where several bands can only differ in the polarization of electromagnetic radiation measured and thus a numerical spectral coordinate would not be able to differentiate between them. Only the variable attributes that support the concept are included in the templates.<br />
<br />
Template with numerical spectral coordinate variable:<br />
<br />
dimensions:<br />
'''time''' = ''<integer>'' ; // option: time = UNLIMITED<br />
'''swath''' = ''<integer>'' ;<br />
'''band''' = ''<integer>'' ;<br />
<br />
variables:<br />
// spectral coordinate variable<br />
'''float band(band) ;'''<br />
band:standard_name = “'''sensor_band_central_radiation_wavelength'''” ;<br />
band:units = “um” ;<br />
<br />
float lat('''time''', '''swath''') ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon('''time''', '''swath''') ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(time) ;<br />
time:standard_name = "time" ;<br />
time:units = "''<units>'' since ''<datetime string>''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data('''time''', '''swath''', '''band''') ;<br />
'''swath_band_data:coordinates = "lon lat" ;'''<br />
<br />
Template with string spectral coordinate variable:<br />
<br />
dimensions:<br />
'''time''' = ''<integer>'' ; // option: time = UNLIMITED<br />
'''swath''' = ''<integer>'' ;<br />
'''band_enum''' = ''<integer>'' ;<br />
'''band_strlen''' = ''<integer>'' ;<br />
<br />
variables: <br />
// string-valued auxiliary coordinate variable<br />
'''char band(band_enum, band_strlen) ;'''<br />
band:standard_name = “'''sensor_band_identifier'''” ;<br />
<br />
float lat('''time''', '''swath''') ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon('''time''', '''swath''') ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(time) ;<br />
time:standard_name = "time" ;<br />
time:units = "''<units>'' since ''<datetime string>''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data('''time''', '''swath''', '''band_enum''') ;<br />
'''swath_band_data:coordinates = "lon lat band" ;'''</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Category:Attribute_Conventions_Dataset_Discovery&diff=45404Category:Attribute Conventions Dataset Discovery2014-01-29T00:18:10Z<p>Ajelenak: </p>
<hr />
<div><br />
=Background=<br />
This category on the ESIP wiki provides a landing page for information related to the Attribute Conventions for Dataset Discovery. These conventions identify and define a list of NetCDF global attributes recommended for describing a NetCDF dataset to discovery systems such as Digital Libraries. Software tools will use these attributes for extracting metadata from datasets, and exporting to Dublin Core, DIF, ADN, FGDC, ISO 19115 etc. metadata formats.<br />
<br />
=History =<br />
{| class="wikitable"<br />
|-<br />
! Version !! Description !! Date<br />
|-<br />
| [http://www.unidata.ucar.edu/software/netcdf-java/formats/DataDiscoveryAttConvention.html 1.0] || Original version published by Ethan Davis on the Unidata website. || 2005-09-28<br />
|-<br />
| [http://wiki.esipfed.org/index.php/Attribute_Convention_for_Data_Discovery_%28ACDD%29 1.1] || The Unidata vocabulary was migrated to the [https://geo-ide.noaa.gov/wiki/index.php?title=NetCDF_Attribute_Convention_for_Dataset_Discovery NOAA Environmental Data Management wiki] on or around 2010-01-20. The discussion and developments on that page focused on mapping the ACDD elements to corresponding ISO elements. These mappings became the basis for software tools to translate from netCDF to ISO19115/19115-2/19119 (e.g. [https://geo-ide.noaa.gov/wiki/index.php?title=NcISO ncISO] and [http://trac.osgeo.org/geonetwork/wiki/ISO19119impl Geonetwork]. The current version on this, the [http://wiki.esipfed.org/index.php/Attribute_Convention_for_Data_Discovery_%28ACDD%29 ESIP Federation Wiki], is a copy of the NOAA page.|| 2013-04-26<br />
|-<br />
| [[Attribute Convention for Data Discovery (ACDD) Working| 1.2 ''beta'' ]] || Migration of the NOAA EDM page to the ESIP wiki. The versions of ACDD were then separated into a current (then v. 1.1) and working standard (v. 1.2 beta). The working standard should not be considered stable and is subject to change. || 2013-04-26 <br />
|-<br />
|}<br />
<br />
NOTE: Occasionally the acronym UDDC (Unidata Dataset Discovery Conventions) is used in the community to refer to the same convention. ACDD is preferred over UDDC going forward.<br />
<br />
Regardless of the numeric version, the current version is always found at [[Attribute Convention for Data Discovery (ACDD)]] and the working version including new concepts and terms under consideration can be found at [[Attribute Convention for Data Discovery (ACDD) Working]]<br />
<br />
=Objectives and Goals=<br />
#To allow dataset discovery and facilitate mapping between dataset metadata (notably netCDF) and ISO 19115.<br />
#The ACDD Steering Group formalizes changes and additions to ACDD<br />
<br />
=Governance=<br />
The discussion for changes to ACDD is carried out via this wiki and the [http://lists.esipfed.org/mailman/roster/esip-documentation ESIP Documentation Cluster mailing list]. To sign up for edit privileges for this wiki you must first [http://commons.esipfed.org/user/register register at the ESIP Commons]. This registration also grants access to other community resources supported by ESIP. Both the mailing list and this wiki are open and anyone in the community. ACDD will evolve based on the discussions on this list and as documented on these wiki pages. Occasionally, the discussion may need to be moderated or a decision must be made. In these cases the steering committee will vote and adopt a solution as described below. <br />
==Steering Committee==<br />
ACDD will evolve based on the direction of the steering committee initially comprised of the following members:<br />
<br />
*Derrick Snowden (Chair) IOOS<br />
*Dave Blodgett USGS<br />
*Nan Galbraith WHOI<br />
*John Graybeal Marinexplore.org<br />
*Ted Habermann The HDF Group<br />
*Steve Hankin PMEL<br />
*Marcos Hermida Unidata<br />
*Aleksandar Jelenak The HDF Group<br />
*Anna Milan NGDC<br />
*Dave Neufeld CIRES<br />
*Rich Signell USGS<br />
*Bob Simons NMFS<br />
*Ed Armstrong JPL<br />
<br />
==Decision Making Process==<br />
<br />
Vote 70% majority of voting members; members may decline to vote on some issues<br />
<br />
If a vote is taken or a decision is reached, that decision should be broadcast to those who could not be present. Discussion of the decision takes place for some period of time (or till the next meeting?) If there is disagreement or ongoing discussion, the decision is not finalized. If there is no discussion or disagreement, the topic is final and will not be revisited later.<br />
<br />
<br />
[[Category: Documentation Cluster]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=44504Standard Names For Satellite Observations2013-07-17T18:18:42Z<p>Ajelenak: /* CF Standard Name Version 24, 27 June 2013 */</p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Accepted Standard Names==<br />
<br />
Below are listed proposed standard names from this page that are now accepted in the official CF standard name table.<br />
<br />
===CF Standard Name Table Version 24, 27 June 2013===<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|''N/A''<br />
|-<br />
|'''Definition'''<br />
| A variable with the standard name of sensor_band_identifier contains strings which give the alphanumeric identifier of a sensor band. These strings have not yet been standardised.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| sensor_band_central_radiation_wavelength is the central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| sensor_band_central_radiation_wavenumber is the central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_frequency<br />
|-<br />
|'''Canonical units'''<br />
| s-1<br />
|-<br />
|'''Definition'''<br />
| sensor_band_central_radiation_frequency is the central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|sensor_zenith_angle is the angle between the line of sight to the sensor and the local zenith at the observation target. This angle is measured starting from directly overhead and its range is from zero (directly overhead the observation target) to 180 degrees (directly below the observation target). Local zenith is a line perpendicular to the Earth's surface at a given location. "Observation target" means a location on the Earth defined by the sensor performing the observations. A standard name also exists for platform_zenith_angle, where "platform" refers to the vehicle from which observations are made e.g. aeroplane, ship, or satellite. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated zenith angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_view_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Sensor view angle is the angle between the line of sight from the sensor and the direction straight vertically down. Zero view angle means looking directly beneath the sensor. There is no standardized sign convention for sensor_view_angle. A standard name also exists for platform_view_angle, where "platform" refers to the vehicle from which observations are made e.g. aeroplane, ship, or satellite. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated view angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|sensor_azimuth_angle is the horizontal angle between the line of sight from the observation point to the sensor and a reference direction at the observation point, which is often due north. The angle is measured clockwise positive, starting from the reference direction. A comment attribute should be added to a data variable with this standard name to specify the reference direction. A standard name also exists for platform_azimuth_angle, where "platform" refers to the vehicle from which observations are made e.g. aeroplane, ship, or satellite. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated azimuth angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_view_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Standard names for platform describe the motion and orientation of the vehicle from which observations are made e.g. aeroplane, ship or satellite. Platform view angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero view angle means looking directly beneath the platform. There is no standardized sign convention for platform_view_angle. A standard name also exists for sensor_view_angle. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated view angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Standard names for platform describe the motion and orientation of the vehicle from which observations are made e.g. aeroplane, ship or satellite. Platform azimuth angle is the horizontal angle between the line of sight from the observation point to the platform and a reference direction at the observation point, which is often due north. The angle is measured clockwise positive, starting from the reference direction. A comment attribute should be added to a data variable with the standard name platform_azimuth_angle to specify the reference direction. A standard name also exists for sensor_azimuth_angle. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated azimuth angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Standard names for platform describe the motion and orientation of the vehicle from which observations are made e.g. aeroplane, ship or satellite. relative_platform_azimuth_angle is the difference between the viewing geometries from two different platforms over the same observation target. It is the difference between the values of two quantities with standard name platform_azimuth_angle. There is no standardized sign convention for relative_platform_azimuth_angle. "Observation target" means a location on the Earth defined by the sensor performing the observations. A standard name also exists for relative_sensor_azimuth_angle. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated azimuth angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|relative_sensor_azimuth_angle is the difference between the viewing geometries from two different sensors over the same observation target. It is the difference between the values of two quantities with standard name sensor_azimuth_angle. There is no standardized sign convention for relative_sensor_azimuth_angle. "Observation target" means a location on the Earth defined by the sensor performing the observations. A standard name also exists for relative_platform_azimuth_angle, where "platform" refers to the vehicle from which observations are made e.g. aeroplane, ship, or satellite. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated azimuth angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 m-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|time_sample_difference_due_to_collocation is the difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target is an average of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation target. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target is the standard deviation of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation target. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene is an average of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation scene. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation scene" is a grouping of a sensor's adjacent field-of-views centered on a collocation target. The size of the collocation scene is typically about twice that of the collocation target. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene is the standard deviation of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation scene. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation scene" is a grouping of a sensor's adjacent field-of-views centered on a collocation target. The size of the collocation scene is typically about twice that of the collocation target. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. The brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, wavenumber, or frequency. The standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The toa radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant toa spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|toa_brightness_temperature_bias_at_standard_scene_due_to_intercalibration is the difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. The standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, wavenumber, or frequency. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature. The specification of a physical process by the phrase "due_to_" process means that the quantity named is a single term in a sum of terms which together compose the general quantity named by omitting the phrase.<br />
|}<br />
<br />
==Template for Standard Name Proposals==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
==Proposed Names==<br />
<br />
===Proposal #1===<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
===Proposal #2===<br />
<br />
<br />
<br />
<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
<!--<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
--><br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44471NetCDF-CF File Examples for Satellite Swath Data2013-07-10T15:48:25Z<p>Ajelenak: Removed coordinate variables from the coordinates attribute</p>
<hr />
<div>[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]<br />
[[Category:Climate Forecast Conventions]]<br />
__FORCETOC__<br />
<br />
==GHRSST Level 2 Data==<br />
''Contributor: Ed Armstrong (NASA JPL)''<br />
<br />
The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
<br />
==Templates for Multiband Imagery (Level 1) Data==<br />
''Contributor: Aleksandar Jelenak (NOAA Center for Satellite Applications and Research)''<br />
<br />
These templates can be used for storing satellite swath multiband (a.k.a. Level 1) geolocated and calibrated data. The templates have been inspired by a [http://mailman.cgd.ucar.edu/pipermail/cf-metadata/2013/056398.html discussion] on the CF metadata mailing list and the resulting CF trac [https://cf-pcmdi.llnl.gov/trac/ticket/100 ticket] to allow non-spatiotemporal coordinates.<br />
<br />
The following two templates differ in the type of variable, named <tt>band</tt> in both, that serves as the spectral coordinate. The first template uses a numerical coordinate variable whereas the second a string-valued auxiliary coordinate variable. The first template is applicable to data acquired by optical imagers. The second template is aimed at data from microwave instruments where several bands can only differ in the polarization of electromagnetic radiation measured and thus a numerical spectral coordinate would not be able to differentiate between them. Only the variable attributes that support the concept are included in the templates.<br />
<br />
Template with numerical spectral coordinate variable:<br />
<br />
dimensions:<br />
'''time''' = ''<integer>'' ; // option: time = UNLIMITED<br />
'''swath''' = ''<integer>'' ;<br />
'''band''' = ''<integer>'' ;<br />
<br />
variables:<br />
// spectral coordinate variable<br />
'''float band(band) ;'''<br />
band:standard_name = “'''sensor_band_central_radiation_wavelength'''” ;<br />
band:units = “um” ;<br />
<br />
float lat('''time''', '''swath''') ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon('''time''', '''swath''') ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(time) ;<br />
time:standard_name = "time" ;<br />
time:units = "''<units>'' since ''<datetime string>''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data('''time''', '''swath''', '''band''') ;<br />
'''swath_band_data:coordinates = "lon lat" ;'''<br />
<br />
Template with string spectral coordinate variable:<br />
<br />
dimensions:<br />
'''time''' = ''<integer>'' ; // option: time = UNLIMITED<br />
'''swath''' = ''<integer>'' ;<br />
'''band_enum''' = ''<integer>'' ;<br />
'''band_strlen''' = ''<integer>'' ;<br />
<br />
variables: <br />
// string-valued auxiliary coordinate variable<br />
'''char band(band_enum, band_strlen) ;'''<br />
band:standard_name = “'''sensor_band_identifier'''” ;<br />
<br />
float lat('''time''', '''swath''') ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon('''time''', '''swath''') ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(time) ;<br />
time:standard_name = "time" ;<br />
time:units = "''<units>'' since ''<datetime string>''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data('''time''', '''swath''', '''band_enum''') ;<br />
'''swath_band_data:coordinates = "lon lat band" ;'''</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=44443Standard Names For Satellite Observations2013-07-01T05:23:29Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Accepted Standard Names==<br />
<br />
Below are listed proposed standard names from this page that are now accepted in the official CF standard name table.<br />
<br />
===CF Standard Name Version 24, 27 June 2013===<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|''N/A''<br />
|-<br />
|'''Definition'''<br />
| A variable with the standard name of sensor_band_identifier contains strings which give the alphanumeric identifier of a sensor band. These strings have not yet been standardised.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| sensor_band_central_radiation_wavelength is the central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| sensor_band_central_radiation_wavenumber is the central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_frequency<br />
|-<br />
|'''Canonical units'''<br />
| s-1<br />
|-<br />
|'''Definition'''<br />
| sensor_band_central_radiation_frequency is the central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|sensor_zenith_angle is the angle between the line of sight to the sensor and the local zenith at the observation target. This angle is measured starting from directly overhead and its range is from zero (directly overhead the observation target) to 180 degrees (directly below the observation target). Local zenith is a line perpendicular to the Earth's surface at a given location. "Observation target" means a location on the Earth defined by the sensor performing the observations. A standard name also exists for platform_zenith_angle, where "platform" refers to the vehicle from which observations are made e.g. aeroplane, ship, or satellite. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated zenith angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_view_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Sensor view angle is the angle between the line of sight from the sensor and the direction straight vertically down. Zero view angle means looking directly beneath the sensor. There is no standardized sign convention for sensor_view_angle. A standard name also exists for platform_view_angle, where "platform" refers to the vehicle from which observations are made e.g. aeroplane, ship, or satellite. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated view angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|sensor_azimuth_angle is the horizontal angle between the line of sight from the observation point to the sensor and a reference direction at the observation point, which is often due north. The angle is measured clockwise positive, starting from the reference direction. A comment attribute should be added to a data variable with this standard name to specify the reference direction. A standard name also exists for platform_azimuth_angle, where "platform" refers to the vehicle from which observations are made e.g. aeroplane, ship, or satellite. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated azimuth angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_view_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Standard names for platform describe the motion and orientation of the vehicle from which observations are made e.g. aeroplane, ship or satellite. Platform view angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero view angle means looking directly beneath the platform. There is no standardized sign convention for platform_view_angle. A standard name also exists for sensor_view_angle. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated view angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Standard names for platform describe the motion and orientation of the vehicle from which observations are made e.g. aeroplane, ship or satellite. Platform azimuth angle is the horizontal angle between the line of sight from the observation point to the platform and a reference direction at the observation point, which is often due north. The angle is measured clockwise positive, starting from the reference direction. A comment attribute should be added to a data variable with the standard name platform_azimuth_angle to specify the reference direction. A standard name also exists for sensor_azimuth_angle. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated azimuth angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Standard names for platform describe the motion and orientation of the vehicle from which observations are made e.g. aeroplane, ship or satellite. relative_platform_azimuth_angle is the difference between the viewing geometries from two different platforms over the same observation target. It is the difference between the values of two quantities with standard name platform_azimuth_angle. There is no standardized sign convention for relative_platform_azimuth_angle. "Observation target" means a location on the Earth defined by the sensor performing the observations. A standard name also exists for relative_sensor_azimuth_angle. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated azimuth angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|relative_sensor_azimuth_angle is the difference between the viewing geometries from two different sensors over the same observation target. It is the difference between the values of two quantities with standard name sensor_azimuth_angle. There is no standardized sign convention for relative_sensor_azimuth_angle. "Observation target" means a location on the Earth defined by the sensor performing the observations. A standard name also exists for relative_platform_azimuth_angle, where "platform" refers to the vehicle from which observations are made e.g. aeroplane, ship, or satellite. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated azimuth angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 m-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|time_sample_difference_due_to_collocation is the difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target is an average of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation target. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target is the standard deviation of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation target. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene is an average of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation scene. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation scene" is a grouping of a sensor's adjacent field-of-views centered on a collocation target. The size of the collocation scene is typically about twice that of the collocation target. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene is the standard deviation of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation scene. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation scene" is a grouping of a sensor's adjacent field-of-views centered on a collocation target. The size of the collocation scene is typically about twice that of the collocation target. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. The brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, wavenumber, or frequency. The standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The toa radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant toa spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|toa_brightness_temperature_bias_at_standard_scene_due_to_intercalibration is the difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. The standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, wavenumber, or frequency. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature. The specification of a physical process by the phrase "due_to_" process means that the quantity named is a single term in a sum of terms which together compose the general quantity named by omitting the phrase.<br />
|}<br />
<br />
==Template for Standard Name Proposals==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
==Proposed Names==<br />
<br />
===Proposal #1===<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
===Proposal #2===<br />
<br />
<br />
<br />
<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
<!--<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
--><br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=44442Standard Names For Satellite Observations2013-07-01T05:01:54Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Accepted Standard Names==<br />
<br />
Below are listed proposed standard names from this page that are now accepted in the official CF standard name table.<br />
<br />
===CF Standard Name Version 24, 27 June 2013===<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|''N/A''<br />
|-<br />
|'''Definition'''<br />
| A variable with the standard name of sensor_band_identifier contains strings which give the alphanumeric identifier of a sensor band. These strings have not yet been standardised.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| sensor_band_central_radiation_wavelength is the central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| sensor_band_central_radiation_wavenumber is the central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_frequency<br />
|-<br />
|'''Canonical units'''<br />
| s-1<br />
|-<br />
|'''Definition'''<br />
| sensor_band_central_radiation_frequency is the central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|sensor_zenith_angle is the angle between the line of sight to the sensor and the local zenith at the observation target. This angle is measured starting from directly overhead and its range is from zero (directly overhead the observation target) to 180 degrees (directly below the observation target). Local zenith is a line perpendicular to the Earth's surface at a given location. "Observation target" means a location on the Earth defined by the sensor performing the observations. A standard name also exists for platform_zenith_angle, where "platform" refers to the vehicle from which observations are made e.g. aeroplane, ship, or satellite. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated zenith angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_view_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Sensor view angle is the angle between the line of sight from the sensor and the direction straight vertically down. Zero view angle means looking directly beneath the sensor. There is no standardized sign convention for sensor_view_angle. A standard name also exists for platform_view_angle, where "platform" refers to the vehicle from which observations are made e.g. aeroplane, ship, or satellite. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated view angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|sensor_azimuth_angle is the horizontal angle between the line of sight from the observation point to the sensor and a reference direction at the observation point, which is often due north. The angle is measured clockwise positive, starting from the reference direction. A comment attribute should be added to a data variable with this standard name to specify the reference direction. A standard name also exists for platform_azimuth_angle, where "platform" refers to the vehicle from which observations are made e.g. aeroplane, ship, or satellite. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated azimuth angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_view_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Standard names for platform describe the motion and orientation of the vehicle from which observations are made e.g. aeroplane, ship or satellite. Platform view angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero view angle means looking directly beneath the platform. There is no standardized sign convention for platform_view_angle. A standard name also exists for sensor_view_angle. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated view angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Standard names for platform describe the motion and orientation of the vehicle from which observations are made e.g. aeroplane, ship or satellite. Platform azimuth angle is the horizontal angle between the line of sight from the observation point to the platform and a reference direction at the observation point, which is often due north. The angle is measured clockwise positive, starting from the reference direction. A comment attribute should be added to a data variable with the standard name platform_azimuth_angle to specify the reference direction. A standard name also exists for sensor_azimuth_angle. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated azimuth angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Standard names for platform describe the motion and orientation of the vehicle from which observations are made e.g. aeroplane, ship or satellite. relative_platform_azimuth_angle is the difference between the viewing geometries from two different platforms over the same observation target. It is the difference between the values of two quantities with standard name platform_azimuth_angle. There is no standardized sign convention for relative_platform_azimuth_angle. "Observation target" means a location on the Earth defined by the sensor performing the observations. A standard name also exists for relative_sensor_azimuth_angle. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated azimuth angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|relative_sensor_azimuth_angle is the difference between the viewing geometries from two different sensors over the same observation target. It is the difference between the values of two quantities with standard name sensor_azimuth_angle. There is no standardized sign convention for relative_sensor_azimuth_angle. "Observation target" means a location on the Earth defined by the sensor performing the observations. A standard name also exists for relative_platform_azimuth_angle, where "platform" refers to the vehicle from which observations are made e.g. aeroplane, ship, or satellite. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated azimuth angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 m-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|time_sample_difference_due_to_collocation is the difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target is an average of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation target. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target is the standard deviation of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation target. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene is an average of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation scene. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation scene" is a grouping of a sensor's adjacent field-of-views centered on a collocation target. The size of the collocation scene is typically about twice that of the collocation target. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene is the standard deviation of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation scene. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation scene" is a grouping of a sensor's adjacent field-of-views centered on a collocation target. The size of the collocation scene is typically about twice that of the collocation target. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
==Template for Standard Name Proposals==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
==Proposed Names==<br />
<br />
===Proposal #1===<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
===Proposal #2===<br />
<br />
<br />
<br />
<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=44441Standard Names For Satellite Observations2013-07-01T04:59:01Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Accepted Standard Names==<br />
<br />
Below are listed proposed standard names from this page that are now accepted in the official CF standard name table.<br />
<br />
===CF Standard Name Version 24, 27 June 2013===<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|''N/A''<br />
|-<br />
|'''Definition'''<br />
| A variable with the standard name of sensor_band_identifier contains strings which give the alphanumeric identifier of a sensor band. These strings have not yet been standardised.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| sensor_band_central_radiation_wavelength is the central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| sensor_band_central_radiation_wavenumber is the central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_frequency<br />
|-<br />
|'''Canonical units'''<br />
| s-1<br />
|-<br />
|'''Definition'''<br />
| sensor_band_central_radiation_frequency is the central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|sensor_zenith_angle is the angle between the line of sight to the sensor and the local zenith at the observation target. This angle is measured starting from directly overhead and its range is from zero (directly overhead the observation target) to 180 degrees (directly below the observation target). Local zenith is a line perpendicular to the Earth's surface at a given location. "Observation target" means a location on the Earth defined by the sensor performing the observations. A standard name also exists for platform_zenith_angle, where "platform" refers to the vehicle from which observations are made e.g. aeroplane, ship, or satellite. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated zenith angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_view_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Sensor view angle is the angle between the line of sight from the sensor and the direction straight vertically down. Zero view angle means looking directly beneath the sensor. There is no standardized sign convention for sensor_view_angle. A standard name also exists for platform_view_angle, where "platform" refers to the vehicle from which observations are made e.g. aeroplane, ship, or satellite. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated view angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|sensor_azimuth_angle is the horizontal angle between the line of sight from the observation point to the sensor and a reference direction at the observation point, which is often due north. The angle is measured clockwise positive, starting from the reference direction. A comment attribute should be added to a data variable with this standard name to specify the reference direction. A standard name also exists for platform_azimuth_angle, where "platform" refers to the vehicle from which observations are made e.g. aeroplane, ship, or satellite. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated azimuth angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|platform_view_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Standard names for platform describe the motion and orientation of the vehicle from which observations are made e.g. aeroplane, ship or satellite. Platform view angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero view angle means looking directly beneath the platform. There is no standardized sign convention for platform_view_angle. A standard name also exists for sensor_view_angle. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated view angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Standard names for platform describe the motion and orientation of the vehicle from which observations are made e.g. aeroplane, ship or satellite. Platform azimuth angle is the horizontal angle between the line of sight from the observation point to the platform and a reference direction at the observation point, which is often due north. The angle is measured clockwise positive, starting from the reference direction. A comment attribute should be added to a data variable with the standard name platform_azimuth_angle to specify the reference direction. A standard name also exists for sensor_azimuth_angle. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated azimuth angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Standard names for platform describe the motion and orientation of the vehicle from which observations are made e.g. aeroplane, ship or satellite. relative_platform_azimuth_angle is the difference between the viewing geometries from two different platforms over the same observation target. It is the difference between the values of two quantities with standard name platform_azimuth_angle. There is no standardized sign convention for relative_platform_azimuth_angle. "Observation target" means a location on the Earth defined by the sensor performing the observations. A standard name also exists for relative_sensor_azimuth_angle. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated azimuth angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|relative_sensor_azimuth_angle is the difference between the viewing geometries from two different sensors over the same observation target. It is the difference between the values of two quantities with standard name sensor_azimuth_angle. There is no standardized sign convention for relative_sensor_azimuth_angle. "Observation target" means a location on the Earth defined by the sensor performing the observations. A standard name also exists for relative_platform_azimuth_angle, where "platform" refers to the vehicle from which observations are made e.g. aeroplane, ship, or satellite. For some viewing geometries the sensor and the platform cannot be assumed to be close enough to neglect the difference in calculated azimuth angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 m-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|time_sample_difference_due_to_collocation is the difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target is an average of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation target. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target is the standard deviation of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation target. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene is an average of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation scene. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation scene" is a grouping of a sensor's adjacent field-of-views centered on a collocation target. The size of the collocation scene is typically about twice that of the collocation target. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene is the standard deviation of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation scene. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation scene" is a grouping of a sensor's adjacent field-of-views centered on a collocation target. The size of the collocation scene is typically about twice that of the collocation target. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
==Template for Standard Name Proposals==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
==Proposed Names==<br />
<br />
===Proposal #1===<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
===Proposal #2===<br />
<br />
<br />
<br />
<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=44440Standard Names For Satellite Observations2013-07-01T03:31:38Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Accepted Standard Names==<br />
<br />
Below are listed proposed standard names from this page that are now accepted in the official CF standard name table.<br />
<br />
===CF Standard Name Version 24, 27 June 2013===<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|''N/A''<br />
|-<br />
|'''Definition'''<br />
| A variable with the standard name of sensor_band_identifier contains strings which give the alphanumeric identifier of a sensor band. These strings have not yet been standardised.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| sensor_band_central_radiation_wavelength is the central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| sensor_band_central_radiation_wavenumber is the central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_frequency<br />
|-<br />
|'''Canonical units'''<br />
| s-1<br />
|-<br />
|'''Definition'''<br />
| sensor_band_central_radiation_frequency is the central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|time_sample_difference_due_to_collocation is the difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target is an average of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation target. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target is the standard deviation of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation target. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene is an average of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation scene. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation scene" is a grouping of a sensor's adjacent field-of-views centered on a collocation target. The size of the collocation scene is typically about twice that of the collocation target. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|W m-2 sr-1 (m-1)-1<br />
|-<br />
|'''Definition'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene is the standard deviation of observations of the quantity with standard name toa_outgoing_radiance_per_unit_wavenumber from a sensor's adjacent field-of-views within a collocation scene. "toa" means top of atmosphere. The TOA outgoing radiance is the upwelling radiance, i.e., toward outer space. Radiance is the radiative flux in a particular direction, per unit of solid angle. In accordance with common usage in geophysical disciplines, "flux" implies per unit area, called "flux density" in physics. The "collocation scene" is a grouping of a sensor's adjacent field-of-views centered on a collocation target. The size of the collocation scene is typically about twice that of the collocation target. The "collocation target" is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field-of-view footprint. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
==Template for Standard Name Proposals==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
==Proposed Names==<br />
<br />
===Proposal #1===<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
===Proposal #2===<br />
<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith at the observation target; a value of zero is directly overhead the observation target. Local zenith is a line perpendicular to the Earth’s surface at a given location. Observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 um-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44431NetCDF-CF File Examples for Satellite Swath Data2013-06-25T01:49:23Z<p>Ajelenak: </p>
<hr />
<div>[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]<br />
[[Category:Climate Forecast Conventions]]<br />
__FORCETOC__<br />
<br />
==GHRSST Level 2 Data==<br />
''Contributor: Ed Armstrong (NASA JPL)''<br />
<br />
The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
<br />
==Templates for Multiband Imagery (Level 1) Data==<br />
''Contributor: Aleksandar Jelenak (NOAA Center for Satellite Applications and Research)''<br />
<br />
These templates can be used for storing satellite swath multiband (a.k.a. Level 1) geolocated and calibrated data. The templates have been inspired by a [http://mailman.cgd.ucar.edu/pipermail/cf-metadata/2013/056398.html discussion] on the CF metadata mailing list and the resulting CF trac [https://cf-pcmdi.llnl.gov/trac/ticket/100 ticket] to allow non-spatiotemporal coordinates.<br />
<br />
The following two templates differ in the type of variable, named <tt>band</tt> in both, that serves as the spectral coordinate. The first template uses a numerical coordinate variable whereas the second a string-valued auxiliary coordinate variable. The first template is applicable to data acquired by optical imagers. The second template is aimed at data from microwave instruments where several bands can only differ in the polarization of electromagnetic radiation measured and thus a numerical spectral coordinate would not be able to differentiate between them. Only the variable attributes that support the concept are included in the templates.<br />
<br />
Template with numerical spectral coordinate variable:<br />
<br />
dimensions:<br />
'''time''' = ''<integer>'' ; // option: time = UNLIMITED<br />
'''swath''' = ''<integer>'' ;<br />
'''band''' = ''<integer>'' ;<br />
<br />
variables:<br />
// spectral coordinate variable<br />
'''float band(band) ;'''<br />
band:standard_name = “'''sensor_band_central_radiation_wavelength'''” ;<br />
band:units = “um” ;<br />
<br />
float lat('''time''', '''swath''') ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon('''time''', '''swath''') ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(time) ;<br />
time:standard_name = "time" ;<br />
time:units = "''<units>'' since ''<datetime string>''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data('''time''', '''swath''', '''band''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''<br />
<br />
Template with string spectral coordinate variable:<br />
<br />
dimensions:<br />
'''time''' = ''<integer>'' ; // option: time = UNLIMITED<br />
'''swath''' = ''<integer>'' ;<br />
'''band_enum''' = ''<integer>'' ;<br />
'''band_strlen''' = ''<integer>'' ;<br />
<br />
variables: <br />
// string-valued auxiliary coordinate variable<br />
'''char band(band_enum, band_strlen) ;'''<br />
band:standard_name = “'''sensor_band_identifier'''” ;<br />
<br />
float lat('''time''', '''swath''') ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon('''time''', '''swath''') ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(time) ;<br />
time:standard_name = "time" ;<br />
time:units = "''<units>'' since ''<datetime string>''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data('''time''', '''swath''', '''band_enum''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44430NetCDF-CF File Examples for Satellite Swath Data2013-06-25T01:44:18Z<p>Ajelenak: </p>
<hr />
<div>[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]<br />
[[Category:Climate Forecast Conventions]]<br />
__FORCETOC__<br />
<br />
==GHRSST Level 2 Data==<br />
''Contributor: Ed Armstrong (NASA JPL)''<br />
<br />
The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
<br />
==Templates for Multiband Imagery (Level 1) Data==<br />
''Contributor: Aleksandar Jelenak (NOAA Center for Satellite Applications and Research)''<br />
<br />
These templates can be used for storing satellite swath multiband (a.k.a. Level 1) geolocated and calibrated data. The templates have been inspired by a [http://mailman.cgd.ucar.edu/pipermail/cf-metadata/2013/056398.html discussion] on the CF metadata mailing list and the resulting CF trac [https://cf-pcmdi.llnl.gov/trac/ticket/100 ticket] to allow non-spatiotemporal coordinates.<br />
<br />
The following two templates differ in the type of variable, named <tt>band</tt> in both, that serves as the spectral coordinate. The first template uses a numerical coordinate variable whereas the second a string-valued auxiliary coordinate variable. The first template is applicable to data acquired by optical imagers. The second template is aimed at data from microwave instruments where several bands can only differ in the polarization of electromagnetic radiation measured and thus a numerical spectral coordinate would not be able to differentiate between them. Only the variable attributes that support the concept are included in the templates.<br />
<br />
Template with numerical spectral coordinate variable:<br />
<br />
dimensions:<br />
'''time''' = ''<integer>'' ; // option: time = UNLIMITED<br />
'''swath''' = ''<integer>'' ;<br />
'''band''' = ''<integer>'' ;<br />
<br />
variables:<br />
// spectral coordinate variable<br />
'''float band(band) ;'''<br />
band:standard_name = “'''sensor_band_central_radiation_wavelength'''” ;<br />
band:units = “um” ;<br />
<br />
float lat('''time''', '''swath''') ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon('''time''', '''swath''') ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(time) ;<br />
time:standard_name = "time" ;<br />
time:units = "''<units>'' since ''<datetime string>''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data('''time''', '''swath''', '''band''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''<br />
<br />
Template with string spectral coordinate variable<br />
<br />
dimensions:<br />
'''time''' = ''<integer>'' ; // option: time = UNLIMITED<br />
'''swath''' = ''<integer>'' ;<br />
'''band_enum''' = ''<integer>'' ;<br />
'''band_strlen''' = ''<integer>'' ;<br />
<br />
variables: <br />
// string-valued auxiliary coordinate variable<br />
'''char band(band_enum, band_strlen) ;'''<br />
band:standard_name = “'''sensor_band_identifier'''” ;<br />
<br />
float lat('''time''', '''swath''') ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon('''time''', '''swath''') ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(time) ;<br />
time:standard_name = "time" ;<br />
time:units = "''<units>'' since ''<datetime string>''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data('''time''', '''swath''', '''band_enum''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44429NetCDF-CF File Examples for Satellite Swath Data2013-06-25T01:42:30Z<p>Ajelenak: </p>
<hr />
<div>[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]<br />
[[Category:Climate Forecast Conventions]]<br />
<br />
==GHRSST Level 2 Data==<br />
''Contributor: Ed Armstrong (NASA JPL)''<br />
<br />
The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
<br />
==Templates for Multiband Imagery (Level 1) Data==<br />
''Contributor: Aleksandar Jelenak (NOAA Center for Satellite Applications and Research)''<br />
<br />
These templates can be used for storing satellite swath multiband (a.k.a. Level 1) geolocated and calibrated data. The templates have been inspired by a [http://mailman.cgd.ucar.edu/pipermail/cf-metadata/2013/056398.html discussion] on the CF metadata mailing list and the resulting CF trac [https://cf-pcmdi.llnl.gov/trac/ticket/100 ticket] to allow non-spatiotemporal coordinates.<br />
<br />
The following two templates differ in the type of variable, named <tt>band</tt> in both, that serves as the spectral coordinate. The first template uses a numerical coordinate variable whereas the second a string-valued auxiliary coordinate variable. The first template is applicable to data acquired by optical imagers. The second template is aimed at data from microwave instruments where several bands can only differ in the polarization of electromagnetic radiation measured and thus a numerical spectral coordinate would not be able to differentiate between them. Only the variable attributes that support the concept are included in the templates.<br />
<br />
Template with numerical spectral coordinate variable:<br />
<br />
dimensions:<br />
'''time''' = ''<integer>'' ; // option: time = UNLIMITED<br />
'''swath''' = ''<integer>'' ;<br />
'''band''' = ''<integer>'' ;<br />
<br />
variables:<br />
// spectral coordinate variable<br />
'''float band(band) ;'''<br />
band:standard_name = “'''sensor_band_central_radiation_wavelength'''” ;<br />
band:units = “um” ;<br />
<br />
float lat('''time''', '''swath''') ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon('''time''', '''swath''') ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(time) ;<br />
time:standard_name = "time" ;<br />
time:units = "''<units>'' since ''<datetime string>''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data('''time''', '''swath''', '''band''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''<br />
<br />
Template with string spectral coordinate variable<br />
<br />
dimensions:<br />
'''time''' = ''<integer>'' ; // option: time = UNLIMITED<br />
'''swath''' = ''<integer>'' ;<br />
'''band_enum''' = ''<integer>'' ;<br />
'''band_strlen''' = ''<integer>'' ;<br />
<br />
variables: <br />
// string-valued auxiliary coordinate variable<br />
'''char band(band_enum, band_strlen) ;'''<br />
band:standard_name = “'''sensor_band_identifier'''” ;<br />
<br />
float lat('''time''', '''swath''') ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon('''time''', '''swath''') ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(time) ;<br />
time:standard_name = "time" ;<br />
time:units = "''<units>'' since ''<datetime string>''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data('''time''', '''swath''', '''band_enum''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44405NetCDF-CF File Examples for Satellite Swath Data2013-06-17T13:27:22Z<p>Ajelenak: </p>
<hr />
<div>[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]<br />
[[Category:Climate Forecast Conventions]]<br />
<br />
==GHRSST Level 2 Data==<br />
''Contributor: Ed Armstrong (NASA JPL)''<br />
<br />
The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
<br />
==Templates for Multiband Imagery (Level 1) Data==<br />
''Contributor: Aleksandar Jelenak (NOAA Center for Satellite Applications and Research)''<br />
<br />
These templates can be used for storing satellite swath multiband (a.k.a. Level 1) geolocated and calibrated data. The templates have been inspired by a [http://mailman.cgd.ucar.edu/pipermail/cf-metadata/2013/056398.html discussion] on the CF metadata mailing list and the resulting CF trac [https://cf-pcmdi.llnl.gov/trac/ticket/100 ticket] to allow non-spatiotemporal coordinates.<br />
<br />
The following two templates differ in the type of variable, named <tt>band</tt> in both, that serves as the spectral coordinate. The first template uses a numerical coordinate variable whereas the second a string-valued auxiliary coordinate variable. The first template is applicable to data acquired by optical imagers. The second template is aimed at data from microwave instruments where several bands can only differ in the polarization of electromagnetic radiation measured and thus a numerical spectral coordinate would not be able to differentiate between them.<br />
<br />
Only the variable attributes that support the concept are included in the templates.<br />
<br />
===Template with Numerical Spectral Coordinate Variable===<br />
<br />
dimensions:<br />
'''time''' = ''<integer>'' ; // option: time = UNLIMITED<br />
'''swath''' = ''<integer>'' ;<br />
'''band''' = ''<integer>'' ;<br />
<br />
variables:<br />
// spectral coordinate variable<br />
'''float band(band) ;'''<br />
band:standard_name = “'''sensor_band_central_radiation_wavelength'''” ;<br />
band:units = “um” ;<br />
<br />
float lat('''time''', '''swath''') ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon('''time''', '''swath''') ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(time) ;<br />
time:standard_name = "time" ;<br />
time:units = "''<units>'' since ''<datetime string>''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data('''time''', '''swath''', '''band''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''<br />
<br />
===Template with String Spectral Coordinate Variable===<br />
<br />
dimensions:<br />
'''time''' = ''<integer>'' ; // option: time = UNLIMITED<br />
'''swath''' = ''<integer>'' ;<br />
'''band_enum''' = ''<integer>'' ;<br />
'''band_strlen''' = ''<integer>'' ;<br />
<br />
variables: <br />
// string-valued auxiliary coordinate variable<br />
'''char band(band_enum, band_strlen) ;'''<br />
band:standard_name = “'''sensor_band_identifier'''” ;<br />
<br />
float lat('''time''', '''swath''') ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon('''time''', '''swath''') ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(time) ;<br />
time:standard_name = "time" ;<br />
time:units = "''<units>'' since ''<datetime string>''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data('''time''', '''swath''', '''band_enum''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44383NetCDF-CF File Examples for Satellite Swath Data2013-06-13T03:14:58Z<p>Ajelenak: More compact templates are now featured only</p>
<hr />
<div>[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]<br />
[[Category:Climate Forecast Conventions]]<br />
<br />
==GHRSST Level 2 Data==<br />
''Contributor: Ed Armstrong (NASA JPL)''<br />
<br />
The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
<br />
==Templates for Multiband Imagery (Level 1) Data==<br />
''Contributor: Aleksandar Jelenak (NOAA Center for Satellite Applications and Research)''<br />
<br />
These templates can be used for storing satellite swath multiband (a.k.a. Level 1) geolocated and calibrated data. The templates have been inspired by a [http://mailman.cgd.ucar.edu/pipermail/cf-metadata/2013/056398.html discussion] on the CF metadata mailing list and the resulting CF trac [https://cf-pcmdi.llnl.gov/trac/ticket/100 ticket] to allow non-spatiotemporal coordinates.<br />
<br />
The following two templates differ in the type of variable, named <tt>band</tt> in both, that serves as the spectral coordinate. The first template uses a numerical coordinate variable whereas the second a string-valued auxiliary coordinate variable. The first template is applicable to data acquired by optical imagers. The second template is aimed at data from microwave instruments where several bands can only differ in the polarization of electromagnetic radiation measured and thus a numerical spectral coordinate would not be able to differentiate between them.<br />
<br />
Only the variable attributes that support the concept are included in the templates.<br />
<br />
===Template with Numerical Spectral Coordinate Variable===<br />
<br />
dimensions:<br />
'''time''' = ''<integer>'' ; // option: time = UNLIMITED<br />
'''swath''' = ''<integer>'' ;<br />
'''band''' = ''<integer>'' ;<br />
<br />
variables:<br />
// spectral coordinate variable<br />
'''float band(band) ;'''<br />
band:standard_name = “'''sensor_band_central_radiation_wavelength'''” ;<br />
band:units = “um” ;<br />
<br />
float lat('''time''', '''swath''') ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon('''time''', '''swath''') ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(time) ;<br />
time:standard_name = "time" ;<br />
time:units = "''<units>'' since ''<datetime string>''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data('''time''', '''swath''', '''band''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''<br />
<br />
===Template with String Spectral Coordinate Variable===<br />
<br />
dimensions:<br />
'''time''' = ''<integer>'' ; // option: time = UNLIMITED<br />
'''swath''' = ''<integer>'' ;<br />
'''band_enum''' = ''<integer>'' ;<br />
'''band_strlen''' = ''<integer>'' ;<br />
<br />
variables:<br />
'''short band_enum(band_enum) ;'''<br />
<br />
// string-valued auxiliary coordinate variable<br />
'''char band(band_enum, band_strlen) ;'''<br />
band:standard_name = “'''sensor_band_identifier'''” ;<br />
<br />
float lat('''time''', '''swath''') ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon('''time''', '''swath''') ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(time) ;<br />
time:standard_name = "time" ;<br />
time:units = "''<units>'' since ''<datetime string>''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data('''time''', '''swath''', '''band_enum''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Documenting_People_and_Organizations&diff=44296Documenting People and Organizations2013-05-30T02:23:29Z<p>Ajelenak: </p>
<hr />
<div>Many documentation dialects include mechanisms for connecting people and organizations to metadata records. There are two general approaches to these connections. The first involves including the roles of the people in the names of the metadata element's. For example, the [[Attribute Convention for Data Discovery (ACDD)|NetCDF Attribute Convention for Data Discovery]] includes fields titled creator_name, creator_email, and creator_url. This approach makes it difficult to standardize because new standard elements must be added in order to add a new role, i.e. processor_name, processor_email, processor_URL.<br />
<br />
The second approach centers around a generic description of a person or an organization that includes an attribute that gives the role they play with respect to the resource being documented. This approach allows additions by extending the list of roles. See [[NetCDF,_HDF,_and_ISO_Metadata|NetCDF, HDF, and ISO Metadata]] for more details on this approach.<br />
<br />
==People==<br />
Connecting people to resources is an important role of metadata. In addition, it is critical to describe people's role with respect to the resource. In ISO, most objects that include associated people or organizations can have multiple associations and the roles are described in a codeList. This means that, for example, a citation can have people identified in any or all of the roles listed in the CI_RoleCode object. These roles are:<br />
<br />
'''CI_RoleCode'''<br />
<table cellpadding="2"><br />
<tr><br />
<td>ISO 19115</td><td>Added in ISO 19115-1</td></tr><br />
<tr><br />
<td valign="top"><br />
+ resourceProvider<br><br />
+ custodian<br><br />
+ owner<br><br />
+ user<br><br />
+ distributor<br><br />
+ originator<br><br />
+ pointOfContact<br><br />
+ principalInvestigator<br><br />
+ processor<br><br />
+ publisher<br><br />
+ author<br><br />
</td><br />
<td valign="top"><br />
+ sponsor<br><br />
+ coAuthor<br><br />
+ collaborator<br><br />
+ editor<br><br />
+ mediator<br><br />
+ rightsHolder<br><br />
+ contributor<br><br />
+ funder<br><br />
+ stakeholder<br><br />
</td><br />
</tr><br />
</table><br />
<br />
==Crosswalks==<br />
<table width="95%" border="1" cellpadding="3" cellspacing="3" style="border-collapse: collapse;"><br />
<tr><br />
<th>Concept</th><br />
<th>Description</th><br />
<th>Paths</th><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Role</td><br />
<td style="word-break:break-all;">function performed by the responsible party</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Role<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:Role<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:role/gmd:CI_RoleCode<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Position Name</td><br />
<td style="word-break:break-all;">Name of the job or position in an organization</td><br />
<td style="word-break:break-all;"><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:ContactPersons/echo:ContactPerson/echo:JobPosition<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:positionName/gco:CharacterString<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">First Name</td><br />
<td style="word-break:break-all;">First name of the individual</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:First_Name<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:ContactPersons/echo:ContactPerson/echo:FirstName<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:IndividualName<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Middle Name</td><br />
<td style="word-break:break-all;">Middle name of the individual</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Middle_Name<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:ContactPersons/echo:ContactPerson/echo:MiddleName<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:IndividualName<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Last Name</td><br />
<td style="word-break:break-all;">Last name of the individual</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Last_Name<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:ContactPersons/echo:ContactPerson/echo:LastName<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:IndividualName<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Email</td><br />
<td style="word-break:break-all;">Email address of the individual or organization</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Email<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationEmails/echo:Email<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:electronicMailAddress/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:ElectronicMailAddress<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Hours of Service</td><br />
<td style="word-break:break-all;">Time period (including time zone) when individuals can contact the organisation or<br />
individual<br />
</td><br />
<td style="word-break:break-all;"><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:HoursOfService<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:hoursOfService/gco:CharacterString<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Contact Instructions</td><br />
<td style="word-break:break-all;">Supplemental instructions on how or when to contact the individual or organisation</td><br />
<td style="word-break:break-all;"><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:Instructions<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:contactInstructions/gco:CharacterString<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Phone</td><br />
<td style="word-break:break-all;">Telephone numbers at which the organisation or individual may be contacted</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Phone<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationPhones/echo:Phone[echo:type='voice]'/echo:Number<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:phone/gmd:CI_Telephone/gmd:voice/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Phone/ows:Voice<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Fax</td><br />
<td style="word-break:break-all;">Telephone numbers at which the organisation or individual may be contacted via facsimile<br />
(fax)<br />
</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Fax<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationPhones/echo:Phone[echo:type='fax]'/echo:Number<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:phone/gmd:CI_Telephone/gmd:facsimile/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Phone/ows:Facsimile<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Address</td><br />
<td style="word-break:break-all;">Address line for the location</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Contact_Address/dif:Address<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationAddresses/echo:Address/echo:StreetAddress<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:deliveryPoint/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:DeliveryPoint<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">City</td><br />
<td style="word-break:break-all;">City of the location</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Contact_Address/dif:City<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationAddresses/echo:Address/echo:City<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:city/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:City<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Province or State</td><br />
<td style="word-break:break-all;">Province, state, or other administrative area of the location</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Contact_Address/dif:Province_or_State<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationAddresses/echo:Address/echo:StateProvince<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:administrativeArea/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:AdministrativeArea<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Postal_Code</td><br />
<td style="word-break:break-all;">Zip code or other postal code for the location</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Contact_Address/dif:Postal_Code<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationAddresses/echo:Address/echo:PostalCode<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:postalCode/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:PostalCode<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Country</td><br />
<td style="word-break:break-all;">Country of the location</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Contact_Address/dif:Country<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationAddresses/echo:Address/echo:Country<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:coountry/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:Country<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Web Page</td><br />
<td style="word-break:break-all;">On-line information that can be used to contact the individual or organisation</td><br />
<td style="word-break:break-all;"><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:onlineResource/gmd:CI_OnlineResource<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ProviderSite/@xlink:href<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Organization Name</td><br />
<td style="word-break:break-all;">Name of the organization</td><br />
<td style="word-break:break-all;"><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationName<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:organisationName/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ProviderName<br></td><br />
</tr><br />
</table><br />
''xPath Note:'' The xPaths included in this table use several wildcards. // means<br />
any path, so //gmd:CI_ResponsibleParty indicates a gmd:CI_ResponsibleParty anywhere<br />
in an XML file. /*/ indicates a single level with several possible elements. This<br />
usually indicates one of several concrete realizations of an abstract object. For<br />
example /*/gmd:identificationInfo could be gmd:MD_Metadata/gmd:identificationInfo<br />
or gmi:MI_Metadata/gmd:identificationInfo and gmd:identificationInfo//*/gmd:descriptiveKeywords<br />
could be gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords<br />
or gmd:identificationInfo/srv:SV_ServiceIdentification/gmd:descriptiveKeywords.<br />
[[Category:Documentation Connections]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Documenting_People_and_Organizations&diff=44295Documenting People and Organizations2013-05-30T02:23:02Z<p>Ajelenak: </p>
<hr />
<div>Many documentation dialects include mechanisms for connecting people and organizations to metadata records. There are two general approaches to these connections. The first involves including the roles of the people in the names of the metadata element`s. For example, the [[Attribute Convention for Data Discovery (ACDD)|NetCDF Attribute Convention for Data Discovery]] includes fields titled creator_name, creator_email, and creator_url. This approach makes it difficult to standardize because new standard elements must be added in order to add a new role, i.e. processor_name, processor_email, processor_URL.<br />
<br />
The second approach centers around a generic description of a person or an organization that includes an attribute that gives the role they play with respect to the resource being documented. This approach allows additions by extending the list of roles. See [[NetCDF,_HDF,_and_ISO_Metadata|NetCDF, HDF, and ISO Metadata]] for more details on this approach.<br />
<br />
==People==<br />
Connecting people to resources is an important role of metadata. In addition, it is critical to describe people's role with respect to the resource. In ISO, most objects that include associated people or organizations can have multiple associations and the roles are described in a codeList. This means that, for example, a citation can have people identified in any or all of the roles listed in the CI_RoleCode object. These roles are:<br />
<br />
'''CI_RoleCode'''<br />
<table cellpadding="2"><br />
<tr><br />
<td>ISO 19115</td><td>Added in ISO 19115-1</td></tr><br />
<tr><br />
<td valign="top"><br />
+ resourceProvider<br><br />
+ custodian<br><br />
+ owner<br><br />
+ user<br><br />
+ distributor<br><br />
+ originator<br><br />
+ pointOfContact<br><br />
+ principalInvestigator<br><br />
+ processor<br><br />
+ publisher<br><br />
+ author<br><br />
</td><br />
<td valign="top"><br />
+ sponsor<br><br />
+ coAuthor<br><br />
+ collaborator<br><br />
+ editor<br><br />
+ mediator<br><br />
+ rightsHolder<br><br />
+ contributor<br><br />
+ funder<br><br />
+ stakeholder<br><br />
</td><br />
</tr><br />
</table><br />
<br />
==Crosswalks==<br />
<table width="95%" border="1" cellpadding="3" cellspacing="3" style="border-collapse: collapse;"><br />
<tr><br />
<th>Concept</th><br />
<th>Description</th><br />
<th>Paths</th><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Role</td><br />
<td style="word-break:break-all;">function performed by the responsible party</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Role<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:Role<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:role/gmd:CI_RoleCode<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Position Name</td><br />
<td style="word-break:break-all;">Name of the job or position in an organization</td><br />
<td style="word-break:break-all;"><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:ContactPersons/echo:ContactPerson/echo:JobPosition<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:positionName/gco:CharacterString<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">First Name</td><br />
<td style="word-break:break-all;">First name of the individual</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:First_Name<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:ContactPersons/echo:ContactPerson/echo:FirstName<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:IndividualName<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Middle Name</td><br />
<td style="word-break:break-all;">Middle name of the individual</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Middle_Name<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:ContactPersons/echo:ContactPerson/echo:MiddleName<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:IndividualName<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Last Name</td><br />
<td style="word-break:break-all;">Last name of the individual</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Last_Name<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:ContactPersons/echo:ContactPerson/echo:LastName<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:individualName/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:IndividualName<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Email</td><br />
<td style="word-break:break-all;">Email address of the individual or organization</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Email<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationEmails/echo:Email<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:electronicMailAddress/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:ElectronicMailAddress<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Hours of Service</td><br />
<td style="word-break:break-all;">Time period (including time zone) when individuals can contact the organisation or<br />
individual<br />
</td><br />
<td style="word-break:break-all;"><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:HoursOfService<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:hoursOfService/gco:CharacterString<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Contact Instructions</td><br />
<td style="word-break:break-all;">Supplemental instructions on how or when to contact the individual or organisation</td><br />
<td style="word-break:break-all;"><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:Instructions<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:contactInstructions/gco:CharacterString<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Phone</td><br />
<td style="word-break:break-all;">Telephone numbers at which the organisation or individual may be contacted</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Phone<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationPhones/echo:Phone[echo:type='voice]'/echo:Number<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:phone/gmd:CI_Telephone/gmd:voice/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Phone/ows:Voice<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Fax</td><br />
<td style="word-break:break-all;">Telephone numbers at which the organisation or individual may be contacted via facsimile<br />
(fax)<br />
</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Fax<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationPhones/echo:Phone[echo:type='fax]'/echo:Number<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:phone/gmd:CI_Telephone/gmd:facsimile/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Phone/ows:Facsimile<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Address</td><br />
<td style="word-break:break-all;">Address line for the location</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Contact_Address/dif:Address<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationAddresses/echo:Address/echo:StreetAddress<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:deliveryPoint/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:DeliveryPoint<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">City</td><br />
<td style="word-break:break-all;">City of the location</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Contact_Address/dif:City<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationAddresses/echo:Address/echo:City<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:city/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:City<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Province or State</td><br />
<td style="word-break:break-all;">Province, state, or other administrative area of the location</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Contact_Address/dif:Province_or_State<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationAddresses/echo:Address/echo:StateProvince<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:administrativeArea/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:AdministrativeArea<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Postal_Code</td><br />
<td style="word-break:break-all;">Zip code or other postal code for the location</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Contact_Address/dif:Postal_Code<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationAddresses/echo:Address/echo:PostalCode<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:postalCode/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:PostalCode<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Country</td><br />
<td style="word-break:break-all;">Country of the location</td><br />
<td style="word-break:break-all;"><b>DIF</b> /dif:DIF/dif:Personnel/dif:Contact_Address/dif:Country<br><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationAddresses/echo:Address/echo:Country<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:address/gmd:CI_Address/gmd:coountry/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ServiceContact/ows:ContactInfo/ows:Address/ows:Country<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Web Page</td><br />
<td style="word-break:break-all;">On-line information that can be used to contact the individual or organisation</td><br />
<td style="word-break:break-all;"><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:contactInfo/gmd:CI_Contact/gmd:onlineResource/gmd:CI_OnlineResource<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ProviderSite/@xlink:href<br></td><br />
</tr><br />
<tr><br />
<td style="word-break:break-all;">Organization Name</td><br />
<td style="word-break:break-all;">Name of the organization</td><br />
<td style="word-break:break-all;"><b>ECHO</b> /echo:Collection/echo:Contacts/echo:Contact/echo:OrganizationName<br><b>ISO</b> //gmd:CI_ResponsibleParty/gmd:organisationName/gco:CharacterString<br><b>OGC-SOS</b> /sos:Capabilities/ows:ServiceProvider/ows:ProviderName<br></td><br />
</tr><br />
</table><br />
''xPath Note:'' The xPaths included in this table use several wildcards. // means<br />
any path, so //gmd:CI_ResponsibleParty indicates a gmd:CI_ResponsibleParty anywhere<br />
in an XML file. /*/ indicates a single level with several possible elements. This<br />
usually indicates one of several concrete realizations of an abstract object. For<br />
example /*/gmd:identificationInfo could be gmd:MD_Metadata/gmd:identificationInfo<br />
or gmi:MI_Metadata/gmd:identificationInfo and gmd:identificationInfo//*/gmd:descriptiveKeywords<br />
could be gmd:identificationInfo/gmd:MD_DataIdentification/gmd:descriptiveKeywords<br />
or gmd:identificationInfo/srv:SV_ServiceIdentification/gmd:descriptiveKeywords.<br />
[[Category:Documentation Connections]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44292NetCDF-CF File Examples for Satellite Swath Data2013-05-30T02:11:11Z<p>Ajelenak: More compact template with string spectral coordinate</p>
<hr />
<div>[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]<br />
[[Category:Climate Forecast Conventions]]<br />
<br />
==GHRSST Level 2 Data==<br />
''(Contributed by: Ed Armstrong, NASA JPL)''<br />
<br />
The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
<br />
==Templates for Multiband Imagery (Level 1) Data==<br />
''(Contributed by: Aleksandar Jelenak, NOAA Center for Satellite Applications and Research)''<br />
<br />
These templates can be used for storing satellite swath multiband (a.k.a. Level 1 geolocated and calibrated) data. The templates seem to have been unofficially confirmed in a [http://mailman.cgd.ucar.edu/pipermail/cf-metadata/2013/056398.html discussion] on the CF metadata mailing list and have prompted a CF trac [https://cf-pcmdi.llnl.gov/trac/ticket/100 ticket] to modify the convention to allow non-spatiotemporal coordinates.<br />
<br />
The following two templates differ in the type of variable for the spectral coordinate. The name of that variable in both templates is <tt>band</tt>. The first template uses a numerical coordinate variable while the second a string-valued auxiliary coordinate variable. The first template is applicable to data acquired by optical imagers. The second template is aimed at data from microwave instruments where several channels can only differ in the polarization of electromagnetic radiation measured and thus a numerical spectral coordinate would not be able to differentiate between them.<br />
<br />
Only the variable attributes that support the concept are included in the templates.<br />
<br />
===Template with Numerical Spectral Coordinate Variable===<br />
<br />
dimensions:<br />
along_track = ''integer'' ; // option: along_track = UNLIMITED<br />
across_track = ''integer'' ;<br />
'''band''' = ''integer'' ;<br />
<br />
variables:<br />
short along_track(along_track) ;<br />
along_track:axis = "Y" ;<br />
<br />
short across_track(across_track) ;<br />
across_track:axis = "X" ;<br />
<br />
// '''spectral coordinate variable'''<br />
'''float band(band) ;'''<br />
band:standard_name = “'''sensor_band_central_radiation_wavelength'''” ; // new proposed name<br />
band:units = “um” ;<br />
<br />
float lat(along_track, across_track) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon(along_track, across_track) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(along_track) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data(along_track, across_track, '''band''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''<br />
<br />
===Template with String Spectral Coordinate Variable===<br />
<br />
dimensions:<br />
along_track = ''integer'' ; // option: along_track = UNLIMITED<br />
across_track = ''integer'' ;<br />
'''band_enum''' = ''integer'' ;<br />
'''band_strlen''' = ''integer'' ;<br />
<br />
variables:<br />
short along_track(along_track) ;<br />
along_track:axis = "Y" ;<br />
<br />
short across_track(across_track) ;<br />
across_track:axis = "X" ;<br />
<br />
'''short band_enum(band_enum) ;'''<br />
<br />
// '''string-valued auxiliary coordinate variable'''<br />
'''char band(band_enum, band_strlen) ;'''<br />
band:standard_name = “'''sensor_band_identifier'''” ; // proposed new name<br />
<br />
float lat(along_track, across_track) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon(along_track, across_track) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(along_track) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data(along_track, across_track, '''band_enum''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''<br />
<br />
=== More Compact Template Form ===<br />
<br />
The above templates can be simplified by replacing the <tt>along_track</tt> and <tt>across_track</tt> dimensions and variables with two dimensions: <tt>time</tt> and <tt>swath</tt>. The advantage of this approach is that it can support data aggregation along the time coordinate.<br />
<br />
First, the template with a numerical spectral coordinate:<br />
<br />
dimensions:<br />
'''time''' = ''integer'' ; // option: time = UNLIMITED<br />
'''swath''' = ''integer'' ;<br />
band = ''integer'' ;<br />
<br />
variables:<br />
float band(band) ;<br />
band:standard_name = “sensor_band_central_radiation_wavelength” ; // new proposed name<br />
band:units = “um” ;<br />
<br />
float lat('''time''', '''swath''') ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon('''time''', '''swath''') ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(time) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data('''time''', '''swath''', band) ;<br />
swath_band_data:coordinates = "lon lat time band" ;<br />
<br />
and below the template with a string spectral coordinate:<br />
<br />
dimensions:<br />
'''time''' = ''integer'' ; // option: time = UNLIMITED<br />
'''swath''' = ''integer'' ;<br />
band_enum = ''integer'' ;<br />
band_strlen = ''integer'' ;<br />
<br />
variables:<br />
'''char band(band_enum, band_strlen) ;'''<br />
band:standard_name = “sensor_band_identifier” ; // proposed new name<br />
<br />
float lat('''time''', '''swath''') ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon('''time''', '''swath''') ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(time) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data('''time''', '''swath''', band_enum) ;<br />
swath_band_data:coordinates = "lon lat time band" ;</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Category:Attribute_Conventions_Dataset_Discovery&diff=44261Category:Attribute Conventions Dataset Discovery2013-05-23T01:35:56Z<p>Ajelenak: /* Steering Committee */</p>
<hr />
<div><br />
=Background=<br />
This category on the ESIP wiki provides a landing page for information related to the Attribute Conventions for Dataset Discovery. These conventions identify and define a list of NetCDF global attributes recommended for describing a NetCDF dataset to discovery systems such as Digital Libraries. Software tools will use these attributes for extracting metadata from datasets, and exporting to Dublin Core, DIF, ADN, FGDC, ISO 19115 etc. metadata formats.<br />
<br />
=History =<br />
{| class="wikitable"<br />
|-<br />
! Version !! Description !! Date<br />
|-<br />
| [http://www.unidata.ucar.edu/software/netcdf-java/formats/DataDiscoveryAttConvention.html 1.0] || Original version published by Ethan Davis on the Unidata website. || 2005-09-28<br />
|-<br />
| [https://geo-ide.noaa.gov/wiki/index.php?title=NetCDF_Attribute_Convention_for_Dataset_Discovery 1.1] || The Unidata vocabulary was migrated to the NOAA Environmental Data Management wiki. The discussion and developments on that page focused on mapping the ACDD elements to corresponding ISO elements. These mappings became the basis for software tools to translate from netCDF to ISO19115/19115-2/19119 (e.g. [https://geo-ide.noaa.gov/wiki/index.php?title=NcISO ncISO] and [http://trac.osgeo.org/geonetwork/wiki/ISO19119impl Geonetwork]|| 2010-01-20<br />
|-<br />
| [[Attribute Convention for Data Discovery (ACDD) Working| 2.0 ''beta'' ]] || Migration of the NOAA EDM page to the ESIP wiki. || 2013-04-26 <br />
|-<br />
|}<br />
<br />
NOTE: Occasionally the acronym UDDC (Unidata Dataset Discovery Conventions) is used in the community to refer to the same convention. ACDD is preferred over UDDC going forward.<br />
<br />
Regardless of the numeric version, the current version is always found at [[Attribute Convention for Data Discovery (ACDD)]] and the working version including new concepts and terms under consideration can be found at [[Attribute Convention for Data Discovery (ACDD) Working]]<br />
<br />
=Objectives and Goals=<br />
#To allow dataset discovery and facilitate mapping between dataset metadata (notably netCDF) and ISO 19115.<br />
#The ACDD Steering Group formalizes changes and additions to ACDD<br />
<br />
=Governance=<br />
The discussion for changes to ACDD is carried out via this wiki and the [http://lists.esipfed.org/mailman/roster/esip-documentation ESIP Documentation Cluster mailing list]. To sign up for edit privileges for this wiki you must first [http://commons.esipfed.org/user/register register at the ESIP Commons]. This registration also grants access to other community resources supported by ESIP. Both the mailing list and this wiki are open and anyone in the community. ACDD will evolve based on the discussions on this list and as documented on these wiki pages. Occasionally, the discussion may need to be moderated or a decision must be made. In these cases the steering committee will vote and adopt a solution as described below. <br />
==Steering Committee==<br />
ACDD will evolve based on the direction of the steering committee initially comprised of the following members:<br />
<br />
*Derrick Snowden (Chair) IOOS<br />
*Dave Blodgett USGS<br />
*Nan Galbraith WHOI<br />
*Ted Habermann HDFGroup<br />
*Steve Hankin PMEL<br />
*Marcos Hermida Unidata<br />
*Aleksandar Jelenak NESDIS/STAR<br />
*Anna Milan NGDC<br />
*Dave Neufeld CIRES<br />
*Rich Signell USGS<br />
*Bob Simons NMFS<br />
*Ed Armstrong JPL<br />
<br />
==Decision Making Process==<br />
<br />
Vote 70% majority of voting members; members may decline to vote on some issues<br />
<br />
If a vote is taken or a decision is reached, that decision should be broadcast to those who could not be present. Discussion of the decision takes place for some period of time (or till the next meeting?) If there is disagreement or ongoing discussion, the decision is not finalized. If there is no discussion or disagreement, the topic is final and will not be revisited later.<br />
<br />
<br />
[[Category: Documentation Cluster]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44224NetCDF-CF File Examples for Satellite Swath Data2013-05-19T21:05:45Z<p>Ajelenak: Compact Level 2 template form</p>
<hr />
<div>[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]<br />
[[Category:Climate Forecast Conventions]]<br />
<br />
==GHRSST Level 2 Data==<br />
''(Contributed by: Ed Armstrong, NASA JPL)''<br />
<br />
The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
<br />
==Templates for Multiband Imagery (Level 1) Data==<br />
''(Contributed by: Aleksandar Jelenak, NOAA Center for Satellite Applications and Research)''<br />
<br />
These templates can be used for storing satellite swath multiband (a.k.a. Level 1 geolocated and calibrated) data. The templates seem to have been unofficially confirmed in a [http://mailman.cgd.ucar.edu/pipermail/cf-metadata/2013/056398.html discussion] on the CF metadata mailing list and have prompted a CF trac [https://cf-pcmdi.llnl.gov/trac/ticket/100 ticket] to modify the convention to allow non-spatiotemporal coordinates.<br />
<br />
The following two templates differ in the type of variable for the spectral coordinate. The name of that variable in both templates is <tt>band</tt>. The first template uses a numerical coordinate variable while the second a string-valued auxiliary coordinate variable. The first template is applicable to data acquired by optical imagers. The second template is aimed at data from microwave instruments where several channels can only differ in the polarization of electromagnetic radiation measured and thus a numerical spectral coordinate would not be able to differentiate between them.<br />
<br />
Only the variable attributes that support the concept are included in the templates.<br />
<br />
===Template with Numerical Spectral Coordinate Variable===<br />
<br />
dimensions:<br />
along_track = ''integer'' ; // option: along_track = UNLIMITED<br />
across_track = ''integer'' ;<br />
'''band''' = ''integer'' ;<br />
<br />
variables:<br />
short along_track(along_track) ;<br />
along_track:axis = "Y" ;<br />
<br />
short across_track(across_track) ;<br />
across_track:axis = "X" ;<br />
<br />
// '''spectral coordinate variable'''<br />
'''float band(band) ;'''<br />
band:standard_name = “'''sensor_band_central_radiation_wavelength'''” ; // new proposed name<br />
band:units = “um” ;<br />
<br />
float lat(along_track, across_track) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon(along_track, across_track) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(along_track) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data(along_track, across_track, '''band''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''<br />
<br />
===Template with String Spectral Coordinate Variable===<br />
<br />
dimensions:<br />
along_track = ''integer'' ; // option: along_track = UNLIMITED<br />
across_track = ''integer'' ;<br />
'''band_enum''' = ''integer'' ;<br />
'''band_strlen''' = ''integer'' ;<br />
<br />
variables:<br />
short along_track(along_track) ;<br />
along_track:axis = "Y" ;<br />
<br />
short across_track(across_track) ;<br />
across_track:axis = "X" ;<br />
<br />
'''short band_enum(band_enum) ;'''<br />
<br />
// '''string-valued auxiliary coordinate variable'''<br />
'''char band(band_enum, band_strlen) ;'''<br />
band:standard_name = “'''sensor_band_identifier'''” ; // proposed new name<br />
<br />
float lat(along_track, across_track) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon(along_track, across_track) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(along_track) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data(along_track, across_track, '''band_enum''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''<br />
<br />
=== More Compact Template Form ===<br />
<br />
The above templates can be simplified by replacing the <tt>along_track</tt> and <tt>across_track</tt> dimensions and variables with two dimensions: <tt>time</tt> and <tt>swath</tt>. The advantage of this approach is that it can support data aggregation along the time coordinate. Below is the new template with the numerical spectral coordinate variable.<br />
<br />
dimensions:<br />
'''time''' = ''integer'' ; // option: time = UNLIMITED<br />
'''swath''' = ''integer'' ;<br />
band = ''integer'' ;<br />
<br />
variables:<br />
float band(band) ;<br />
band:standard_name = “sensor_band_central_radiation_wavelength” ; // new proposed name<br />
band:units = “um” ;<br />
<br />
float lat('''time''', '''swath''') ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon('''time''', '''swath''') ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(time) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data('''time''', '''swath''', band) ;<br />
swath_band_data:coordinates = "lon lat time band" ;</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44115NetCDF-CF File Examples for Satellite Swath Data2013-05-06T17:31:36Z<p>Ajelenak: </p>
<hr />
<div>[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]<br />
[[Category:Climate Forecast Conventions]]<br />
<br />
==GHRSST Level 2 Data==<br />
''(Contributed by: Ed Armstrong, NASA JPL)''<br />
<br />
The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
<br />
==Templates for Multichannel Imagery (Level 1) Data==<br />
''(Contributed by: Aleksandar Jelenak, NOAA Center for Satellite Applications and Research)''<br />
<br />
These templates can be used for storing Level 1 (geolocated and calibrated) satellite swath data. The templates seem to have been unofficially confirmed in a [http://mailman.cgd.ucar.edu/pipermail/cf-metadata/2013/056398.html discussion] on the CF metadata mailing list and have prompted a CF trac [https://cf-pcmdi.llnl.gov/trac/ticket/100 ticket] to modify the convention to allow non-spatiotemporal coordinates.<br />
<br />
The following two templates differ in the type of variable for the spectral coordinate. The name of that variable in both templates is <tt>band</tt>. The first template uses a numerical coordinate variable while the second a string-valued auxiliary coordinate variable. The first template is applicable to data acquired by optical imagers. The second template is aimed at data from microwave instruments where several channels can only differ in the polarization of electromagnetic radiation measured and thus a numerical spectral coordinate would not be able to differentiate between them.<br />
<br />
Only the variable attributes that support the concept are included in the templates.<br />
<br />
===Template with Numerical Spectral Coordinate Variable===<br />
<br />
dimensions:<br />
along_track = ''integer'' ; // option: along_track = UNLIMITED<br />
across_track = ''integer'' ;<br />
'''band''' = ''integer'' ;<br />
<br />
variables:<br />
short along_track(along_track) ;<br />
along_track:axis = "Y" ;<br />
<br />
short across_track(across_track) ;<br />
across_track:axis = "X" ;<br />
<br />
// '''spectral coordinate variable'''<br />
'''float band(band) ;'''<br />
band:standard_name = “'''sensor_band_central_radiation_wavelength'''” ; // new proposed name<br />
band:units = “um” ;<br />
<br />
float lat(along_track, across_track) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon(along_track, across_track) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(along_track) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data(along_track, across_track, '''band''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''<br />
</nowiki><br />
<br />
===Template with String Spectral Coordinate Variable===<br />
<br />
dimensions:<br />
along_track = ''integer'' ; // option: along_track = UNLIMITED<br />
across_track = ''integer'' ;<br />
'''band_enum''' = ''integer'' ;<br />
'''band_strlen''' = ''integer'' ;<br />
<br />
variables:<br />
short along_track(along_track) ;<br />
along_track:axis = "Y" ;<br />
<br />
short across_track(across_track) ;<br />
across_track:axis = "X" ;<br />
<br />
'''short band_enum(band_enum) ;'''<br />
<br />
// '''string-valued auxiliary coordinate variable'''<br />
'''char band(band_enum, band_strlen) ;'''<br />
band:standard_name = “'''sensor_band_identifier'''” ; // proposed new name<br />
<br />
float lat(along_track, across_track) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon(along_track, across_track) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(along_track) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data(along_track, across_track, '''band_enum''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44114NetCDF-CF File Examples for Satellite Swath Data2013-05-06T17:28:45Z<p>Ajelenak: </p>
<hr />
<div>[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]<br />
[[Category:Climate Forecast Conventions]]<br />
<br />
==GHRSST Level 2 Data==<br />
''(Contributed by: Ed Armstrong, NASA JPL)''<br />
<br />
The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
<br />
==Templates for Multichannel Imagery Data==<br />
''(Contributed by: Aleksandar Jelenak, NOAA Center for Satellite Applications and Research)''<br />
<br />
These templates can be used for storing Level 1 (geolocated and calibrated) satellite swath data. The templates seem to have been unofficially confirmed in a [http://mailman.cgd.ucar.edu/pipermail/cf-metadata/2013/056398.html discussion] on the CF metadata mailing list and have prompted a CF trac [https://cf-pcmdi.llnl.gov/trac/ticket/100 ticket] to modify the convention to allow non-spatiotemporal coordinates.<br />
<br />
The following two templates differ in the type of variable for the spectral coordinate. The name of that variable in both templates is <tt>band</tt>. The first template uses a numerical coordinate variable while the second a string-valued auxiliary coordinate variable. The first template is applicable to data acquired by optical imagers. The second template is aimed at data from microwave instruments where several channels can only differ in the polarization of electromagnetic radiation measured and thus a numerical spectral coordinate would not be able to differentiate between them.<br />
<br />
Only the variable attributes that support the concept are included in the templates.<br />
<br />
===Template with Numerical Band Coordinate Variable===<br />
<br />
dimensions:<br />
along_track = ''integer'' ; // option: along_track = UNLIMITED<br />
across_track = ''integer'' ;<br />
'''band''' = ''integer'' ;<br />
<br />
variables:<br />
short along_track(along_track) ;<br />
along_track:axis = "Y" ;<br />
<br />
short across_track(across_track) ;<br />
across_track:axis = "X" ;<br />
<br />
// '''spectral coordinate variable'''<br />
'''float band(band) ;'''<br />
band:standard_name = “'''sensor_band_central_radiation_wavelength'''” ; // new proposed name<br />
band:units = “um” ;<br />
<br />
float lat(along_track, across_track) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon(along_track, across_track) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(along_track) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data(along_track, across_track, '''band''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''<br />
</nowiki><br />
<br />
===Template with String Band Coordinate Variable===<br />
<br />
dimensions:<br />
along_track = ''integer'' ; // option: along_track = UNLIMITED<br />
across_track = ''integer'' ;<br />
'''band_enum''' = ''integer'' ;<br />
'''band_strlen''' = ''integer'' ;<br />
<br />
variables:<br />
short along_track(along_track) ;<br />
along_track:axis = "Y" ;<br />
<br />
short across_track(across_track) ;<br />
across_track:axis = "X" ;<br />
<br />
'''short band_enum(band_enum) ;'''<br />
<br />
// '''string-valued auxiliary coordinate variable'''<br />
'''char band(band_enum, band_strlen) ;'''<br />
band:standard_name = “'''sensor_band_identifier'''” ; // proposed new name<br />
<br />
float lat(along_track, across_track) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon(along_track, across_track) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(along_track) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data(along_track, across_track, '''band_enum''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=44065Standard Names For Satellite Observations2013-05-03T19:09:38Z<p>Ajelenak: "central" names got "radiation" added</p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Template for Standard Name Proposals==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
==Proposed Names==<br />
<br />
===Proposal #1===<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
===Proposal #2===<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
| sensor_band_central_radiation_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith at the observation target; a value of zero is directly overhead the observation target. Local zenith is a line perpendicular to the Earth’s surface at a given location. Observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 um-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44063NetCDF-CF File Examples for Satellite Swath Data2013-05-03T18:04:29Z<p>Ajelenak: /* Template with Numerical Band Coordinate Variable */</p>
<hr />
<div>[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]<br />
<br />
==GHRSST Level 2 Data==<br />
''(Contributed by: Ed Armstrong, NASA JPL)''<br />
<br />
The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
<br />
==Templates for Multichannel Imagery Data==<br />
''(Contributed by: Aleksandar Jelenak, NOAA Center for Satellite Applications and Research)''<br />
<br />
These templates can be used for storing Level 1 (geolocated and calibrated) satellite swath data. The templates seems to have been unofficially approved in a [http://mailman.cgd.ucar.edu/pipermail/cf-metadata/2013/056398.html discussion] on the CF metadata mailing list and have prompted a CF trac [https://cf-pcmdi.llnl.gov/trac/ticket/100 ticket] to modify the convention to allow non-spatiotemporal coordinates.<br />
<br />
The following two templates differ in the type of coordinate variable used to represent the spectral (band, channel) dimension. The first template uses a numerical coordinate variable while the second a string-valued auxiliary coordinate variable. The first template is applicable to data acquired by optical imagers while the second template is aimed at data from microwave instruments where several channels can only differ in the polarization of electromagnetic radiation measured and thus a numerical spectral coordinate would not be able to differentiate between them.<br />
<br />
Only the variable attributes that support the concept are included in the templates.<br />
<br />
===Template with Numerical Band Coordinate Variable===<br />
<br />
dimensions:<br />
along_track = ''integer'' ; // option: along_track = UNLIMITED<br />
across_track = ''integer'' ;<br />
'''band = ''integer'' ;'''<br />
<br />
variables:<br />
short along_track(along_track) ;<br />
along_track:axis = "Y" ;<br />
<br />
short across_track(across_track) ;<br />
across_track:axis = "X" ;<br />
<br />
// '''spectral coordinate variable'''<br />
'''float band(band) ;'''<br />
band:standard_name = “'''sensor_band_central_radiation_wavelength'''” ; // new proposed name<br />
band:units = “um” ;<br />
<br />
float lat(along_track, across_track) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon(along_track, across_track) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(along_track) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data(along_track, across_track, '''band''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''<br />
<br />
===Template with String Band Coordinate Variable===<br />
<br />
dimensions:<br />
along_track = ''integer'' ; // option: along_track = UNLIMITED<br />
across_track = ''integer'' ;<br />
'''band_enum = ''integer'' ;'''<br />
'''band_strlen = ''integer'' ;'''<br />
<br />
variables:<br />
short along_track(along_track) ;<br />
along_track:axis = "Y" ;<br />
<br />
short across_track(across_track) ;<br />
across_track:axis = "X" ;<br />
<br />
'''short band_enum(band_enum) ;'''<br />
<br />
// '''string-valued auxiliary coordinate variable'''<br />
'''char band(band_enum, band_strlen) ;'''<br />
band:standard_name = “'''sensor_band_identifier'''” ; // proposed new name<br />
<br />
float lat(along_track, across_track) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon(along_track, across_track) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(along_track) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data(along_track, across_track, '''band_enum''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44062NetCDF-CF File Examples for Satellite Swath Data2013-05-03T18:04:06Z<p>Ajelenak: /* Template with String Band Coordinate Variable */</p>
<hr />
<div>[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]<br />
<br />
==GHRSST Level 2 Data==<br />
''(Contributed by: Ed Armstrong, NASA JPL)''<br />
<br />
The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
<br />
==Templates for Multichannel Imagery Data==<br />
''(Contributed by: Aleksandar Jelenak, NOAA Center for Satellite Applications and Research)''<br />
<br />
These templates can be used for storing Level 1 (geolocated and calibrated) satellite swath data. The templates seems to have been unofficially approved in a [http://mailman.cgd.ucar.edu/pipermail/cf-metadata/2013/056398.html discussion] on the CF metadata mailing list and have prompted a CF trac [https://cf-pcmdi.llnl.gov/trac/ticket/100 ticket] to modify the convention to allow non-spatiotemporal coordinates.<br />
<br />
The following two templates differ in the type of coordinate variable used to represent the spectral (band, channel) dimension. The first template uses a numerical coordinate variable while the second a string-valued auxiliary coordinate variable. The first template is applicable to data acquired by optical imagers while the second template is aimed at data from microwave instruments where several channels can only differ in the polarization of electromagnetic radiation measured and thus a numerical spectral coordinate would not be able to differentiate between them.<br />
<br />
Only the variable attributes that support the concept are included in the templates.<br />
<br />
===Template with Numerical Band Coordinate Variable===<br />
<br />
dimensions:<br />
along_track = ''integer'' ; // option: along_track = UNLIMITED<br />
across_track = ''integer'' ;<br />
band = ''integer'' ;<br />
<br />
variables:<br />
short along_track(along_track) ;<br />
along_track:axis = "Y" ;<br />
<br />
short across_track(across_track) ;<br />
across_track:axis = "X" ;<br />
<br />
// '''spectral coordinate variable'''<br />
'''float band(band) ;'''<br />
band:standard_name = “'''sensor_band_central_radiation_wavelength'''” ; // new proposed name<br />
band:units = “um” ;<br />
<br />
float lat(along_track, across_track) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon(along_track, across_track) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(along_track) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data(along_track, across_track, '''band''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''<br />
<br />
===Template with String Band Coordinate Variable===<br />
<br />
dimensions:<br />
along_track = ''integer'' ; // option: along_track = UNLIMITED<br />
across_track = ''integer'' ;<br />
'''band_enum = ''integer'' ;'''<br />
'''band_strlen = ''integer'' ;'''<br />
<br />
variables:<br />
short along_track(along_track) ;<br />
along_track:axis = "Y" ;<br />
<br />
short across_track(across_track) ;<br />
across_track:axis = "X" ;<br />
<br />
'''short band_enum(band_enum) ;'''<br />
<br />
// '''string-valued auxiliary coordinate variable'''<br />
'''char band(band_enum, band_strlen) ;'''<br />
band:standard_name = “'''sensor_band_identifier'''” ; // proposed new name<br />
<br />
float lat(along_track, across_track) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon(along_track, across_track) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(along_track) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data(along_track, across_track, '''band_enum''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44058NetCDF-CF File Examples for Satellite Swath Data2013-05-03T17:30:56Z<p>Ajelenak: String aux coord template added</p>
<hr />
<div>[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]<br />
<br />
==GHRSST Level 2 Data==<br />
''(Contributed by: Ed Armstrong, NASA JPL)''<br />
<br />
The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
<br />
==Templates for Multichannel Imagery Data==<br />
''(Contributed by: Aleksandar Jelenak, NOAA Center for Satellite Applications and Research)''<br />
<br />
These templates can be used for storing Level 1 (geolocated and calibrated) satellite swath data. The templates seems to have been unofficially approved in a [http://mailman.cgd.ucar.edu/pipermail/cf-metadata/2013/056398.html discussion] on the CF metadata mailing list and have prompted a CF trac [https://cf-pcmdi.llnl.gov/trac/ticket/100 ticket] to modify the convention to allow non-spatiotemporal coordinates.<br />
<br />
The following two templates differ in the type of coordinate variable used to represent the spectral (band, channel) dimension. The first template uses a numerical coordinate variable while the second a string-valued auxiliary coordinate variable. The first template is applicable to data acquired by optical imagers while the second template is aimed at data from microwave instruments where several channels can only differ in the polarization of electromagnetic radiation measured and thus a numerical spectral coordinate would not be able to differentiate between them.<br />
<br />
Only the variable attributes that support the concept are included in the templates.<br />
<br />
===Template with Numerical Band Coordinate Variable===<br />
<br />
dimensions:<br />
along_track = ''integer'' ; // option: along_track = UNLIMITED<br />
across_track = ''integer'' ;<br />
band = ''integer'' ;<br />
<br />
variables:<br />
short along_track(along_track) ;<br />
along_track:axis = "Y" ;<br />
<br />
short across_track(across_track) ;<br />
across_track:axis = "X" ;<br />
<br />
// '''spectral coordinate variable'''<br />
'''float band(band) ;'''<br />
band:standard_name = “'''sensor_band_central_radiation_wavelength'''” ; // new proposed name<br />
band:units = “um” ;<br />
<br />
float lat(along_track, across_track) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon(along_track, across_track) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(along_track) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data(along_track, across_track, '''band''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''<br />
<br />
===Template with String Band Coordinate Variable===<br />
<br />
dimensions:<br />
along_track = ''integer'' ; // option: along_track = UNLIMITED<br />
across_track = ''integer'' ;<br />
band = ''integer'' ;<br />
<br />
variables:<br />
short along_track(along_track) ;<br />
along_track:axis = "Y" ;<br />
<br />
short across_track(across_track) ;<br />
across_track:axis = "X" ;<br />
<br />
'''short band_enum(band_enum) ;'''<br />
<br />
// '''string-valued auxiliary coordinate variable'''<br />
'''char band(band_enum, band_strlen) ;'''<br />
band:standard_name = “'''sensor_band_identifier'''” ; // proposed new name<br />
<br />
float lat(along_track, across_track) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon(along_track, across_track) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(along_track) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data(along_track, across_track, '''band_enum''') ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44057NetCDF-CF File Examples for Satellite Swath Data2013-05-03T17:19:16Z<p>Ajelenak: /* Template with Numerical Band Coordinate Variable */</p>
<hr />
<div>[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]<br />
<br />
==GHRSST Level 2 Data==<br />
''(Contributed by: Ed Armstrong, NASA JPL)''<br />
<br />
The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
<br />
==Templates for Multichannel Imagery Data==<br />
''(Contributed by: Aleksandar Jelenak, NOAA Center for Satellite Applications and Research)''<br />
<br />
These templates can be used for storing Level 1 (geolocated and calibrated) satellite swath data. The templates seems to have been unofficially approved in a [http://mailman.cgd.ucar.edu/pipermail/cf-metadata/2013/056398.html discussion] on the CF metadata mailing list and have prompted a CF trac [https://cf-pcmdi.llnl.gov/trac/ticket/100 ticket] to modify the convention to allow non-spatiotemporal coordinates.<br />
<br />
The following two templates differ in the type of coordinate variable used to represent the spectral (band, channel) dimension. The first template uses a numerical coordinate variable while the second a string-valued auxiliary coordinate variable. The first template is applicable to data acquired by optical imagers while the second template is aimed at data from microwave instruments where several channels can only differ in the polarization of electromagnetic radiation measured and thus a numerical spectral coordinate would not be able to differentiate between them.<br />
<br />
Only the variable attributes that support the concept are included in the templates.<br />
<br />
===Template with Numerical Band Coordinate Variable===<br />
<br />
dimensions:<br />
along_track = ''integer'' ; // option: along_track = UNLIMITED<br />
across_track = ''integer'' ;<br />
band = ''integer'' ;<br />
<br />
variables:<br />
short along_track(along_track) ;<br />
along_track:axis = "Y" ;<br />
<br />
short across_track(across_track) ;<br />
across_track:axis = "X" ;<br />
<br />
'''float band(band) ;'''<br />
band:standard_name = “'''sensor_band_central_radiation_wavelength'''” ; // new proposed name<br />
band:units = “um” ;<br />
<br />
float lat(along_track, across_track) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon(along_track, across_track) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(along_track) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data(along_track, across_track, band) ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''<br />
<br />
===Template with String Band Coordinate Variable===</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44056NetCDF-CF File Examples for Satellite Swath Data2013-05-03T17:18:16Z<p>Ajelenak: /* Template with Numerical Band Coordinate Variable */</p>
<hr />
<div>[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]<br />
<br />
==GHRSST Level 2 Data==<br />
''(Contributed by: Ed Armstrong, NASA JPL)''<br />
<br />
The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
<br />
==Templates for Multichannel Imagery Data==<br />
''(Contributed by: Aleksandar Jelenak, NOAA Center for Satellite Applications and Research)''<br />
<br />
These templates can be used for storing Level 1 (geolocated and calibrated) satellite swath data. The templates seems to have been unofficially approved in a [http://mailman.cgd.ucar.edu/pipermail/cf-metadata/2013/056398.html discussion] on the CF metadata mailing list and have prompted a CF trac [https://cf-pcmdi.llnl.gov/trac/ticket/100 ticket] to modify the convention to allow non-spatiotemporal coordinates.<br />
<br />
The following two templates differ in the type of coordinate variable used to represent the spectral (band, channel) dimension. The first template uses a numerical coordinate variable while the second a string-valued auxiliary coordinate variable. The first template is applicable to data acquired by optical imagers while the second template is aimed at data from microwave instruments where several channels can only differ in the polarization of electromagnetic radiation measured and thus a numerical spectral coordinate would not be able to differentiate between them.<br />
<br />
Only the variable attributes that support the concept are included in the templates.<br />
<br />
===Template with Numerical Band Coordinate Variable===<br />
<br />
dimensions:<br />
along_track = <integer> ; // option: along_track = UNLIMITED<br />
across_track = <integer> ;<br />
band = <integer> ;<br />
<br />
variables:<br />
short along_track(along_track) ;<br />
along_track:axis = "Y" ;<br />
<br />
short across_track(across_track) ;<br />
across_track:axis = "X" ;<br />
<br />
'''float band(band) ;'''<br />
band:standard_name = “'''sensor_band_central_radiation_wavelength'''” ; // new proposed name<br />
band:units = “um” ;<br />
<br />
float lat(along_track, across_track) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
<br />
float lon(along_track, across_track) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
<br />
double time(along_track) ;<br />
time:standard_name = "time" ;<br />
time:units = "''units'' since ''datetime string''" ;<br />
time:calendar = "gregorian" ;<br />
<br />
float swath_band_data(along_track, across_track, band) ;<br />
'''swath_band_data:coordinates = "lon lat time band" ;'''<br />
<br />
===Template with String Band Coordinate Variable===</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44055NetCDF-CF File Examples for Satellite Swath Data2013-05-03T16:48:21Z<p>Ajelenak: Reorganized stuff, preparing for Level 1 templates</p>
<hr />
<div>[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]<br />
<br />
==GHRSST Level 2 Data==<br />
''(Contributed by: Ed Armstrong, NASA JPL)''<br />
<br />
The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
<br />
==Templates for Multichannel Imagery Data==<br />
''(Contributed by: Aleksandar Jelenak, NOAA Center for Satellite Applications and Research)''<br />
<br />
These templates can be used for storing Level 1 (geolocated and calibrated) satellite swath data. The templates seems to have been unofficially approved in a [http://mailman.cgd.ucar.edu/pipermail/cf-metadata/2013/056398.html discussion] on the CF metadata mailing list and have prompted a CF trac [https://cf-pcmdi.llnl.gov/trac/ticket/100 ticket] to modify the convention to allow non-spatiotemporal coordinates.<br />
<br />
The following two templates differ in the type of coordinate variable used to represent the spectral (band, channel) dimension. The first template uses a numerical coordinate variable while the second a string-valued auxiliary coordinate variable. The first template is applicable to data acquired by optical imagers while the second template is aimed at data from microwave instruments where several channels can only differ in the polarization of electromagnetic radiation measured and thus a numerical spectral coordinate would not be able to differentiate between them.<br />
<br />
Only the variable attributes that support the concept are included in the templates.<br />
<br />
===Template with Numerical Band Coordinate Variable===<br />
<br />
===Template with String Band Coordinate Variable===</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_With_Satellite_Swath_Data&diff=44051NetCDF-CF File Examples With Satellite Swath Data2013-05-02T04:28:44Z<p>Ajelenak: Ajelenak moved page NetCDF-CF File Examples With Satellite Swath Data to NetCDF-CF File Examples for Satellite Swath Data</p>
<hr />
<div>#REDIRECT [[NetCDF-CF File Examples for Satellite Swath Data]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44050NetCDF-CF File Examples for Satellite Swath Data2013-05-02T04:28:44Z<p>Ajelenak: Ajelenak moved page NetCDF-CF File Examples With Satellite Swath Data to NetCDF-CF File Examples for Satellite Swath Data</p>
<hr />
<div>The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF/CF_example_--_satellite_swath_data&diff=44049NetCDF/CF example -- satellite swath data2013-05-02T04:27:52Z<p>Ajelenak: Ajelenak moved page NetCDF/CF example -- satellite swath data to NetCDF-CF File Examples With Satellite Swath Data</p>
<hr />
<div>#REDIRECT [[NetCDF-CF File Examples With Satellite Swath Data]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44048NetCDF-CF File Examples for Satellite Swath Data2013-05-02T04:27:52Z<p>Ajelenak: Ajelenak moved page NetCDF/CF example -- satellite swath data to NetCDF-CF File Examples With Satellite Swath Data</p>
<hr />
<div>The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=NetCDF-CF_File_Examples_for_Satellite_Swath_Data&diff=44047NetCDF-CF File Examples for Satellite Swath Data2013-05-02T04:22:12Z<p>Ajelenak: </p>
<hr />
<div>The following CDL represents an example of the structure of a GHRSST Level 2P file for an SST data set derived from the Sentinel-3A Sea and Land Surface Temperature (SLSTR) data set. Its straight from the [ftp://podaac.jpl.nasa.gov/OceanTemperature/ghrsst/docs/GDS20r5.pdf GHRSST Data Processing Specification version 2] <br />
<br />
The dimensions ni and nj represent the satellite across and along track coordinates respectively. Other important variables are time, lon, lat for positioning satellite observations/information found in the sea_surface_temperature, sst_dtime, sses_bias, sses_standard_deviation, and quality_level variables (and others).<br />
<br />
<br />
netcdf l2p {<br />
dimensions:<br />
ni = 1760;<br />
nj = 40000;<br />
time = 1;<br />
variables:<br />
float lat(nj, ni) ;<br />
lat:standard_name = "latitude" ;<br />
lat:units = "degrees_north" ;<br />
lat:valid_min = -90. ;<br />
lat:valid_max = 90. ;<br />
lat:comment = "Geographical coordinates, WGS84 datum" ;<br />
float lon(nj, ni) ;<br />
lon:standard_name = "longitude" ;<br />
lon:units = "degrees_east" ;<br />
lon:valid_min = -180. ;<br />
lon:valid_max = 180. ;<br />
lon:comment = "Geographical coordinates, WGS84 datum" ;<br />
int time(time);<br />
time:long_name = "reference time of SST file";<br />
time:units = "seconds since 1981-01-01 00:00:00";<br />
time:comment = "Includes leap seconds since 1981" ;<br />
short sea_surface_temperature(time, nj, ni);<br />
sea_surface_temperature:long_name = "sea surface skin temperature";<br />
sea_surface_temperature:standard_name = "sea_surface_skin_temperature";<br />
sea_surface_temperature:units = "kelvin";<br />
sea_surface_temperature:add_offset = 290.0;<br />
sea_surface_temperature:scale_factor = 1.0e-3;<br />
sea_surface_temperature:valid_min = -32767s;<br />
sea_surface_temperature:valid_max = 32767s;<br />
sea_surface_temperature:_FillValue = -32768s;<br />
sea_surface_temperature:coordinates = "lon lat";<br />
sea_surface_temperature:comment = "Skin temperature of the ocean";<br />
short sst_dtime (time, nj, ni); <br />
sst_dtime:long_name = "time difference from reference time";<br />
sst_dtime:units = "second";<br />
sst_dtime:add_offset = 0s;<br />
sst_dtime:scale_factor = 1s;<br />
sst_dtime:valid_min = -32767s;<br />
sst_dtime:valid_max = 32767s;<br />
sst_dtime:_FillValue = -32768s;<br />
sst_dtime:coordinates = "lon lat";<br />
sst_dtime:comment = "Variable time plus sst_dtime gives seconds after 00:00:00 UTC January 1, 1981";<br />
byte sses_bias (time, nj, ni);<br />
sses_bias:long_name = "SSES bias estimate";<br />
sses_bias:units = "kelvin";<br />
sses_bias:add_offset = 0.0;<br />
sses_bias:scale_factor = 0.02;<br />
sses_bias:valid_min = -127b;<br />
sses_bias:valid_max = 127b;<br />
sses_bias:_FillValue = -128b;<br />
sses_bias:coordinates = "lon lat";<br />
sses_bias:comment = "Estimated bias as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte sses_standard_deviation (time, nj, ni);<br />
sses_standard_deviation:long_name = "SSES standard deviation";<br />
sses_standard_deviation:units = "kelvin";<br />
sses_standard_deviation:add_offset = 1.27;<br />
sses_standard_deviation:scale_factor = 0.01;<br />
sses_standard_deviation:valid_min = -127b;<br />
sses_standard_deviation:valid_max = 127b;<br />
sses_standard_deviation:_FillValue = -128b; <br />
sses_standard_deviation:coordinates = "lon lat";<br />
sses_standard_deviation:comment = "Estimated standard deviation as described at http://www.ghrsst.org/SSES-Description-of-schemes.html";<br />
byte dt_analysis (time, nj, ni);<br />
dt_analysis:long_name = "deviation from SST reference climatology";<br />
dt_analysis:units = "kelvin";<br />
dt_analysis:add_offset = 0.;<br />
dt_analysis:scale_factor = 0.1;<br />
dt_analysis:valid_min = -127b;<br />
dt_analysis:valid_max = 127b;<br />
dt_analysis:_FillValue = -128b;<br />
dt_analysis:coordinates = "lon lat";<br />
dt_analysis:comment = "Reference is GHRSST L4 OSTIA";<br />
byte wind_speed (time, nj, ni);<br />
wind_speed:long_name = "10m wind speed";<br />
wind_speed:standard_name = "wind_speed";<br />
wind_speed:units = "m s-1";<br />
wind_speed:height = "10 m";<br />
wind_speed:add_offset = 25.4;<br />
wind_speed:scale_factor = 0.2;<br />
wind_speed:valid_min = -127b;<br />
wind_speed:valid_max = 127b;<br />
wind_speed:_FillValue = -128b;<br />
wind_speed:coordinates = "lon lat";<br />
wind_speed:sources = "ECMWF_A";<br />
wind_speed:comment = "These wind speeds were created by the ECMWF and represent winds at 10 metres above the sea surface.";<br />
byte wind_speed_dtime_from_sst (time, nj, ni);<br />
wind_speed_dtime_from_sst :long_name = "time difference of wind speed measurement from sst measurement";<br />
wind_speed_dtime_from_sst:units = "hour";<br />
wind_speed_dtime_from_sst:add_offset = 12.7;<br />
wind_speed_dtime_from_sst:scale_factor = 0.1;<br />
wind_speed_dtime_from_sst:valid_min = -127b;<br />
wind_speed_dtime_from_sst:valid_max = 127b;<br />
wind_speed_dtime_from_sst:_FillValue = -128b;<br />
wind_speed_dtime_from_sst:coordinates = "lon lat";<br />
wind_speed_dtime_from_sst:comment = "The hours between the wind speed measurement and the SST observation using variable sst_dtime as the reference";<br />
byte sea_ice_fraction(time, nj, ni);<br />
sea_ice_fraction:long_name = "sea ice fraction";<br />
sea_ice_fraction:standard_name = "sea_ice_area_fraction";<br />
sea_ice_fraction:units = "1";<br />
sea_ice_fraction:add_offset = 0.;<br />
sea_ice_fraction:scale_factor = 0.01 ;<br />
sea_ice_fraction:valid_min = 0b;<br />
sea_ice_fraction:valid_max = 100b;<br />
sea_ice_fraction:_FillValue = -128b;<br />
sea_ice_fraction:coordinates = "lon lat";<br />
sea_ice_fraction:sources = "ECMWF_A";<br />
sea_ice_fraction:comment = "Fractional sea ice cover from the ECMWF_A ice product";<br />
byte sea_ice_fraction_dtime_from_sst (time, nj, ni);<br />
sea_ice_fraction_dtime_from_sst :long_name = "time difference of sea ice fraction measurement from sst measurement";<br />
sea_ice_fraction_dtime_from_sst:units = "hour";<br />
sea_ice_fraction_dtime_from_sst:add_offset = 0.;<br />
sea_ice_fraction_dtime_from_sst:scale_factor = 0.1;<br />
sea_ice_fraction_dtime_from_sst:valid_min = -127b;<br />
sea_ice_fraction_dtime_from_sst:valid_max = 127b;<br />
sea_ice_fraction_dtime_from_sst:_FillValue = -128b;<br />
sea_ice_fraction_dtime_from_sst:coordinates = "lon lat";<br />
sea_ice_fraction_dtime_from_sst:comment = “The hours between the sea ice measurement and the SST observation using variable sst_dtime as the reference";<br />
byte aerosol_dynamic_indicator(time, nj, ni);<br />
aerosol_dynamic_indicator:long_name = "aerosol dynamic indicator";<br />
aerosol_dynamic_indicator:units = " ";<br />
aerosol_dynamic_indicator:_FillValue = -128b;<br />
aerosol_dynamic_indicator:add_offset = 0.;<br />
aerosol_dynamic_indicator:scale_factor = 1.;<br />
aerosol_dynamic_indicator:valid_min = -127b;<br />
aerosol_dynamic_indicator:valid_max = 127b;<br />
aerosol_dynamic_indicator:coordinates = "lon lat";<br />
aerosol_dynamic_indicator:sources = "SDI";<br />
aerosol_dynamic_indicator:comment = "Estimate of the potential for aerosol contamination based on the SDI product ";<br />
byte adi_dtime_from_sst(time, nj, ni);<br />
adi_dtime_from_sst:long_name = "time difference of ADI data from sst measurement";<br />
adi_dtime_from_sst:units = "hour";<br />
adi_dtime_from_sst:_FillValue = -128b;<br />
adi_dtime_from_sst:add_offset = 0.;<br />
adi_dtime_from_sst:scale_factor = 0.1;<br />
adi_dtime_from_sst:valid_min = -127b;<br />
adi_dtime_from_sst:valid_max = 127b;<br />
adi_dtime_from_sst:coordinates = "lon lat";<br />
adi_dtime_from_sst:comment = "The hours between the aerosol measurement and the SST observation using variable sst_dtime as the reference";<br />
short l2p_flags(time, nj, ni);<br />
l2p_flags:long_name = "L2P flags";<br />
l2p_flags:coordinates = "lon lat";<br />
l2p_flags:valid_min = 0s;<br />
l2p_flags:valid_max = 65535s;<br />
l2p_flags:flag_meanings = "microwave land ice lake river reserved_for_future_use no_retrieval N2_retrieval N3R_retrieval N3_retrieval D2_retrieval D3_retrieval cloud sun_glint cosmetic_fill validation";<br />
l2p_flags:flag_masks = 1s, 2s, 4s, 8s, 16s, 32s, 64s, 128s, 256s, 512s, 1024s, 2048s, 4096s, 8192s, 16384s, 32768s ;<br />
l2p_flags:comment = "These flags can be used to further filter data variables";<br />
byte quality_level (time, nj, ni);<br />
quality_level:long_name = "SST measurement quality" ;<br />
quality_level:coordinates = "lon lat" ;<br />
quality_level:_FillValue = -128b;<br />
quality_level:valid_min = 0b;<br />
quality_level:valid_max = 5b;<br />
quality_level:flag_meanings = "no_data bad_data worst_quality low_quality acceptable_quality best_quality";<br />
quality_level:flag_values = 0b, 1b, 2b, 3b, 4b, 5b;<br />
quality_level:comment = " These are the overall quality indicators and are used for all GHRSST SSTs";<br />
byte satellite_zenith_angle(time, nj, ni) ; <br />
satellite_zenith_angle:long_name = "satellite zenith angle" ;<br />
satellite_zenith_angle:standard_name = " zenith_angle";<br />
satellite_zenith_angle:units = "angular_degree" ;<br />
satellite_zenith_angle:_FillValue = -128b ;<br />
satellite_zenith_angle:add_offset = 0. ;<br />
satellite_zenith_angle:scale_factor = 1. ;<br />
satellite_zenith_angle:valid_min = -90b ;<br />
satellite_zenith_angle:valid_max = 90b ;<br />
satellite_zenith_angle:coordinates = "lon lat" ;<br />
satellite_zenith_angle:grid_mapping = "polar_stereographic" ;<br />
satellite_zenith_angle:comment = “The satellite zenith angle at the time of the SST observations; Optional L2P field” ;<br />
// global attributes:<br />
:Conventions = "CF-1.4";<br />
:title = "SENTINEL-3A SLSTR L2P product";<br />
:summary = "The L2P product for the Sentinel-3A mission. This data set is the follow-on the ATSR-1, ATSR-2, and AATSR series of instruments dating back to 1991.";<br />
:references = "http://sentinel.esa.int/handbooks/SLSTR_product_handbook.pdf";<br />
:institution = "ESA";<br />
:history = "processor XXX.YY";<br />
:comment = "SST from Sentinel-3A";<br />
:license = "These data are available free of charge under the GMES data policy.";<br />
:id = "SLSTR-EUR-L2P-Sentinel3A-v1";<br />
:naming_authority = "org.ghrsst";<br />
:product_version = "1.0";<br />
:uuid = "D7A88FA8-7421-4039-807C-B551D638EDC6";<br />
:gds_version_id = "2.0";<br />
:necdf_version_id = "4.1";<br />
:date_created = "20100201T120000Z";<br />
:file_quality_level=1;<br />
:spatial_resolution = "1 km";<br />
:start_time = "20100131T001223Z";<br />
:time_coverage_start = "20100131T001223Z";<br />
:stop_time = "20100131T001418Z";<br />
:time_coverage_end = "20100131T001418Z";<br />
:northernmost_latitude = 85.;<br />
:sourthenmost_latitude = -85.;<br />
:westernmost_longitude = -180.;<br />
:easternmost_longitude = 180.;<br />
:source = "S3A_SLSTR OSTIA ECMWF_A";<br />
:platform = "SENTINEL_3A";<br />
:sensor = "SLSTR";<br />
:Metadata_Conventions = "Unidata Observation Dataset v1.0";<br />
:metadata_link = "http://data.nodc.noaa.gov/waf/FGDC-GHRSST_all-SLSTR-EUR-L2P-Sentinel3A-v1.html";<br />
:keywords = "Oceans > Ocean Temperature > Sea Surface Temperature";<br />
:keywords_vocabulary = "NASA Global Change Master Directory (GCMD) Science Keywords";<br />
:standard_name_vocabulary = "NetCDF Climate and Forecast (CF) Metadata Convention";<br />
:geospatial_lat_units = "degrees north";<br />
:geospatial_lat_resolution = "0.01";<br />
:geospatial_lon_units = "degrees east";<br />
:geospatial_lon_resolution = "0.01";<br />
:acknowledgment = "Please acknowledge the use of these data with the following statement: These data were provided by GHRSST and its European Regional Data Assembly Center";<br />
:creator_name = "European Space Agency";<br />
:creator_email ="eohelp@esa.int";<br />
:creator_url = "http://sentinel.esa.int";<br />
:project = "Group for High Resolution SST";<br />
:publisher_name = "GHRSST Project Office";<br />
:publisher_url ="http://www.ghrsst.org";<br />
:publisher_email ="ghrsst-po@nceo.ac.uk";<br />
:processing_level = "L2P";<br />
:cdm_data_type = "swath";<br />
}<br />
<br />
[[Category:Documentation Cluster]]<br />
[[Category:Documentation Connections]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=44025Standard Names For Satellite Observations2013-04-30T20:01:58Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Template for Standard Name Proposals==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
==Proposed Names==<br />
<br />
===Proposal #1===<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
===Proposal #2===<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith at the observation target; a value of zero is directly overhead the observation target. Local zenith is a line perpendicular to the Earth’s surface at a given location. Observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 um-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=43603Standard Names For Satellite Observations2013-04-16T03:09:23Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Template for Standard Name Proposals==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
==Proposed Names==<br />
<br />
===Proposal #1===<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
===Proposal #2===<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith; a value of zero is directly overhead.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle from which observations are made e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 um-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=43602Standard Names For Satellite Observations2013-04-16T03:02:18Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Template for Standard Name Proposals==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
==Proposed Names==<br />
<br />
===Proposal #1===<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
===Proposal #2===<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith; a value of zero is directly overhead.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle from which observations are made e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PowderBlue"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 um-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=43601Standard Names For Satellite Observations2013-04-15T23:41:12Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Template for Standard Name Proposals==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
==Proposed Names==<br />
<br />
===Proposal #1===<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
===Proposal #2===<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith; a value of zero is directly overhead.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle from which observations are made e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 um-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=43600Standard Names For Satellite Observations2013-04-15T23:36:20Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Template for Standard Name Proposals==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
==Proposed Names==<br />
<br />
===Proposal #1===<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
===Proposal #2===<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith; a value of zero is directly overhead.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle from which observations are made e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 um-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=43599Standard Names For Satellite Observations2013-04-15T23:26:42Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Template for Standard Name Proposals==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
==Proposed Names==<br />
<br />
===Proposal #1===<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
===Proposal #2===<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith; a value of zero is directly overhead.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle from which observations are made e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#D0F8D0"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 um-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=43598Standard Names For Satellite Observations2013-04-15T23:24:32Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Template for Standard Name Proposals==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
==Proposed Names==<br />
<br />
===Proposal #1===<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
===Proposal #2===<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith; a value of zero is directly overhead.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle from which observations are made e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:#BCF5BC"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 um-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=43597Standard Names For Satellite Observations2013-04-15T22:34:31Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Template for Standard Name Proposals==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
==Proposed Names==<br />
<br />
===Proposal #1===<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
===Proposal #2===<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith; a value of zero is directly overhead.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle from which observations are made e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:LightGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 um-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=43596Standard Names For Satellite Observations2013-04-15T22:25:40Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Template for Standard Name Proposals==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
==Proposed Names==<br />
<br />
===Proposal #1===<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
===Proposal #2===<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith; a value of zero is directly overhead.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle from which observations are made e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:PaleGreen"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 um-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=43532Standard Names For Satellite Observations2013-04-15T16:10:40Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Template for Standard Name Proposals==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
==Proposed Names==<br />
<br />
===Proposal #1===<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
===Proposal #2===<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith; a value of zero is directly overhead.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle from which observations are made e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 um-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=43531Standard Names For Satellite Observations2013-04-15T16:08:16Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Proposed Names==<br />
<br />
===Proposal #1===<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
===Proposal #2===<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith; a value of zero is directly overhead.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle from which observations are made e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 um-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
----<br />
<br />
====Table Template for Standard Name Proposals====<br />
<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=43526Standard Names For Satellite Observations2013-04-15T14:36:03Z<p>Ajelenak: "spectral_radiance" replaced with "radiance_per_unit_..." and many other small changes</p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Proposed Names==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith; a value of zero is directly overhead.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle from which observations are made e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavelength<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 um-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|toa_outgoing_radiance_per_unit_wavenumber_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_radiance_per_unit_wavenumber'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance expressed as a function of wavenumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit of either wavelength, frequency, or wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|quadratic_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance expressed as a function of wavennumber. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' and ''linear_term_of_radiance_per_unit_wavenumber_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavelength, frequency, or wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
----<br />
<br />
====Table Template for Standard Name Proposals====<br />
<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=43465Standard Names For Satellite Observations2013-04-12T14:21:37Z<p>Ajelenak: Removed "emitted" from toa_outgoing_spectral_radiance</p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Proposed Names==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith; a value of zero is directly overhead.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle from which observations are made e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means toward outer space; "spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_spectral_radiance'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_spectral_radiance'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_spectral_radiance'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_spectral_radiance'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|constant_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. "Spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|quadratic_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_spectral_radiance_correction<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_spectral_radiance_correction_due_to_intercalibration'' and ''linear_term_of_spectral_radiance_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
----<br />
<br />
====Table Template for Standard Name Proposals====<br />
<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=43083Standard Names For Satellite Observations2013-03-24T04:36:22Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Proposed Names==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|string<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith; a value of zero is directly overhead.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle from which observations are made e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means emitted toward outer space; "spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_spectral_radiance'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_spectral_radiance'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_spectral_radiance'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_spectral_radiance'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|constant_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. "Spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|quadratic_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_spectral_radiance_correction<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_spectral_radiance_correction_due_to_intercalibration'' and ''linear_term_of_spectral_radiance_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
----<br />
<br />
====Table Template for Standard Name Proposals====<br />
<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=43082Standard Names For Satellite Observations2013-03-24T04:33:48Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Proposed Names==<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|''N/A''<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|''N/A''<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith; a value of zero is directly overhead.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle from which observations are made e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means emitted toward outer space; "spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_spectral_radiance'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_spectral_radiance'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_spectral_radiance'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_spectral_radiance'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|constant_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. "Spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|quadratic_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_spectral_radiance_correction<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_spectral_radiance_correction_due_to_intercalibration'' and ''linear_term_of_spectral_radiance_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
----<br />
<br />
====Table Template for Standard Name Proposals====<br />
<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=43080Standard Names For Satellite Observations2013-03-23T15:28:58Z<p>Ajelenak: </p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Proposed Names==<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|''N/A''<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|''N/A''<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith; a value of zero is directly overhead.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle from which observations are made e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means emitted toward outer space; "spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_spectral_radiance'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_spectral_radiance'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_spectral_radiance'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_spectral_radiance'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|constant_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. "Spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|quadratic_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_spectral_radiance_correction<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_spectral_radiance_correction_due_to_intercalibration'' and ''linear_term_of_spectral_radiance_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
----<br />
<br />
====Table Template for Standard Name Proposals====<br />
<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenakhttps://wiki.esipfed.org/w/index.php?title=Standard_Names_For_Satellite_Observations&diff=43079Standard Names For Satellite Observations2013-03-23T15:27:48Z<p>Ajelenak: Cleaned up the wiki markup</p>
<hr />
<div>The [http://cf-pcmdi.llnl.gov/ Climate and Forecast (CF) metadata convention] maintains a list of [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/ ''standard names''] for data stored in variables of a netCDF file. Not many standard names in that list are relevant to satellite observation data so additional names are proposed here. The new names and accompanying information will follow the CF [http://cf-pcmdi.llnl.gov/documents/cf-standard-names/guidelines guidelines].<br />
<br />
==Instruments or Sensors?==<br />
There is some uncertainty about the hierarchy required to completely describe devices that are used to collect data in the field. This uncertainty boils down to whether this hierarchy requires two levels, i.e. platform and instrument, or three levels, i.e. platform, instrument, and sensor. The simple hierarchy works well in many cases, but there are also clear cases that require three levels, i.e. "platform" that hosts "instruments" that host multiple "sensors".<br />
<br />
Various communities have adopted conventional approaches to this nomenclature:<br />
*GOES-R NcML examples use global attributes "platform_ID" and "instrument_ID" and metadata variables "gcmd_platform_keywords" and "gcmd_instrument_keywords".<br />
*The NESDIS STAR netCDF template uses global attributes "satellite_name" and "instrument_name"<br />
*The GHRSST data specification uses global attributes "platform" and "sensor"<br />
* NPP (HDF) uses global attributes "Platform" and "Instrument"<br />
<br />
Of course agreement is more important than justification in this case. We propose to use sensor in these names because it works in the two level case and does not preclude the use of three levels when required.<br />
<br />
===Definitions from the SensorML Standard===<br />
<br />
SensorML is an XML dialect for describing processes and processing components associated with the measurement and post-measurement transformation of observations. It is one of the Open Geospatial Consortium standards. The following descriptions of the terms ''detector'', ''sensor'', and ''platform'' are taken verbatim from the SensorML's implementation specification document (ref: 07-000; version: 1.0.0, dated: 2007-07-17).<br />
<br />
From Section 4, ''Terms and definitions'':<br />
<br />
; detector<br />
: Atomic part of a composite Measurement System defining sampling and response characteristic of a simple detection device. A detector has only one input and one output, both being scalar quantities. More complex Sensors, such as a frame camera, which are composed of multiple detectors can be described as a detector group or array using a System or Sensor. In SensorML a detector is a particular type of Process Model.<br />
<br />
; sensor<br />
: An entity capable of observing a phenomenon and returning an observed value. In SensorML, modeled as a specific type of System representing a complete Sensor. This could be for example a complete airborne scanner which includes several Detectors (one for each band).<br />
<br />
; (sensor) platform<br />
: An entity to which can be attached sensors or other platforms. A platform has an associated local coordinate frame that can be referenced to an external coordinate reference frame and to which the frames of attached sensors and platforms can be referenced.<br />
<br />
The SensorML document does not specifically define the term ''instrument''.<br />
<br />
==Proposed Names==<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|sensor_band_identifier<br />
|-<br />
|'''Canonical units'''<br />
|''N/A''<br />
|-<br />
|'''Definition'''<br />
|Alphanumeric identifier of a sensor band.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavelength<br />
|-<br />
|'''Canonical units'''<br />
| m<br />
|-<br />
|'''Definition'''<br />
| The central wavelength of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_wavenumber<br />
|-<br />
|'''Canonical units'''<br />
| m-1<br />
|-<br />
|'''Definition'''<br />
| The central wavenumber of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
| sensor_band_central_frequency<br />
|-<br />
|'''Canonical units'''<br />
| Hz<br />
|-<br />
|'''Definition'''<br />
| The central frequency of a sensor's band, calculated as the first moment of the band's normalized spectral response function.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:AliceBlue"<br />
|'''Standard name'''<br />
| time_sample_difference_due_to_collocation<br />
|-<br />
|'''Canonical units'''<br />
|s<br />
|-<br />
|'''Definition'''<br />
|The difference in time between two events that are collocated. Two events are deemed to be collocated based on some set of spatial, temporal, and viewing geometry criteria.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|datetime_iso8601<br />
|-<br />
|'''Canonical units'''<br />
|''N/A''<br />
|-<br />
|'''Definition'''<br />
|String representing date-time information according to the ISO 8601:2004(E) standard. Variables with this standard name cannot serve as coordinate variables. Date-time information is in the Gregorian calendar. For dates preceding the Gregorian calendar the date-time information is in the proleptic Gregorian calendar. Possible date-time string forms are:<br />
<br />
<pre><br />
<datetime> = <date> "T" <time> <timezone> ;<br />
<br />
<date> = YYYY "-" MM "-" DD <nowiki>|</nowiki> YYYY "-" DDD ;<br />
<br />
<time> = hh <nowiki>|</nowiki> hh ":" mm <nowiki>|</nowiki> hh ":" mm ":" ss <nowiki>|</nowiki> hh ":" mm ":" ss "." S <nowiki>|</nowiki> hh ":" mm ":" ss "," S ;<br />
<br />
<timezone> = "" <nowiki>|</nowiki> "Z" <nowiki>|</nowiki> "+" hh <nowiki>|</nowiki> "+" hh ":" mm <nowiki>|</nowiki> "-" hh <nowiki>|</nowiki> "-" hh ":" mm<br />
</pre><br />
<br />
Where:<br />
<br />
* "YYYY" is a four-digit year (0000-9999).<br />
<br />
* "MM" is a two-digit month of the year (01-12).<br />
<br />
* "DD" is a two-digit day of the month (01-31).<br />
<br />
* "DDD" is a three-digit ordinal day of the year (001-366).<br />
<br />
* "hh" is a two-digit hour (00-23).<br />
<br />
* "mm" is a two-digit minute (00-59)<br />
<br />
* "ss" is a two-digit second (00-59).<br />
<br />
* "S" is one or more digits representing a decimal fraction of the second.<br />
<br />
* The value of any designator when not specified is zero.<br />
<br />
* If <timezone> is ommitted the default value is "Z".<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_zenith_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight to the sensor and the local zenith; a value of zero is directly overhead.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|platform_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle from which observations are made e.g. airplane, ship, or satellite. Platform look angle is the angle between the line of sight from the platform and the direction straight vertically down. Zero look angle means looking directly beneath the platform.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|sensor_look_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The angle between the line of sight from the sensor and the direction straight vertically down. Zero look angle means looking directly beneath the sensor.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|"platform" refers to the vehicle on which the sensor making observations is mounted on, e.g. airplane, ship, or satellite. Platform azimuth angle is the horizontal angle where the observation target is at the vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the platform. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable" style="background-color:Cornsilk"<br />
|'''Standard name'''<br />
|sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|The horizontal angle with the observation target at its vertex, one side of the angle points to the reference direction (typically due north) and the other side points to the sensor. The angle is measured clockwise starting from the reference direction. The observation target is a location on the Earth defined by the sensor performing the observations.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_platform_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''platform_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|relative_sensor_azimuth_angle<br />
|-<br />
|'''Canonical units'''<br />
|degree<br />
|-<br />
|'''Definition'''<br />
|Difference between two ''sensor_azimuth_angle'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere; "outgoing" means emitted toward outer space; "spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_mean_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_spectral_radiance'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_stdev_within_collocation_target<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_spectral_radiance'' observations from sensor's adjacent field of views within a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest field of view footprint.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_mean_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|An average of ''toa_outgoing_spectral_radiance'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_outgoing_spectral_radiance_stdev_within_collocation_scene<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Standard deviation of ''toa_outgoing_spectral_radiance'' observations within a collocation scene. Collocation scene is a grouping of sensor's adjacent field of views (FOVs) centered on a collocation target. Collocation target is an area on the Earth's surface at which observations from at least two sensors are collected. Its size is defined by the sensor with the largest FOV footprint. Collocation scene's size is typically about twice the size of its collocation target.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|constant_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Constant term (offset) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable with measured spectral radiance of the reference sensor. "Spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|linear_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|1<br />
|-<br />
|'''Definition'''<br />
|Linear term (slope) of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|quadratic_term_of_spectral_radiance_correction_due_to_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|m2 sr cm-1 mW-1<br />
|-<br />
|'''Definition'''<br />
|Quadratic term of the formula for correcting measured spectral radiance. The correction is derived from intercalibration between the monitored and the reference sensor. The resulting corrected spectral radiance of the monitored sensor becomes comparable to measured spectral radiance of the reference sensor. "Spectral" means per unit wavenumber or as a function of wavenumber. Radiance is the radiant power per unit area in a particular direction per unit of solid angle.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|covariance_between_constant_and_linear_terms_of_spectral_radiance_correction<br />
|-<br />
|'''Canonical units'''<br />
|mW m-2 sr-1 (cm-1)-1<br />
|-<br />
|'''Definition'''<br />
|Covariance between ''constant_term_of_spectral_radiance_correction_due_to_intercalibration'' and ''linear_term_of_spectral_radiance_correction_due_to_intercalibration'' values.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_of_standard_scene<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|"toa" means top of atmosphere. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavenumber. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. The top-of-atmosphere radiance of the standard scene is calculated using a radiative transfer model for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with a sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|toa_brightness_temperature_bias_at_standard_scene_wrt_intercalibration<br />
|-<br />
|'''Canonical units'''<br />
|K<br />
|-<br />
|'''Definition'''<br />
|The difference between top-of-atmosphere (TOA) brightness temperature of the reference sensor and TOA brightness temperature of the monitored sensor. This TOA brightness temperature difference is a measure of the calibration difference between the monitored and reference sensors. Standard scene is a target area with typical Earth surface and atmospheric conditions that is accepted as a reference. Brightness temperature of a body is the temperature of a black body which radiates the same power per unit solid angle per unit area at a given wavenumber. TOA brightness temperature of the standard scene is calculated using a radiative transfer simulation for a given viewing geometry. The resultant top-of-atmosphere spectral radiance is then integrated with each sensor's spectral response function and converted to equivalent brightness temperature.<br />
|}<br />
<br />
----<br />
<br />
====Table Template for Standard Name Proposals====<br />
<br />
<br />
{| class="wikitable"<br />
|'''Standard name'''<br />
|<code>'''''...standard name...'''''</code><br />
|-<br />
|'''Canonical units'''<br />
|<code>'''''...units...'''''</code><br />
|-<br />
|'''Definition'''<br />
|<code>'''''...text...'''''</code><br />
|}<br />
<br />
<br />
<br />
[[Category: Documentation Cluster]][[category:Climate Forecast Conventions]]</div>Ajelenak