This project provides a Python library for working with the SpatioTemporal Asset Catalog (STAC) extension for Montandon. It extends the capabilities of PySTAC to handle disaster and hazard-related data using the Montandon schema.
- Extend STAC Collections and Items with Montandon-specific properties.
- Support for hazard detail objects.
- Integration with GDACS data sources.
- Utilities for pairing and correlation ID generation.
To install the library, use pip:
pip install pystac_montyThe library provides classes and functions to work with Montandon STAC objects. Here is an example of how to create a Montandon Item:
import pystac
from pystac_monty.extension import MontyExtension
item = pystac.Item(...) # Create or load a STAC Item
monty_ext = MontyExtension.ext(item)
monty_ext.episode_number = 1
print(monty_ext.episode_number)To transform GDACS event data into STAC Items:
from pystac_monty.sources.gdacs import GDACSTransformer, GDACSDataSource
data_source = GDACSDataSource(source_url="...", data="...", type=GDACSDataSourceType.EVENT)
transformer = GDACSTransformer(data=[data_source])
items = transformer.make_items()To set up the development environment:
pip install uv
uv syncTo run the tests:
- Make the test with actual calls to http and write them in the cassette files:
uv run pytest -v -s --record-mode rewrite- Run the tests with the recorded calls:
uv run pytest -v -sContributions are welcome! Please open an issue or submit a pull request.
This project is licensed under the Apache License, Version 2.0. See the LICENSE file for more details.