stactools-viirs

• Name: viirs
• Package: stactools.viirs
• PyPI: https://pypi.org/project/stactools-viirs/
• Owner: @pjhartzell
• Dataset homepage: https://viirsland.gsfc.nasa.gov/index.html
• STAC extensions used:
  • classification
  • eo
  • item-assets
  • proj
  • raster
  • scientific
• Extra fields:
  • viirs:horizontal-tile
  • viirs:vertical-tile
  • viirs:tile-id

Use this repository to create STAC Items and Collections for VIIRS data.

STAC Examples

There is an example Collection and Item for each VIIRS product supported by this repository in the examples directory.

Installation

pip install stactools-viirs

Command-line Usage

To create a single STAC Item from a VIIRS H5 file:

$ stac viirs create-item <H5 file path> <output directory>

To create COGs for each subdataset in the H5 file and include them as Assets in the STAC Item, append the -c flag to the command.

To create a STAC Collection, enter H5 file paths into a text file with one file path per line. Then pass the text file to the create-collection command:

$ stac viirs create-collection <text file path> <output directory>

If the text file contains H5 file paths from multiple VIIRS products, multiple STAC Collections will be created. If COGs exist alongside the H5 files, they will be included as Assets in the STAC Items contained in the Collection(s). For example, if COGs exist for all H5 files in examples/file-list.txt, then the example Collections and Items can be created with:

$ stac viirs create-collection examples/file-list.txt examples --antimeridian-strategy normalize

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

Contributing

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

$ pip install -e .
$ pip install -r requirements-dev.txt
$ pre-commit install

To check all files:

$ pre-commit run --all-files

To run the tests:

$ pytest -vv