A no-dependency Python package for STAC, using Rust under the hood.
Project description
stacrs
A no-dependency Python package for STAC, using Rust under the hood.
Usage
Install via pip:
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,
)
pystac
If pystac is present, stacrs.pystac
provides functions that take pystac objects as their inputs and outputs:
import pystac
import stacrs.pystac
item = pystac.read_file("item.json")
stacrs.pystac.validate(item)
items = list(stacrs.pystac.search(...))
You can install pystac with stacrs via an optional dependency:
pip install 'stacrs[pystac]'
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for stacrs-0.1.0-cp312-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e8ac26e59c07ed78ba82f4b0c228f9a3dda4cd92ed565483481e0ce2ce15cfb5 |
|
MD5 | 626aae2da8e5efc40a47909eb8656968 |
|
BLAKE2b-256 | de67a57d8f3eb6612973b59794597170266f29d0aa1ca167583b5e5d85b8483a |
Hashes for stacrs-0.1.0-cp312-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4718921fb24b9a10d88af616784ad608ff7e00b5ad3229a346374590daa70098 |
|
MD5 | 9a3385f9380b801af19dd7084acd06d7 |
|
BLAKE2b-256 | 3e074507dcfdd91228e455a00617bb1bb34f38cd9fea6a2dcf6137fefbd8dcdd |
Hashes for stacrs-0.1.0-cp312-cp312-manylinux_2_34_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e1e4d029cd90279636f172d52fb7b2eb72142f14dfb03478dc36dd2530ad651b |
|
MD5 | 56828cb92ffa687c90f4a332ba04397a |
|
BLAKE2b-256 | 5470af04ab9f348a6104ec0b07a29264b52deebcda877e7bc9a24bc4945933e4 |
Hashes for stacrs-0.1.0-cp312-cp312-macosx_11_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8db1e66ce5d5cd9d0d57fcc0079ab0cdd547f3318c9ccf60627c5bd691845cf4 |
|
MD5 | 461dc5934fc36ea3a60046ccbf68114a |
|
BLAKE2b-256 | 4bf2301d93dfe31acba441bde4418fda24686d0b564ac7c375a4edcf9208b029 |
Hashes for stacrs-0.1.0-cp312-cp312-macosx_10_12_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | abe83528b3ebd435a2834086c3cbb3ea03b71038f2877a7b3d491d54c25d23db |
|
MD5 | 3d0a7d827f28f2ec1393d7eaecfcf8bb |
|
BLAKE2b-256 | 8ee8abf2105960831c1e826ae4124ed17a328222a757a92ffe56ff0c35add6ab |
Hashes for stacrs-0.1.0-cp311-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bdf990a6c5db9fb0223f2b34c5b50a582fd8f65642d18c61523c7a51e5552469 |
|
MD5 | 22a58824c684a60d0cdc21a7b04b2f98 |
|
BLAKE2b-256 | 86d6225c284106c602641697c11d82efba8eae1d1019fbfde058599183981860 |
Hashes for stacrs-0.1.0-cp311-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f4972e2b44d92f4288fa6b6d5f750888d3f7419738765c4669dfd6c376940d3c |
|
MD5 | 8d0b596c506584095ee213cab9217b9c |
|
BLAKE2b-256 | 25c83476977e3a9713b282912bb6774957879bbc7009b7f30cd7972852b8fb59 |
Hashes for stacrs-0.1.0-cp311-cp311-macosx_11_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7be91c4501c0d6ee322265650bce406092409f89b4b4887e3114475528aef72b |
|
MD5 | e918b87bb2de129498f63f3e926f3aa3 |
|
BLAKE2b-256 | 6ddd301dd910975422ec131083ab2218464f83ef56eb407f7ab39d121e51e0e4 |
Hashes for stacrs-0.1.0-cp311-cp311-macosx_10_12_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 669794641f5c6c906ce5a4e5627bff49c375ea25bcc660779b5f876dcf62ed1d |
|
MD5 | b9f59b31d41f5e04340cb17048ae6b0b |
|
BLAKE2b-256 | 868a33e3e462eaefc3e571e607f2fd347d6fc5c609142d14de8b571948b5a300 |
Hashes for stacrs-0.1.0-cp310-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7be25d9fd03db93fddc0bce0d065b3e6208ed197cc344a994516f1c0bf12014f |
|
MD5 | 79dbab8a87bc390e8746f9f6ee808302 |
|
BLAKE2b-256 | 23332796ce511a19894e0bd4bdd01fdef5fb0acb77535365e036d30c0e94444a |
Hashes for stacrs-0.1.0-cp310-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 21f1a35ae5966a26283dc1751a6ef03779e55e4d45a2b064801be19fea4bc3a4 |
|
MD5 | 56be8e7e7faa5f74c93c48a8e3f3ac11 |
|
BLAKE2b-256 | 4896c7d8740aa958ce4e19e8785948a0c0ffb3bac2f146ede30d39fe66503b28 |
Hashes for stacrs-0.1.0-cp310-cp310-manylinux_2_34_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1c56604d8f5cb2b55903f224e5eee34ec1a172feebee7da5c1fae73b3900a515 |
|
MD5 | 47fb7a2fce9785718fedba072ee12a12 |
|
BLAKE2b-256 | e3e584ee468751f4cf93f5696fc86bc6385153131940f15e4c16e1832eddbefa |
Hashes for stacrs-0.1.0-cp310-cp310-macosx_11_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 47faa093676cc11059cc69b452c6c0c3cbd1a3f11040fe4f8d0aafaa12b2d3ce |
|
MD5 | 1b80ae11480db1b6bbf9f4a128d94062 |
|
BLAKE2b-256 | 6c97a0ff2953e2fd7bf2b17a1194fdbe6c252b964264508dcfef8a41726acf99 |
Hashes for stacrs-0.1.0-cp39-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ec3866b101b714a5300c32b0bfaf81f1920971dc0db0a8c72899bd518addf57a |
|
MD5 | 9eb3aa645eca4214e4a799c4f8524fc4 |
|
BLAKE2b-256 | 3f0ff71e59f409ed63cd3459bc22189766156a59c90c191f234d621da5ed7ff1 |
Hashes for stacrs-0.1.0-cp39-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 91c5d9cb676d521819a19cb93aa0a6f48c2c5924237f66815d2342164a05a8d5 |
|
MD5 | 40d15c64dcab89028e9b2c68df89375b |
|
BLAKE2b-256 | 2908611e2f53c2f855fc07dbea8d84f9c2197598a69c52dfa71e86bdcb49c51d |
Hashes for stacrs-0.1.0-cp39-cp39-macosx_11_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0180a65a11b294e14c194e0f7d1be20cccffd4c3f2505e31f6c50f585018de96 |
|
MD5 | 848726a0676b9aa44b2070008a7f926a |
|
BLAKE2b-256 | 2c707671da2569463a8bd55247803b66843bd569566f58d81502df1b51648ea0 |
Hashes for stacrs-0.1.0-cp38-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 325d531a370d3b221472fee8a556463ab9a80a7479b0dd2ec2c6d64566c5060a |
|
MD5 | cf100929ef19db45af670b864fab4ae8 |
|
BLAKE2b-256 | 1fa0cc0b8921be9f9ac4d1bf88f57a4fedeadbd13d9e97014730accd0d66c36e |
Hashes for stacrs-0.1.0-cp38-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 982fd55753d93b368c78d701c11487344fc83f27425a5f42d3cef5110c6fd0ae |
|
MD5 | 524674739c75a3c8eaebbc2f36247631 |
|
BLAKE2b-256 | 43908e2ed51b85675b800f7a76fa1026e6849249b532b6d01693139eace693d7 |