stac2odc is a tool created to facilitate indexing data in the Open Data Cube (ODC) using the information provided by STAC catalogs.
To allow different users to enjoy the benefits of indexing data in the ODC via STAC, stac2odc was developed to support several STAC versions, with varied ways of implementing and organizing resources. This is possible thanks to engine files, which are definition files of how the mapping between STAC and ODC entities should be done.
The engine files have different keys and ways to describe the mapping that is being done. With these files, it is possible to describe the mapping with predefined functions, which have advanced and straightforward mapping options. Still, it is also possible to use customized scripts, which receive the data and allow complex rules to be described.xing products and datasets in an ODC instance.
To start using stac2odc it is necessary to install it. The following command can be used for this activity.:
pip install git+https://github.com/brazil-data-cube/stac2odc
or:
git clone https://github.com/brazil-data-cube/stac2odc \
&& cd stac2odc \
&& python3 setup.py install
After installation, the tool will be ready for use:
$ stac2odc Usage: stac2odc [OPTIONS] COMMAND [ARGS]... :return: Options: --help Show this message and exit. Commands: collection2product Function to convert a STAC Collection JSON to ODC... item2dataset Function to convert a STAC Collection JSON to ODC...
Two operations are available with the tool
collection2product: This function is used to convert STAC Collections into ODC Productsitem2dataset: This function converts STAC Assets into ODC ODC Datasets
The complete documentation with all the options for using the tool is still being produced. However, it is possible to consume some usage examples available in the directory examples.