insula-earthcode-publication-tool 1.0.6

Insula EarthCODE Publication Tool

Insula EarthCODE Publication Tool

Use this tool to generate templates with placeholder values for the EarthCODE project. This tool can be used both as an import and as a CLI command.

To install use:

pip install insula-earthcode-publication-tool

- Template Generator:

CLI

  -h, --help            show this help message and exit
  -p, --project         If present generate a project template with the same name
  -w, --workflow        If present generate a workflow template with the same name
  -t TARGET, --target TARGET
                        The target location where the templates will be generated.

Example usage using local code:

python template_generator.py -p -w -t targetdir

or using the equivalent custom command after installation:

insula_earthcode_template_gen -p -w -t targetdir

Import

For usage inside notebooks just install the package, import it and call the generate_template() function. generate_template(project, workflow, target) Example usage equivalent to previous CLI call:

from insula_earthcode_publication_tool import generate_template

generate_template(project=True, workflow=True, target="targetdir")

- STAC Json Generator:

After filling the templates with the correct informations for a new product or workflow, the following command can generate a STAC json conform to the Open Science Catalog.

The generated project_collection.json shall be moved to catalog/projects/{project-id}/collection.json in the OSC.
The generated workflow_record.json shall be moved to catalog/workflows/{workflow-id}/record.json in the OSC

CLI

  -h, --help            show this help message and exit
  -p PROJECT, --project PROJECT
                        Project YAML template location
  -w WORKFLOW, --workflow WORKFLOW
                        Workflow YAML template location
  -t TARGET, --target TARGET
                        The target location where the STAC jsons will be created.

Example usage using local code:

python stac_generator.py -p templ/project.yaml -w templ/workflow.yaml -t targetdir

or using the equivalent custom command after installation:

insula_earthcode_stac_gen -p templ/project.yaml -w templ/workflow.yaml -t targetdir

Import

For usage inside notebooks just install the package, import it and call the generate_stac() function. generate_stac(project, workflow, target) Example usage equivalent to previous CLI call:

from insula_earthcode_publication_tool import generate_stac

generate_stac(project="templ/project.yaml", workflow="templ/workflow.yaml", target="targetdir")