Skip to main content

AWS-native STAC-based processing pipeline

Project description

Cirrus

build-status-image coverage-status-image pypi-version

Cirrus is a STAC-based geospatial processing pipeline platform, implemented using a scalable architecture deployed on AWS. Cirrus provides the generic infrastructure for processing, allowing a user to focus on implementing the specific processing logic for their data.

architecture-overview

As input, Cirrus takes a STAC ItemCollection along with a process definition block. That input is called a "payload" and follows the Payload model defined in the stac-task package, with slightly tighter requirements on the presence and content of the process definition block.

An input payload is run through a workflow that generates one or more output STAC Items. These output Items are added to the Cirrus static STAC catalog in S3, and are also broadcast via an SNS topic. Subscriptions to that topic can trigger additional workflows or external processes, such as indexing into a STAC API catalog (e.g., stac-server).

Cirrus workflows range from the simple publishing of unmodified input items to the complex transformation of input Items and generation of wholly-new output Items. The current state of a payload in a processing pipeline is tracked in a state database to prevent duplicate processing and allow for a user to follow the state of any input payload through the pipeline.

As shown in this high-level overview of Cirrus, users input data to Cirrus through the use of feeders. Feeders are simply programs that get/generate some type of STAC metadata, combine it with processing parameters, and pass it into Cirrus as a payload.

Cirrus Development

If developing new code for cirrus-geo, checkout the Contributing Guide.

Documentation

Documentation for deploying, using, and customizing Cirrus is contained within the docs directory:

  • Learn how to get started
  • Understand the architecture of Cirrus and key concepts
  • Use Cirrus to process input data and publish resulting STAC Items
  • Cirrus features several component types that each represent a specific role within the Cirrus architecture

About

Cirrus is an Open-Source pipeline for processing geospatial data in AWS. Cirrus was developed by Element 84 originally under a NASA ACCESS project called Community Tools for Analysis of NASA Earth Observation System Data in the Cloud.

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

cirrus_geo-1.1.2.tar.gz (454.6 kB view details)

Uploaded Source

Built Distribution

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

cirrus_geo-1.1.2-py3-none-any.whl (57.2 kB view details)

Uploaded Python 3

File details

Details for the file cirrus_geo-1.1.2.tar.gz.

File metadata

  • Download URL: cirrus_geo-1.1.2.tar.gz
  • Upload date:
  • Size: 454.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for cirrus_geo-1.1.2.tar.gz
Algorithm Hash digest
SHA256 24a23b2f75d19b235a48f35e8277bce69a0dc06ec9909c7a60020837e877e008
MD5 1b7632895f011aa24742ab4464bceb9f
BLAKE2b-256 b3822011b08c9d7ea4c780b3dd7a7c8aa15584370e13dca8dd87fe2305ef38c8

See more details on using hashes here.

Provenance

The following attestation bundles were made for cirrus_geo-1.1.2.tar.gz:

Publisher: python-publish.yml on cirrus-geo/cirrus-geo

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

File details

Details for the file cirrus_geo-1.1.2-py3-none-any.whl.

File metadata

  • Download URL: cirrus_geo-1.1.2-py3-none-any.whl
  • Upload date:
  • Size: 57.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for cirrus_geo-1.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 9a2559a4e186788563e0a195ce795ba577a57e7691ed343e14118f7e1737793b
MD5 2cc61f47f6bc8b191a166d2f1aa23d7c
BLAKE2b-256 4ae962a79b9c84ae7dd3f55862aa21633cdfe61b380af633e42a6ed7fcec8569

See more details on using hashes here.

Provenance

The following attestation bundles were made for cirrus_geo-1.1.2-py3-none-any.whl:

Publisher: python-publish.yml on cirrus-geo/cirrus-geo

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

Supported by

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