carms.state {CARMS}

Modify an "carms" Object adding a state element

Description

This function defines a state with attributes for diagram name, size, proportion and placement in a diagram.

Usage

carms.state(x, prob,  name, size=4, h2w=21/24, position,
		Pfunction=NULL, plot.line.color=NULL,  description="")
	

Arguments

x

An "carms" object as initialized by carms.make or modified only by previous carms.state calls

prob

An initial probability.

name

A string that will be used to identify the state on a diagram.

size

A relative value for the state element often determined by trial and modification of diagram development.

h2w

A proportion value for the state element often determined by trial and modification of diagram development.

position

A vector of (column, row) related to the diagram grid and often determined by trial and modification of diagram development.

Pfunction

A string defining a function providing for an alternative probability determination after simulation, typically accumulating the probabilty values of several other states.

plot.line.color

A string providing for an override of the default color palatte designation for this particular state on the simulation plot.

description

A string providing more information about the state (never seen on diagram nor plot).

Value

The input object will be returned with the addition this state information in the "carms$state" list element.

References

Jan Pukite and Paul Pukite (1998), "Modeling for Reliability Analysis", IEEE Press, New York

William J. Stewart (1994), "Introduction to the numerical solution of Markov chains", Princeton University Press, Princeton

Examples

	SiSimpl<-carms.make(title="Parallel            Identical components", diagram_grid=c(5,8))
	SiSimpl<-carms.state(SiSimpl, prob=1, name="P1", size=7, h2w=14/20, position=c(2,3) )
	SiSimpl<-carms.state(SiSimpl, prob=0, name="P2", size=7, h2w=14/20, position=c(6,3) )