Metadata-Version: 2.4
Name: rss_da_stac
Version: 0.1.6
Summary: Utilities for JRSRP users to interact with common STAC providers
Author-email: rdenham <robert.denham@detsi.qld.gov.au>
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: planetary-computer>=1.0.0
Requires-Dist: pystac-client>=0.9.0
Requires-Dist: pystac>=1.13.0
Requires-Dist: pytz>=2025.2
Requires-Dist: requests>=2.32.0
Requires-Dist: tifftools>=1.6.1
Requires-Dist: typer>=0.15.0
Description-Content-Type: text/markdown

# `rss_da_stac` - Python utilities for interacting with common STAC providers

![Pipeline Status](https://gitlab.com/jrsrp/sys/stac/rss_da_stac/badges/main/pipeline.svg)
![Security](https://gitlab.com/jrsrp/sys/stac/rss_da_stac/badges/main/pipeline.svg?job=secret_gatekeeper&key_text=secrets)
![Python](https://img.shields.io/badge/python-3.12-blue)
![License](https://img.shields.io/badge/license-MIT-green)
[![Latest Release](https://img.shields.io/gitlab/v/tag/jrsrp/sys/stac/rss_da_stac?label=version&color=blue)](https://gitlab.com/jrsrp/sys/stac/rss_da_stac/-/tags)
[![DOI](https://img.shields.io/badge/DOI-10.48610%2Fd3a13bb-blue)](https://doi.org/10.48610/d3a13bb)


Remote Sensing Scientists associated with the [JRSRP](https://www.jrsrp.org.au/)
have several established work practices that have been developed over many years,
and predate STAC and cloud-native Earth Observation (EO) data.

This package is designed To help integrate
their current work approaches with modern data providers via STAC. Of particular
interest is the interoperability of the [`qvf`](https://jrsrp.gitlab.io/sys/meta_info/)
name convention and how that relates to STAC. Several utilities are designed
to work with `qvf` style names, such as

* `qvf2item`: Convert one or more QVF files to a STAC ItemCollection
* `item2qvf`: Given a stac item or itemcollection, provide the equivalent qvf compliant name for each item.


see [notes](https://jrsrp.gitlab.io/sys/stac/rss_da_stac/) for details on the included scripts and the API.

## Installation

Use `pip` or `uv`, for example, as part of a uv project:

```sh
uv add rss-da-stac
```

## Using as a command-line tool

The quickest way to run `rss-stac` without setting up a project is with `uvx`:

```bash
uvx rss-da-stac qvf2item cfmsre_t56kkv_20221223_adbm6.tif
```

This downloads and runs the package in a temporary environment — no installation needed.

If you want the `rss-stac` command permanently available on your system:

```bash
uv tool install rss-da-stac
rss-stac qvf2item cfmsre_t56kkv_20221223_adbm6.tif
```


## Citation

If you use this software in your research, please cite it as:

Denham, Robert (2026). *rss_da_stac_source_code: Python utilities for interacting
with common STAC providers for remote sensing scientists*. Version 0.1.5.
The University of Queensland. Data Collection.
https://doi.org/10.48610/d3a13bb

### BibTeX

```bibtex
@misc{denham_2026_rss_da_stac,
  author    = {Denham, Robert},
  title     = {rss\_da\_stac\_source\_code: Python utilities for interacting
               with common STAC providers for remote sensing scientists},
  year      = {2026},
  version   = {0.1.5},
  publisher = {The University of Queensland},
  type      = {Data Collection},
  doi       = {10.48610/d3a13bb},
  url       = {https://doi.org/10.48610/d3a13bb}
}
```
