Home

callusgs aims to be a complete and (mostly) typed implementation of USGS’s machine-to-machine API (v1.5.0). In addition, callusgs provides a suite of command line tools that can be used to query and download scenes, use the geocoding service provided by the USGSS and convert WRS 1/2 coordinates to geographic coordinates.

See also

Setup

More detailed setup information for callusgs

User Guide

How to provide callUSGS with your login credentials and other login methods.

API Restrictions

What can be expected to function when not applying for the MACHINE role.

Features

callusgs is both a Python package and a suite of command line tools that allows

1. Downloading of select products (see table below)

2. Access to the USGS geocoding API

3. Conversion between the WRS1 and WRS2 grids to geographic coordinates and

4. clean up of download order queues (mainly as utility functionality)

Currently supported products for download are:

Product string	Prodcut Name
landsat_em_c2_l1	Landsat 4/5 Collection 2 Level 1
landsat_em_c2_l2	Landsat 4/5 Collection 2 Level 1
landsat_etm_c2_l1	Landsat 7 Collection 2 Level 1
landsat_etm_c2_l2	Landsat 7 Collection 2 Level 2
landsat_ot_c2_l1	Landsat 8/9 Collection 2 Level 1
landsat_ot_c2_l2	Landsat 8/9 Collection 2 Level 2
landsat_ba_tile_c2	Landsat Burned Area Product
landsat_dswe_tile_c2	Landsat Dynamic Surface Water Extent
landsat_fsca_tile_c2	Landsat Fractional Snow Covered Area
gmted2010	GMTED 2010 DEM

Installation

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

pip install callusgs

Alternatively, if you’re only interested in the CLI functionality of this tool the best choice is probably to use pipx for installation.

pipx install callusgs