---
id: pystac-ext-classification
version: "2.0.1"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pystac-ext-classification — Classification extension for PySTAC

License: permissive · Maintenance: active · Downloads: 4.0M/mo

## What it is and what it does

pystac-ext-classification is a PySTAC extension package that adds support for the STAC Classification Extension specification. It enables developers to attach categorical metadata to raster and vector data items, describing classification schemes with class names, descriptions, color hints, and regional mappings. The package targets multiple versions of the Classification Extension specification (v2.0.0, v1.1.0, v1.0.0) and is versioned to match the extension specification it implements.

The package depends on pystac-core for core STAC functionality and pystac-ext-raster for raster-specific support. It is actively maintained, with a production-stable status and support for Python 3.10 through 3.13. Installation is straightforward via a pure-Python wheel with no compiled dependencies.

Use it for:

- Annotate raster imagery with classification metadata (e.g., land cover classes, confidence scores) in STAC catalogs.
- Define and document classification schemes for machine learning training datasets with class names and color hints.
- Map regional classification variants to the same STAC item for multi-region geospatial workflows.
- Extend PySTAC items with categorical data descriptions for vector features or segmentation masks.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides PySTAC extension support for describing categorical data and classification schemes in raster and vector data, including class names, descriptions, color hints, and regional mappings.

Yes. The package is actively maintained, has no known vulnerabilities, uses a permissive license, and provides essential extension support for STAC-based classification workflows. Install friction is low and Python version support is current. Suitable for projects that need to catalog and describe classified raster or vector data within PySTAC.

## Install

pip install pystac-ext-classification
uv add pystac-ext-classification
poetry add pystac-ext-classification

## Installing pystac-ext-classification

Before you install: Low install friction with a pure-Python wheel. Active maintenance with a recent release (4 days old) and a commit history through 2026-08-10. Requires pystac-core and pystac-ext-raster as runtime dependencies.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions.

Quickstart:

pip install pystac-ext-classification

from pystac_ext_classification import Classification

# Use Classification extension with PySTAC items
classification = Classification.from_dict(item_dict)

Requires Python 3.10 or later.

Verify before relying:

- Whether the extension integrates seamlessly with existing PySTAC workflows or requires specific setup steps.
- Performance characteristics when working with large classification schemes or many regional mappings.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 4.0M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

STAC classification extension, PySTAC categorical data, raster classification metadata, STAC class descriptions, classification scheme for imagery, PySTAC extension, vector data classification, geospatial-metadata, stac-extension, raster-classification

[View on SkillFed](https://skillfed.io/packages/pystac-ext-classification) · [View on PyPI](https://pypi.org/project/pystac-ext-classification/)