stactools-esa-cci-lc
- Name: esa-cci-lc
- Package:
stactools.esa_cci_lc - stactools-esa-cci-lc on PyPI
- Owner: @m-mohr
- Dataset homepage:
- STAC extensions used:
- Extra fields:
- None
A stactools package for ESA's Climate Change Initiative (CCI) Land Cover (LC) product.
This dataset provides global maps describing the land surface classes, which have been defined using the United Nations Food and Agriculture Organization's (UN FAO) Land Cover Classification System (LCCS). In addition to the land cover (LC) maps, four quality flags are produced to document the reliability of the classification and change detection. In order to ensure continuity, these land cover maps are consistent with the series of global annual LC maps from the 1990s to 2015 produced by the European Space Agency (ESA) Climate Change Initiative (CCI).
This package can generate STAC files from netCDF files and that either link to the original netCDF files or to Cloud-Optimized GeoTiff (COG) files.
STAC Examples
Installation
pip install stactools-esa-cci-lc
Command-line Usage
Use stac esa-cci-lc --help to see all subcommands and options.
Collection
Create a collection:
stac esa-cci-lc create-collection collection.json
Get information about all options for collection creation:
stac esa-cci-lc create-collection --help
Item
Create an item with netCDF and COG assets:
stac esa-cci-lc create-item /path/to/source/file.nc item.json --collection collection.json
Create an item with only COG assets:
stac esa-cci-lc create-item /path/to/source/file.nc item.json --collection collection.json --nonetcdf TRUE
Get information about all options for item creation:
stac esa-cci-lc create-item --help
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
Tests
Due to the large file sizes, the data files for the tests are missing in this repository.
To run the tests, please download the files for 1992, 2015, 2016 and 2020 from the
Climate Data Store.
You can download them all at once in a ZIP or gzipped TAR file and then extract the .nc files
to the tests/data-files/external folder.
The CI doesn't run any tests for item generation due to the missing data files. Please ensure you've tested the changes against the data files locally!
Also, due to the long processing time of the tests with COGs conversion (in total 3-4 hours on
my local machine), the tests by default run without COG processing (i.e. --nocog is enabled).
To run the tests with COG generation, please run pytest -vv --withcog.
Metadata
Release files for stactools-esa-cci-lc 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| stactools-esa-cci-lc-0.1.0.tar.gz | 15.4 kB | Without provenance | Details for stactools-esa-cci-lc-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| stactools_esa_cci_lc-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for stactools_esa_cci_lc-0.1.0-py3-none-any.whl |
Total release size: 32.4 kB
Release files / stactools-esa-cci-lc-0.1.0.tar.gz
| Download URL | stactools-esa-cci-lc-0.1.0.tar.gz |
|---|---|
| Size | 15.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d0b6bd41f26703177eaf7fa3f9ee21548bf397fc53c9e1a000121bf29758c237
|
|
BLAKE2b-256 checksum How to use checksums |
ea010ef290be95522baf6dc5edc5911f511f18774b3876523a0b87e029c7cbeb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.1
|
Release files / stactools_esa_cci_lc-0.1.0-py3-none-any.whl
| Download URL | stactools_esa_cci_lc-0.1.0-py3-none-any.whl |
|---|---|
| Size | 17.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
da37530cccaf9e9d1a717917e47b5488a07ea29b258b42943f84527749b1e7df
|
|
BLAKE2b-256 checksum How to use checksums |
c14f3831d676d5323ca774a2ac5dbf4545bd26d56774bdce75bff783093b1d9d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.1
|
Security for stactools-esa-cci-lc 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.