R: Auxiliary for Controlling Temporal ERGM Simulation

control.simulate.tergm {tergm} | R Documentation

## Auxiliary for Controlling Temporal ERGM Simulation

### Description

Auxiliary function as user interface for fine-tuning TERGM simulation.

### Usage

    control.simulate.tergm(
      MCMC.burnin.min = NULL,
      MCMC.burnin.max = NULL,
      MCMC.burnin.pval = NULL,
      MCMC.burnin.add = NULL,
      MCMC.prop = NULL,
      MCMC.prop.weights = NULL,
      MCMC.prop.args = NULL,
      MCMC.maxedges = NULL,
      MCMC.maxchanges = NULL,
      term.options = NULL,
      MCMC.packagenames = NULL
    )

    control.simulate.formula.tergm(
      MCMC.burnin.min = 1000,
      MCMC.burnin.max = 1e+05,
      MCMC.burnin.pval = 0.5,
      MCMC.burnin.add = 1,
      MCMC.prop = ~discord + sparse,
      MCMC.prop.weights = "default",
      MCMC.prop.args = NULL,
      MCMC.maxedges = Inf,
      MCMC.maxchanges = 1e+06,
      term.options = NULL,
      MCMC.packagenames = c()
    )

### Arguments

`MCMC.burnin.min, MCMC.burnin.max, MCMC.burnin.pval, MCMC.burnin.add` | Number of Metropolis-Hastings steps per time step used in simulation. By default, this is determined adaptively by keeping track of increments in the Hamming distance between the transitioned-from network and the network being sampled. Once `MCMC.burnin.min` steps have elapsed, the increments are tested against 0, and when their average number becomes statistically indistinguishable from 0 (with the p-value being greater than `MCMC.burnin.pval`), or `MCMC.burnin.max` steps are proposed, whichever comes first, the simulation is stopped after an additional `MCMC.burnin.add` times the number of elapsed steps have been taken. (Stopping immediately would bias the sampling.) To use a fixed number of steps, set `MCMC.burnin.min` and `MCMC.burnin.max` to the same value.
`MCMC.prop` | Hints and/or constraints for selecting and initializing the proposal.
`MCMC.prop.weights` | Specifies the proposal weighting scheme to be used in the MCMC Metropolis-Hastings algorithm. Possible choices may be determined by calling `ergm_proposal_table`.
`MCMC.prop.args` | An alternative, direct way of specifying additional arguments to the proposal.
`MCMC.maxedges` | Maximum number of edges expected in network.
`MCMC.maxchanges` | Maximum number of changes for which to allocate space.
`term.options` | A list of additional arguments to be passed to term initializers. It can also be set globally via `options(ergm.term=list(...))`.
`MCMC.packagenames` | Names of packages in which to look for change statistic functions in addition to those autodetected. This argument should not be needed outside of very strange setups.

### Details

This function is only used within a call to the `simulate` function. See the `usage` section in `simulate.tergm` for details.

### Value

A list with arguments as components.

### See Also

`simulate.tergm`, `simulate.formula`. `control.tergm` performs a similar function for `tergm`.

[Package tergm version 4.0.2 Index]