carms.arrow {CARMS}

Modify an "carms" Object adding a transition as an arrow element

Description

This function defines a transition, by attributes of source (from) and destination (to), rate value, connecting arrow arc, position and diagram label.

Usage

carms.arrow(x, from, to, rate, arc=0.35, arrow.position=0.5, label="")
	

Arguments

x

An "carms" object as initialized by carms.make and modified by previous carms.state, carms.base and/or carms.arrow calls

from

The state number (as determined by order of entry) of the source state for transition.

to

The state number (as determined by order of entry) of the destination state for transition.

rate

A base label or formula (either as a string or as global environment labels) utilizing base labels. Alternatively, a single value unassigned as a base.

arc

A convexity/concavity value for the connecting transition arc often determined by trial and modification of diagram development.

arrow.position

A value from 0 to 1 for the location of the arrow on a transition arc as well as the transition label often determined by trial and modification of diagram development.

label

A string defining the transition often as a rate. The rate and label may often be identical, but they are treated in different ways.

Value

The input object will be returned with the addition this arrow information in the "carms$arrows$arrow" 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) )	
	SiSimpl<-carms.base(SiSimpl, 1, time_units="hours",  description="Failure rate")
	SiSimpl<-carms.arrow(SiSimpl, from=1, to=2, rate="B1",label="B1")