getOrderedMatrix: Ordered matrix according to NormDS values

In steepness: Testing Steepness of Dominance Hierarchies

Ordered matrix according to NormDS values

Description

Function to order the observed matrix of dyadic dominance encounters according to the individuals' NormDS values.

Usage

   getOrderedMatrix(X, names=NULL, method=c("Dij","Pij"))

Arguments

X	Empirical sociomatrix containing wins-losses frequencies in dyadic encounters.
names	Character vector with the names of individuals. This vector is NULL by default
method	A character string indicating which dyadic dominance measure is to be used for the computation of David's scores. One of "Dij" or "Pij", can be abbreviated.

Details

getOrderedMatrix is only applied for square matrices in which the set of n actors is also the set of n partners. The matrices must also be numeric.

Value

ordered.matrix	Matrix of observed dyadic dominance encounters ordered according to the individuals' NormDS values.
ordered.names	Vector of individuals' names ordered according to their NormDS values.
order.seq	Sequence used in the order of the matrix of dyadic encounters and the vector of names.

Author(s)

David Leiva [e-mail] & Han de Vries [e-mail].

References

de Vries, H., Stevens, J. M. G., & Vervaecke, H. (2006). Measuring and testing the steepness of dominance hierarchies. Animal Behaviour, 71, 585-592.

See Also

getNormDS.

Examples

##############################################################################
###               Example taken from Vervaecke et al. (2007):              ###
##############################################################################

X <- matrix(c(0,58,50,61,32,37,29,39,25,8,0,22,22,9,27,20,10,48,
              3,3,0,19,29,12,13,19,8,5,8,9,0,33,38,35,32,57,
              4,7,9,1,0,28,26,16,23,4,3,0,0,6,0,7,6,12,
              2,0,4,1,4,4,0,5,3,0,2,1,1,5,8,3,0,10,3,1,3,0,0,4,1,2,0),
              nrow=9,byrow=TRUE)

individuals <- c("V","VS","B","FJ","PR","VB","TOR","MU","ZV")

res <- getOrderedMatrix(X,individuals,method="Dij")$ordered.matrix

print(res,digits=3)

steepness documentation built on May 6, 2022, 9:07 a.m.