stactools-glad-global-forest-change

• Name: glad-global-forest-change
• Package: stactools.glad_global_forest_change
• stactools-glad-global-forest-change on PyPI
• Owner: @hrodmn
• Dataset homepage
• STAC extensions used:
  • proj
• Browse the example in human-readable form
• Browse a notebook demonstrating the example item and collection

STAC examples

• Collection
• Item

Installation

pip install stactools-glad-global-forest-change

Command-line usage

By default, stactools-glad-global-forest-change 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 gladglobalforestchange create-collection \
  --sample-asset-href https://storage.googleapis.com/earthenginepartners-hansen/GFC-2023-v1.11/Hansen_GFC-2023-v1.11_gain_40N_080W.tif \
  {destination}

stac gladglobalforestchange create-item \
  https://storage.googleapis.com/earthenginepartners-hansen/GFC-2023-v1.11/Hansen_GFC-2023-v1.11_gain_40N_080W.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 gladglobalforestchange create-collection \
  --sample-asset-href {sample_tif_url} \
  {destination}

stac gladglobalforestchange create-item \
  --href-format s3://bucket/glad/GFC-2023-v1.11/Hansen_GFC-2023-v1.11_{asset}_{loc}.tif \
  {cog_href} \
  {destination}

Use stac gladglobalforestchange --help to see all subcommands and options.

Contributing

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

uv sync
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