Page History
Table of Contents | ||
---|---|---|
|
Element Description
The archive and distribution information main element allows data providers to provide users information of what is available for downloading when they are initially looking at a collection. The end users get information such as the average downloadable file size, format, mime type, checksum, an estimate of the collection's entire downloadable file size, etc.
Best Practices
There are multiple sub-elements that comprise Archive and Distribution Information for Collections:
Format: Defines a single format for an archival artifact (e.g., binary, jpeg, HDF5, HDF-EOS5, geotiff)
Format Type: Allows the provider to define if the archival artifact's format is in its native format or another supported format
Average File Size: An approximate average of the size of the the archivable item, which gives users an idea of the magnitude of each archivable file
Average File Size Unit: Unit of measure for the average file size (e.g., KB, MB, TB)
Total Collection File Size: An approximate total size of the archivable items, which gives users an idea of the magnitude of all the archivable files combined
Total Collection File Size Unit: Unit of measure for the total collection file size (e.g., KB, MB, TB)
Total Collection File Size Begin Date: The date that data collection began for the collection, which should be in the following format: yyyy-MM-ddTHH:mm:ssZ
Description: Enables the provider to provide more information about the archivable item
Media: Defines how the distributable material can be obtained by an end user (e.g., CD-ROM, hard drives, online, etc.)
Fees: Provide the price an end user will need to pay in order to obtain the distributable material
Examples:
Format Type: "Native"
Average File Size: "250"
Average File Size Unit: "KB"
Total Collection File Size: "25"
Total Collect File Size Unit: "GB"
Total Collection File Size Begin Date: "2018-04-01T00:00:00Z"
Element Specification
Cardinality of Archive and Distribution Information:
Model | Element | Type | Usable Valid Values | Constraints | Required? | Cardinality | Notes |
---|---|---|---|---|---|---|---|
UMM-Common | ArchiveAndDistributionInformation/ FileArchiveInformation/ Format | String | 1 - 80 characters | Yes | 1 | ||
UMM-Common | ArchiveAndDistributionInformation/ FileArchiveInformation/FormatType | String | Native Supported | n/a | No | 0..1 | |
UMM-Common | ArchiveAndDistributionInformation/ FileArchiveInformation/ AverageFileSize | Decimal | Yes, if TotalCollectionFileSizeBeginDate is used. | 0..1 | |||
UMM-Common | ArchiveAndDistributionInformation/ FileArchiveInformation/ AverageFileSizeUnit | String | KB MB GB TB PB NA | n/a | Yes, if AverageFileSize is used. | 0..1 | |
UMM-Common | ArchiveAndDistributionInformation/ FileArchiveInformation/ TotalCollectionFileSize | Decimal | No | 0..1 | Either use TotalCollectionFileSize or TotalCollectiopnFileSizeBeginDate | ||
UMM-Common | ArchiveAndDistributionInformation/ FileArchiveInformation/ TotalCollectionFileSizeUnit | Enumeration | KB MB GB TB PB NA | n/a | Yes, if TotalCollectionFileSize is used | 0..1 | |
UMM-Common | ArchiveAndDistributionInformation/ FileArchiveInformation/ TotalCollectionFileSizeBeginDate | Date | No | 0..1 | Either use TotalCollectionFileSize or TotalCollectiopnFileSizeBeginDate | ||
UMM-Common | ArchiveAndDistributionInformation/ FileArchiveInformation/ Description | String | n/a | 1 - 1024 characters | No | 0..1 | |
ArchiveAndDistributionInformation/ FileDistributionInformation/Format | String | 1 - 80 characters | Yes | 1 | |||
ArchiveAndDistributionInformation/ FileDistributionInformation/ FormatType | String | Native Supported | No | 0..1 | |||
UMM-Common | ArchiveAndDistributionInformation/ FileDistributionInformation/ Media | String | n/a | 1 - 80 characters | No | 0..1 | |
UMM-Common | ArchiveAndDistributionInformation/ FileDistributionInformation/ AverageFileSize | Decimal | n/a | n/a | Yes, if TotalCollectionFileSizeBeginDate is used. | 0..1 | |
UMM-Common | ArchiveAndDistributionInformation/ FileDistributionInformation/ AverageFileSizeUnit | Enumeration | KB MB GB TB PB NA | Yes, if AverageFileSize is used. | 0..1 | ||
UMM-Common | ArchiveAndDistributionInformation/ FileDistributionInformation/ TotalCollectionFileSize | Decimal | n/a | No | 0..1 | Either use TotalCollectionFileSize or TotalCollectiopnFileSizeBeginDate | |
UMM-Common | ArchiveAndDistributionInformation/ FileDistributionInformation/ TotalCollectionFileSizeUnit | Enumeration | KB MB GB TB PB NA | n/a | Yes, if TotalCollectionFileSize is used | 0..1 | |
UMM-Common | ArchiveAndDistributionInformation/ FileDistributionInformation/ TotalCollectionFileSizeBeginDate | Date | No | 0..1 | Either use TotalCollectionFileSize or TotalCollectiopnFileSizeBeginDate | ||
UMM-Common | ArchiveAndDistributionInformation/ FileDistributionInformation/ Description | String | n/a | 1 - 1024 characters | No | 0..1 | |
UMM-Common | Fees | String | n/a | 1 - 255 characters | No | 0..1 |
Metadata Validation and QA/QC
All metadata entering the CMR goes through the below process to ensure metadata quality requirements are met. All records undergo CMR validation before entering the system. The process of QA/QC is slightly different for NASA and non-NASA data providers. Non-NASA providers include interagency and international data providers and are referred to as the International Directory Network (IDN).
Lucidchart | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Please see the expandable sections below for flowchart details.
Expand | ||
---|---|---|
| ||
|
Expand | ||
---|---|---|
| ||
|
Expand | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
ARC Automated Checks
|
Dialect Mappings
Expand | ||
---|---|---|
| ||
DIF 9 (Note: DIF-9 is being phased out and will no longer be supported after 2018) |
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DIF 10All of the sub-elements are optional in DIF 10.
|
Expand | ||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||||||||||||||||||
ECHO 10Only 2 UMM-C Archive and Distribution Information sub-elements map to ECHO 10, Data Format and Fees, and providing either sub-neither element is not required.
|
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ISO 19115-2 MENDSArchive and Distribution Information is an optional metadata element in ISO 19115-2 MENDS.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ISO 19115-2 MENDSArchive and Distribution Information is an optional metadata element in ISO 19115-2 MENDS.
| ArchiveAndDistributionInformation/FileDistributionInformation/Description | [=> /gmd:distributor xlink:href="FileDistributionInformation_<Block Number>"/gmd:MD_Distributor/gmd:distributionOrderProcess/gmd:MD_StandardOrderProcess/gmd:orderingInstructions/gmd:CharacterString | ArchiveAndDistributionInformation/FileDistributionInformation/Fees | [=> /gmd:distributor
|
|
Expand | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
ISO 19115-2 SMAPArchive and Distribution Information does not currently map to ISO 19115-2 SMAP.
| ||||||||||||||
Expand | ||||||||||||||
| ||||||||||||||
UMM-C Element | Path | Type | Notes | |||||||||||
N/A | N/A | N/A | N/A | |||||||||||
Section |
Column | ||
---|---|---|
| ||
N/A |
width | 50% |
---|
UMM
ArchiveandDistributionInformation: [
{
AverageFileSizeUnit: "250 B",
},
{
TotalCollectionFileSizeBeginDate: "2018-04-01T00:00:00Z",
}
],
UMM Migration
None
|
UMM Migration
None
Future Mappings
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ISO 19115-1
Example Mapping
|
Future Mappings
Expand | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||
ISO 19115-1Instrument is an optional metadata element, however, it is strongly recommended that it be provided when possible. Multiple Instruments may be listed if necessary (Cardinality: 0..*). Providing instrument characteristics is optional. An unlimited amount of instrument characteristics may be specified for a particular instrument (Cardinality: 0..*). If instrument characteristics are provided, all 5 sub-fields (Name, Description, DataType, Unit, Value) are required. | |||||||||||||||||||||
UMM-C Element | Path | Type | Notes | ||||||||||||||||||
Platforms/Instruments/ShortName | /mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here>"/mac:identifier/mcc:MD_Identifier/mcc:code/gco:CharacterString with /mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here>"/mac:identifier/mcc:MD_Identifier/mcc:codeSpace/gco:CharacterString = gov.nasa.esdis.umm.instrumentshortname | String | Corresponds to the UMM field Platforms/Instruments/ShortName. A list of valid instrument short names can be found in the KMS under the 'Short_Name' column. For each instrument listed the short name is required by CMR. The short name value goes in the gmd:code field. The value of " gov.nasa.esdis.umm.instrumentshortname" should be provided in gmd:CodeSpace field so that CMR can properly parse out the instrument short name. An ID should be provided directly after "eos:EOS_Instrument" in the ISO x-path. This ID corresponds to the instrument and is used to link the instrument information to the associated platform. The ID should be unique within the metadata record. | ||||||||||||||||||
Platforms/Instruments/LongName | /mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here>"/mac:identifier/mcc:MD_Identifier/mcc:description/gco:CharacterString | String | Corresponds to the UMM field Platforms/Instruments/LongName. A list of valid instrument long names can be found in the KMS under the 'Long_Name' column. | ||||||||||||||||||
Platforms/Instruments/Technique | /mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here>"mac:type/gco:CharacterString | String | Corresponds to the UMM field Platforms/Instruments/Technique. | Platforms/Instruments/NumberOfInstruments | When translating to UMM-C the number of instruments is counted. The number is not translated to ISO 19115-2 MENDS | Corresponds to the UMM field Platforms/Instruments/NumberOfInstruments. | /mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here> "/mac:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:type/eos:EOS_AdditionalAttributeTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#EOS_AdditionalAttributeTypeCode" codeListValue="instrumentInformation" = instrumentInformation | Codelist | The "instrumentInformation" codelist value must be provided so that CMR can properly identify the associated information as instrument characteristics. This codelist value does not directly map to a UMM element—choosing 'instrumentInformation' indicates to CMR that the instrument characteristic elements should be mapped. | ||||||||||||
Platforms/Instruments/Characteristics/Name | /mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here> "/mac:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:name/gco:CharacterString | String | Corresponds to the UMM field Platforms/Instruments/Characteristics/Name. | ||||||||||||||||||
Platforms/Instruments/Characteristics/Description | /mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here> "/mac:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:description/gco:CharacterString | String | Corresponds to the UMM field Platforms/Instruments/Characteristics/Description. | ||||||||||||||||||
Platforms/Instruments/Characteristics/DataType | /mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here> "/mac:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:dataType/eos:EOS_AdditionalAttributeDataTypeCode codeList="https://cdn.earthdata.nasa.gov/iso/resources/Codelist/gmxCodelists.xml#MD_DatatypeCode" codeListValue=<date type> value=<data type> | Codelist | Corresponds to the UMM field Platforms/Instruments/Characteristics/DataType. ISO codelist values (class, codelist, enumeration, codelistElement, abstractClass, aggregateClass, specifiedClass, datatypeClass, interfaceClass, unionClass, metaClass, typeClass, characterString, integer, association) UMM enum (STRING, FLOAT, INT BOOLEAN, DATE, TIME, DATETIME, DATE_STRING, TIME_STRING, DATETIME_STRING) | ||||||||||||||||||
Platforms/Instruments/Characteristics/Unit | /mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here> "/mac:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:parameterUnitsOfMeasure/gco:CharacterString | String | Corresponds to the UMM field Platforms/Instruments/Characteristics/Unit. | ||||||||||||||||||
Platforms/Instruments/Characteristics/Value | /mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here> "/mac:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:value/gco:CharacterString | String | Corresponds to the UMM field Platforms/Instruments/Characteristics/Value. | ||||||||||||||||||
Platforms/Instruments/OperationalModes | /mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here> "/mac:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:reference/eos:EOS_AdditionalAttributeDescription/ eos:name/gco:CharacterString="OperationalMode" and /mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here> "/mac:otherProperty/gco:Record/eos:AdditionalAttributes/eos:AdditionalAttribute/eos:value/gco:CharacterString | String | Corresponds to the UMM field Platforms/Instruments/OperationalMode. The eos:name field must read "OperationalMode" so that CMR can properly parse out the operation mode information. The actual operation mode value should be provided in the eos:value field. | /mdb:MD_Metadata/mdb:acquisitionInformation/mac:MI_AcquisitionInformation/mac:instrument/mac:MI_Instrument id="<insert unique instrument ID here>/gmi:mountedOn xlink:href='<insert unique platform ID here>' | An ID should be provided here and should match the ID provided for the associated platform. This ID should be unique within a metadata record. This will link all of the information provided on the instrument to its associated platform. |
Section | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
History
UMM Versioning
Version | Date | What Changed |
---|---|---|
1.13.0 | 04/11/2019 | This element was added to the UMM-C specification. |
ARC Documentation
Version | Date | What Changed | Author |
---|---|---|---|
1.0 | 05/16/18 | Recommendations/priority matrix transferred from internal ARC documentation to wiki space |