README.md

In SebastianSosa/ANTs: Animal Network Toolkit Software

Animal Network Toolkit Software (ANTs)

Animal Network Toolkit Software (ANTs) is a free open R package for analysing animal networks.

ANTs is a multi-collaborative project and is meant to continuously evolve. If you wish to contribute by providing suggestions or additional codes please contact us at: [e-mail]

If you need help or if you want to report bugs, please contact us at: [e-mail]

For more information, visit our websites:

www.s-sosa.com/ants

https://www.researchgate.net/project/A-multilevel-statistical-toolkit-to-study-animal-social-networks-Animal-Network-Toolkit-ANT-R-package

Authors: Sebastian Sosa, Ivan Puga-Gonzalez, Hu Feng He, Xiaohua Xie, Cédric Sueur

Description

How animals interact and develop social relationships in face of sociodemographic and ecological pressures is of great interest. New methodologies, in particular Social Network Analysis (SNA), allow us to elucidate these types of questions. However, the different methodologies developed to that end and the speed at which they emerge make their use difficult. Moreover, the lack of communication between the different software developed to provide an answer to the same/different research questions is a source of confusion.

The R package ‘Animal Network Toolkit’ (ANTs) was developed with the aim of implementing in one package the different social network analysis techniques currently used in the study of animal social networks. Hence, ANTs is a toolkit for animal research allowing among other things to: 1) measure global, dyadic and nodal networks metrics; 2) perform data randomization: pre- and post-network (node and link permutations); 3) perform statistical permutation tests as correlation test, t-test, General Linear Model, General Linear Mixed Model, deletion simulation, Matrix TauKr correlations.

The package is partially coded in C++ using the R package Rcpp for an optimal coding speed.

The package gives researchers a workflow from the raw data to the achievement of statistical analyses, allowing for a multilevel approach: from the individual’s position and role within the network, to the identification of interactional patterns, and the study of the overall network properties.

Furthermore, ANTs also provides a guideline on the SNA techniques used: 1) from the appropriate randomization technique according to the data collected; 2) to the choice, the meaning, the limitations and advantages of the network metrics to apply, 3) and the type of statistical tests to run. The ANTs project is multi-collaborative, aiming to provide access to advanced social network analysis techniques and to create new ones that meet researchers’ needs in future versions.

Installation of stable version

In R, use the command line : install.packages("ANTs") Then load it to use it, with the command line: library(ANTs)

Installation of version in development

1. Install R 4.0.0 at least
2. For : 
     a. Windows users, install Rtools at https://cran.r-project.org/bin/windows/Rtools/
     b. Mac users, install Xcode from the Mac App Store.
     c. Linux users, install a compiler and various development libraries (details vary across different flavors of Linux).

3. Install R package devtool with the following command: install.packages("devtools")

4. Install ANTs with the following command: devtools::install_github("SebastianSosa/ANTs")

Vignette

Tutorials

1. Tutorial 1: Examining node level in static or time-aggregated networks with R package ANTs through node label permutations

2. Tutorial 2: Examining node level in static or time-aggregated networks with R package ANTs through data stream permutations

3. Videos at https://www.s-sosa.com/videos

SebastianSosa/ANTs documentation built on Sept. 25, 2023, 11:06 p.m.