CIDnetworks (version 0.6.0)

CIDnetworks-gibbs: CIDnetworks: Bayesian Inference

Description

Usage of CID Gibbs Samplers.

Usage

CID.Gibbs (input,
             outcome,
             components = list(),
             class.outcome = NULL,
             fill.in.missing.edges = missing(outcome),
             new.chain = FALSE,
             draws = 100,
             burnin = -1,
             thin = 10,            
             ...)
  ## S3 method for class 'CID.Gibbs':
print(x, \dots)
  ## S3 method for class 'CID.Gibbs':
summary(object, \dots)
  ## S3 method for class 'CID.Gibbs':
plot(x, \dots)
  ## S3 method for class 'summary.CID.Gibbs':
print(x, \dots)
  likelihood.plot(x, ...)
  intercept.plot(x, trace = FALSE, ...)
  COV.plot(x, ...)
  LSM.plot(x, ...)
  SBM.plot(x, ...)
  MMSBM.plot(x, ...)
  SR.plot(x, ...)
  network.plot (x, fitted.values=FALSE, ...)
  sociogram.plot (x, component.color=0, vertexcolor, ...)
  n.nodes(object)
  edge.list(object)
  is.net.directed(object)
  net.density(object)
  outcome(object)
  node.names(object)
  inDegree(object)
  outDegree(object)
  socio(object)
  value.mat(CID.Gibbs.object, prob = TRUE)
  switcheroo(CID.Gibbs.object)

Arguments

input

An object containing information about the edges in a network. Must be one of the following classes: Matrix, CIDnetwork, or CID.Gibbs. If input is a square matrix, it is assumed to be a sociomatrix. Otherwise a matrix with 2 columns and a

outcome

If an edgelist is provided as input and outcome is missing, the edges provided are assumed to be the ones in a binary sociomatrix. Otherwise, an outcome value must be specified for each edge in the edgelist, and any edges not provided are ass

CID.Gibbs.object

If desired, an existing CID.Gibbs output object can be loaded instead of a new network specification.

components

A list of sub-components, including (COV, HBM, LSM, LVM, MMSBM, SBM, SR).

class.outcome

One of "ordinal" (default, values from 0 to higher integers), "binary" (ordinal in 0 and 1) or "gaussian" (unbounded continuous values). Class is auto-detected if NULL remains in place.

fill.in.missing.edges

If TRUE, the edge list will be augmented with zeroes for all unspecified but possible edges. By default, if an outcome is specified, these edges will not be added.

new.chain

If a CID.Gibbs object is provided, the default value of FALSE will return both the old and new MCMC chain combined. A value of TRUE will drop the old chain completely.

draws

Number of draws to return.

burnin

Number of draws to burnin. A negative value will automatically determine burnin amount.

thin

Amount of draws to thin the chain by.

...

Further arguments to be passed to the Gibbs sampler routine or the plot routine. See details for more.

x, object

An object outputted from CID.Gibbs.

fitted.values

If TRUE, plots the fitted tie strength under the Gibbs sampler. If FALSE, plots the network outcomes as entered.

component.color

If non-zero, colors the nodes in the sociogram according to the output of the Gibbs sampler.

vertexcolor

User-passed vertex colors for sociogram.plot .

trace

If selected, displays the Gibbs sampler trace plot for the intercept rather than a point and interval.

prob

In value.mat, converts the linear predictor value to the probability of a binary edge.

Value

• CID.Gibbs outputs a list containing a CID object, the results of the Gibbs sampler, and the Deviance Information Criterion estimate for the Gibbs.

Details

This is the main routine for running a Gibbs sampler on any of the CID models. See the vignettes for more information.