This document covers setting up ingest to track primary and ancillary files under various file types, which will carry through to the CMR and granule record. Cumulus has a number of options for tracking files in granule records, and in CMR metadata under certain metadata elements or with specified file types. We will cover Cumulus file types, file type configuration, effects on CMR metadata, and some common use case examples.
Cumulus follows the Cloud Notification Mechanism (CNM) file type conventions. Under this schema, there are four data types:
In Cumulus, these data types are mapped to the
Type attribute on
RelatedURLs for UMM-G metadata, or used to map
resources to one of
AssociatedBrowseImages for ECHO10 XML metadata.
File Type Configuration
File types for each file in a granule can be configured in a number of different ways, depending on the ingest type and workflow. For more information, see the ancillary metadata documentation.
When updating granule CMR metadata, the
UpdateGranulesCmrMetadataFileLinks task will add the external facing URLs to the CMR metadata file based on the file type.
The table below shows how the CNM data types map to CMR metadata updates. Non-CNM file types are handled as 'data' file types.
The UMM-G column reflects the
Type derived from the CNM type, whereas the ECHO10 column shows how the CNM type affects the destination element.
|CNM Type||UMM-G ||ECHO10 Location|
Common Use Cases
This section briefly documents some common use cases and the recommended configuration for the file. The examples shown here are for the DiscoverGranules use case, which allows configuration at the Cumulus dashboard level. The other two cases covered in the ancillary metadata documentation require configuration at the provider notification level (either CNM message or PDR) and are not covered here.
Configuring browse imagery:
Configuring a documentation entry:
Configuring other associated files (use types
qa as appropriate):