Metadata-Version: 2.1
Name: stactools-drcog-lulc
Version: 0.2.0
Summary: stactools package for Denver Regional Council of Governments (DRCOG) Land Use Land Cover (LULC)
Home-page: https://github.com/stactools-packages/drcog-lulc
Author: Paola Holleway
Author-email: paolaholleway@gmail.com
Project-URL: Issues, https://github.com/stactools-packages/drcog-lulc/issues
Keywords: stactools,pystac,catalog,STAC,landcover
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: Apache Software License
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-drcog-lulc

[![PyPI](https://img.shields.io/pypi/v/stactools-drcog-lulc)](https://pypi.org/project/stactools-drcog-lulc/)

- Name: drcog-lulc
- Package: `stactools.drcog_lulc`
- PyPI: https://pypi.org/project/stactools-drcog-lulc/
- Owner: @pholleway
- Dataset homepage: https://drcog.org/services-and-resources/data-maps-and-modeling/regional-land-use-land-cover-project
- STAC extensions used:
  - [classification](https://github.com/stac-extensions/classification/)
  - [item-assets](https://github.com/stac-extensions/item-assets)
  - [proj](https://github.com/stac-extensions/projection)
  - [raster](https://github.com/stac-extensions/raster)
  - [scientific](https://github.com/stac-extensions/scientific)

This repository will assist you in the generation of STAC files for the Denver Regional Council of Goverments (DRCOG) Land Use Land Cover (LULC) dataset.

DRCOG provides data for 2018 and 2020 in geodatabase form. This package assumes a raster has been extracted from each geodatabase and tiled into smaller cloud optimized GeoTIFF (COG) image files. The tile filenames are expected to contain the prefix `DRCOG_{year}_LULC_`, where `{year}` is either "2018" or "2020".


## Examples

### STAC objects

- [Collection](examples/collection.json)
- [Item](examples/DRCOG_2018_LULC_E3220000_N1710000/DRCOG_2018_LULC_E3220000_N1710000.json)

### Command-line usage

To create a STAC `Item` for a 2018 tile:

```bash
stac drcog-lulc create-item tests/data-files/DRCOG_2018_LULC_E3220000_N1710000.tif examples
```

To create a STAC `Collection` from a file containing a list of DRCOG asset hrefs:

```bash
stac drcog-lulc create-collection examples --file-list examples/file-list.txt
```

The above `create-collection` command is exactly how the contents of the `examples` directory are generated.

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