{
  "generated_at_utc": "2026-04-07T10:22:59.293401+00:00",
  "description": "Official-source band subsets used for the documentation and mapping examples.",
  "comparison_band_ids": [
    "blue",
    "green",
    "red",
    "nir",
    "swir1",
    "swir2"
  ],
  "example_design": {
    "strategy": "held_out_exact_rows_from_external_full_siac_library",
    "description": "Four exact spectra are selected from the previously composed full SIAC library as public targets. Each query excludes only its own prepared row_id at mapping time, leaving the rest of the full library available.",
    "held_out_samples": [
      {
        "sample_id": "blue_spruce_needles",
        "row_id": "usgs_v7:usgs_v7_002183:Blue_Spruce DW92-5 needles    BECKa AREF",
        "source_id": "usgs_v7",
        "spectrum_id": "usgs_v7_002183",
        "sample_name": "Blue_Spruce DW92-5 needles    BECKa AREF",
        "source_name": "USGS Spectral Library v7",
        "landcover_group": "vegetation",
        "title": "Vegetation holdout",
        "description": "USGS v7 blue spruce needles spectrum used as a query while excluding only the matching prepared row id."
      },
      {
        "sample_id": "pale_brown_silty_loam",
        "row_id": "ecostress_v1:ecostress_v1_002334:Pale brown silty loam",
        "source_id": "ecostress_v1",
        "spectrum_id": "ecostress_v1_002334",
        "sample_name": "Pale brown silty loam",
        "source_name": "ECOSTRESS Spectral Library v1.0",
        "landcover_group": "soil",
        "title": "Soil holdout",
        "description": "ECOSTRESS pale brown silty loam spectrum used as a query while excluding only the matching prepared row id."
      },
      {
        "sample_id": "tap_water",
        "row_id": "ecostress_v1:ecostress_v1_003451:Tap water",
        "source_id": "ecostress_v1",
        "spectrum_id": "ecostress_v1_003451",
        "sample_name": "Tap water",
        "source_name": "ECOSTRESS Spectral Library v1.0",
        "landcover_group": "water",
        "title": "Water holdout",
        "description": "ECOSTRESS tap water spectrum used as a query while excluding only the matching prepared row id."
      },
      {
        "sample_id": "asphalt_road",
        "row_id": "usgs_v7:usgs_v7_000004:Asphalt GDS376 Blck_Road old ASDFRa AREF",
        "source_id": "usgs_v7",
        "spectrum_id": "usgs_v7_000004",
        "sample_name": "Asphalt GDS376 Blck_Road old ASDFRa AREF",
        "source_name": "USGS Spectral Library v7",
        "landcover_group": "urban",
        "title": "Urban holdout",
        "description": "USGS v7 asphalt road spectrum used as a query while excluding only the matching prepared row id."
      }
    ],
    "library_reference": {
      "mode": "external_full_siac_library",
      "siac_root": "build/siac_spectral_library_real_full_raw_no_ghisacasia_no_understory_no_santa37",
      "metadata_csv": "build/siac_spectral_library_real_full_raw_no_ghisacasia_no_understory_no_santa37/tabular/siac_spectra_metadata.csv",
      "spectra_csv": "build/siac_spectral_library_real_full_raw_no_ghisacasia_no_understory_no_santa37/tabular/siac_normalized_spectra.csv",
      "row_count": 77125,
      "landcover_counts": {
        "soil": 60905,
        "unlabeled": 5932,
        "urban": 1474,
        "vegetation": 8723,
        "water": 91
      },
      "build_summary_path": "build/siac_spectral_library_real_full_raw_no_ghisacasia_no_understory_no_santa37/build_summary.json",
      "build_summary": {
        "classified_spectra": 71193,
        "excluded_source_ids": [
          "ghisacasia_v001",
          "understory_estonia_czech"
        ],
        "landcover_counts": {
          "soil": 60905,
          "urban": 1474,
          "vegetation": 8723,
          "water": 91
        },
        "total_spectra": 77125
      }
    },
    "self_exclusion_policy": "exclude_matching_row_id_only",
    "example_k": 10,
    "neighbor_estimator": "simplex_mixture"
  },
  "sensors": [
    {
      "sensor_id": "terra_modis",
      "display_name": "Terra MODIS",
      "source_agency": "NASA MCST",
      "source_document": "Terra_RSR_in-band.xlsx",
      "source_url": "https://mcst.gsfc.nasa.gov/sites/default/files/file_attachments/Terra_RSR_in-band.xlsx",
      "source_note": "Official Terra MODIS in-band relative spectral response workbook.",
      "source_artifacts": [
        {
          "url": "https://mcst.gsfc.nasa.gov/sites/default/files/file_attachments/Terra_RSR_in-band.xlsx",
          "sha256": "f14498183f9258ed691999313a13fc425edb2eb2d89ca676f79abbb6f48ad637",
          "size_bytes": 427103,
          "downloaded_at_utc": "2026-04-07T10:22:59.882944+00:00",
          "local_name": "Terra_RSR_in-band.xlsx",
          "etag": "\"6845f-610f906a512e5\"",
          "last_modified": "Fri, 09 Feb 2024 20:46:44 GMT"
        }
      ],
      "selected_bands": [
        {
          "band_id": "blue",
          "official_band": "Band 3",
          "segment": "vnir",
          "description": "Blue"
        },
        {
          "band_id": "green",
          "official_band": "Band 4",
          "segment": "vnir",
          "description": "Green"
        },
        {
          "band_id": "red",
          "official_band": "Band 1",
          "segment": "vnir",
          "description": "Red"
        },
        {
          "band_id": "nir",
          "official_band": "Band 2",
          "segment": "vnir",
          "description": "Near infrared"
        },
        {
          "band_id": "swir1",
          "official_band": "Band 6",
          "segment": "swir",
          "description": "Shortwave infrared 1"
        },
        {
          "band_id": "swir2",
          "official_band": "Band 7",
          "segment": "swir",
          "description": "Shortwave infrared 2"
        }
      ]
    },
    {
      "sensor_id": "sentinel-2a_msi",
      "display_name": "Sentinel-2A MSI",
      "source_agency": "ESA Copernicus",
      "source_document": "COPE-GSEG-EOPG-TN-15-0007 - Sentinel-2 Spectral Response Functions 2024 - 4.0.xlsx",
      "source_url": "https://sentiwiki.copernicus.eu/__attachments/1692737/COPE-GSEG-EOPG-TN-15-0007%20-%20Sentinel-2%20Spectral%20Response%20Functions%202024%20-%204.0.xlsx",
      "source_note": "Official Sentinel-2 spectral response workbook; the examples use the S2A sheet.",
      "source_artifacts": [
        {
          "url": "https://sentiwiki.copernicus.eu/__attachments/1692737/COPE-GSEG-EOPG-TN-15-0007%20-%20Sentinel-2%20Spectral%20Response%20Functions%202024%20-%204.0.xlsx",
          "sha256": "1a9edc27d692a570911a460d589f188da0fc3e27f0b0bd1ad322059c380519b0",
          "size_bytes": 1339179,
          "downloaded_at_utc": "2026-04-07T10:23:01.499830+00:00",
          "local_name": "Sentinel-2_Spectral_Response_Functions_2024_4.0.xlsx",
          "etag": "\"05a866b9653a4d2bc442df394ea6cc7a\""
        }
      ],
      "selected_bands": [
        {
          "band_id": "ultra_blue",
          "official_band": "B1",
          "segment": "vnir",
          "description": "Coastal aerosol / ultra blue"
        },
        {
          "band_id": "blue",
          "official_band": "B2",
          "segment": "vnir",
          "description": "Blue"
        },
        {
          "band_id": "green",
          "official_band": "B3",
          "segment": "vnir",
          "description": "Green"
        },
        {
          "band_id": "red",
          "official_band": "B4",
          "segment": "vnir",
          "description": "Red"
        },
        {
          "band_id": "nir",
          "official_band": "B08",
          "segment": "vnir",
          "description": "Near infrared"
        },
        {
          "band_id": "swir1",
          "official_band": "B11",
          "segment": "swir",
          "description": "Shortwave infrared 1"
        },
        {
          "band_id": "swir2",
          "official_band": "B12",
          "segment": "swir",
          "description": "Shortwave infrared 2"
        }
      ]
    },
    {
      "sensor_id": "landsat-8_oli",
      "display_name": "Landsat 8 OLI",
      "source_agency": "USGS",
      "source_document": "Spectral Characteristics Viewer band JSON",
      "source_url": "https://landsat.usgs.gov/spectral-characteristics-viewer",
      "source_note": "Official USGS Spectral Characteristics Viewer JSON for Landsat 8 OLI/TIRS reflective bands 1-7.",
      "source_artifacts": [
        {
          "url": "https://landsat.usgs.gov/landsat/spectral_viewer/c3-master/htdocs/data/bands/Landsat8OLITIRS1.json",
          "sha256": "eac3cad7cb80a43bddb933607c9b27d9f90960602461ca90fba8964555020795",
          "size_bytes": 2399,
          "downloaded_at_utc": "2026-04-07T10:23:02.314901+00:00",
          "local_name": "Landsat8OLITIRS1.json",
          "etag": "\"95f-60903fc75d386\"",
          "last_modified": "Tue, 31 Oct 2023 14:29:45 GMT",
          "official_band": "Band 1",
          "band_id": "ultra_blue"
        },
        {
          "url": "https://landsat.usgs.gov/landsat/spectral_viewer/c3-master/htdocs/data/bands/Landsat8OLITIRS2.json",
          "sha256": "9f1c84f0ae4e7ab9e2a8ca350b7d2f4f32a19e807684dfcde7d83a4093a9800d",
          "size_bytes": 6763,
          "downloaded_at_utc": "2026-04-07T10:23:03.145051+00:00",
          "local_name": "Landsat8OLITIRS2.json",
          "etag": "\"1a6b-60903fc7ad0ef\"",
          "last_modified": "Tue, 31 Oct 2023 14:29:45 GMT",
          "official_band": "Band 2",
          "band_id": "blue"
        },
        {
          "url": "https://landsat.usgs.gov/landsat/spectral_viewer/c3-master/htdocs/data/bands/Landsat8OLITIRS3.json",
          "sha256": "e14e09142bfdf6d1c6c28964935567b67c7413697b6ae1a0cdab2acf402aa560",
          "size_bytes": 7218,
          "downloaded_at_utc": "2026-04-07T10:23:04.008958+00:00",
          "local_name": "Landsat8OLITIRS3.json",
          "etag": "\"1c32-60903fc7f8bef\"",
          "last_modified": "Tue, 31 Oct 2023 14:29:46 GMT",
          "official_band": "Band 3",
          "band_id": "green"
        },
        {
          "url": "https://landsat.usgs.gov/landsat/spectral_viewer/c3-master/htdocs/data/bands/Landsat8OLITIRS4.json",
          "sha256": "5fd742b51174422957c30081f18a588d1afaca635f5eaeb6aa5e7a9403c67be1",
          "size_bytes": 4883,
          "downloaded_at_utc": "2026-04-07T10:23:04.877740+00:00",
          "local_name": "Landsat8OLITIRS4.json",
          "etag": "\"1313-60903fc7fab2f\"",
          "last_modified": "Tue, 31 Oct 2023 14:29:46 GMT",
          "official_band": "Band 4",
          "band_id": "red"
        },
        {
          "url": "https://landsat.usgs.gov/landsat/spectral_viewer/c3-master/htdocs/data/bands/Landsat8OLITIRS5.json",
          "sha256": "d67d2a2b3ed833bfd30501ba1c5c91bcc6e4b86b5f52e8a9b02f7bf0a283806e",
          "size_bytes": 5519,
          "downloaded_at_utc": "2026-04-07T10:23:05.694214+00:00",
          "local_name": "Landsat8OLITIRS5.json",
          "etag": "\"158f-60903fc849127\"",
          "last_modified": "Tue, 31 Oct 2023 14:29:46 GMT",
          "official_band": "Band 5",
          "band_id": "nir"
        },
        {
          "url": "https://landsat.usgs.gov/landsat/spectral_viewer/c3-master/htdocs/data/bands/Landsat8OLITIRS6.json",
          "sha256": "1f11f134b29dbd813e223519cd564745dc1ed7dd17c3f8815f9324099aa888f7",
          "size_bytes": 14044,
          "downloaded_at_utc": "2026-04-07T10:23:06.611810+00:00",
          "local_name": "Landsat8OLITIRS6.json",
          "etag": "\"36dc-60903fc849127\"",
          "last_modified": "Tue, 31 Oct 2023 14:29:46 GMT",
          "official_band": "Band 6",
          "band_id": "swir1"
        },
        {
          "url": "https://landsat.usgs.gov/landsat/spectral_viewer/c3-master/htdocs/data/bands/Landsat8OLITIRS7.json",
          "sha256": "9849f924327a10763cb05cadfbbf97152fa9a907e7a9b6d2fc6be9a32b701526",
          "size_bytes": 24487,
          "downloaded_at_utc": "2026-04-07T10:23:07.500010+00:00",
          "local_name": "Landsat8OLITIRS7.json",
          "etag": "\"5fa7-60903fc897338\"",
          "last_modified": "Tue, 31 Oct 2023 14:29:46 GMT",
          "official_band": "Band 7",
          "band_id": "swir2"
        }
      ],
      "selected_bands": [
        {
          "band_id": "ultra_blue",
          "official_band": "Band 1",
          "segment": "vnir",
          "description": "Coastal aerosol / ultra blue"
        },
        {
          "band_id": "blue",
          "official_band": "Band 2",
          "segment": "vnir",
          "description": "Blue"
        },
        {
          "band_id": "green",
          "official_band": "Band 3",
          "segment": "vnir",
          "description": "Green"
        },
        {
          "band_id": "red",
          "official_band": "Band 4",
          "segment": "vnir",
          "description": "Red"
        },
        {
          "band_id": "nir",
          "official_band": "Band 5",
          "segment": "vnir",
          "description": "Near infrared"
        },
        {
          "band_id": "swir1",
          "official_band": "Band 6",
          "segment": "swir",
          "description": "Shortwave infrared 1"
        },
        {
          "band_id": "swir2",
          "official_band": "Band 7",
          "segment": "swir",
          "description": "Shortwave infrared 2"
        }
      ]
    },
    {
      "sensor_id": "landsat-9_oli2",
      "display_name": "Landsat 9 OLI",
      "source_agency": "USGS",
      "source_document": "Spectral Characteristics Viewer band JSON",
      "source_url": "https://landsat.usgs.gov/spectral-characteristics-viewer",
      "source_note": "Official USGS Spectral Characteristics Viewer JSON for Landsat 9 OLI/TIRS reflective bands 1-7.",
      "source_artifacts": [
        {
          "url": "https://landsat.usgs.gov/landsat/spectral_viewer/c3-master/htdocs/data/bands/Landsat9OLITIRS1.json",
          "sha256": "aa5642c4168e5aaeb9e4be82bc635d95c80d434300bb2343eec02238d3f6f01f",
          "size_bytes": 2462,
          "downloaded_at_utc": "2026-04-07T10:23:08.624703+00:00",
          "local_name": "Landsat9OLITIRS1.json",
          "etag": "\"99e-60903fc9379c1\"",
          "last_modified": "Tue, 31 Oct 2023 14:29:47 GMT",
          "official_band": "Band 1",
          "band_id": "ultra_blue"
        },
        {
          "url": "https://landsat.usgs.gov/landsat/spectral_viewer/c3-master/htdocs/data/bands/Landsat9OLITIRS2.json",
          "sha256": "ed573882223f71cdda2119a7d29530f8f2557c33bc6ced2119a48e38ea9cc1b8",
          "size_bytes": 7101,
          "downloaded_at_utc": "2026-04-07T10:23:09.431145+00:00",
          "local_name": "Landsat9OLITIRS2.json",
          "etag": "\"1bbd-60903fc9d3611\"",
          "last_modified": "Tue, 31 Oct 2023 14:29:47 GMT",
          "official_band": "Band 2",
          "band_id": "blue"
        },
        {
          "url": "https://landsat.usgs.gov/landsat/spectral_viewer/c3-master/htdocs/data/bands/Landsat9OLITIRS3.json",
          "sha256": "6d6d6f4567f987c01f7b664aba1d288262cf987d0ffcf8692cb86c7e544d9cd0",
          "size_bytes": 7393,
          "downloaded_at_utc": "2026-04-07T10:23:10.413303+00:00",
          "local_name": "Landsat9OLITIRS3.json",
          "etag": "\"1ce1-60903fc9d610a\"",
          "last_modified": "Tue, 31 Oct 2023 14:29:47 GMT",
          "official_band": "Band 3",
          "band_id": "green"
        },
        {
          "url": "https://landsat.usgs.gov/landsat/spectral_viewer/c3-master/htdocs/data/bands/Landsat9OLITIRS4.json",
          "sha256": "525b561ca2806851c32147b3a1a84512dd497bed97e722da015f688583410801",
          "size_bytes": 5009,
          "downloaded_at_utc": "2026-04-07T10:23:11.205782+00:00",
          "local_name": "Landsat9OLITIRS4.json",
          "etag": "\"1391-60903fca24702\"",
          "last_modified": "Tue, 31 Oct 2023 14:29:48 GMT",
          "official_band": "Band 4",
          "band_id": "red"
        },
        {
          "url": "https://landsat.usgs.gov/landsat/spectral_viewer/c3-master/htdocs/data/bands/Landsat9OLITIRS5.json",
          "sha256": "8bafd07066f5af096495d7e2b4e346f2c96d1e67d5b24a7f214439b014cbbf2d",
          "size_bytes": 5522,
          "downloaded_at_utc": "2026-04-07T10:23:12.064513+00:00",
          "local_name": "Landsat9OLITIRS5.json",
          "etag": "\"1592-60903fca24aea\"",
          "last_modified": "Tue, 31 Oct 2023 14:29:48 GMT",
          "official_band": "Band 5",
          "band_id": "nir"
        },
        {
          "url": "https://landsat.usgs.gov/landsat/spectral_viewer/c3-master/htdocs/data/bands/Landsat9OLITIRS6.json",
          "sha256": "69f4f5c46d451d5fad028558c4809958fad4741b62973e1ea9dbfc56f610e31a",
          "size_bytes": 14053,
          "downloaded_at_utc": "2026-04-07T10:23:12.936750+00:00",
          "local_name": "Landsat9OLITIRS6.json",
          "etag": "\"36e5-60903fca7540b\"",
          "last_modified": "Tue, 31 Oct 2023 14:29:48 GMT",
          "official_band": "Band 6",
          "band_id": "swir1"
        },
        {
          "url": "https://landsat.usgs.gov/landsat/spectral_viewer/c3-master/htdocs/data/bands/Landsat9OLITIRS7.json",
          "sha256": "ba38f81b69c490acd8896f6d409f0aa8da12fda37017254203ec18281af890ca",
          "size_bytes": 24486,
          "downloaded_at_utc": "2026-04-07T10:23:13.880782+00:00",
          "local_name": "Landsat9OLITIRS7.json",
          "etag": "\"5fa6-60903fca7540b\"",
          "last_modified": "Tue, 31 Oct 2023 14:29:48 GMT",
          "official_band": "Band 7",
          "band_id": "swir2"
        }
      ],
      "selected_bands": [
        {
          "band_id": "ultra_blue",
          "official_band": "Band 1",
          "segment": "vnir",
          "description": "Coastal aerosol / ultra blue"
        },
        {
          "band_id": "blue",
          "official_band": "Band 2",
          "segment": "vnir",
          "description": "Blue"
        },
        {
          "band_id": "green",
          "official_band": "Band 3",
          "segment": "vnir",
          "description": "Green"
        },
        {
          "band_id": "red",
          "official_band": "Band 4",
          "segment": "vnir",
          "description": "Red"
        },
        {
          "band_id": "nir",
          "official_band": "Band 5",
          "segment": "vnir",
          "description": "Near infrared"
        },
        {
          "band_id": "swir1",
          "official_band": "Band 6",
          "segment": "swir",
          "description": "Shortwave infrared 1"
        },
        {
          "band_id": "swir2",
          "official_band": "Band 7",
          "segment": "swir",
          "description": "Shortwave infrared 2"
        }
      ]
    }
  ]
}
