Metadata-Version: 2.1
Name: stactools-threedep
Version: 0.2.0
Summary: PROVIDE DESCRIPTION HERE
Home-page: https://github.com/stactools-threedeps/stactools-threedep
Author: stac-utils
Author-email: stac@radiant.earth
License: UNKNOWN
Project-URL: Documentation, https://stactools-threedep.readthedocs.io/en/latest/
Project-URL: Issues, https://github.com/stactools-threedeps/stactools-threedep/issues
Keywords: stactools,pystac,catalog,STAC
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Description-Content-Type: text/markdown
License-File: LICENSE

# stactools-threedep

- Name: threedep
- Package: `stactools.threedep`
- PyPI: https://pypi.org/project/stactools-threedep/
- Owner: @gadomski
- Dataset homepage: https://www.usgs.gov/core-science-systems/ngp/3dep
- STAC extensions used:
  - [proj](https://github.com/stac-extensions/projection/)
- Extra fields:
  - `threedep:region`: A short string identifying a 10x10 latlon box that the data falls within.
    Used to create subcatalogs for multi-level catalog tree.

This package creates STAC items for USGS 3DEP (formerly NED) elevation data.

## Examples

### STAC objects

- [Catalog](examples/catalog.json)
- [Collection](examples/usgs-3dep-1/collection.json)
- [Item](examples/usgs-3dep-1/n40w110/n41w106-1/n41w106-1.json)

### Command-line usage

Create a catalog for all 3DEP data.
This catalog will contain two collections, one for the 1 arc-second data and one for the 1/3 arc-second data:

```bash
$ stac threedep create-catalog destination
```

Create a catalog for a single lat+lon id:

```bash
$ stac threedep create-catalog --id n41w106 destination
```

Download all XML metadata:

```bash
$ stac threedep download-metadata destination
```

Fetch all available IDs:

```bash
$ stac threedep fetch-ids
```

Use `stac threedep --help` to see all subcommands and options.


