transform_ilr: Isometric Log-Ratios (ILR)

In nexus: Sourcing Archaeological Materials by Chemical Composition

Isometric Log-Ratios (ILR)

Description

Computes ILR transformations.

Usage

transform_ilr(object, ...)

## S4 method for signature 'CompositionMatrix'
transform_ilr(object)

## S4 method for signature 'CLR'
transform_ilr(object)

## S4 method for signature 'ALR'
transform_ilr(object)

Arguments

object	A CompositionMatrix object.
...	Currently not used.

Details

The ILR transformation provides the coordinates of any composition with respect to a given orthonormal basis. transform_ilr() uses the orthonormal basis (Helmert matrix) originally defined by Egozcue et al. (2003).

Value

An ILR object.

Author(s)

N. Frerebeau

References

Egozcue, J. J., Pawlowsky-Glahn, V., Mateu-Figueras, G. & Barceló-Vidal, C. (2003). Isometric Logratio Transformations for Compositional Data Analysis. Mathematical Geology, 35(3), 279-300. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1023/A:1023818214614")}.

Greenacre, M. J. (2019). Compositional Data Analysis in Practice. Boca Raton: CRC Press.

Greenacre, M. J. (2021). Compositional Data Analysis. Annual Review of Statistics and Its Application, 8(1): 271-299. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1146/annurev-statistics-042720-124436")}.

See Also

Other log-ratio transformations: transform_alr(), transform_clr(), transform_inverse(), transform_lr(), transform_plr()

Examples

## Data from Aitchison 1986
data("hongite")

## Coerce to compositional data
coda <- as_composition(hongite)

## Isometric log-ratio
ilr <- transform_ilr(coda)
plr <- transform_plr(coda)

## Inverse transformation
inv_ilr <- transform_inverse(ilr)
all.equal(coda, inv_ilr)

inv_plr <- transform_inverse(plr)
all.equal(coda, inv_plr)

nexus documentation built on Sept. 11, 2024, 6:43 p.m.