stactools-usda-cdl
- Name: usda-cdl
- Package:
stactools.usda_cdl - PyPI: https://pypi.org/project/stactools-usda-cdl/
- Owner: @gadomski, @pholleway
- Dataset homepage: https://www.nass.usda.gov/Research_and_Science/Cropland/Release/index.php
- STAC extensions used:
- Extra fields:
usda_cdl:type: The item type.
- Browse the example in human-readable form
A stactools package for USDA Cropland Data Layer (CDL) product.
The USDA Cropland Data Layer (CDL) is a crop-specific land cover data layer. The data is provided at 30 m resolution over the Contiguous United States (CONUS) from 2008 to Present. The USDA CDL is produced using satellite imagery from the Landsat 8 OLI/TIRS sensor, the ISRO ResourceSat-2 LISS-3, and the ESA SENTINEL-2 sensors collected during the current growing season.
This package can generate STAC files from TIFF files that link to the Cloud-Optimized GeoTiff (COG) files.
Item types
There are three primary item types in this dataset:
cropland: Yearly crop-cover classification dataset, optionally with a confidence product.cultivated: A boolean raster describing whether a given pixel was "cultivated" in the target year.frequency: A set of four rasters that describe how often four main crop types were planted in the past fourteen years.
Examples
There is an example collection at examples/collection.json.
Tiling
While this stactools package can create items for the original, CONUS-wide GeoTIFFS, it also supports tiling the data into more manageable sized Cloud-Optimized GeoTIFFs. To tile a GeoTIFF:
stac usda-cdl tile --size 500 tests/data-files/2021_30m_cdls.tif tiles
If you have a bunch of hrefs to existing tiles, you can use stac.create_items_from_tiles to intelligantly partition those hrefs by product type and tile:
from stactools.usda_cdl import stac
from pathlib import Path
hrefs = list(Path("tests/data-files/tiles").glob("*.tif"))
items = stac.create_items_from_tiles(hrefs)
Installation
pip install stactools-usda-cdl
Command-line Usage
Use stac usda-cdl --help to see all subcommands and options.
Collection
Create a collection:
stac usda-cdl create-collection collection.json
Item
Create an item:
stac usda-cdl create-item /path/to/source/file.tif item.json
Get information about all options for item creation:
stac usda-cdl 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
Metadata
Release files for stactools-usda-cdl 0.1.3
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-usda-cdl-0.1.3.tar.gz | 16.4 kB | Without provenance | Details for stactools-usda-cdl-0.1.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| stactools_usda_cdl-0.1.3-py3-none-any.whl | Python 3 | none | any | Details for stactools_usda_cdl-0.1.3-py3-none-any.whl |
Total release size: 31.8 kB
Release files / stactools-usda-cdl-0.1.3.tar.gz
| Download URL | stactools-usda-cdl-0.1.3.tar.gz |
|---|---|
| Size | 16.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
59c9bf15ced18964c81de73a2afdb9520ed66523ee5e1c5136d92a8cd6803eca
|
|
BLAKE2b-256 checksum How to use checksums |
9504d09167110d186beecb47ccf083faf9c781ab7bd22301d86cedea2b78d578
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.2
|
Release files / stactools_usda_cdl-0.1.3-py3-none-any.whl
| Download URL | stactools_usda_cdl-0.1.3-py3-none-any.whl |
|---|---|
| Size | 15.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e4c79c87930d0a2323bd0cccbe29869c2ed74b40959321f44905897da0887bbe
|
|
BLAKE2b-256 checksum How to use checksums |
349a06c0ed864531d6a4d33a62321fffc2aa562783749b67a911ca13772dd329
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/4.0.2 CPython/3.11.2
|
Security for stactools-usda-cdl 0.1.3
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.