flowgraph {heR.Simulation}R Documentation

Plot a Directed Graph of Air Flows

Description

Function to plot the flows in a multi-room dwelling as a network of nodes (i.e. rooms, the outdoors, and the central ventilation system) – with arrows connecting nodes between which air is allowed to flow.

Usage

flowgraph(f, arrow.max = 0.6, circle.max = 0.15, lwd.min = 2,
          labels.out = TRUE, by = NULL, ...)

Arguments

f a square matrix or array containing flows between zones
arrow.max the maximum arrowhead length
circle.max the maximum circle size for the nodes
lwd.min the minimum line width for edges
labels.out logical, whether to plot labels just outside each node circle or not, i.e., at the center of the circle
by character vector containing "col" or "lwd" for plotting edges distiguished by line thickness or by color
... additional arguments to the gplot2 function, which is used to draw the directed graph

Details

This function plots a directed graph with nodes corresponding to zones (rooms, the outdoors, the ventilation system) and edges corresponding to the flows. The line characteristics of each arrow (edge) can be related to the total flow between two nodes in different ways (color, line width, see the by argument) with arrowhead sizes proportional to the magnitude of flow. Different colors are automatically assigned to flows that differ by 10% of the maximum flow.

f is a matrix or 3-way array of flows, see cmpt for the format. It can contain flow specifications for multiple consecutive time periods. If more than one time period is specified (as a third dimension with length greater than 1) an array of network graphs is produced, each graph corresponding to a different time period.

Value

Invoked to produce a directed graph.

Author(s)

Neil Klepeis

See Also

connectiongraph, gplot2, cmpt


[Package heR.Simulation version 0.0.3 Index]