convertHStoDS: Convert HS to DS

In IDmeasurer: Assessment of Individual Identity in Animal Signals

Description

This function converts HS to DS. Because the model used to convert values is derived from stats::loess model model, it cannot make predictions outside the range of the values used to construct the model. Our model was tailored to the values frequently used by studies on individuality:
- number of individuals should be between 5 and 40 individuals
- number of observations per individual should be between 5 - 20
- HS value should be between 0 - 12.9

Consider increasing your sampling if number of individuals and number of observations are lower than 5. If number of individuals and observations exceeds the function limits, it might be possible to use the largest possible values allowed by the model to get the estimate - biases get smaller with large sampling, so, if your sampling exceeds function limits a little bit, the estimate should be still quite precise.

Usage

convertHStoDS(nindivs, nobs, HS, se = FALSE)

Arguments

nindivs	Number of individuals. Must be within 5-40 individuals.
nobs	Number of observations per individual. Must be within 5-20 observations.
HS	HS value to be converted into DS. Must be within 0-12.9 bits.
se	should standard errors be computed (takes more time)?

Value

If se = FALSE, Numeric value. DS for a specified number of individuals and number of observations per individual.
If se = TRUE, a list containing components fit, se, residual.scale, df. See predict.loess for more details.

See Also

Other metric conversion: convertDStoHS

Examples

convertHStoDS(nindivs=10, nobs=10, HS=5)

IDmeasurer documentation built on May 9, 2019, 5:02 p.m.