stactools package for USDA Cropland Data Layer
Project description
stactools-usda-cdl
- Name: usda-cdl
- Package:
stactools.usda_cdl
- PyPI: https://pypi-hypernode.com/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
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file stactools-usda-cdl-0.1.3.tar.gz
.
File metadata
- Download URL: stactools-usda-cdl-0.1.3.tar.gz
- Upload date:
- Size: 16.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 59c9bf15ced18964c81de73a2afdb9520ed66523ee5e1c5136d92a8cd6803eca |
|
MD5 | a05590c0237c9a9696f01a3a75452d20 |
|
BLAKE2b-256 | 9504d09167110d186beecb47ccf083faf9c781ab7bd22301d86cedea2b78d578 |
Provenance
File details
Details for the file stactools_usda_cdl-0.1.3-py3-none-any.whl
.
File metadata
- Download URL: stactools_usda_cdl-0.1.3-py3-none-any.whl
- Upload date:
- Size: 15.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.11.2
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e4c79c87930d0a2323bd0cccbe29869c2ed74b40959321f44905897da0887bbe |
|
MD5 | 261a15db8ee998b742b5ae5afdd18e0e |
|
BLAKE2b-256 | 349a06c0ed864531d6a4d33a62321fffc2aa562783749b67a911ca13772dd329 |