getOrderedMatrix {steepness}

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)