control.stergm: Auxiliary for Controlling Separable Temporal ERGM Fitting

Description

Auxiliary function as user interface for fine-tuning 'stergm' fitting.

Usage

control.stergm(init.form=NULL,
                         init.diss=NULL,
                         init.method=NULL,
                         MCMC.prop.weights.form="default",MCMC.prop.args.form=NULL,
                         MCMC.prop.weights.diss="default",MCMC.prop.args.diss=NULL,
                         MCMC.init.maxedges=20000,
                         MCMC.init.maxchanges=20000,
                         MCMC.packagenames="ergm",
                         MCMC.burnin=1000,
                         CMLE.control=NULL,
                         CMLE.control.form=control.ergm(init=init.form, MCMC.prop.weights=MCMC.prop.weights.form, MCMC.prop.args=MCMC.prop.args.form, MCMC.init.maxedges=MCMC.init.maxedges, MCMC.packagenames=MCMC.packagenames, MCMC.interval=MCMC.burnin, parallel=parallel, parallel.type=parallel.type, parallel.version.check=parallel.version.check),
                         CMLE.control.diss=control.ergm(init=init.diss, MCMC.prop.weights=MCMC.prop.weights.diss, MCMC.prop.args=MCMC.prop.args.diss, MCMC.init.maxedges=MCMC.init.maxedges, MCMC.packagenames=MCMC.packagenames, MCMC.interval=MCMC.burnin, parallel=parallel, parallel.type=parallel.type, parallel.version.check=parallel.version.check),
                         EGMME.main.method=c("Stochastic-Approximation"),
                         SAN.maxit=10,
                         SAN.control=control.san(coef=init.form,
                           SAN.prop.weights=MCMC.prop.weights.form,
                           SAN.prop.args=MCMC.prop.args.form,
                           SAN.init.maxedges=MCMC.init.maxedges,
                           SAN.burnin=MCMC.burnin,
                           SAN.packagenames=MCMC.packagenames,
                           parallel=parallel,
                           parallel.type=parallel.type,
                           parallel.version.check=parallel.version.check),
                         SA.burnin=1000,
                         SA.plot.progress=FALSE,
                         SA.max.plot.points=400,
                         SA.init.gain=0.1,
                         SA.gain.decay=0.8,
                         SA.gain.max.dist.boost=8,
                         SA.runlength=25,
                         SA.interval.mul=2,
                         SA.init.interval=500, 
                         SA.min.interval=20, 
                         SA.phase1.tries=20, 
                         SA.phase1.jitter=0.1, 
                         SA.phase1.max.p=0.001, 
                         SA.phase1.backoff.rat=1.05, 
                         SA.phase2.levels=10, 
                         SA.phase2.repeats=400,
                         SA.stepdown.maxn=100,
                         SA.stepdown.p=0.05,
                         SA.stepdown.ct.base=5,
                         SA.stepdown.ct.subphase=1,
                         SA.phase2.backoff.rat=1.1, 
                         SA.keep.oh=0.5, 
                         SA.phase2.jitter.mul=0.2, 
                         SA.phase2.maxreljump=4, 
                         SA.phase2.refine=FALSE, 
                         SA.refine=c("linear","mean","none"), 
                         SA.se=TRUE, 
                         SA.phase3.samplesize=1000, 
                         seed=NULL,
                         parallel=0,
                         parallel.type=NULL,
                         parallel.version.check=TRUE)

Arguments

init.form, init.diss

numeric or NA vector equal in length to the number of parameters in the formation/dissolution model or NULL (the default); the initial values for the estimation and coefficient offset terms. If NULL is pa

Value

A list with arguments as components.

item

init.method
MCMC.prop.weights.form, MCMC.prop.weights.diss
MCMC.prop.args.form, MCMC.prop.args.diss
MCMC.init.maxedges
MCMC.init.maxchanges
MCMC.packagenames
MCMC.burnin
CMLE.control
CMLE.control.form, CMLE.control.diss
EGMME.main.method
SAN.maxit
SAN.control
SA.burnin
SA.plot.progress
SA.max.plot.points
SA.init.gain
SA.gain.decay
SA.gain.max.dist.boost
SA.runlength
SA.interval.mul
SA.init.interval
SA.min.interval
SA.phase1.tries
SA.phase1.jitter
SA.phase1.max.p
SA.phase1.backoff.rat, SA.phase2.backoff.rat
SA.phase2.levels
SA.phase2.repeats, SA.stepdown.maxn, SA.stepdown.p, SA.stepdown.ct.base, SA.stepdown.ct.subphase
SA.keep.oh
SA.phase2.jitter.mul
SA.phase2.refine
SA.phase2.maxreljump
SA.refine
SA.se
SA.phase3.samplesize
seed
parallel
parallel.type
parallel.version.check

code

ergm

link

parallel processing

Details

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

References

Boer, P., Huisman, M., Snijders, T.A.B., and Zeggelink, E.P.H. (2003), StOCNET User\'s Manual. Version 1.4.
Firth (1993), Bias Reduction in Maximum Likelihood Estimates. Biometrika, 80: 27-38.
Hunter, D. R. and M. S. Handcock (2006), Inference in curved exponential family models for networks. Journal of Computational and Graphical Statistics, 15: 565-583.
Hummel, R. M., Hunter, D. R., and Handcock, M. S. (2010), A Steplength Algorithm for Fitting ERGMs, Penn State Department of Statistics Technical Report.