Skip to content

Collection overview: show discrete band legend #356

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jdries opened this issue Apr 28, 2025 · 1 comment
Open

Collection overview: show discrete band legend #356

jdries opened this issue Apr 28, 2025 · 1 comment
Labels
enhancement New feature or request upstream

Comments

@jdries
Copy link

jdries commented Apr 28, 2025

For users, it is important to know the classes available in discrete bands. Often, they have to be retrieved from the product user manuals, which can be tedious.
STAC metadata can represent this info via the classification extension, so if the web editor can render this nicely, our users will be able to find it much more easily.

Here's an example of raster:bands I just added to summaries of ESA WorldCover. I'm also open to suggestions on a best practice for this type of band in collection metadata.


 "summaries": {
      "eo:bands": [
        {
          "name": "MAP",
          "gsd": 10,
          "type": "uint8"
        }
      ],
       "raster:bands": [
         {
           "classification:classes": [
             {
               "value": 10,
               "name": "Tree cover",
               "description": "This class includes any geographic area dominated by trees with a\ncover of 10% or more. Other land cover classes (shrubs and/or herbs\nin the understorey, built-up, permanent water bodies, …) can be\npresent below the canopy, even with a density higher than trees.\nAreas planted with trees for afforestation purposes and plantations\n(e.g. oil palm, olive trees) are included in this class. This class also\nincludes tree covered areas seasonally or permanently flooded with\nfresh water except for mangroves."
             },
             {
               "value": 20,
               "name": "Shrubland",
               "description": "This class includes any geographic area dominated by natural shrubs\nhaving a cover of 10% or more. Shrubs are defined as woody\nperennial plants with persistent and woody stems and without any\ndefined main stem being less than 5 m tall. Trees can be present in\nscattered form if their cover is less than 10%. Herbaceous plants can\nalso be present at any density. The shrub foliage can be either\nevergreen or deciduous."
             },
             {
               "value": 30,
               "name": "Grassland",
               "description": "This class includes any geographic area dominated by natural\nherbaceous plants (Plants without persistent stem or shoots above\nground and lacking definite firm structure): (grasslands, prairies,\nsteppes, savannahs, pastures) with a cover of 10% or more,\nirrespective of different human and/or animal activities, such as:\ngrazing, selective fire management etc. Woody plants (trees and/or\nshrubs) can be present assuming their cover is less than 10%. It may\nalso contain uncultivated cropland areas (without harvest/ bare soil\nperiod) in the reference year"
             },
             {
               "value": 40,
               "name": "Cropland",
               "description": "Land covered with annual cropland that is sowed/planted and\nharvestable at least once within the 12 months after the\nsowing/planting date. The annual cropland produces an herbaceous\ncover and is sometimes combined with some tree or woody\nvegetation. Note that perennial woody crops will be classified as the\nappropriate tree cover or shrub land cover type. Greenhouses are\nconsidered as built-up."
             },
             {
               "value": 50,
               "name": "Built-up",
               "description": "Land covered by buildings, roads and other man-made structures\nsuch as railroads. Buildings include both residential and industrial\nbuilding. Urban green (parks,\nsport facilities) is not included in this class. Waste dump deposits\nand extraction sites are considered as bare."
             },
             {
               "value": 60,
               "name": "Bare / sparse vegetation",
               "description": "Lands with exposed soil, sand, or rocks and never has more than 10\n% vegetated cover during any time of the year"
             },
             {
               "value": 70,
               "name": "Snow and ice",
               "description": "This class includes any geographic area covered by snow or glaciers\npersistently."
             },
             {
               "value": 80,
               "name": "Permanent water bodies",
               "description": "This class includes any geographic area covered for most of the year\n(more than 9 months) by water bodies: lakes, reservoirs, and rivers.\nCan be either fresh or salt-water bodies. In some cases the water can be frozen for part of the year."
             },
             {
               "value": 90,
               "name": "Herbaceous wetland",
               "description": "Land dominated by natural herbaceous vegetation (cover of 10% or\nmore) that is permanently or regularly flooded by fresh, brackish or\nsalt water. It excludes unvegetated sediment (see 60), swamp\nforests (classified as tree cover) and mangroves see 95)"
             },
             {
               "value": 95,
               "name": "Mangroves",
               "description": "Taxonomically diverse, salt-tolerant tree and other plant species\nwhich thrive in intertidal zones of sheltered tropical shores,\n\"overwash\" islands, and estuaries"
             },
             {
               "value": 100,
               "name": "Moss and lichen",
               "description": "Land covered with lichens and/or mosses. Lichens are composite\norganisms formed from the symbiotic association of fungi and\nalgae. Mosses contain photo-autotrophic land plants without true\nleaves, stems, roots but with leaf-and stemlike organs."
             }
           ]
         }
      ]
    },
@m-mohr m-mohr added enhancement New feature or request upstream labels Apr 30, 2025
@m-mohr
Copy link
Member

m-mohr commented Apr 30, 2025

Where would you want to render it? Collection Overview? Map? ...?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request upstream
Projects
None yet
Development

No branches or pull requests

2 participants