Skip to content

stactools-packages/geoparquet-items

Repository files navigation

stactools-geoparquet-items

PyPI

Uses stac-geoparquet to generate a geoparquet for a list of STAC items.

Installation

pip install stactools-geoparquet-items

Command-line Usage

Use stac geoparquet-items --help to see all subcommands and options.

Create GeoParquet from STAC Items

You need to provide a folder to read the items (deeply) from. Then you provide a file to write the geoparquet to. Optionally, you can add the geoparquet as an asset to a STAC Collection.

stac geoparquet-items create https://example.com/collections/id/items result.geoparquet
stac geoparquet-items create /path/to/folder result.geoparquet --collection /path/to/collection.json

Convert from GeoParquet to other file formats

Convert from geoparquet to GeoPackage (without stac_version, type and assets):

stac geoparquet-items convert source.geoparquet result.gpkg

Convert to FlatGeoBuf and exclude even more fields:

stac geoparquet-items convert source.geoparquet result.fgb --format flatgeobuf --exclude stac_version,type,assets,links,collection

Supported formats: flatgeobuf, geojson, geojsonseq, gpkg (default), shapefile

Show information about a geoparquet file

You can easily retrieve metadata and a data excerpt:

stac geoparquet-items info source.geoparquet

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