Get started with Cecil in a few simple steps.

1. Install the SDK

Install the Cecil SDK in your project virtual environment.

pip install cecil

2. Sign up for an account

Use the SDK to sign up for an account. You will receive an email with instructions to generate your user API key. By signing up, you agree to our pricing and terms.

# The organisation name must start with a letter and
# can only contain alphanumeric characters and spaces.

import cecil

client = cecil.Client()

client.sign_up(
    organisation={
	      "name": "Your organisation name",
    },
    user={
        "first_name": "Your first name",
        "last_name": "Your last name",
        "email": "[email protected]",
    },
)

3. Configure the SDK

Follow the instructions in the email and configure the SDK with your API key.

export CECIL_API_KEY="my-api-key"

set CECIL_API_KEY=my-api-key

4. Create an AOI

Create your first area of interest (AOI) using the geometry object of a GeoJSON in EPSG:4326. Learn more about the AOI specification in the SDK documentation.

import cecil

client = cecil.Client()

aoi = client.create_aoi(
    name="Kakadu National Park",
    geometry={
        "type": "Polygon",
        "coordinates": [
            [
                [132.52934211276073, -12.721072673008706],
                [132.52934211276073, -12.730063400794094],
                [132.54027735328083, -12.730063400794094],
                [132.54027735328083, -12.721072673008706],
                [132.52934211276073, -12.721072673008706]
            ]
        ]
    }
)

print(aoi)

5. Acquire datasets

Create data requests for your AOI and let Cecil integrate with data providers for you. You can find the dataset_id on the details page of available datasets.

This step runs in the background and the processing time varies from a few hours to a few business days depending on the data provider.

import cecil

client = cecil.Client()

kanop_data_request = client.create_data_request(
    aoi_id="my-aoi-id",
    dataset_id="kanop-dataset-id",
)

planet_data_request = client.create_data_request(
    aoi_id="my-aoi-id",
    dataset_id="planet-dataset-id",
)

print(kanop_data_request)
print(planet_data_request)

6. Make datasets joinable

Create transformations to make all datasets consistent and joinable with your preferred CRS and spatial resolution. In this example, a spatial resolution of 0.00025 degrees represents 27.8 metres at the equator. Learn more about transformations in the SDK documentation.