Last updated 19 Nov 97
PLTVAL will plot the range of one standard deviation from the mean for background, computed or task variables. This program uses the Group Statistics file created by CSTATS.
Program Invocation
The specific syntax for program invocation varies between operating systems. This document diplays the code for the AIX version.
opt: Program Options (none currently supported) ssss: The study number GSf: Input Group Statistics file created by CSTATS
PLTVAL Control Card
PLTVAL: cc 01-06 The literal 'PLTVAL' study: cc 08-11 The study number title: cc 13-71 The report title for this run.
PLOT Card
The PLOT card describes which variable to plot. There is no limit to the number of PLOT cards which can be input.
PLOT: cc 01-04 The literal 'PLOT' var: cc 06-10 The background, computed, or task variable name grp: cc 12 If non-blank, group cards will follow the PLOT card. These cards specify which groups to plot. The default is to display all groups for that variable from the input statistics file. sort: cc 14 Sort option 1 - Sort plots by mean. (Default) 2 - Sort plots by mean minus one standard deviation. 3 - Sort plots by mean plus one standard deviation. 4 - Sort plots by number of members for each group. min: cc 16-23 Optional minimum value for the range to plot. The program defaults to lowest value of RMIN, where RMIN is mean minus one standard deviation. max: cc 25-32 Optional maximum value for the range to plot. The program defaults to the highest value of RMAX, where RMAX is mean plus one standard deviation. title: cc 34-73 Optional scale heading to print under the plot (e.g., 'Number of Tasks').
Group Cards
These cards have to be included if the group option (cc 12) was specified on the PLOT card. They should directly follow the PLOT card. From 1 to 11 groups can be specified per card and as many cards as are necessary can be specified.
grp1: cc 01-06 Six character group ID grp2: cc 08-13 Six character group ID grp3: cc 15-20 Six character group ID grp4: cc 22-27 Six character group ID grp5: cc 29-34 Six character group ID grp6: cc 36-41 Six character group ID grp7: cc 43-48 Six character group ID grp8: cc 50-55 Six character group ID grp9: cc 57-62 Six character group ID grp10: cc 64-69 Six character group ID grp11: cc 71-76 Six character group ID
These cards are terminated by an '@eof' image.
All sets of control cards are terminated by an end-of-file or an additional '@eof' image.
@codap pltval - ssss gs100 PLTVAL ssss This is the main title PLOT V0001 G GP0001 GP0002 GP0003 @EOF PLOT C0010 2 0.0 363.0 Number of tasks @EOF
This run of PLTVAL will create two plots. The first plot will be variable V0001 plotted for three different groups. The second plot will be C0010 plotted for all group mean and standard deviations for that variable on the Group Statistics file. The minimum and maximum are set to the number of tasks and a title will be printed at the bottom of the scale. The plot will be sorted descending by the mean minus one standard deviation.