Add Landsat 1-5 (MSS and TM) and 7 (ETM) Item creation

.dockerignore

@@ -1,3 +1,4 @@
+z-dev
 .git
 .github
 .gitignore

.github/workflows/continuous-integration.yml

@@ -56,87 +56,3 @@ jobs:
         run: conda env update -f environment.yml -n test
       - name: Execute linters and test suites
         run: ./scripts/cibuild
-  docker:
-    name: docker
-    needs:
-      - codecov
-      - python-matrix
-    permissions:
-      contents: read
-      packages: write
-    runs-on: ubuntu-latest
-    steps:
-      - name: Set up Python 3.x
-        uses: actions/setup-python@v2
-        with:
-          python-version: "3.x"
-      -
-        name: Checkout
-        uses: actions/checkout@v2
-      -
-        name: Login to GitHub Container Registry
-        uses: docker/login-action@v1
-        with:
-          registry: ${{ env.DOCKER_REGISTRY }}
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
-      - name: Run rename script if in the template repo
-        run: |
-          if [[ "$GITHUB_REPOSITORY" == */template ]]; then
-            scripts/rename
-          fi
-      - name: Source build args
-        run: |
-          source ./docker_env
-          STACTOOLS_VERSION=$(python scripts/stactools-version.py)
-          echo "stactools_version=$STACTOOLS_VERSION" >> $GITHUB_ENV
-          echo "docker_workdir=$DOCKER_WORKDIR" >> $GITHUB_ENV
-          echo "docker_namespace_package_dir=$DOCKER_NAMESPACE_PACKAGE_DIR" >> $GITHUB_ENV
-      -
-        name: Docker meta main
-        id: meta-main
-        uses: docker/metadata-action@v3
-        with:
-          images: ${{ env.DOCKER_REGISTRY }}/${{ env.DOCKER_IMAGE_NAME }}
-          tags: |
-            type=ref,event=branch
-            type=ref,event=pr
-      -
-        name: Build and push main
-        uses: docker/build-push-action@v2
-        with:
-          context: .
-          file: docker/Dockerfile
-          build-args: |
-            STACTOOLS_VERSION=${{ env.stactools_version }}
-            DOCKER_WORKDIR=${{ env.docker_workdir }}
-            DOCKER_NAMESPACE_PACKAGE_DIR=${{ env.docker_namespace_package_dir }}
-          # Don't try to push if the event is a PR from a fork
-          push: ${{ github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository }}
-          tags: ${{ steps.meta-main.outputs.tags }}
-          labels: ${{ steps.meta-main.outputs.labels }}
-      -
-        name: Docker meta dev
-        id: meta-dev
-        uses: docker/metadata-action@v3
-        with:
-          images: ${{ env.DOCKER_REGISTRY }}/${{ env.DOCKER_IMAGE_NAME }}
-          flavor: |
-            suffix=-dev
-          tags: |
-            type=ref,event=branch
-            type=ref,event=pr
-      -
-        name: Build and push dev
-        uses: docker/build-push-action@v2
-        with:
-          context: .
-          file: docker/Dockerfile-dev
-          build-args: |
-            STACTOOLS_VERSION=${{ env.stactools_version }}
-            DOCKER_WORKDIR=${{ env.docker_workdir }}
-            DOCKER_NAMESPACE_PACKAGE_DIR=${{ env.docker_namespace_package_dir }}
-          # Don't try to push if the event is a PR from a fork
-          push: ${{ github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository }}
-          tags: ${{ steps.meta-dev.outputs.tags }}
-          labels: ${{ steps.meta-dev.outputs.labels }}

CHANGELOG.MD

@@ -6,13 +6,38 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ## [Unreleased]
 
-### Feature
+NOTE: For backwards compatibility, all items under the Added, Changed, and Fixed headings below are ignored for Landsat 8 scenes unless `legacy_l8=False` is passed to the `create_stac_item` function.
 
-- Option to use geometry from the corresponding USGS STAC Item in lieu of computation from the ANG metadata.
+### Added
 
