Skip to main content

Tilebox Logo

Documentation | Console | Example Gallery

Tilebox Storage

Download satellite payload data for your Tilebox datasets.

Quickstart

Install using pip:

pip install tilebox-storage tilebox-datasets

Fetch a datapoint to download the payload data for:

from tilebox.datasets import Client


# Creating clients
client = Client(token="YOUR_TILEBOX_API_KEY")
datasets = client.datasets()

# Choosing the dataset and collection
s2_dataset = datasets.open_data.copernicus.sentinel2_msi
collections = s2_dataset.collections()
collection = collections["S2A_S2MSI2A"]

# Loading metadata
s2_data = collection.load(("2024-08-01", "2024-08-02"), show_progress=True)

# Let's download the first granule
s2_granule = s2_data.isel(time=0)

Then download the payload data using a storage client:

from pathlib import Path
from tilebox.storage import CopernicusStorageClient

# Check out the Copernicus Dataspace S3 documentation at
# https://documentation.dataspace.copernicus.eu/APIs/S3.html
# to learn how to get your access key and secret access key
storage_client = CopernicusStorageClient(
    access_key="YOUR_ACCESS_KEY", secret_access_key="YOUR_SECRET_ACCESS_KEY", cache_directory=Path("./data")
)

downloaded_data = storage_client.download(s2_granule)

print(f"Downloaded granule: {downloaded_data.name} to {downloaded_data}")
print("Contents: ")
for content in downloaded_data.iterdir():
    print(f" - {content.relative_to(downloaded_data)}")

License

Distributed under the MIT License (The MIT License).

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tilebox_storage-0.58.0.tar.gz (17.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tilebox_storage-0.58.0-py3-none-any.whl (20.4 kB view details)

Uploaded Python 3

File details

Details for the file tilebox_storage-0.58.0.tar.gz.

File metadata

  • Download URL: tilebox_storage-0.58.0.tar.gz
  • Upload date:
  • Size: 17.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for tilebox_storage-0.58.0.tar.gz
Algorithm Hash digest
SHA256 b7b9834d3bd5983a0efa5ef7172a190c8bc415f5c76380f3c932e4b52a31cae4
MD5 a631aa1c110dae110fce54ae89ec3a23
BLAKE2b-256 965b3296d3a5159fa1290c63bd4e397da530ac498f719e3bd4cc57f3d772ed75

See more details on using hashes here.

Provenance

The following attestation bundles were made for tilebox_storage-0.58.0.tar.gz:

Publisher: publish_tilebox_storage.yml on tilebox/tilebox-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file tilebox_storage-0.58.0-py3-none-any.whl.

File metadata

File hashes

Hashes for tilebox_storage-0.58.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3f5d9272b4c8331f1be317bec57eb475ede24e3f5a2a8dee4dd78a2e81d922ad
MD5 eaf824a8b99ef3ab06ce9b002c66f679
BLAKE2b-256 6ed87f12710577f15398e097325d5ff0ad5d5bd04a002ce5a0a3044204d06984

See more details on using hashes here.

Provenance

The following attestation bundles were made for tilebox_storage-0.58.0-py3-none-any.whl:

Publisher: publish_tilebox_storage.yml on tilebox/tilebox-python

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.61.0

2 files

0.60.0

2 files

0.59.0

2 files

This release

0.58.0 This release

2 files

0.57.0

2 files

0.56.0

2 files

0.55.0

2 files

0.54.0

2 files

0.53.0

2 files

0.52.0

2 files

0.51.0

2 files

0.50.1

2 files

0.50.0

2 files

0.49.0

2 files

0.48.0

2 files

0.47.0

2 files

0.46.0

2 files

0.45.0

2 files

0.44.0

2 files

0.43.0

2 files

0.42.0

2 files

0.41.0

2 files

0.40.0

2 files

0.39.0

2 files

0.38.0

2 files

0.37.1

2 files

0.37.0

2 files

0.36.1

2 files

0.36.0

2 files

0.35.0

2 files

0.34.0

2 files

0.33.1

2 files

0.33.0

2 files

0.32.1

2 files

0.32.0

2 files

0.31.0

2 files

0.30.2

2 files

0.30.1

2 files

0.30.0

2 files

0.29.0

2 files

0.28.0

2 files

0.27.2

2 files

0.27.1

2 files

0.27.0

2 files

0.26.0

2 files

0.25.1

2 files

0.25.0

2 files

0.24.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page