fCressieRead {OnomasticDiversity} | R Documentation |
Cressie and Read
Description
This function obtains the Cressie and Read statistics introduced by Noel Cressie and Timothy Read. It is a method for quantifying species biodiversity that can be adapted to the context of onomastics.
Usage
fCressieRead(x, number, population, ni, location, lambda)
Arguments
x |
dataframe of the data values. |
number |
name of a variable which represents number of individuals of each species. |
population |
name of variable which represents total number of individuals. |
ni |
name of variable which represent number of species. |
location |
name of variable which represent represents the grouping element. |
lambda |
free parameter. |
Details
For a community i
, Cressie and Read (1984) introduced the following parametric form for a generalised statistic
I_n (\lambda) = \frac{2}{\lambda(\lambda+1)} \sum_{k\in S_i} { n_{ki} \left[ \left(\frac{n_{ki}}{n/S_i}\right)^\lambda-1\right]}
, where n_{ki}
represents the number of individuals of species k
in a sample (in the population is N_{ki}
), S_i
represents all species at the community, species richness, and \lambda
is a free parameter.
Varying the value of \lambda
gets different statistics.
If \lambda= -1
and \lambda= 0
, I_n(\lambda)
is not defined, but in any case, limits \lambda = -1
and \lambda = 0
can be taken.
In onomastic context, n_{ki}
(\approx N_{ki}
) denotes the absolute frequency of surname k
in region i
(\approx
community diversity context i
).
Value
A dataframe containing the following components:
location |
represents the grouping element, for example the communities / regions. |
cressieRead |
the value of Cressie and Read statistics. |
Author(s)
Maria Jose Ginzo Villamayor
References
Cressie, Noel and Read, Timothy RC (1984) Multinomial goodness-of-fit tests. Computational Statistics and Data Analysis, 46(3), 440–464.
See Also
Examples
data(surnamesgal14)
result = fCressieRead(x= surnamesgal14 , number="number",
population="population", location = "muni", ni="ni",
lambda = 2)
result