glyph-arrow: The arrow glyph creates a graphic of a two data points, from a beginning point to an end point.
Description
The arrow glyph creates a simple arrow with pointing heads from a beginning point (col1 value) to the ending point (col2 value). If the beginning and ending point values are the same, a solid dot will be used to represent the two points. The point value is provided through the col1 and col2 in panelDesc data.frame providing named/numbers of columns in the statsDFrame user provided data structure. Only the points related to the area rows associated to the group/row are used to create the arrow for that area. If the median consist of only a single area, the single arrow is plotted in the group/row. The panelDesc variables col1 or col2 provide the name/number of the data columns in the statsDFrame data.frame supplied by the user.
Arguments
Value
None
Author
Jim Pearson, StatNet Consulting, LLC, Gaithersburg, MD
Details
The col1 snd col2 panelDesc variable provide the name/number of the column in the statsDFrame containing data values used to plot the beginning and end points of each arrow. The beginning value may be higher than the ending point to identify arrow going down between the col1 and col2 time points.
The user can specify the lab1, lab2, lab3, lab4, refval, and reftxt information/values in the appropriate column j related to the glyph in the panelDesc provide additional information on how to create the glyph graphic column. The information is used to create the column headers, trailers, and reference information.
An X-axis is drawn above and below the column based on the data provided in the col1 an col2 columns in the statsDFrame provided by the user.
For the arrow glyph, the col1 and col2 column names/numbers must be supplied.
panelDesc variable rows not used are the col3, panelData, and parm variable rows. If these rows are present the value for the arrow glyph should be set to NA.
The following is an example of a section of a boxplot glyph column in a linked micromap:
If both the start and end points of an arrow are the same, a "dot" is draw. If the begin and end points of an arrow are very close to each other, the arrow may not be much more than an arrow head. See example below.
The statsDFrame and panelDesc data.frames reside in the global environment and automatically accessible to the process along with several other major structures.
See Also
micromapST