Learn R Programming

HiveR (version 0.2-16)

mineHPD: Examine (mine) a HivePlotData object and extract information contained within it

Description

A HivePlotData object, especially one created fresh using dot2HPD, generally contains a lot of hidden information about the network described. This function can extract this hidden information. This function has options which are quite specific as to what they do. The user can easily write new options and incorporate them (or send them to me for incorporation). This function can be called multiple times using different options to gradually modify the HivePlotData object.

Usage

mineHPD(HPD, option = "rad <- tot.edge.count")

Arguments

HPD
A HivePlotData object.
option
A character string giving the option desired. See Details for current options.

Value

  • A modified HivePlotData object.

Details

option = "rad <- tot.edge.count" This option looks through the HivePlotData object and determines how many edges start or end on each node (the "degree"). This value is then assigned to the radius for that node. option = "axis <- source.man.sink" This option examines the nodes and corresponding edges in a HivePlotData object to determine if the node is a source, manager or sink. A source node only has outgoing edges. A sink node only has incoming edges. A manager has both. Hence, this option treats the HivePlotData object as if it were directed in that the first node of an edge in will be in HPD$nodes$id1 and the second node of an edge will be in HPD$nodes$id2. As a result, this option produces a hive plot with 3 axes. This concept is similar to the idea of FuncMap but the internals are quite different. See also dot2HPD for some details about processing .dot files in an agnostic fashion. option = "remove orphans" removes nodes that have degree zero (no incoming or outgoing edges). option = "remove zero edge" removes edges with length zero, which includes edges that start and end at the same node (as in option = "remove self edge") as well as edges that are zero length because the axis and radius of the start and end nodes just happen to be the same. The node coordinates are the criteria: if an edge starts on a given axis at a given radius and ends at the same point, it is removed. option = "remove self edge" removes edges that start and end on the same node. This differs from option = "remove zero edge" in that it is the node labels that are compared rather than the node coordinates.

References

http://academic.depauw.edu/~hanson/HiveR/HiveR.html

See Also

See the vignette for an example of using this function. Use > vignette("HiveR") to produce the vignette.