Metadata-Version: 2.3
Name: pyucalgarysrs
Version: 1.23.3
Summary: Tools for interacting with UCalgary Space Remote Sensing data
License: Apache-2.0
Author: Darren Chaddock
Author-email: dchaddoc@ucalgary.ca
Maintainer: Darren Chaddock
Maintainer-email: dchaddoc@ucalgary.ca
Requires-Python: >=3.9
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: h5py (>=3.1.0,<4.0.0)
Requires-Dist: humanize (>=4.4.0,<5.0.0)
Requires-Dist: numpy (>=1.21.0,<2.0.0) ; python_version == "3.9"
Requires-Dist: numpy (>=1.21.0,<2.3.0) ; python_version == "3.10"
Requires-Dist: numpy (>=1.21.0,<3.0.0) ; python_version >= "3.11"
Requires-Dist: opencv-python (>=4.4.0,<5.0.0)
Requires-Dist: requests (>=2.28.0,<3.0.0)
Requires-Dist: scipy (>=1.6.0,<2.0.0) ; python_version == "3.9"
Requires-Dist: scipy (>=1.8.0,<2.0.0) ; python_version >= "3.10"
Requires-Dist: texttable (>=1.6.4,<2.0.0)
Requires-Dist: tqdm (>=4.61.2,<5.0.0)
Project-URL: API Reference, https://docs-pyucalgarysrs.phys.ucalgary.ca/
Project-URL: Homepage, https://github.com/ucalgary-srs/pyUCalgarySRS
Project-URL: Repository, https://github.com/ucalgary-srs/pyUCalgarySRS
Project-URL: UCalgary SRS Open Data Platform, https://data.phys.ucalgary.ca
Description-Content-Type: text/markdown

# PyUCalgarySRS

[![GitHub tests](https://github.com/ucalgary-srs/pyUCalgarySRS/actions/workflows/tests_default.yml/badge.svg)](https://github.com/ucalgary-srs/pyUCalgarySRS/actions/workflows/tests_default.yml)
[![PyPI version](https://img.shields.io/pypi/v/pyucalgarysrs.svg)](https://pypi.python.org/pypi/pyucalgarysrs/)
[![PyPI Python versions](https://img.shields.io/pypi/pyversions/pyucalgarysrs)](https://pypi.python.org/pypi/pyucalgarysrs/)

This is the Python library for retrieving and loading data provided by UCalgary Space Remote Sensing. More information including tutorials and dataset descriptions can be found on our open data platform at https://data.phys.ucalgary.ca.

> [!NOTE]
> This library is primarily a sub-dependency for higher-level data access and analysis support libraries [PyAuroraX](https://github.com/aurorax-space/pyaurorax) and [PyUCRio](https://github.com/ucalgary-srs/pyUCRio). We recommend using those libraries for accessing and analyzing optical (all-sky imager, spectrograph) data and riometer data, respectively.

PyUCalagarySRS currently supports Python 3.9+.

Some links to help:
- [PyUCalgarySRS API Reference](https://docs-pyucalgarysrs.phys.ucalgary.ca)
- [Crib sheets that utilize PyUCalgarySRS](https://data.phys.ucalgary.ca/working_with_data/index.html#crib-sheets)
- [UCalgary Space Remote Sensing Open Data Platform](https://data.phys.ucalgary.ca)
- [Usage examples](https://github.com/ucalgary-srs/pyUCalgarySRS/tree/main/examples)

## Installation

Installation can be done using pip:

```console
$ pip install pyucalgarysrs
```

For the most bleeding edge version of PyUCalgarySRS, you can install it directly from the Github repository:

```console
$ pip install pyucalgarysrs@git+https://github.com/ucalgary-srs/pyUCalgarySRS

[OR]

$ git clone https://github.com/ucalgary-srs/pyUCalgarySRS.git
$ cd pyUCalgarySRS
$ pip install .
```

## Usage

Below is how the library can be imported and initialized:

```python
import pyucalgarysrs
srs = pyucalgarysrs.PyUCalgarySRS()
```

A large collection of examples can be found in the [`examples`](https://github.com/ucalgary-srs/pyUCalgarySRS/tree/main/examples) directory. 

