A no-dependency Python package for STAC, using Rust under the hood.

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for quentonc from gravatar.com quentonc
Meta

Unverified details

These details have not been verified by PyPI
Meta
  • License: Apache Software License, MIT License (MIT OR Apache-2.0)
  • Author: Pete Gadomski <pete.gadomski@gmail.com>
  • Tags stac, geospatial
  • Requires: Python >=3.8
Classifiers

Project description

stacrs

GitHub Workflow Status PyPI - Version PyPI - License Contributor Covenant

A no-dependency Python package for STAC, using Rust under the hood.

Usage

Install via pip:

python -m pip install stacrs

Then:

import stacrs

# Search a STAC API
items = stacrs.search(
    "https://landsatlook.usgs.gov/stac-server",
    collections="landsat-c2l2-sr",
    intersects={"type": "Point", "coordinates": [-105.119, 40.173]},
    sortby="-properties.datetime",
    max_items=100,
)

# Write items to a stac-geoparquet file
stacrs.write("items.parquet", items)

# Read items from a stac-geoparquet file as an item collection
item_collection = stacrs.read("items.parquet")

# Use `search_to` for better performance if you know you'll be writing the items
# to a file
stacrs.search_to(
    "items.parquet",
    "https://landsatlook.usgs.gov/stac-server",
    collections="landsat-c2l2-sr",
    intersects={"type": "Point", "coordinates": [-105.119, 40.173]},
    sortby="-properties.datetime",
    max_items=100,
)

See the documentation for details. In particular, our example notebook demonstrates some of the more interesting features.

Comparisons

This package (intentionally) has limited functionality, as it is not intended to be a replacement for existing Python STAC packages. pystac is a mature Python library with a significantly richer API for working with STAC objects. For querying STAC APIs, pystac-client is more feature-rich than our simplistic stacrs.search.

That being said, it is hoped that stacrs will be a nice complement to the existing Python STAC ecosystem by providing a no-dependency package with unique capabilities, such as searching directly into a stac-geoparquet file.

Other info

This package is part of the stac-rs monorepo, see its README for contributing and license information.

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for quentonc from gravatar.com quentonc
Meta

Unverified details

These details have not been verified by PyPI
Meta
  • License: Apache Software License, MIT License (MIT OR Apache-2.0)
  • Author: Pete Gadomski <pete.gadomski@gmail.com>
  • Tags stac, geospatial
  • Requires: Python >=3.8
Classifiers

Release history Release notifications | RSS feed

This version

0.2.2

0.2.1

0.2.0

0.1.3

0.1.2

0.1.1

0.1.0

0.0.3

0.0.2

0.0.1

Download files

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

Source Distribution

stacrs-0.2.2.tar.gz (1.6 MB view hashes)

Uploaded Source

Built Distributions

stacrs-0.2.2-pp310-pypy310_pp73-musllinux_1_1_x86_64.whl (29.6 MB view hashes)

Uploaded PyPy musllinux: musl 1.1+ x86-64

stacrs-0.2.2-pp310-pypy310_pp73-musllinux_1_1_armv7l.whl (28.5 MB view hashes)

Uploaded PyPy musllinux: musl 1.1+ ARMv7l

stacrs-0.2.2-pp310-pypy310_pp73-musllinux_1_1_aarch64.whl (28.7 MB view hashes)

Uploaded PyPy musllinux: musl 1.1+ ARM64

