landcover_to_p452_clutter_zones

pycraf.pathprof.landcover_to_p452_clutter_zones(landcover_map, conversion_table)

Convert a map of landcover class IDs to P.452 clutter types.

Two pre-defined mappings (conversion tables) are provided in pathprof, one for the Corine landcover survey (by the Copernicus mission) that is a high-resolution database for Europe, and one for IGBP class IDs, which are used e.g., by the Terra and Aqua combined Moderate Resolution Imaging Spectroradiometer, MODIS, which is available for several years. One version of that data, the “MOD12C1” (Majority_Land_Cover_Type_1) map is a (rather low-resolution) version for the full Earth.

Be careful, some data files seem to contain zero-indexed IGBP IDs! One may need to increase the input map values by One in such cases.

Parameters:

landcover_map2D ndarray (usually integer type)

Map of land cover types (e.g. from Corine land cover survey). Data type will usually be some Integer type and must contain land cover class IDs (see e.g. Notes below).

conversion_tabledict

A dictionary with a mapping (conversion) from the land cover ID to the P.452 clutter zone type. Two mappings are pre-defined in pathprof, the CORINE_TO_P452_CLASSES and the IGBP_TO_P452_CLASSES.

Returns:

p452_clutter_zones_map2D ndarray of int8

Map of P.452 clutter zone types derived from the provided dictionary with the landcover class IDs.

Notes

• Corine land cover classes:

  111 Continuous urban fabric

  112 Discontinuous urban fabric

  121 Industrial or commercial units

  122 Road and rail networks and associated land

  123 Port areas

  124 Airports

  131 Mineral extraction sites

  132 Dump sites

  133 Construction sites

  141 Green urban areas

  142 Sport and leisure facilities

  211 Non-irrigated arable land

  212 Permanently irrigated land

  213 Rice fields

  221 Vineyards

  222 Fruit trees and berry plantations

  223 Olive groves

  231 Pastures

  241 Annual crops associated with permanent crops

  242 Complex cultivation patterns

  243 Agricultural land with significant areas of natural vegetation

  244 Agro-forestry areas

  311 Broad-leaved forest

  312 Coniferous forest

  313 Mixed forest

  321 Natural grasslands

  322 Moors and heathland

  323 Sclerophyllous vegetation

  324 Transitional woodland-shrub

  331 Beaches dunes sands

  332 Bare rocks

  333 Sparsely vegetated areas

  334 Burnt areas

  335 Glaciers and perpetual snow

  411 Inland marshes

  412 Peat bogs

  421 Salt marshes

  422 Salines

  423 Intertidal flats

  511 Water courses

  512 Water bodies

  521 Coastal lagoons

  522 Estuaries

  523 Sea and ocean

  999 NODATA

• IGBP land cover classes:

  1 Evergreen needleleaf forests

  2 Evergreen broadleaf forests

  3 Deciduous needleleaf forests

  4 Deciduous broadleaf forests

  5 Mixed forests

  6 Closed shrublands

  7 Open shrublands

  8 Woody savannas

  9 Savannas

  10 Grasslands

  11 Permanent wetlands

  12 Croplands

  13 Urban and built-up lands

  14 Cropland/natural vegetation mosaics

  15 Snow and ice

  16 Barren

  17 Water bodies