gmba_ids_from_spi: Get mountain range IDs from SPI regions

In GMBA-biodiversity/gmbaR: A set of R functions to work with the GMBA Inventory v2.0

Get mountain range IDs from SPI regions

Description

Get GMBA Inventory v2.0 mountain range IDs that are within one or more (sub-) regions referenced to in the science-policy-interfaces a) IPBES, the Intergovernmental Science-Policy Platform on Biodiversity and Ecosystem Services, or b) the IPCC, Intergovernmental Panel on Climate Change.

Usage

gmba_ids_from_spi(
  spi,
  regions,
  calc = "maj",
  range_selection = "all",
  manual = NULL
)

Arguments

spi	Character string, either "ipbes" or "ipcc"
regions	Character vector, indicating the IPBES or IPCC regions to get mountain range IDs for. See details for the format of regions needed
calc	Calculation of how mountain ranges are associated with the IPBES or IPCC regions. Options are "maj" (default) and "str". See details for the methodologies
range_selection	Character string, the options are: "all" = all level ranges, cross-scale (returns lists of ids!) (default) "basic" = basic mountain ranges only "300" = ranges included in the 300 pre-selection "100" = ranges included in the 100 pre-selection "level1"-"level10" = ranges pertaining to the respective level of the inventory hierarchy "manual" = range IDs provided with manual
manual	Character string containing the IDs of manually selected mountain ranges. Only needed when range_selection is set to manual. Default is set to NULL

Details

IPBES regions: The subsequent IPBES regions (and subregions) are implemented. In region, use the (sub)region name in the same spelling, incl. upper and lower cases:

1. Africa (Central Africa, East Africa and adjacent islands, North Africa, Southern Africa, West Africa)

2. The Americas (Caribbean, Mesoamerica, North America, South America)

3. Asia and the Pacific (North-East Asia, Oceania, South Asia, South-East Asia, Western Asia)

4. Europe and Central Asia (Central and Western Europe, Central Asia, Eastern Europe)

IPCC regions: The subsequent IPCC AR6 regions are implemented. In region, use the region abbreviations in upper cases:

1. Greenland/Iceland (GIC)

2. N.W.North-America (NWN)

3. N.E.North-America (NEN)

4. W.North-America (WNA)

5. C.North-America (CNA)

6. E.North-America (ENA)

7. N.Central-America (NCA)

8. S.Central-America (SCA)

9. Caribbean (CAR)

10. N.W.South-America (NWS)

11. N.South-America (NSA)

12. N.E.South-America (NES)

13. South-American-Monsoon (SAM)

14. S.W.South-America (SWS)

15. S.E.South-America (SES)

16. S.South-America (SSA)

17. N.Europe (NEU)

18. Western&Central-Asia (WCE)

19. E.Europe (EEU)

20. Mediterranean (MED)

21. Sahara (SAH)

22. Western-Africa (WAF)

23. Central-Africa (CAF)

24. N.Eastern-Africa (NEAF)

25. S.Eastern-Africa (SEAF)

26. W.Southern-Africa (WSAF)

27. E.Southern-Africa (ESAF)

28. Madagascar (MDG)

29. Russian-Arctic (RAR)

30. W.Siberia (WSB)

31. E.Siberia (ESB)

32. Russian-Far-East (RFE)

33. W.C.Asia (WCA)

34. E.C.Asia (ECA)

35. Tibetan-Planteau (TIB)

36. E.Asia (EAS)

37. Arabian-Peninsula (ARP)

38. S.Asia (SAS)

39. S.E.Asia (SEA)

40. N.Australia (NAU)

41. C.Australia (CAU)

42. E.Australia (EAU)

43. S.Australia (SAU)

44. New-Zealand (NZ)

45. E.Antarctica (EAN)

46. W.Antarctica (WAN)

47. Arctic-Ocean (ARO)

48. N.Pacific-Ocean (NPO)

49. Equatorial.Pacific-Ocean (EPO)

50. S.Pacific-Ocean (SPO)

51. N.Atlantic-Ocean (NAO)

52. Equatorial.Atlantic-Ocean (EAO)

53. S.Atlantic-Ocean (SAO)

54. Arabian-Sea (ARS)

55. Bay-of-Bengal (BOB)

56. Equatorial.Indic-Ocean (EIO)

57. S.Indic-Ocean (SIO)

58. Southern-Ocean (SOO)

The method behind calc: We attributed corresponding IPBES or IPCC regions to each of the GMBA Inventory v2.0 polygons by a geometric union between the GMBA_Inventory_v2.0_broad layer on the one hand and the respective reference region shapefiles IPCC AR6 (doi.org/10.5194/essd-12-2959-2020) and IPBES (doi.org/10.5281/zenodo.3928281). Area calculations for all GMBA_V2_ID and IPBES or IPCC reference region combinations were performed after reprojecting each of the two union layers to Mollweide. For each GMBA Inventory v2.0 polygon and reference region combination, we selected the one with the largest overlap and attributed that reference region to the respective GMBA_V2_ID (calc = "maj"). In addition, we created a string with all the reference regions each GMBA_V2_ID intersected with (calc = "str"). The default is set to "maj"

Value

Character vector of the GMBA Inventory v2.0 mountain range IDs associated with the input IPBES or IPCC regions

Examples

## Not run: 
rangeids <- gmba_ids_from_ipcc("ipbes", c("Europe and Central Asia"))

## End(Not run)

GMBA-biodiversity/gmbaR documentation built on Feb. 13, 2025, 8:44 a.m.