assoc.gfi: Generalized affiliation index

Description Usage Arguments Details Value Author(s) References

View source: R/assoc.gfi.R

Description

Computes generalized affiliation indices based on a matrix of interactions or associations and a confounding factor.

Usage

1
assoc.gfi(M1, M2, fr = TRUE, sym = FALSE, erase.diag = TRUE)

Arguments

M1

a square adjacency matrix representing individual interactions or associations.

M2

a square adjacency matrix representing individual values of confounding factors.

fr

if true, it considers the argument M1 as an adjacency matrix representing interaction frequencies between individuals. Otherwise, it considers the argument M1 as an adjacency matrix representing associations between individuals.

sym

if true, it considers the argument M1 as an adjacency matrix representing symmetric interactions/associations.

erase.diag

if true, it omits the diagonal of the matrix.

Details

Generalized affiliation indices allow to control for individual associations by a given confounding factor (such as temporal or spatial overlaps, gregariousness, social unit membership, kinship...). The principle is to perform a Generalized Linear Regression (GLR) on both matrices (one representing the individual interactions/associations and the other one representing the confounding factor) and to use GLR residuals as association indices. For an adjacency matrix representing individual interactions, the GLR belongs to the Poisson family. For an adjacency matrix representing individual associations, the GLR belongs to the Binomial family. High positive values suggest strong associations between two individuals and negative values suggest avoidance between two individuals.

Value

a square adjacency matrix representing the generalized affiliation index between individuals.

Author(s)

Sebastian Sosa, Ivan Puga-Gonzalez.

References

Whitehead, H., & James, R. (2015). Generalized affiliation indices extract affiliations from social network data. Methods in Ecology and Evolution, 6(7), 836-844.


SebastianSosa/ant documentation built on Dec. 5, 2018, 2:24 a.m.