Metadata-Version: 2.1
Name: callusgs
Version: 0.1.2a0
Summary: Implementation of USGS's machine-to-machine API (v1.5.0)
Home-page: https://github.com/Florian-Katerndahl/callusgs
License: GPL-2.0-only
Keywords: USGS,API,machine-to-machine,Landsat,CLI,geodata,GIS,EROS,download,EarthExplorer
Author: Florian-Katerndahl
Author-email: florian@katerndahl.com
Requires-Python: >=3.9,<4.0
Classifier: Environment :: Console
Classifier: Framework :: Sphinx
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
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 :: Only
Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
Classifier: Topic :: Scientific/Engineering :: GIS
Classifier: Typing :: Typed
Requires-Dist: fiona (>=1.9.6,<2.0.0)
Requires-Dist: requests (>=2.32.3,<3.0.0)
Requires-Dist: tqdm (>=4.66.4,<5.0.0)
Project-URL: Bug Tracker, https://github.com/Florian-Katerndahl/callusgs/issues
Project-URL: Documentation, https://callusgs.readthedocs.io/
Project-URL: Repository, https://github.com/Florian-Katerndahl/callusgs
Description-Content-Type: text/markdown

# callusgs

Implementation of USGS's machine-to-machine API 

## Features

`callusgs` is both a python package and a suite of command line tools.

## Installation

### Prerequisites

- account at USGS
- access to m2m MACHINE, otherwise: see resticions

Install the package together with the respective command line applications from pip.

```bash
pip install callusgs
```

## Usage

For more detailed usage instructions and/or examples, please refer to the documentation linked below.

### Command Line Tools

#### Download

```bash
callusgs download
```

#### Geocode

```bash
callusgs geocode
```

#### Grid2ll

```bash
callusgs grid2ll
```

## Documentation

See the docs folder for raw documentation or visit [callusgs.readthedocs.io](https://callusgs.readthedocs.io).

## License

- `callusgs` is licensed under the [GPL-v2](LICENSE)
- the file `docs/requirements.txt` is licensed under the MIT license.

## Citation

If you use this software, please use the bibtex entry below or refer to [the citation file](CITATION.cff).

```
@software{callusgs,
author = {Katerndahl, Florian},
license = {GPL-2.0},
title = {{callusgs}},
url = {https://github.com/Florian-Katerndahl/callusgs}
}
```

## Acknowledgments

- Most of the docstrings were provided by the USGS in their API documentation.  
- The download application took initial inspiration from [the example script provided by the USGS](https://m2m.cr.usgs.gov/api/docs/example/download_data-py).
- `docs/requirements.txt` is taken from [here](https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html)

