feat: Add NLCD example (#16)

* feat: Add NLCD example

* Move maxar data into subfolder

Author: kylebarron

README.md

@@ -31,6 +31,4 @@ Run `pixi run generate`.
 
 ## Image Sources
 
-### Vantor (formerly Maxar)
-
-Some test images are copyright [Vantor](https://vantor.com/), provided under a [Creative Commons Attribution Non Commercial](https://spdx.org/licenses/CC-BY-NC-4.0.html) license via the [Maxar Open Data Program](https://registry.opendata.aws/maxar-open-data/).
+Images in the `real_data/` folder are sourced from various open data programs. See the individual README files in each subfolder for details.

real_data/maxar_opendata_yellowstone_visual.md

@@ -0,0 +1,23 @@
+# NLCD Landcover
+
+Highlights:
+
+- Paletted
+- Custom CRS (not defined by EPSG code)
+
+## Data creation
+
+From
+
+```
+s3://usgs-landcover/annual-nlcd/c1/v1/cu/mosaic/Annual_NLCD_LndCov_2024_CU_C1V1.tif
+```
+
+```bash
+AWS_REQUEST_PAYER=requester pixi run gdal_translate \
+  -srcwin 0 0 256 256 \
+  -of COG \
+  -co BLOCKSIZE=64 \
+  /vsis3/usgs-landcover/annual-nlcd/c1/v1/cu/mosaic/Annual_NLCD_LndCov_2024_CU_C1V1.tif \
+  nlcd_landcover.tif
+```

real_data/nlcd/nlcd_landcover.md

@@ -0,0 +1,46 @@
+```
+Driver: GTiff
+File: real_data/nlcd/nlcd_landcover.tif
+COG: True
+Compression: LZW
+ColorSpace: None
+
+Profile
+    Width:            256
+    Height:           256
+    Bands:            1
+    Tiled:            True
+    Dtype:            uint8
+    NoData:           250.0
+    Alpha Band:       False
+    Internal Mask:    False
+    Interleave:       BAND
+    ColorMap:         True
+    ColorInterp:      ('palette',)
+    Scales:           (1.0,)
+    Offsets:          (0.0,)
+
+Geo
+    Crs:              PROJCS["AEA        WGS84",GEOGCS["WGS 84",DATUM["WGS_1984",SPHEROID["WGS 84",6378137,298.257223563,AUTHORITY["EPSG","7030"]],AUTHORITY["EPSG","6326"]],PRIMEM["Greenwich",0],UNIT["degree",0.0174532925199433,AUTHORITY["EPSG","9122"]],AUTHORITY["EPSG","4326"]],PROJECTION["Albers_Conic_Equal_Area"],PARAMETER["latitude_of_center",23],PARAMETER["longitude_of_center",-96],PARAMETER["standard_parallel_1",29.5],PARAMETER["standard_parallel_2",45.5],PARAMETER["false_easting",0],PARAMETER["false_northing",0],UNIT["metre",1,AUTHORITY["EPSG","9001"]],AXIS["Easting",EAST],AXIS["Northing",NORTH]]
+    Origin:           (-2415585.0, 3314805.0)
+    Resolution:       (30.0, -30.0)
+    BoundingBox:      (-2415585.0, 3307125.0, -2407905.0, 3314805.0)
+    MinZoom:          11
+    MaxZoom:          12
+
+Image Metadata
+    AREA_OR_POINT: Area
+
+Image Structure
+    LAYOUT: COG
+    COMPRESSION: LZW
+    INTERLEAVE: BAND
+
+Band 1
+    ColorInterp: palette
+
+IFD
+    Id      Size           BlockSize     Decimation
+    0       256x256        64x64         0
+    1       128x128        64x64         2
+```

real_data/nlcd/nlcd_landcover.tif

@@ -0,0 +1,3 @@
+# Vantor (formerly Maxar)
+
+The test images in this folder are copyright [Vantor](https://vantor.com/), provided under a [Creative Commons Attribution Non Commercial](https://spdx.org/licenses/CC-BY-NC-4.0.html) license via the [Maxar Open Data Program](https://registry.opendata.aws/maxar-open-data/).

real_data/nlcd/nlcd_landcover_info.md

@@ -0,0 +1,16 @@
+## Repro
+
+From
+```
+https://maxar-opendata.s3.amazonaws.com/events/yellowstone-flooding22/ard/12/120000020112/2022-06-18/10300100D51B8C00-visual.tif
+```
+
+```bash
+pixi run gdal_translate \
+  -srcwin 0 0 64 64 \
+  -of COG \
+  -co COMPRESS=JPEG \
+  -co BLOCKSIZE=32 \
+  /vsicurl/https://maxar-opendata.s3.amazonaws.com/events/yellowstone-flooding22/ard/12/120000020112/2022-06-18/10300100D51B8C00-visual.tif \
+  maxar_opendata_yellowstone_visual.tif
+```

real_data/vantor/README.md

@@ -1,6 +1,6 @@
 ```
 Driver: GTiff
-File: real_data/maxar_opendata_yellowstone_visual.tif
+File: real_data/vantor/maxar_opendata_yellowstone_visual.tif
 COG: True
 Compression: JPEG
 ColorSpace: YCbCr