Skip to content

Product

cdse.product.Product dataclass

Represents a satellite product from CDSE catalog.

This class wraps the raw STAC feature response and provides convenient access to common properties.

Attributes:

Name Type Description
id str

Unique product identifier

name str

Product name (e.g., S2A_MSIL2A_...)

collection str

Collection name (e.g., sentinel-2-l2a)

datetime Optional[datetime]

Acquisition datetime

cloud_cover Optional[float]

Cloud cover percentage (0-100)

geometry dict[str, Any]

GeoJSON geometry of the product footprint

bbox list[float]

Bounding box [min_lon, min_lat, max_lon, max_lat]

properties dict[str, Any]

Full properties dictionary from STAC response

assets dict[str, Any]

Available assets for download

raw dict[str, Any]

Original STAC feature dictionary

size: Optional[int] property

Get product size in bytes if available.

size_mb: Optional[float] property

Get product size in megabytes.

platform: Optional[str] property

Get satellite platform (e.g., sentinel-2a).

instrument: Optional[str] property

Get instrument (e.g., MSI).

processing_level: Optional[str] property

Get processing level (e.g., L2A).

tile_id: Optional[str] property

Get tile ID for Sentinel-2 products.

orbit_number: Optional[int] property

Get orbit number.

download_url: Optional[str] property

Get direct download URL if available in assets.

from_stac_feature(feature: dict[str, Any]) -> Product classmethod

Create a Product from a STAC feature dictionary.

Parameters:

Name Type Description Default
feature dict[str, Any]

STAC feature dictionary from catalog search

required

Returns:

Type Description
Product

Product instance

__str__() -> str

Return string representation.

__repr__() -> str

Return detailed representation.

to_dict() -> dict[str, Any]

Convert to dictionary.

Returns:

Type Description
dict[str, Any]

Dictionary representation of the product.