map_size: Assesses mapping characteristics across multiple ECM sizes

In johnlpearce/ECM: ECM: Exposure Continuum Mapping

Description

map_size provides diagnostic plots and summaries of select criteria for determining how the size of the SOM influences characteristics of the SOM model.

Usage

map_size(
  trn_dat,
  kmn = NULL,
  kmx = NULL,
  itermax. = NULL,
  nstarts. = NULL,
  maptopo. = NULL,
  distmet. = NULL,
  lmode. = NULL,
  symsize = 1
)

Arguments

trn_dat	is a data object to train the map. Should be a numerical or factor based data matrix.
kmn	is the minimum number of map units (aka nodes) to evaluate. Default value is 2.
kmx	is maximum number of map units (aka nodes) to evaluate. Default is 5*sqrt(n).
itermax.	maximum number of iterations passed to map_ecm. Default is 500*number of map nodes (k).
nstarts.	number of random initializatons passed to map_inits. Default is 5.
maptopo.	map topology passed to map_ecm. Default is hexagonal.
distmet.	distance method passed to map_ecm. Default is Euclidean.
lmode.	self-organizing map learning algorithm passed to map_ecm
symsize	sets symbol size on plots

Details

An important step in the application of ECM are the user provided SOM inputs for the dimensions of the mapping (i.e., size). Here we provide common model performance metrics and class-level evaluations in effort to assist the user in determining an appropriate map size.

Value

Panels a-d on the diagnostic plot illustrate common model performance metrics as a function of map size. Panels e-f examine within-class-sum-of-squares and frequency distributions as a function of map size. A list of model and class-level perfomance statistics is also returned.

• xdim x dimension

• ydim y dimension

• k Number of map nodes

• R2 R2

• ADJ_R2 Adjusted R2

• MAE mean absolute error based on class assignment distances

• RMSE root-mean-square-error based on class assignment distances

• AIC a form of Akaikes Information Criteria applied to clustering algorithms

• TotWCSS Total Within-Cluster Sum-of-Squares

• N Number class assignments

• FREQ Proportion of class assignments

• WCD average within-class distance

• BCD average between-class distance

• WB_Ratio WCD/BCD

johnlpearce/ECM documentation built on Dec. 21, 2021, 2:13 a.m.