CohenD: Calculate Cohen's cumulative distance
In popdemo: Demographic Modelling Using Projection Matrices

Description Usage Arguments Details Value References See Also Examples

Calculate Cohen's cumulative distance metric for a population matrix projection model.

1	CohenD(A, vector)

`A`	a square, irreducible, non-negative numeric matrix of any dimension.
`vector`	a numeric vector or one-column matrix describing the age/stage distribution used to calculate the distance.

Calculates the cumulative distance metric as outlined in Cohen (1979). Will not work for reducible matrices and returns a warning for imprimitive matrices (although will not function for imprimitive matrices with nonzero imaginary components in the dominant eigenpair).

Cohen's D1.

Cohen (1979) SIAM J. Appl. Math., 36, 169-175.
Stott et al. (2011) Ecol. Lett., 14, 959-970.

Other DistanceMeasures: KeyfitzD(), projectionD()

  # Create a 3x3 PPM
  ( A <- matrix(c(0,1,2,0.5,0.1,0,0,0.6,0.6), byrow=TRUE, ncol=3) )

  # Create an initial stage structure
  ( initial <- c(1,3,2) )

  # Calculate Cohen cumulative distance
  CohenD(A, vector=initial)