graph.cem {LoopAnalyst}

Graph a Community Effect Matrix

Description

Represents a community effect matrix as a graph in the dot language. This representation is sometimes termed a 'prediction scenario'.

Usage

graph.cem(CEM, file, color="bw")

Arguments

CEM

a community effect matrix to be graphed.

file

a connection or a character string giving the name of the dot file (should have a .dot suffix).

color

select which color mode to graph the system: bw, color, or greyscale. Default bw is black and white.

Details

This function outputs a dot file for use with graphviz or similar graph layout package to visually represent the community effect matrix system. The color options color and greyscale assist in graph readability when there are a large number of nodes and connections between them. Ambiguous effects are represented by dotted edges and tee-style arrowheads.

comments

The representation of loop analytic predictions in graph form is an emerging practice. Feedback and ideas are welcome, and I am amenable to implementing them in future versions of LoopAnalyst. graph.cem does not currently work with weighted.predictions output.

Author(s)

Alexis Dinno ([e-mail])

Please contact me with any questions, bug reports or suggestions for improvement. Fixing bugs will be facilitated by sending along:

[1]	a copy of your relevant R data file (de-labeled or anonymized is fine),
[2]	a copy of the command syntax used, and
[3]	a copy of the exact output of the command.

https://alexisdinno.com/LoopAnalyst/

References

Gansner, E., Koutsofios, E. and North, S. (2002) Drawing graphs with dot. https://www.graphviz.org

Puccia, C. J. and Levins, R. (1986) Qualitative Modeling of Complex Systems: An Introduction to Loop Analysis and Time Averaging. Cambridge: Harvard University Press. <doi:10.4159/harvard.9780674435070>.

See Also

make.cem.

Examples

## graph the community effect matrix of cm.levins 
data(cm.levins)
cem.levins <- make.cem(cm.levins) 
graph.cem(cem.levins, file="levins.dot", color="color") 

## graph the community effect matrix of cm.dambacher 
data(cm.dambacher)
cem.dambacher <- make.cem(cm.dambacher) 
graph.cem(cem.dambacher, file="dambacher.dot", color="color")