PySTAC

PySTAC 是一个用于在 Python 3 中处理 SpatioTemporal Asset Catalog 规范的库。

安装

从 PyPi 安装（推荐）

python -m pip install pystac

如果您希望启用利用 jsonschema 项目的验证功能，请安装可选的 validation 依赖项：

python -m pip install 'pystac[validation]'

如果您希望使用 orjson 而不是 标准的 json 库进行 JSON 序列化/反序列化，请使用 可选的 orjson 依赖项进行安装：

python -m pip install 'pystac[orjson]'

如果您希望在使用 PySTAC 读取时，使用自定义的 RetryStacIO 类来自动重试网络请求，或者如果您的 URL 中包含非 ASCII 字符，您将需要 urllib3:

python -m pip install 'pystac[urllib3]'

如果您正在使用 jupyter notebooks 并希望启用 pystac 对象的漂亮显示，您需要 jinja2

python -m pip install 'pystac[jinja2]'

从源码安装

git clone https://github.com/stac-utils/pystac.git
cd pystac
python -m pip install .

参见安装页面 以获取更多选项。

版本控制

核心 PySTAC API 遵循语义化版本控制。 截至2026 年春天，我们的扩展实现已迁移到独立的 Python 包中，因此可以独立于核心 PySTAC API 进行版本控制。 扩展包 API 的破坏性变更在 PySTAC 版本控制的目的下_不_被视为破坏性变更。

STAC 扩展包的 MAJOR 和 MINOR 版本将与扩展本身版本匹配，例如 pystac-ext-projection v2.0.0 对应 projection 扩展的 v2.0.0 版本。 对软件（而非扩展）的任何更改将通过 PATCH 版本发布。

文档

参见文档页面以获取最新文档。

开发

参见贡献文档 以了解如何为本项目做出贡献的详细信息。

运行快速入门和教程

在 docs/tutorials 文件夹中有一个以 jupyter notebook 编写的快速入门和教程。 要运行这些 notebook，请在以 docs 目录作为 notebook 目录的情况下运行 jupyter notebook：

jupyter notebook --ip 0.0.0.0 --port 8888 --notebook-dir=docs

然后您可以导航到笔记本并执行它们。

需要安装 Jupyter。