stactools-goes-glm 0.1.0

stactools package for the Geostationary Lightning Mapper (GLM) on the GOES-16/R and GOES-17/S satellites.

stactools-goes-glm

• Name: goes-glm
• Package: stactools.goes_glm
• PyPI: https://pypi.org/project/stactools-goes-glm/
• Owner: @m-mohr
• Dataset homepage:
  • https://www.goes-r.gov/spacesegment/glm.html
  • https://ghrc.nsstc.nasa.gov/lightning/overview_glm.html
• STAC extensions used:
  • datacube (for netCDF only)
  • GOES (unreleased)
  • processing
  • proj
  • table (for geoparquet only)
• Extra fields:
  • Prefix goes:: They have been defined in the GOES extension so that they can be shared across multiple GOES products.
  • Prefix goes-glm:: Variables with valid scalar values / without dimensions are added to the Item properties. The variable name is used as the property key after the prefix, e.g. goes-glm:event_count.

A stactools package for the Geostationary Lightning Mapper (GLM) dataset, which is on the GOES-16/R and GOES-17/S satellites. GLM detects all forms of lightning during both day and night, continuously, with a high spatial resolution and detection efficiency. Note: This package doesn't support GOES-18/T yet.

This package can generate STAC files from netCDF files and that either link to the original netCDF files or to geoparquet files.

STAC Examples

• Collection
• Item (GOES-16/R)
• Item (GOES-17/S)
• Browse the example in a human-readable form

Installation

pip install stactools-goes-glm

Command-line Usage

Collection

Create a collection:

stac goes-glm create-collection collection.json --license=https://www.ncei.noaa.gov/access/metadata/landing-page/bin/iso?id=gov.noaa.ncdc:C01527

Get information about all options for collection creation:

stac goes-glm create-collection --help

Item

Create an item with a netCDF and multiple geoparquet asset:

stac goes-glm create-item OR_GLM-L2-LCFA_G16_s20203662359400_e20210010000004_c20210010000030.nc item.json --collection collection.json

Create an item with only geoparquet assets:

stac goes-glm create-item OR_GLM-L2-LCFA_G17_s20221542100000_e20221542100200_c20221542100217.nc item.json --collection collection.json --nonetcdf TRUE

Get information about all options for item creation:

stac goes-glm create-item --help

Use stac goes-glm --help to see all subcommands and options.

Note: This package can only read files that contain the timestamp in the file name. It can NOT read the files that contain latest instead of a timestamp in the file name.

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