S3 Functions that initialize the Metropolis-Hastings Proposal (ergm_proposal)
object using the InitErgmProposal.*
function that corresponds to the name given in
'object'. These functions are not generally called directly by the user.
See ergmProposal
for general explanation and lists of available
Metropolis-Hastings proposal types.
ergm_proposal(object, ...)# S3 method for character
ergm_proposal(
object,
arguments,
nw,
...,
reference = ergm_reference(trim_env(~Bernoulli), nw, term.options = term.options, ...),
term.options = list()
)
# S3 method for formula
ergm_proposal(
object,
arguments,
nw,
hints = trim_env(~sparse),
...,
term.options = list()
)
# S3 method for term_list
ergm_proposal(
object,
arguments,
nw,
hints = trim_env(~sparse),
...,
term.options = list()
)
# S3 method for ergm_conlist
ergm_proposal(
object,
arguments,
nw,
weights = "default",
class = "c",
reference = trim_env(~Bernoulli),
...,
term.options = list()
)
# S3 method for ergm
ergm_proposal(
object,
...,
constraints = NULL,
arguments = NULL,
nw = NULL,
weights = NULL,
class = "c",
reference = NULL
)
Returns an ergm_proposal object: a list with class ergm_proposal
containing the following named elements:
the C name of the proposal
inputs to be passed to C
shared library name where the proposal
can be found (usually "ergm"
)
the reference distribution
list of arguments passed to
the InitErgmProposal
function; in particular,
constraints
list of constraints
a string generated with the proposal, concatenating the UNIX time (Sys.time()
) to maximum available precision, process ID (Sys.getpid()
), and a counter that starts at -.Machine$integer.max
and increments by 1 with every call; different proposals are, generally, guaranteed to have different strings, but identical proposals are not guaranteed to have the same string
Either a character, a formula
or an
ergm
object. The formula
should be of the format documented in the constraints
argument of ergm()
and in the ERGM constraints documentation.
Further arguments passed to other functions.
A list of parameters used by the InitErgmProposal routines
The network object originally given to ergm()
via 'formula'
A one-sided formula specifying the reference measure (\(h(y)\)) to be used. See help for ERGM reference measures implemented in the ergm package.
A list of additional arguments to be passed to term initializers. See ? term.options
.
Specifies the method used to allocate probabilities of being proposed to dyads, providing an intermediate method (between hints and specifying the proposal name directly) for specifying the proposal; options include "TNT", "StratTNT", "TNT10", "random", "nonobserved" and "default"; default="default"
The class of the proposal; choices include "c", "f", and "d" default="c".
A one-sided formula specifying one or more constraints on
the support of the distribution of the networks being simulated. See the
documentation for a similar argument for ergm()
and see
ergmConstraint
for more information.
ergm_proposal(character)
: object
argument is a character string
giving the R name of the proposal.
ergm_proposal(formula)
: object
argument is an ERGM constraint formula; constructs the ergm_conlist
object and hands off to ergm_proposal.ergm_conlist()
.
ergm_proposal(term_list)
: object
argument is a term_list
;
same implementation as the formula
method.
ergm_proposal(ergm_conlist)
: object
argument is an ERGM constraint
list; constructs the internal ergm_reference
object, looks up the
proposal, and hands off to ergm_proposal.character()
.
ergm_proposal(ergm)
: object
argument is an ergm
fit whose proposals are extracted which is reproduced as best as possible.
InitErgmProposal