-### Update
+- Collection 2 Level-1 and Level-2 Items from additional instruments and platforms:
+    - Landsat 1-5 Multispectral Scanner System (MSS, Level-1)
+    - Landsat 4-5 Thematic Mapper (TM, Level-2)
+    - Landsat 7 Enhanced Thematic Mapper Plus (ETM+, Level-2)
+    - Landsat 8*-9 Operational Land Imager and Thermal Infrared Sensor (OLI-TIRS, Level-2)
+- Collection 2 Level-1 and Level-2 STAC Collections
+- Item links to corresponding USGS STAC Items
+- Item and Collection DOI links (`scientific` extension) specific to the instrument
+- Option to split or normalize Item geometries that cross the antimeridian
+- Option to use Item geometry from the corresponding USGS STAC Item in lieu of computation from the ANG.txt metadata file
+- `raster extension`
+
+
+### Changed
+
+- Decrease Asset verbosity by moving redundant `projection` extension and `gsd` information from the Assets to Item properties.
+    - Assets having a different `gsd` than specified in the Item properties now override the Item properties `gsd` with their own `gsd` value (i.e., the thermal bands).
+- Update the `landsat` extension from `v1.1.0` to `v1.1.1`
+- Include non-zero `off_nadir` angles for Landsat 8-9
+- Switch to [common EO band names](https://github.com/stac-extensions/eo#common-band-names) for Asset keys to address existence of different band numbers for the same EO band between instruments or platforms
+- Update repository to the stactools-packages [template contents](https://github.com/stac-extensions/template/commit/7dfc84fd70c4cf15d6035968323c0baf8da06dd8).
+
+
+### Fixed
+
+- Correct EPSG code for southern hemisphere scenes to [always use northern hemisphere codes](https://www.usgs.gov/faqs/why-do-landsat-scenes-southern-hemisphere-display-negative-utm-values)
+- Remove incorrect link to USGS STAC browser page
 
-- Repo brought up to date with the current stactools-packages template contents as of 2022-02-18.
 
 ## [0.2.0] - 2021-07-20
 

README.md

@@ -27,16 +27,23 @@ Source: https://pubs.usgs.gov/fs/2015/3081/fs20153081_ver1.2.pdf
 
 ## Examples
 
-### STAC objects
+### STAC Collections and Items
 
-- [Item](examples/item/LC08_L2SP_005009_20150710_02_T2.json)
+- [Collection](examples/landsat-c2-l2/collection.json)
+- [Item](examples/landsat-c2-l1/LM01_L1GS_001010_19720908_02_T2/LM01_L1GS_001010_19720908_02_T2.json)
 
 ### Command-line usage
 
-To create the example STAC `Item`:
+To create a STAC `Item`:
 
 ```bash
-$ stac landsat create-item "tests/data-files/assets/LC08_L2SP_005009_20150710_20200908_02_T2_MTL.xml" "examples/item/LC08_L2SP_005009_20150710_02_T2.json"
+$ stac landsat create-item --mtl tests/data-files/oli-tirs/LC08_L2SP_047027_20201204_20210313_02_T1_MTL.xml --output examples --usgs_geometry
 ```
 
-Use `stac landsat --help` to see all subcommands and options.
+To create a STAC `Collection` from a text file containing a list of Landsat scene XML metadata files:
+
+```bash
+$ stac landsat create-collection --file_list examples/c2-l2-file-list.txt --output examples/landsat-c2-l2 --id landsat-c2-l2 --usgs_geometry
+```
+
+The above `create-collection` command is exactly how the contents of the `examples/landsat-c2-l2` directory are generated.

docker/Dockerfile

@@ -8,9 +8,9 @@ WORKDIR $DOCKER_WORKDIR
 
 # For caching purposes, install dependencies but remove the actual package
 COPY pyproject.toml setup.cfg ./
-COPY src/$DOCKER_NAMESPACE_PACKAGE_DIR/__init__.py src/$DOCKER_NAMESPACE_PACKAGE_DIR/
-RUN pip install . \
-    && rm -r /opt/conda/lib/python$PYTHON_VERSION/site-packages/$DOCKER_NAMESPACE_PACKAGE_DIR
+# COPY src/$DOCKER_NAMESPACE_PACKAGE_DIR/__init__.py src/$DOCKER_NAMESPACE_PACKAGE_DIR/
+# RUN pip install . \
+#     && rm -r /opt/conda/lib/python$PYTHON_VERSION/site-packages/$DOCKER_NAMESPACE_PACKAGE_DIR
 
 COPY src ./src
 RUN pip install .

docker/Dockerfile-dev

@@ -8,10 +8,10 @@ WORKDIR $DOCKER_WORKDIR
 
 # For caching purposes, install dependencies but remove the actual package
 COPY pyproject.toml requirements-dev.txt setup.cfg ./
-COPY src/$DOCKER_NAMESPACE_PACKAGE_DIR/__init__.py src/$DOCKER_NAMESPACE_PACKAGE_DIR/
-RUN pip install -r requirements-dev.txt \
-    && pip install . \
-    && rm -r /opt/conda/lib/python$PYTHON_VERSION/site-packages/$DOCKER_NAMESPACE_PACKAGE_DIR
+# COPY src/$DOCKER_NAMESPACE_PACKAGE_DIR/__init__.py src/$DOCKER_NAMESPACE_PACKAGE_DIR/
+# RUN pip install -r requirements-dev.txt \
+#     && pip install . \
+#     && rm -r /opt/conda/lib/python$PYTHON_VERSION/site-packages/$DOCKER_NAMESPACE_PACKAGE_DIR
 
 COPY . ./
 RUN pip install -e .