ergm-package: ergm: Fit, Simulate and Diagnose Exponential-Family Models...

In ergm: Fit, Simulate and Diagnose Exponential-Family Models for Networks

ergm: Fit, Simulate and Diagnose Exponential-Family Models for Networks

Description

An integrated set of tools to analyze and simulate networks based on exponential-family random graph models (ERGMs). 'ergm' is a part of the Statnet suite of packages for network analysis. See Hunter, Handcock, Butts, Goodreau, and Morris (2008) \Sexpr[results=rd]{tools:::Rd_expr_doi("10.18637/jss.v024.i03")} and Krivitsky, Hunter, Morris, and Klumb (2023) \Sexpr[results=rd]{tools:::Rd_expr_doi("10.18637/jss.v105.i06")}.

Details

\insertNoCite

HuHa08e,KrHu23eergm

For a complete list of the functions, use library(help="ergm") or read the rest of the manual. For a simple demonstration, use demo(packages="ergm").

When publishing results obtained using this package, please cite the original authors as described in citation(package="ergm").

All programs derived from this package must cite it. Please see the file LICENSE and https://statnet.org/attribution.

Recent advances in the statistical modeling of random networks have had an impact on the empirical study of social networks. Statistical exponential family models (Strauss and Ikeda 1990) are a generalization of the Markov random network models introduced by \insertCiteFrSt86m;textualergm, which in turn derived from developments in spatial statistics \insertCiteBe74sergm. These models recognize the complex dependencies within relational data structures. To date, the use of stochastic network models for networks has been limited by three interrelated factors: the complexity of realistic models, the lack of simulation tools for inference and validation, and a poor understanding of the inferential properties of nontrivial models.

This manual introduces software tools for the representation, visualization, and analysis of network data that address each of these previous shortcomings. The package relies on the network package which allows networks to be represented in . The ergm package implements maximum likelihood estimates of ERGMs to be calculated using Markov Chain Monte Carlo (via ergm()). The package also provides tools for simulating networks (via simulate.ergm()) and assessing model goodness-of-fit (see mcmc.diagnostics() and gof.ergm()).

A number of Statnet Project packages extend and enhance ergm. These include tergm (Temporal ERGM), which provides extensions for modeling evolution of networks over time; ergm.count, which facilitates exponential family modeling for networks whose dyadic measurements are counts; and ergm.userterms, available on GitHub at https://github.com/statnet/ergm.userterms, which allows users to implement their own ERGM terms.

For detailed information on how to download and install the software, go to the ergm website: https://statnet.org. A tutorial, support newsgroup, references and links to further resources are provided there.

Author(s)

Maintainer: Pavel N. Krivitsky [e-mail] (ORCID)

Authors:

• Mark S. Handcock [e-mail]

• David R. Hunter [e-mail]

• Carter T. Butts [e-mail]

• Steven M. Goodreau [e-mail]

• Martina Morris [e-mail]

Other contributors:

• Li Wang [e-mail] [contributor]

• Kirk Li [e-mail] [contributor]

• Skye Bender-deMoll [e-mail] [contributor]

• Chad Klumb [e-mail] [contributor]

• Michał Bojanowski [e-mail] (ORCID) [contributor]

• Ben Bolker [e-mail] [contributor]

• Christian Schmid [e-mail] [contributor]

• Joyce Cheng [e-mail] [contributor]

• Arya Karami [e-mail] [contributor]

• Adrien Le Guillou [e-mail] (ORCID) [contributor]

References

\insertAllCited

Admiraal R, Handcock MS (2007). networksis: Simulate bipartite graphs with fixed marginals through sequential importance sampling. Statnet Project, Seattle, WA. Version 1, https://statnet.org.

Bender-deMoll S, Morris M, Moody J (2008). Prototype Packages for Managing and Animating Longitudinal Network Data: dynamicnetwork and rSoNIA. Journal of Statistical Software, 24(7). \Sexpr[results=rd]{tools:::Rd_expr_doi("10.18637/jss.v024.i07")}

Boer P, Huisman M, Snijders T, Zeggelink E (2003). StOCNET: an open software system for the advanced statistical analysis of social networks. Groningen: ProGAMMA / ICS, version 1.4 edition.

Butts CT (2007). sna: Tools for Social Network Analysis. R package version 2.3-2. https://cran.r-project.org/package=sna

Butts CT (2008). network: A Package for Managing Relational Data in . Journal of Statistical Software, 24(2). \Sexpr[results=rd]{tools:::Rd_expr_doi("10.18637/jss.v024.i02")}

Butts C (2015). network: Classes for Relational Data. The Statnet Project (https://statnet.org). R package version 1.12.0, https://cran.r-project.org/package=network.

Goodreau SM, Handcock MS, Hunter DR, Butts CT, Morris M (2008a). A statnet Tutorial. Journal of Statistical Software, 24(8). \Sexpr[results=rd]{tools:::Rd_expr_doi("10.18637/jss.v024.i08")}

Goodreau SM, Kitts J, Morris M (2008b). Birds of a Feather, or Friend of a Friend? Using Exponential Random Graph Models to Investigate Adolescent Social Networks. Demography, 45, in press.

Handcock, M. S. (2003) Assessing Degeneracy in Statistical Models of Social Networks, Working Paper #39, Center for Statistics and the Social Sciences, University of Washington. https://csss.uw.edu/research/working-papers/assessing-degeneracy-statistical-models-social-networks

Handcock MS (2003b). degreenet: Models for Skewed Count Distributions Relevant to Networks. Statnet Project, Seattle, WA. Version 1.0, https://statnet.org.

Handcock MS, Hunter DR, Butts CT, Goodreau SM, Morris M (2003b). statnet: Software Tools for the Statistical Modeling of Network Data. Statnet Project, Seattle, WA. Version 3, https://statnet.org.

Hunter, D. R. and Handcock, M. S. (2006) Inference in curved exponential family models for networks, Journal of Computational and Graphical Statistics, 15: 565-583

Krivitsky PN, Handcock MS (2007). latentnet: Latent position and cluster models for statistical networks. Seattle, WA. Version 2, https://statnet.org.

Krivitsky PN (2012). Exponential-Family Random Graph Models for Valued Networks. Electronic Journal of Statistics, 2012, 6, 1100-1128. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1214/12-EJS696")}

Morris M, Handcock MS, Hunter DR (2008). Specification of Exponential-Family Random Graph Models: Terms and Computational Aspects. Journal of Statistical Software, 24(4). \Sexpr[results=rd]{tools:::Rd_expr_doi("10.18637/jss.v024.i04")}

Strauss, D., and Ikeda, M.(1990). Pseudolikelihood estimation for social networks. Journal of the American Statistical Association, 85, 204-212.

See Also

ergmTerm, ergmConstraint, ergmReference, ergmHint, and ergmProposal for indices of model specification and estimation components visible to the ergm's API at any given time.

ergm documentation built on Oct. 7, 2024, 5:08 p.m.