# Cecil Earth

> Spatial data, ready for analysis.

Cecil is a spatial data platform for enterprise and developer teams. One contract, one integration, 40+ commercial and open spatial datasets — curated by scientists and ready for your workflows.

## Getting started

```bash
pip install cecil
export CECIL_API_KEY="your-api-key"
```

Sign up and get an API key: https://docs.cecil.earth/getting-started

## What Cecil does

Cecil provides a unified API and Python SDK for:
- Discovering and browsing geospatial datasets
- Subscribing to datasets over a geographic area of interest
- Loading data directly as xarray Datasets or pandas DataFrames
- Receiving webhook notifications when data is delivered

## Available dataset categories

### Plant Biomass
Aboveground biomass stock and change at 10–30 m resolution, annual global coverage from 2000.
Providers: Chloris, Sylvera, Planet, UMD

### Threatened Species
IUCN Red List, Key Biodiversity Areas, World Database of Protected Areas — for biodiversity planning and TNFD disclosures.
Providers: IBAT, IUCN, WDPA

### Biodiversity Integrity
Biodiversity Intactness Index and Forest Landscape Integrity at 300 m–10 km, aligned with SBTN targets.
Providers: NHM, WCS

### Land Use & Cover
Global and US LULC in 9–17 class schemas at 3–30 m across multiple epochs.
Providers: Impact Observatory, JRC, WRI, USGS

### Soil Moisture
Surface soil moisture at 20 m–1 km sub-monthly, plus Planet Soil Water Content.
Providers: Lobelia Earth, Planet

### Asset Locations
Global Major Mines and industrial asset footprints for supply chain due diligence and TNFD reporting.
Providers: PlanetSapling

### Climate & Risk
Coastal flood, cyclone, fluvial flood, and wildfire hazard diagnostics at 1–11 km, 1980–2080.
Providers: Emmi

## Quick example

```python
import cecil

client = cecil.Client()

# Define your area of interest
aoi = client.create_aoi(
    external_ref="Chaco Region",
    geometry={
        "type": "Polygon",
        "coordinates": [[
            [-60.530404375, -20.809574274],
            [-60.530404375, -21.173552046],
            [-59.99196906, -21.173552046],
            [-59.99196906, -20.809574274],
            [-60.530404375, -20.809574274],
        ]]
    }
)

# Subscribe to a dataset
subscription = client.create_subscription(
    external_ref="Forest change - Chaco",
    aoi_id=aoi.id,
    dataset_id="9659ec1d-7091-4f8b-9db5-e9fe07d2f508"
)

# Load as xarray when delivered
ds = client.load_xarray(subscription.id)
```

## Use cases

- TNFD biodiversity and nature-related financial disclosures
- Carbon accounting and MRV workflows
- Supply chain due diligence and screening
- Data center and infrastructure site selection
- Deforestation monitoring
- Agricultural risk and drought monitoring

## Links

- Documentation: https://docs.cecil.earth
- Getting started: https://docs.cecil.earth/getting-started
- SDK reference: https://docs.cecil.earth/sdk
- Contact / sales: https://cecil.earth/contact-us