# Source: MapBiomas Collection 10 — Annual Land Use and Land Cover
# Type: cog
# Catalog: Manual
# Created for: LULC benchmark pipeline (lulc-benchmark-pipeline ticket)
#
# MapBiomas is an open, collaborative LULC initiative mapping 40 years
# of annual land cover for Brazil (and 15 other country initiatives).
# Collection 10 covers 1985-2024 at 30m resolution with 37 classes.
#
# Reference: MapBiomas Project — mapbiomas.org
# License: CC-BY-4.0

source:
  id: mapbiomas-collection-10-lulc
  name: MapBiomas Collection 10 LULC
  type: cog
  url: https://brasil.mapbiomas.org/en/colecoes-mapbiomas/
  description: >
    Annual land use and land cover maps for Brazil from 1985 to 2024 at
    30m resolution (Landsat-derived). Collection 10 is the latest release
    with 37 thematic classes organized in a 4-level hierarchy covering
    natural vegetation, agriculture, non-vegetated areas, and water bodies.
    Each year is a single GeoTIFF covering all of Brazil. Pixel values are
    integer class codes following the MapBiomas legend.
  provider: MapBiomas
  license: CC-BY-4.0
  metadata:
    connector_id: null
    tags:
    - Land Cover
    - Land Use
    - LULC
    - Brazil
    - Landsat
    - 30m
    - Annual
    - MapBiomas
    - Deforestation
    - Agriculture
    dataset:
      tier: 1
      thematic_group: Vegetation & Agriculture
      format: cog
      resolution: 30m
      crs: EPSG:4326
      classes: 37
      bands:
      - id: classification
        description: Land use/land cover class code (MapBiomas legend, integer 0-62)
        dtype: uint8
      temporal:
        range: 1985-01-01/2024-12-31
        frequency: annual
        type: time_series
        default_range: latest
      quality:
        methodology: >
          Random Forest classification of Landsat 5/7/8/9 annual composites
          using spectral-temporal metrics (wet/dry medians, amplitude, SMA fractions),
          with per-biome training samples and temporal post-filtering to enforce
          transition rules. ~91.5% overall accuracy at Level 1.
        accuracy: >
          Collection 10 overall accuracy ~91.5% at Level 1 (6 classes), ~87% at
          Level 2, ~76% at Level 3. See Pontius et al. 2025, Souza et al. 2020.
        coverage: brazil
      layout:
        type: single
        spatial:
          scheme: national
        uri_template: "https://storage.googleapis.com/mapbiomas-public/initiatives/brasil/collection_10/lulc/coverage/brazil_coverage_{year}.tif"
        parameters:
        - var: year
          description: Year of land cover map (1985-2024)
          values_range: [1985, 2024]
      original_source_url: https://storage.googleapis.com/mapbiomas-public/initiatives/brasil/collection_10/
      homepage: https://brasil.mapbiomas.org/en/colecoes-mapbiomas/
      gee_asset_id: projects/mapbiomas-workspace/public/collection10/mapbiomas_collection100_integration_v1