Skip to main content

Storage client for Tilebox

Project description

Tilebox Storage

PyPI - Version Python

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).

Project details


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.25.1.tar.gz (8.4 kB view details)

Uploaded Source

Built Distribution

tilebox_storage-0.25.1-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: tilebox_storage-0.25.1.tar.gz
  • Upload date:
  • Size: 8.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for tilebox_storage-0.25.1.tar.gz
Algorithm Hash digest
SHA256 6ce7ed6c4389f656c7056ba552da07c63eb34702556ff6e3a6cbbf7b5abdcdbc
MD5 3f02fdbeee90e447c9474927b2a9d8a6
BLAKE2b-256 a6c6fac497c7696a34ed08d1424cf51c332932fd73691f505b080b2e227c5716

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for tilebox_storage-0.25.1-py3-none-any.whl
Algorithm Hash digest
SHA256 fdb8425de8d79a4efa70817488cebbdaed877c432a1d9772035a998bc7650fbf
MD5 1abdae96fb251384afa1d2e499d687a9
BLAKE2b-256 00bf88849a60e3f0322ed4ee6a564e0f5045494a6f70c74b19cd903bdab2c9cc

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page