Home

This wiki is intended to document the possible configuration options for the STAC catalog generator. Currently the options are changing rapidly, once a stable state is reached a version should be assigned to be able to describe changes between versions.

Catalog

A catalog instance can be configured by creating a yaml file in the catalogs folder. The file can be configured with following parameters:

Element	Type	Description
id	string	Identifier string used for the collection, no catalog should repeat the id used
title	string	Title added to catalog file, shown by STAC clients
description	string	Description added to catalog file. Markdown may be used for rich text representation.
endpoint	string	Expected url where catalog will be deployed
assets_endpoint	string	Url base path to where locations will be deployed
collections	[string]	List of collections that will be part of the catalog, have to match file names of collections configured in the collections folder (without the extension)

Collection

A collections can be defined by creating a yaml file in the collections folder. The collection can be configured with following parameters:

Element	Type	Description
Name	string	Identifier used for the collection, should not match any other identifier of a collection used in the same catalog.
Title	string	Title used to describe the collection
EodashIdentifier	string	Identifier that will be used within the eodash client
Subtitle	string	Possible subtitle text (currently not represented in eodash client)
Description	string	Can be either a text string (allowing markdown) or relative path (which root is taken from the assets_endpoint configured for the catalog) to a markdown file (with .md extension)
Themes	[string]	List of theme strings that represent the collection
Tags	[string]	List of tag strings that represent the collection
Satellite	[string]	List of satellite strings that represent the collection
Sensor	[string]	List of sensor strings that represent the collection
Agency	[string]	List of agency strings that represent the collection
License	[string]	Collection's license(s), either a SPDX License identifier, various if multiple licenses apply or proprietary for all other cases.
Locations	[Locations]	List of locations of the collection
Provider	[Provider]	List of providers of the collection
Citation	Citation	Citation object containing information on citation aspects of data
Image	string	Relative path (which root is taken from the assets_endpoint configured for the catalog) to a preview image file
Legend	string	Relative path (which root is taken from the assets_endpoint configured for the catalog) to colormap legend image file
Subcollections	[Subcollections]	List of Subcollections that are integrated into the defined collection. When used no Resources should be defined, thes Resources of the linked subcollections are used.
Resources	[Resource]	REQUIRED (if no Subcollections are specified) List of resources` provided by the collection (typically will only be one resource)
Services	[Service]	List of services provided by the collection (typically will only be one service)

Citation

Based on the STAC scientific extension.

Element	Type	Description
DOI	string	The DOI of the data, e.g. 10.1000/xyz123. This MUST NOT be a DOIs link
Citation	string	The recommended human-readable reference (citation) to be used by publications citing the data
Publications	[Publication]	List of relevant publications referencing and describing the data

Publication

Element	Type	Description
DOI	string	The DOI of a publication referencing the data. This MUST NOT be a DOIs link.
Citation	string	Citation of a publication referencing the data.

Example citation:

Citation:
    Citation: This string needs to be added when using the data
    DOI: 10.5061/dryad.s2v81.2
    Publication:
        - Citation: Citation string of publication
          DOI: 10.5061/dryad.s2v81.3
        - Citation: Another string of publication
          DOI: 10.5061/dryad.s2v81.4