stactools-usda-cdl

• 名称：usda-cdl
• 包： stactools.usda_cdl
• PyPI： https://pypi.ac.cn/project/stactools-usda-cdl/
• 所有者：@gadomski, @pholleway
• 数据集主页： https://www.nass.usda.gov/Research_and_Science/Cropland/Release/index.php
• 使用的STAC扩展
  • 分类
  • 项目资产
  • 投影
  • 栅格
• 额外字段
  • usda_cdl:type： 项目类型。
• 以可读形式浏览示例

用于美国农业部农田数据层(CDL)产品的stactools包。

美国农业部农田数据层(CDL)是一个作物特定的土地覆盖数据层。数据以30米分辨率覆盖美国大陆（CONUS），时间从2008年到现在。美国CDL使用Landsat 8 OLI/TIRS传感器、ISRO ResourceSat-2 LISS-3和ESA SENTINEL-2传感器在当前生长季节收集的卫星图像生成。

此包可以将链接到云优化地理标签(COG)文件的TIFF文件生成STAC文件。

项目类型

此数据集中有三个主要的项目类型

• cropland：年作物覆盖分类数据集，可选带有置信度产品。
• 耕种: 一个布尔栅格，描述在目标年份中给定像素是否“耕种”。
• 频率：一组四个栅格，描述过去十四年中四种主要作物类型被种植的频率。

示例

示例集合在 examples/collection.json。

瓦片化

虽然这个stactools包可以创建原始的、覆盖整个CONUS的GeoTIFFS，但它也支持将数据瓦片化为更易于管理的云优化GeoTIFFs。要将GeoTIFF瓦片化

stac usda-cdl tile --size 500 tests/data-files/2021_30m_cdls.tif tiles

如果您有一堆指向现有瓦片的href，您可以使用 stac.create_items_from_tiles 智能地按产品类型和瓦片对这些href进行分区

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)

安装

pip install stactools-usda-cdl

命令行用法

使用 stac usda-cdl --help 查看所有子命令和选项。

集合

创建一个集合

stac usda-cdl create-collection collection.json

项目

创建一个项目

stac usda-cdl create-item /path/to/source/file.tif item.json

获取有关项目创建所有选项的信息

stac usda-cdl create-item --help

贡献

我们使用 pre-commit 来检查任何更改。要设置您的开发环境

pip install -e .
pip install -r requirements-dev.txt
pre-commit install

检查所有文件

pre-commit run --all-files

运行测试

pytest -vv