stacrs-0.2.2-pp310-pypy310_pp73-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (23.7 MB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ ppc64le

stacrs-0.2.2-pp310-pypy310_pp73-manylinux_2_17_i686.manylinux2014_i686.whl (25.5 MB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ i686

stacrs-0.2.2-pp310-pypy310_pp73-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (21.8 MB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ ARMv7l

stacrs-0.2.2-pp310-pypy310_pp73-macosx_11_0_arm64.whl (17.6 MB view hashes)

Uploaded PyPy macOS 11.0+ ARM64

stacrs-0.2.2-pp310-pypy310_pp73-macosx_10_12_x86_64.whl (19.4 MB view hashes)

Uploaded PyPy macOS 10.12+ x86-64

stacrs-0.2.2-pp39-pypy39_pp73-musllinux_1_1_x86_64.whl (29.6 MB view hashes)

Uploaded PyPy musllinux: musl 1.1+ x86-64

stacrs-0.2.2-pp39-pypy39_pp73-musllinux_1_1_armv7l.whl (28.5 MB view hashes)

Uploaded PyPy musllinux: musl 1.1+ ARMv7l

stacrs-0.2.2-pp39-pypy39_pp73-musllinux_1_1_aarch64.whl (28.7 MB view hashes)

Uploaded PyPy musllinux: musl 1.1+ ARM64

stacrs-0.2.2-pp39-pypy39_pp73-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (23.7 MB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ ppc64le

stacrs-0.2.2-pp39-pypy39_pp73-manylinux_2_17_i686.manylinux2014_i686.whl (25.5 MB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ i686

stacrs-0.2.2-pp39-pypy39_pp73-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (21.8 MB view hashes)

Uploaded PyPy manylinux: glibc 2.17+ ARMv7l

stacrs-0.2.2-pp39-pypy39_pp73-macosx_11_0_arm64.whl (17.6 MB view hashes)

Uploaded PyPy macOS 11.0+ ARM64

stacrs-0.2.2-pp39-pypy39_pp73-macosx_10_12_x86_64.whl (19.4 MB view hashes)

Uploaded PyPy macOS 10.12+ x86-64

stacrs-0.2.2-cp313-none-win_amd64.whl (15.7 MB view hashes)

Uploaded CPython 3.13 Windows x86-64

stacrs-0.2.2-cp313-none-win32.whl (13.8 MB view hashes)

Uploaded CPython 3.13 Windows x86

stacrs-0.2.2-cp313-cp313-musllinux_1_1_x86_64.whl (29.6 MB view hashes)

Uploaded CPython 3.13 musllinux: musl 1.1+ x86-64

stacrs-0.2.2-cp313-cp313-musllinux_1_1_armv7l.whl (28.5 MB view hashes)

Uploaded CPython 3.13 musllinux: musl 1.1+ ARMv7l

stacrs-0.2.2-cp313-cp313-musllinux_1_1_aarch64.whl (28.7 MB view hashes)

Uploaded CPython 3.13 musllinux: musl 1.1+ ARM64

stacrs-0.2.2-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (23.7 MB view hashes)

Uploaded CPython 3.13 manylinux: glibc 2.17+ ppc64le

stacrs-0.2.2-cp313-cp313-manylinux_2_17_i686.manylinux2014_i686.whl (25.5 MB view hashes)

Uploaded CPython 3.13 manylinux: glibc 2.17+ i686

stacrs-0.2.2-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (21.8 MB view hashes)

Uploaded CPython 3.13 manylinux: glibc 2.17+ ARMv7l

stacrs-0.2.2-cp313-cp313-macosx_11_0_arm64.whl (17.5 MB view hashes)

Uploaded CPython 3.13 macOS 11.0+ ARM64

stacrs-0.2.2-cp313-cp313-macosx_10_12_x86_64.whl (19.4 MB view hashes)

Uploaded CPython 3.13 macOS 10.12+ x86-64

stacrs-0.2.2-cp312-none-win_amd64.whl (15.7 MB view hashes)

Uploaded CPython 3.12 Windows x86-64

stacrs-0.2.2-cp312-none-win32.whl (13.8 MB view hashes)

Uploaded CPython 3.12 Windows x86

stacrs-0.2.2-cp312-cp312-musllinux_1_1_x86_64.whl (29.6 MB view hashes)

Uploaded CPython 3.12 musllinux: musl 1.1+ x86-64

stacrs-0.2.2-cp312-cp312-musllinux_1_1_armv7l.whl (28.5 MB view hashes)

Uploaded CPython 3.12 musllinux: musl 1.1+ ARMv7l

stacrs-0.2.2-cp312-cp312-musllinux_1_1_aarch64.whl (28.7 MB view hashes)

Uploaded CPython 3.12 musllinux: musl 1.1+ ARM64

stacrs-0.2.2-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (23.7 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ ppc64le

stacrs-0.2.2-cp312-cp312-manylinux_2_17_i686.manylinux2014_i686.whl (25.5 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ i686

stacrs-0.2.2-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (21.8 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ ARMv7l

stacrs-0.2.2-cp312-cp312-macosx_11_0_arm64.whl (17.5 MB view hashes)

Uploaded CPython 3.12 macOS 11.0+ ARM64

stacrs-0.2.2-cp312-cp312-macosx_10_12_x86_64.whl (19.4 MB view hashes)

Uploaded CPython 3.12 macOS 10.12+ x86-64

stacrs-0.2.2-cp311-none-win_amd64.whl (15.7 MB view hashes)

Uploaded CPython 3.11 Windows x86-64

stacrs-0.2.2-cp311-none-win32.whl (13.8 MB view hashes)

Uploaded CPython 3.11 Windows x86

stacrs-0.2.2-cp311-cp311-musllinux_1_1_x86_64.whl (29.6 MB view hashes)

Uploaded CPython 3.11 musllinux: musl 1.1+ x86-64

stacrs-0.2.2-cp311-cp311-musllinux_1_1_armv7l.whl (28.5 MB view hashes)

Uploaded CPython 3.11 musllinux: musl 1.1+ ARMv7l

stacrs-0.2.2-cp311-cp311-musllinux_1_1_aarch64.whl (28.7 MB view hashes)

Uploaded CPython 3.11 musllinux: musl 1.1+ ARM64

stacrs-0.2.2-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (23.7 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ ppc64le

stacrs-0.2.2-cp311-cp311-manylinux_2_17_i686.manylinux2014_i686.whl (25.5 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ i686

stacrs-0.2.2-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (21.8 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ ARMv7l

stacrs-0.2.2-cp311-cp311-macosx_11_0_arm64.whl (17.5 MB view hashes)

Uploaded CPython 3.11 macOS 11.0+ ARM64

stacrs-0.2.2-cp311-cp311-macosx_10_12_x86_64.whl (19.4 MB view hashes)

Uploaded CPython 3.11 macOS 10.12+ x86-64

stacrs-0.2.2-cp310-none-win_amd64.whl (15.7 MB view hashes)

Uploaded CPython 3.10 Windows x86-64

stacrs-0.2.2-cp310-none-win32.whl (13.8 MB view hashes)

Uploaded CPython 3.10 Windows x86

stacrs-0.2.2-cp310-cp310-musllinux_1_1_x86_64.whl (29.6 MB view hashes)

Uploaded CPython 3.10 musllinux: musl 1.1+ x86-64

stacrs-0.2.2-cp310-cp310-musllinux_1_1_armv7l.whl (28.5 MB view hashes)

Uploaded CPython 3.10 musllinux: musl 1.1+ ARMv7l

stacrs-0.2.2-cp310-cp310-musllinux_1_1_aarch64.whl (28.7 MB view hashes)

Uploaded CPython 3.10 musllinux: musl 1.1+ ARM64

stacrs-0.2.2-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (23.7 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ ppc64le

stacrs-0.2.2-cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl (25.5 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ i686

stacrs-0.2.2-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (21.8 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ ARMv7l

stacrs-0.2.2-cp310-cp310-macosx_11_0_arm64.whl (17.5 MB view hashes)

Uploaded CPython 3.10 macOS 11.0+ ARM64

stacrs-0.2.2-cp310-cp310-macosx_10_12_x86_64.whl (19.4 MB view hashes)

Uploaded CPython 3.10 macOS 10.12+ x86-64

stacrs-0.2.2-cp39-none-win32.whl (13.8 MB view hashes)

Uploaded CPython 3.9 Windows x86

stacrs-0.2.2-cp39-cp39-musllinux_1_1_x86_64.whl (29.6 MB view hashes)

Uploaded CPython 3.9 musllinux: musl 1.1+ x86-64

stacrs-0.2.2-cp39-cp39-musllinux_1_1_armv7l.whl (28.5 MB view hashes)

Uploaded CPython 3.9 musllinux: musl 1.1+ ARMv7l

stacrs-0.2.2-cp39-cp39-musllinux_1_1_aarch64.whl (28.7 MB view hashes)

Uploaded CPython 3.9 musllinux: musl 1.1+ ARM64

stacrs-0.2.2-cp39-cp39-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (23.7 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ ppc64le

stacrs-0.2.2-cp39-cp39-manylinux_2_17_i686.manylinux2014_i686.whl (25.5 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ i686

stacrs-0.2.2-cp39-cp39-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (21.8 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ ARMv7l

stacrs-0.2.2-cp39-cp39-macosx_11_0_arm64.whl (17.5 MB view hashes)

Uploaded CPython 3.9 macOS 11.0+ ARM64

stacrs-0.2.2-cp39-cp39-macosx_10_12_x86_64.whl (19.4 MB view hashes)

Uploaded CPython 3.9 macOS 10.12+ x86-64

stacrs-0.2.2-cp38-none-win32.whl (13.8 MB view hashes)

Uploaded CPython 3.8 Windows x86

stacrs-0.2.2-cp38-cp38-musllinux_1_1_x86_64.whl (29.6 MB view hashes)

Uploaded CPython 3.8 musllinux: musl 1.1+ x86-64

stacrs-0.2.2-cp38-cp38-musllinux_1_1_armv7l.whl (28.5 MB view hashes)

Uploaded CPython 3.8 musllinux: musl 1.1+ ARMv7l

stacrs-0.2.2-cp38-cp38-musllinux_1_1_aarch64.whl (28.7 MB view hashes)

Uploaded CPython 3.8 musllinux: musl 1.1+ ARM64

stacrs-0.2.2-cp38-cp38-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl (23.7 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ ppc64le

stacrs-0.2.2-cp38-cp38-manylinux_2_17_i686.manylinux2014_i686.whl (25.5 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ i686

stacrs-0.2.2-cp38-cp38-manylinux_2_17_armv7l.manylinux2014_armv7l.whl (21.8 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ ARMv7l

stacrs-0.2.2-cp38-cp38-macosx_11_0_arm64.whl (17.5 MB view hashes)

Uploaded CPython 3.8 macOS 11.0+ ARM64

stacrs-0.2.2-cp38-cp38-macosx_10_12_x86_64.whl (19.4 MB view hashes)

Uploaded CPython 3.8 macOS 10.12+ x86-64

Supported by

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