Diversity {StrucDiv}  R Documentation 
The functions entropy
, entropyNorm
, contrast
, dissimilarity
and homogeneity
are the (spatial) structural diversity metrics used in the default configurations of strucDiv
and strucDivNest
.
Structural diversity entropy is entropy
with different delta
parameters. Shannon entropy is employed, when delta = 0
.
Shannon entropy has a windowdependent maximum when strucDiv
is used, which may be violated when strucDivNest
is used,
depending on the posterior probabilities of pixel value cooccurrences.
Additionally, the value gradient is considered when delta = 1
or delta = 2
.
The values of structural diversity entropy with delta = 1
or delta = 2
are not restricted and depend on the values of the input raster.
the metric entropyNorm
is Shannon entropy normalized over maximum entropy, which depends on the size of the moving window when no nesting is used.
The metric entropyNorm
ranges between 0 and 1, when strucDiv
is used, but may be larger than 1 when strucDivNest
is used,
depending on the posterior probabilities of pixel value cooccurrences.
The metrics contrast
and dissimilarity
consider the value gradient, their values are not restricted and depend on the values of the input raster.
The metric homogeneity
quantifies the closeness of empirical probabilities to the diagonal and ranges between 0 and 1 when strucDiv
is used,
but may be larger than 1 when strucDivNest
is used, depending on the posterior probabilities of pixel value cooccurrences.
homogeneity(
rank,
delta,
Hetx,
vMat_big = NULL,
SpatMat,
nrp,
narm,
display_progress = TRUE,
...
)
dissimilarity(
rank,
delta,
Hetx,
vMat_big = NULL,
SpatMat,
nrp,
narm,
display_progress,
...
)
contrast(
rank,
delta,
Hetx,
vMat_big = NULL,
SpatMat,
nrp,
narm,
display_progress,
...
)
entropy(
rank,
delta,
Hetx,
vMat_big = NULL,
SpatMat,
nrp,
narm,
display_progress,
...
)
entropyNorm(
rank,
delta,
Hetx,
vMat_big = NULL,
SpatMat,
nrp,
narm,
display_progress,
...
)
rank 
logical. Should values be replaced with ranks in each cooccurrence
matrix (GLCM)? Defaults to 
delta 
numeric, takes 3 options: 
Hetx 
the structural diversity matrix that is returned by an internal function
to the 
vMat_big 
matrix. The matrix containing the pixel values of the outer scale.
Defaults to 
SpatMat 
the GLCM that is returned by an internal function
to the 
nrp 
integer. The total number of pixel pairs. 
narm 
logical. Should NAs be removed?

display_progress 
logical. Should a progress bar be displayed? 
... 
possible further arguments. 
These functions are used internally and are called
as an argument to the strucDiv
and strucDivNest
functions.