stactools-threedep 0.1.5

Subpackage for working with 3DEP data in stactools, a command line tool and Python library for working with STAC.

stactools.threedep

The 3D Elevation Program (3DEP), formerly known as the National Elevation Dataset (NED), is elevation data for the United States. Because 3dep isn't a valid Python package name, this package is named stactools.threedep.

Usage

3DEP items are identified by two attributes: product and id. product is a string that corresponds to the nominal resolution of the data. Options are:

• "1": 1 arc-second DEMs
• "13" 1/3 arc-second DEMs

id is a lat-lon identifier, e.g. n41w106.

Command line

To build a pystac.Collection directly from AWS into a directory named usgs-3dep-stac:

stac threedep create-collection usgs-3dep-stac

If you want to two-step the process, you can download the metadata first:

stac threedep download-metadata usgs-3dep-metadata
stac threedep create-collection usgs-3dep-stac --source usgs-3dep-metadata

API

To create an item from AWS, use stactools.threedep.stac.create_item:

from stactools.threedep import stac
item = stac.create_item_from_product_and_id("1", "n41w106")

You can also create an item directly from the href of a metadata XML file anyhwere:

from stactools.threedep import stac
item = stac.create_item("ftp://rockyftp.cr.usgs.gov/vdelivery/Datasets/Staged/Elevation/1/TIFF/n41w106/USGS_1_n41w106.xml")