gemtc (version 0.3)

mtc.model: Generate network meta-analysis models

Description

The mtc.model function generates network meta-analysis models from an mtc.network object.

Usage

mtc.model(network, type = "consistency", factor = 2.5, n.chain = 4,
  likelihood=NULL, link=NULL, ...)

Arguments

network

An object of S3 class mtc.network

type

A string literal indicating the type of model (either "consistency", "ume", or "use").

factor

Variance scaling factor for the starting values

n.chain

Number of chains in the model

likelihood

The likelihood to be used. If unspecified, a suitable likelihood will be inferred for the given data.

link

The link function to be used. If unspecified, a suitable link function will be inferred for the given data.

...

Additional arguments to be passed to the type-specific model generation function.

Value

• An object of class mtc.model. The following elements are descriptive:
• type
  The type of model
• network
  Network the model was generated from
• tree
  Spanning tree formed by the basic parameters
• var.scale
  The scaling factor used to over-disperse starting values
• likelihood
  The likelihood used
• link
  The link function used
• om.scale
  The scale for the variance parameters
• These elements determine the model run by JAGS/BUGS:
• n.chain
  The number of chains
• code
  Model code in JAGS/BUGS syntax
• data
  Data in JAGS/BUGS compatible format
• inits
  Initial values in JAGS/BUGS compatible format
• monitors
  The nodes of the JAGS/BUGS model to monitor
• These latter fields can be modified to alter the statistical model, but such changes may break the model or assumptions made elsewhere in the package.

encoding

utf8

Visualization

Calling the generic plot method on an S3 mtc.model object will show a graph with the treatments as vertices and the comparisons as edges. The lines with solid arrows represent basic parameters, and the other lines represent comparisons that are not associated with any parameter but do have direct evidence from trials.

html{ The example code will generate the following graph:

parkinson.png

{Graph showing structure of a consistency model generated from parkison example data} } latex{ The example code will generate the following graph:

parkinson.pdf

{options: width=3in} } The default layout algorithm is igraph::layout.circle, other layout algorithms can be used by passing them as an optional argument called layout to plot. The igraph::layout.fruchterman.reingold algorithm also seems to produce nice results and may be better for large graphs. The default up-to version 0.1-2 was igraph::layout.kamada.kawai but could produce overlapping edges.

Details

The mtc.model function generates an object of S3 class mtc.model, which can be visualized by the generic plot function or summarized by the generic summary function.

See Also

mtc.network, mtc.run

Examples

file <- system.file("extdata/parkinson.gemtc", package="gemtc")
network <- read.mtc.network(file)
model <- mtc.model(network)
plot(model)
summary(model)