README.md

stactools-glad-glclu2020

• Name: glad-glclu2020
• Package: stactools.glad_glclu2020
• stactools-glad-glclu2020 on PyPI
• Owner: @hrodmn
• Dataset homepage
• STAC extensions used:
  • proj
  • item-assets
  • scientific
  • version
  • classification
  • render
• Browse the example in human-readable form
  • glad-glclu2020-v2
  • glad-glclu2020-change-v2
• Browse a notebook demonstrating the example item and collection

A short description of the package and its usage.

STAC examples

• Collection
• Item

Installation

pip install stactools-glad-glclu2020

Command-line usage

By default, stactools-glad-glclu2020 will assume that you are generating STAC metadata for the original files which are stored in a Google storage container and publicly available over HTTP.

stac gladlclu2020 create-collection \
  --sample-asset-href https://storage.googleapis.com/earthenginepartners-hansen/GLCLU2000-2020/v2/2000/50N_090W.tif \
  {destination}

stac gladlclu2020 create-item \
  https://storage.googleapis.com/earthenginepartners-hansen/GLCLU2000-2020/v2/2000/50N_090W.tif \
  {destination}

Warning

These files are not cloud-optimized geotiffs (COGs)! Be aware that this has major performance implications for applications that consume the data from these assets.

If you have created your own copy of the data in a different storage container, you can provide a custom URL format for the assets with the --href-format parameter in the create-item command:

stac gladlclu2020 create-collection \
  --sample-asset-href {sample_tif_url} \
  {destination}

stac gladlclu2020 create-item \
  --href-format s3://bucket/glad/GLCLU2000-2020/{version}/{year}/{loc}.tif \
  {cog_href} \
  {destination}

Use stac glad-glclu2020 --help to see all subcommands and options.

Contributing

We use pre-commit to check any changes. To set up your development environment:

uv venv && uv sync --extra dev
uv run pre-commit install

To check all files:

uv run pre-commit run --all-files

To run the tests:

uv run pytest -vv

If you've updated the STAC metadata output, update the examples:

uv run scripts/update-examples