AOI richer summaries
Context
The AOI section of the Half-Earth Map provides species and contextual data for custom geometries in two different ways: On-The-Fly analysis and Precalculations. In this document, we provide information about the second iteration of AOIs, created during the implementation of the “AOI Richer Summaries” (March 2023). But because these updated AOI also include some information generated in the previous iteration, we also provide links to documentation written during the implementation of the first version of the AOI (2021). Be aware that some of that previous documentation might be deprecated. Still, we consider it to be useful if/when the entire process needs to be carried out again.
- On-The-Fly (OTF) analysis:
The data for user-defined geometries is calculated OTF, using Geoprocessing Services that are published in the ArcGIS Enterprise Portal. These webtools are called directly from the Half-Earth Application to extract the biodiversity (related to species) and contextual data that is displayed on the platform.
The section AOIs and CRFs of this documentation provides more information about how these services are created, including links to the current webtools (published in March 2023) and information about the previous services (published in 2021 and no longer active).
The python code used to generate the first version of the Geoprocessing services can be found in the he-scratchfolder
repo. Also, the lookup tables used in the first process were created with this notebook.
- Precalculated data:
OTF analysis is not efficient for geometries over 35,000 sq. kilometers. For that reason, we have precalculated data for some relevant geometries that are too big or complex to use the GP services. That is the case of countries
, subnational boundaries
, protected areas
, places for the Half-Earth future
and some specific regions
.
The process followed to precalculate data for the first iteration of the AOIs is described in the section Precalculated data. Although it is very likely that some of the tables generated during the first iteration of the AOI are no longer available in AGOL (deprecated layers must be periodically removed), the explanations provided here might be useful for future iterations of the precalculated AOIs.
AOI Richer Summaries
The AOI Richer Summaries were implemented in March 2023 to offer users some visualization improvements and add new calculations to the section “Analyze Areas” of the Half-Earth Map. The new AOIs still use most of the data generated in 2021 during the first iteration of the AOIs, but we have included some updates. The following sections describe the changes and processes carried out during the implementation of this second iteration of the AOIs.
On-The-Fly (OTF) calculations
The new Geoprocessing services in charge of the OTF calculations are much more complex than they were before, especially those that extract the biodiversity data. This is because the AOI richer summaries include additional calculations, such as the SPS and the link to Half-Earth goal, that require the use of additional tools. For that reason, the new biodiversity GP services are considerably more time-consuming than they were before. The model for contextual data has also increased in complexity with the incorporation of five new human pressure layers containing time series.
Furthermore, all the new GP services incorporate a new step to ensure that these calculations are only made for the terrestrial parts of the custom AOI. Thus, when a user defines a geometry that intersects both land and ocean, the new webtools operate only with the terrestrial portion of the area of interest.
- Biodiversity GP Services
The new biodiversity GP services were created in ArcGIS Pro (Project AOI_summaries in the Virtual Machine Viz2) and published on the Half-Earth Portal. The following table provides links to the current services, as well as some information about the CRF used and the output fields needed by the FE to display biodiversity information on the platform:
GP Service | Crf name | Output table | Fields |
---|---|---|---|
AmphibiansProd_SPS | amphibians_equal_area_20211003.crf | output_table | SliceNumber : code of the species; per_global : portion of global range in the AOI; SPS_global : SPS of the species globally; SPS_aoi : SPS of the species in the AOI; meet_target : species meeting conservation targets if AOI is protected; SPS_increase : species increasing SPS is AOI is protected. |
BirdsProd_SPS | birds_equal_area_20211003.crf | output_table | SliceNumber : code of the species; per_global : portion of global range in the AOI; SPS_global : SPS of the species globally; SPS_aoi : SPS of the species in the AOI; meet_target : species meeting conservation targets if AOI is protected; SPS_increase : species increasing SPS is AOI is protected. |
MammalsProd_SPS | mammals_equal_area_20211003.crf | output_table | SliceNumber : code of the species; per_global : portion of global range in the AOI; SPS_global : SPS of the species globally; SPS_aoi : SPS of the species in the AOI; meet_target : species meeting conservation targets if AOI is protected; SPS_increase : species increasing SPS is AOI is protected. |
ReptilesProd_SPS | reptiles_equal_area_20211003.crf | output_table | SliceNumber : code of the species; per_global : portion of global range in the AOI; SPS_global : SPS of the species globally; SPS_aoi : SPS of the species in the AOI; meet_target : species meeting conservation targets if AOI is protected; SPS_increase : species increasing SPS is AOI is protected. |
The new calculations included in these biodiversity are:
1. Species Protection Score (SPS): For each species, the AOI richer summaries provide information about the Species Protection Score, or SPS. Specifically, they include both the Global SPS (SPS_global), and the Area SPS (SPS_aoi).
-
The global SPS of each species is retrieved from the species lookup tables:
This field was calculated according to the equation:
SPS = (((wdpa_km2/range_area_km2)*100)/conservation_target)*100
,
where wdpa km2 refers to the total global area of refined range currently protected (derived from June 2021 WDPA), range area km2 is the total global area of refined range, and conservation target is the percent of global refined range needing protection.
- The Area SPS refers to the SPS value for that specific AOI. The calculation is done directly by the GP service, using both information retrieved from the lookup tables and data extracted by the model tools for that specific AOI. The equation used to calculate the SPS_aoi field is the following:
SPS_aoi = ((range_species_protected_aoi/range_species_aoi)*100/conservation_target)*100
,
where range species protected aoi refers to the range of the species in the AOI that that is currently under protection, range species aoi refers to the range of the species in the AOI, and conservation target is the percent of global range needing protection.
2. Link to the Half-Earth goal:
For custom AOIs (only those calculated OTF), we include a message estimating how much the chosen AOI would contribute to the Half-Earth goal if its entire extent was protected. This calculation is done by the GP services and, depending on the results, the platform will display one of these two sentences:
- “Protecting the appropriate habitats in this area would help satisfy the conservation targets of X species, representing X% of species found here.”
This is related to the field called meet_target
, found on the output table generated by the webtool. It refers to the number of species that would meet their conservation targets if the entire AOI was protected. To get that information, the GP service follows these steps:
- Calculates the unprotected terrestrial area of the AOI
- Adds the resulting area to the column wdpa_km2 (lookup table), which estimates the area of protection of that species
- Recalculates the values on the column percent_protected as
new_percent_protected = (new_wdpa_km2/range_area_km2)*100
- Calculates an hypothetical new_SPS using the new_percent_protected
new_SPS = (new_percent_protected/conservation_target)*100
, with a max value of 100 - Gives a value of 1 (True) to those species that would meet their conservation targets if the entire AOI was protected (SPS <100 but new SPS = 100), and 0 (False) to those that do not meet this condition.
If the hypothetical protection of the entire AOI does not help any species reach their conservation target (i.e., meet_target equals 0 for all species in the AOI), the first sentece is replaced by the next one:
- “Protecting the appropriate habitats in this area would improve the Species Protection Score of X species, moving them closer to their conservation target.”
This is related to the field SPS_increase
given in the output table, and it refers to the number of species that would improve their SPS if the entire AOI was protected. For that, the GP service compares the new SPS with the global SPS score stored in the lookup table (SPS field). Species with new SPS > SPS are given a value of 1 (True), or 0 (False) if the condition is not met.
- Contextual GP Service
The AOI also include some contextual data:
- Population
- Climate regime
- Land cover
- Percentage of protection
- Protected areas
- Human pressures
The only difference with the first iteration of AOI regarding contextual data is the substitution of the previous land encroachment layers (irrigated agriculture, rainfed agriculture, rangeland and urban) for new human pressure layers (human intrusion, urban and built-up, agriculture, transportation and energy and extractive resources). These new layers have a higher resolution and incorporate a time series.
There is only one GP service in charge of extracting all the contextual information. It was created in the ArcGIS Pro project (AOI_contextual in Virtual Machine) and published on the Half-Earth Portal as Contextual_Prod. The next table summarizes the inputs and outputs related to this webtool.
Crf name | Output table | Fields needed by FE |
---|---|---|
population.crf | table_out_population | SUM |
ELU.crf | table_out_elu_majority | MAJORITY |
WDPA_Terrestrial_CEA_June2021.crf | output_table_wdpa_percentage | percentage_protectd |
wdpa_Mercator layer (derived from WDPA_Terrestrial_CEA_June2021.crf) included within model | output_table_wdpa | NAME, ORIG_NAME, DESIG, DESIG_ENG,DESIG_TYPE,IUCN_CAT,GOV_TYPE,STATUS, STATUS_YR, AREA_KM,NAME_0 |
Agriculture_TimeSeries_Reclassify_20230501.crf | agriculture_series | percentage_land_encroachment |
Extraction_TimeSeries_Reclassify_20230501 | extraction_series | percentage_land_encroachment |
Transportation_TimeSeries_Reclassify_20230515.crf | transportation_series | percentage_land_encroachment |
HumanIntrusion_TimeSeries_Reclassify_20230501.crf | intrusion_series | percentage_land_encroachment |
Builtup_TimeSeries_Reclassify_20230501.crf | builtup_series | percentage_land_encroachment |
Precalculated data
Because some common AOIs are too big to be calculated by the Geoprocessing Service, we have generated new precalculated data for:
- Countries - whitelisted service
- Subnational regions - whitelisted service
- WDPA - whitelisted service
- Future places - whitelisted service
- Specific regions - whitelisted service
Except in the case of the WDPAs, these AOI groups also have another layer showing the list of WDPA that intersect each of the geometries contained in these layers:
General details on how the precalculated data was generated are compiled in the section of the documentation called Precalculated data. Although some of the links and tables might be deprecated, the descriptions provided there might still be useful, as most of the precalculated data used in the AOI richer summaries comes from the first iteration.
As with the OTF analysis, the new data incorporated in the precalculations is related to the SPS and the new human pressure layers. The only difference is that we do not include the link to the Half-Earth goal on the precalculations. The project called AOI_Summaries_Precalculations, stored in Viz2 (Vizzuality’s Virtual Machine), was used to collect all data data needed to carry out the new calculations, which were done in the following notebooks:
- SPS: Similar to the OTF calculations, the global SPS of each species is retrieved directly from the field SPS
stored in the species lookup tables listed in the previous section. The SPS specific for the AOI, on the other hand, is calculated in the jupyter notebooks using species data extracted in the ArcPro project AOI_summaries_precalculations
for the protected areas of each AOI.
- Human pressures: Data from the new human pressure layers, which include a time series, is also extracted for each of the precalculated AOIs in the ArcPro Project AOI_summaries_precalculations
, and formated in the corresponding notebooks.
Note: although these new layers have a large coverage, we are only considering pixels classified as high human pressure in our calculations.