Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/stac-utils/stac-rs

Tools and libraries for the SpatioTemporal Asset Catalog (STAC) specification, written in Rust
https://github.com/stac-utils/stac-rs

command-line earth-observation geospatial metadata python raster rust server stac

Last synced: 4 days ago
JSON representation

Tools and libraries for the SpatioTemporal Asset Catalog (STAC) specification, written in Rust

Host: GitHub
URL: https://github.com/stac-utils/stac-rs
Owner: stac-utils
License: apache-2.0
Created: 2021-03-29T17:08:13.000Z (almost 4 years ago)
Default Branch: main
Last Pushed: 2024-12-23T03:10:30.000Z (6 days ago)
Last Synced: 2024-12-23T03:30:27.162Z (6 days ago)
Topics: command-line, earth-observation, geospatial, metadata, python, raster, rust, server, stac
Language: Rust
Homepage: https://stac-utils.github.io/stac-rs/
Size: 5.81 MB
Stars: 85
Watchers: 4
Forks: 12
Open Issues: 35
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE-APACHE
- Code of conduct: CODE_OF_CONDUCT
- Codeowners: CODEOWNERS

Awesome Lists containing this project

awesome-earthobservation-code - stac-rs - `Rust` implementation of the SpatioTemporal Asset Catalog (STAC) specification (`Python` processing of optical imagery (non deep learning) / Cloud Native Geospatial)

README

        # stac-rs

[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/stac-utils/stac-rs/ci.yml?branch=main&style=for-the-badge)](https://github.com/stac-utils/stac-rs/actions/workflows/ci.yml)

![Crates.io](https://img.shields.io/crates/l/stac?style=for-the-badge)

[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg?style=for-the-badge)](./CODE_OF_CONDUCT)

![Ferris the crab holding the STAC logo](./img/ferris-holding-stac-small.png)

Command Line Interface (CLI) and Rust libraries for the [SpatioTemporal Asset Catalog (STAC)](https://stacspec.org/) specification.

There's a couple Python projects based on **stac-rs** that might be of interest to you, as well:

- [stacrs](https://github.com/gadomski/stacrs) provides a Python API to **stac-rs**, including

  - Reading and writing [stac-geoparquet](https://github.com/stac-utils/stac-geoparquet)

  - Migrating to [STAC v1.1](https://github.com/radiantearth/stac-spec/releases/tag/v1.1.0)

  - [More...](https://www.gadom.ski/posts/stacrs-python-v0-1/)

- [pgstacrs](https://github.com/stac-utils/pgstacrs) is a Python library for working with [pgstac](https://github.com/stac-utils/pgstac)

## Command line interface

Our command line interface (CLI) can query STAC APIs, validate STAC, and more.

Install:

```shell

pip install stacrs-cli

# or

cargo install stac-cli

```

Then:

```shell

$ stacrs search https://landsatlook.usgs.gov/stac-server \

    -c landsat-c2l2-sr --intersects \

    '{"type": "Point", "coordinates": [-105.119, 40.173]}' \

    --sortby='-properties.datetime' \

    --max-items 1000 \

    -f 'parquet[snappy]' \

    items.parquet

```

## Crates

This monorepo contains several crates:

| Crate                                            | Description                                                                                     | Badges                                                                                                                                                                                                                                                                  |

| ------------------------------------------------ | ----------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

| [stac](./crates/core/README.md)                  | Core data structures and I/O                                                                    | [![docs.rs](https://img.shields.io/docsrs/stac?style=flat-square)](https://docs.rs/stac/latest/stac/) 
 [![Crates.io](https://img.shields.io/crates/v/stac?style=flat-square)](https://crates.io/crates/stac)                                                        |

| [stac-api](./crates/api/README.md)               | Data structures for the [STAC API](https://github.com/radiantearth/stac-api-spec) specification | [![docs.rs](https://img.shields.io/docsrs/stac-api?style=flat-square)](https://docs.rs/stac-api/latest/stac_api/) 
 [![Crates.io](https://img.shields.io/crates/v/stac-api?style=flat-square)](https://crates.io/crates/stac-api)                                    |

| [stac-extensions](./crates/extensions/README.md) | Basic support for [STAC extensions](https://stac-extensions.github.io/)                         | [![docs.rs](https://img.shields.io/docsrs/stac-extensions?style=flat-square)](https://docs.rs/stac-extensions/latest/stac_extensions/) 
 [![Crates.io](https://img.shields.io/crates/v/stac-extensions?style=flat-square)](https://crates.io/crates/stac-extensions) |

| [stac-cli](./crates/cli/README.md)               | Command line interface                                                                          | [![docs.rs](https://img.shields.io/docsrs/stac-cli?style=flat-square)](https://docs.rs/stac-cli/latest/stac_cli/) 
 [![Crates.io](https://img.shields.io/crates/v/stac-cli?style=flat-square)](https://crates.io/crates/stac-cli)                                    |

| [stac-server](./crates/server/README.md)         | STAC API server with multiple backends                                                          | [![docs.rs](https://img.shields.io/docsrs/stac-server?style=flat-square)](https://docs.rs/stac-server/latest/stac_server/) 
 [![Crates.io](https://img.shields.io/crates/v/stac-server?style=flat-square)](https://crates.io/crates/stac-server)                     |

| [pgstac](./crates/pgstac/README.md)              | Bindings for [pgstac](https://github.com/stac-utils/pgstac)                                     | [![docs.rs](https://img.shields.io/docsrs/pgstac?style=flat-square)](https://docs.rs/pgstac/latest/pgstac/) 
 [![Crates.io](https://img.shields.io/crates/v/pgstac?style=flat-square)](https://crates.io/crates/pgstac)                                              |

| [stac-duckdb](./crates/duckdb/README.md)         | Experimental client for [duckdb](https://duckdb.org/)                                           | [![docs.rs](https://img.shields.io/docsrs/stac-duckdb?style=flat-square)](https://docs.rs/stac-duckdb/latest/stac_duckdb/) 
 [![Crates.io](https://img.shields.io/crates/v/stac-duckdb?style=flat-square)](https://crates.io/crates/stac-duckdb)                     |

## Development

See [CONTRIBUTING.md](./CONTRIBUTING.md) for information about contributing to this project.

See [RELEASING.md](./RELEASING.md) for a checklist to use when releasing a new version.

## License

**stac-rs** is dual-licensed under both the MIT license and the Apache license (Version 2.0).

See [LICENSE-APACHE](./LICENSE-APACHE) and [LICENSE-MIT](./LICENSE-MIT) for details.