Skip to content

stocnet/rsiena

Repository files navigation

rsiena

CRAN/METACRAN CRAN/METACRAN GitHub R package version GitHub issues GitHub All Releases

SIENA is a program for the statistical analysis of longitudinal network data, with the focus on social networks. Networks here are understood as entire (complete) networks, not as personal (egocentered) networks: it is assumed that a set of nodes (social actors) is given, and all ties (links) between these nodes are known - except perhaps for a moderate amount of missing data. Longitudinal means that two or more repeated observations ("panel data") are available. The name SIENA stands for Simulation Investigation for Empirical Network Analysis. The R package is called RSiena.

Installation

For most people, the best way to install RSiena is to install the latest version from CRAN:

install.packages("RSiena")

The latest binary release on GitHub will have newer features:

# On Windows:
install.packages("https://github.com/stocnet/rsiena/releases/latest/download/RSiena.zip", repos = NULL)

# On Linux
install.packages("https://github.com/stocnet/rsiena/releases/latest/download/RSiena.tar.gz", repos = NULL)

# On Mac
install.packages("https://github.com/stocnet/rsiena/releases/latest/download/RSiena.tgz", repos = NULL)

To compile and install the source version from GitHub, install the {remotes} package and then run the following. NB: this requires compilation of C++ source files so it may take some time.

# latest version
remotes::install_github("stocnet/rsiena@main")

# development version
remotes::install_github("stocnet/rsiena@develop")

Data types

SIENA is designed for analyzing various types of data as dependent variables:

Longitudinal network data:

This refers to repeated measures of networks on a given node set (although it is allowed that there are some changes in the node set). Models can be specified with actor-oriented as well as tie-oriented dynamics; but mainly the former.

Practical restrictions are that the number of actors should not be too large; a few hundred already is pretty large.

Longitudinal data of networks and behavior:

This is like longitudinal network data, but in addition there are one or more changing nodal variables that are also treated as dependent variables, and referred to as behavior. The network will influence the dynamics of the behavior, and the behavior will influence the dynamics of the network. In other words, this is about the co-evolution of networks and behavior.

Multivariate and two-mode networks:

Network data sets can be multivariate, i.e., be composed of multiple networks on the same node set. Some or all of these networks can be two-mode networks. The restriction is that the first mode must be the same for all networks; the first mode is defined as the set of actors. The second mode node sets are allowed to differ across the various networks in a given data set. For such multivariate data sets, the model again is about the co-evolution of several networks; and this may be combined with behavior.

Manual:

There is an extensive manual which is complementary to the help pages in the package.

Further information...

The main Siena website is here. It has a lot of resources, such as scripts and papers with explanations, and lists of published applications. In future, some of these resources may be migrated to this website; you can find a wiki here that holds much of the information on the original website, including background on SAOMs and RSiena as well as links to teaching materials, literature, and contributing people and projects.

Installation

From binary

Perhaps the easiest way to install RSiena is by installing a compiled binary. Binaries for all major OSes -- Windows, Mac, and Linux -- can be found by clicking on the latest release for your OS here. For Windows you should use the RSiena.zip, for macOS it should be RSiena.tgz, and for Linux RSiena.tar.gz.

Once the file has been downloaded, install the binary appropriate for your Operating System like so:

install.packages("~/Downloads/RSiena.zip", repos = NULL)

amending the file suffix as necessary.

From source

To install from source the latest main version of RSiena from Github, please install the {remotes} package from CRAN and then enter into the console:

remotes::install_github("stocnet/rsiena", ref = "main")

The development version of RSiena can be similarly installed as:

remotes::install_github("stocnet/rsiena@develop")

Citation

To cite the RSiena package in publications use:

Ruth M. Ripley, Tom A. B. Snijders, Zsofia Boda, Andras Voros, and Paulina Preciado (2024). Manual for Siena version 4.0. R package version 1.4.13. https://www.cran.r-project.org/web/packages/RSiena/.

A BibTeX entry for LaTeX users is obtained by requesting

citation(package="RSiena")

in an R session.

For more references, see https://www.stats.ox.ac.uk/~snijders/siena/.