expit: Inverse-logit transformation(s)

Description Usage Arguments Details Value Note Author(s) References See Also Examples

View source: R/expit.R

Description

Undertakes an inverse-logit transformation for a vector or single value.

Usage

1
expit(z)

Arguments

z

the value(s) to be inverse-logit transformed. Natural logarithms are used.

Details

Most analytical chemical data for major, minor and trace elements are of a closed form, i.e. for a sample they sum to a constant, whether it be percent, ppm (mg/kg), or some other units. It does not matter that only some components contributing to the constant sum are present in the matrix, the data are closed. As a result, as some elements increase in concentration others must decrease, this leads to statistics and graphical presentations that do not reflect the true underlying situation even in situations of univariate data analysis and display. The logit transformation provides an appropriate transformation for univariate compositional data. Procedures for removing closure effects for multivariate data are additive log-ratios (alr), centred log-ratios (clr), and isometric log-ratios (ilr).

Value

p

the proportion(s) corresponding to the logit transformed value(s), z, passed to the function.

Note

This function is provided so that summary statistics generated by ‘rgr’ functions can be back-transformed to the original units following computations using logit transformed data, see logit.

Author(s)

Robert G. Garrett

References

Filzmoser, P., Hron, K. and Reimann, C., 2009. Univariate statistical analysis of environmental (compositional) data: Problems and possibilities. Science of the Total Environment, 407(1/3):6100-6108.

See Also

logit, alr, clr, ilr

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
## Generate test data
z <- c(1.6, 0, -2.3)

## Undertake and display inverse-logit transformation(s)
p <- expit(z)
p

## Clean-up
rm(z)
rm(p)

Example output

Loading required package: MASS
Loading required package: fastICA
[1] 0.83201839 0.50000000 0.09112296

rgr documentation built on May 2, 2019, 6:09 a.m.

Related to expit in rgr...