GRASS logo

NAME

r.meb - Compute the multivariate environmental bias (MEB)

KEYWORDS

similarity, raster, modelling

SYNOPSIS

r.meb
r.meb --help
r.meb [-imno] env=names[,names,...] ref=names [output=names] [file=name] [digits=string] [--overwrite] [--help] [--verbose] [--quiet] [--ui]

Flags:

-i
Compute EB for individual variables
-m
Use mean values of IES layers to compute MES
-n
Use median values of IES layers to compute MES
-o
Use minimum values of IES layers to compute MES
--overwrite
Allow output files to overwrite existing files
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog

Parameters:

env=names[,names,...] [required]
Environmental layers
Raster map(s) of environmental conditions
ref=names [required]
Reference area
Sub-area (1) within region (1+0) for which to compute the EB
output=names
Root of name output layers
Output MES layer (and root for IES layers if kept)
file=name
Name of output text file
Name of output text file (csv format)
digits=string
Precision of your input layers values
Default: 5

Table of contents

DESCRIPTION

The Multivariate Environmental Bias (MEB) takes the medium conditions in an reference area N and computes how much conditions in a subset of N (S) deviate from these medium conditions (van Breugel et al. 2015). This can for example be used to see how well conditions in the protected areas of a country represent conditions in the whole country.

The measure is based on the Multivariate Environmental Similarity (MES) surface, which was proposed by Elith et al (2010). The MESS measures the similarity in a set of variables between any given location in an area and the locations in a reference area.

The first step to compute the MES for a location P is to calculate how similar conditions in P are compared to the conditions in the reference area N, based on variable Vi. The similarity is expressed as the deviation from Vi in P from the median of Vi in N. This is done for all variables of interest (V1, V2, ...Vj).

In the original equation proposed by Elith et al (2010) the final MES in location P is computed as the minimum of the similarity values (IESminimum) of the individual variables (Vj) in P. However, to compute the MEB using the mean or median may be a better choice as they take into account the similarity along all environmnetal axes and not only the one that deviates most. The user therefore has the option to use the mean (IESmean) or median (IESmedian) of the IES instead (there is still the option to use the minimum as well).

The MEB is computed as the absolute difference of the median of the MES in the whole target area (MESN) and the median of the MES in the subset (MESS), divided by the median absolute deviation (MAD) of the MES in N. It is also possible to compute the bias based on the individual variables (IEB) in which case the IES instead of the MES is used.

The addon creates a MES layer and a table (saved to csv file) with the median value of each variable in the region and in the reference area, the median absolute deviation (mad) and the environmental bias (eb). Optionally, this can be computed for the individual variables as well. The user has the option to have the addon compute the MEB based on the MES computed using the minimum, average and/or median of the IES layers (see above)

NOTE

Input variables are expected to be or to represent continuous variables.

Example

In the example below the MEB is computed for a map 'forestmap' which gives the distribution of forest (1) and other land cover types (0). As environmental variables, the bio1, bio3 and bio9 are used.
r.meb -m -n -o env=bio_1,bio_3,bio_9 ref=forestmap
output=Test file=Test
Median Test_MES_mean (all region) = 47.338
Median Test_MES_mean (ref. area) = 69.798
MAD Test_MES_mean (all region) = 14.594
EB = 1.539

Median Test_MES_median (all region) = 45.712
Median Test_MES_median (ref. area) = 69.897
MAD Test_MES_median (all region) = 18.786
EB = 1.287

Median Test_MES_minimum (all region) = 20.364
Median Test_MES_minimum (ref. area) = 55.807
MAD Test_MES_minimum (all region) = 15.096
EB = 2.348

The results are written to Test.csv

CITATION

van Breugel P, Kindt R, Lillesø J-PB, van Breugel M (2015) Environmental Gap Analysis to Prioritize Conservation Efforts in Eastern Africa. PLoS ONE 10(4): e0121444. doi: 10.1371/journal.pone.0121444

REFERENCES

SEE ALSO

r.mess

AUTHOR

Paulo van Breugel, paulo at ecodiv.earth

SOURCE CODE

Available at: r.meb source code (history)

Latest change: Monday Jan 30 19:52:26 2023 in commit: cac8d9d848299297977d1315b7e90cc3f7698730


Main index | Raster index | Topics index | Keywords index | Graphical index | Full index

© 2003-2023 GRASS Development Team, GRASS GIS 8.3.dev Reference Manual