Formatting the Chart

If necessary, PROC GANTT divides the Gantt chart into several pages. You can force the Gantt chart to fit on one page by specifying the COMPRESS option in the CHART statement. You can achieve a similar result using the PCOMPRESS option, which also maintains the aspect ratio. In addition, you can fit the chart into a prescribed number of horizontal and vertical pages by using the HPAGES= and VPAGES= options in the CHART statement.

The amount of information contained on each page is determined by the values of the graphics options HPOS= and VPOS= specified in a GOPTIONS statement. If any compression of the Gantt chart is performed, the values of HPOS and VPOS are increased, as necessary, to the number of rows and columns respectively, that the entire chart occupies in uncompressed mode. The default height of each row of the Gantt chart is computed as (100/v)% of the screen height where VPOS=v. Thus, the larger the value of VPOS, the narrower the row. You can control the default bar height and default bar offset by using the BARHT= option and the BAROFF= option, respectively. You can further override these at the schedule level. For example, the ABARHT= option affects only the height of the actual schedule bars. The screen is assumed to be divided into h columns where HPOS=h; thus, each column is assumed to be as wide as (100/h)% of the screen width. Hence, the specifications SCALE=10 and MININTERVAL=WEEK imply that a duration of one week is denoted by a bar of length (1000/h)% of the screen width.

The height of the text characters is controlled by both the HEIGHT= option in the CHART statement and the HTEXT= option specified in a GOPTIONS statement. The text height is set equal to the product of the HEIGHT= and HTEXT= values. The units in which the text height is measured are those of the HTEXT= option. By default, the value of HEIGHT= is 1, which sets the text height to be equal to the HTEXT= value. The default value of HTEXT= is 1 unit, where a unit is defined by the GUNIT= option in a GOPTIONS statement. Thus, in the absence of the HEIGHT=, HTEXT=, and GUNIT= options, the text height is the same as the bar height, namely one cell height. Increasing the value of HEIGHT= is useful when you use the COMPRESS option, particularly when you have a very large chart. Since the chart is scaled as appropriate to fit on one page, the text can be very hard to discern, or even illegible, and would benefit from enlargement. Relative positioning of the font baseline for activity text is controlled by the HTOFF= option in the CHART statement. By default, the font baseline for an activity is at the bottom of the first bar corresponding to the activity.

The color of the text characters is specified by using the CTEXT= option in the CHART statement. The default color depends on the GOPTIONS statement and the GSTYLE system option; see the section ODS Style Definitions for more information. You can override the text colors for selected columns of activity text at the activity level by using a PATTERN variable in the Schedule data set and specifying the CTEXTCOLS= option in the CHART statement.

The font used for the text characters is specified with the FONT= option in the CHART statement. The default font depends on the GOPTIONS statement and the GSTYLE system option; see the section ODS Style Definitions for more information.

Global PATTERN statements are used to specify the fill pattern for the different types of bars drawn on the Gantt chart. Each fill pattern can be associated with a color. Patterns can be used to reflect the status of an activity (normal, critical, supercritical) in the predicted early/late schedule, to indicate the different schedule types (actual, resource-constrained, baseline), and to represent weekends, holidays and breaks on the Gantt chart. See the section Using PATTERN Statements for details. In addition, you can override these fill patterns for selected schedules at an activity level by using a PATTERN variable in the Schedule data set and specifying the PATLEVEL= option in the CHART statement.

You can use global SYMBOL statements to define the symbols that represent CHART variables in the Gantt chart. The SYMBOL statement enables you to select symbols from different fonts and modify their appearance to suit your requirements. You can specify a color and a height for the symbol in addition to a variety of other options. See the section Using SYMBOL Statements for details.

Annotate Processing

The Annotate facility enables you to enhance graphics output produced by PROC GANTT. However, if the only items being annotated are symbols and text strings, it is recommended that you use the Automatic Text Annotation facility that is built into the Gantt procedure instead. This facility was developed specifically for labeling Gantt charts; it has some very useful features and requires a minimum of effort.

To use the SAS/GRAPH Annotate facility, you must create an Annotate data set that contains a set of graphics commands that can be superimposed on the Gantt chart. This data set has a specific format and must contain key variables. Each observation in the Annotate data set represents a command to draw a graphics element or perform an action. The values of the variables in the observation determine what is done and how it is done. The observations in an Annotate data set can be created by explicitly assigning values to the Annotate variables through a DATA step or SAS/FSP procedure or by implicitly assigning values with Annotate macros within a SAS DATA step. The process of creating Annotate observations is greatly simplified through the use of Annotate macros.

Coordinates specify where graphic elements are to be positioned. A coordinate system, in turn, determines how coordinates are interpreted. There are several different coordinate systems that are used by the Annotate facility. Typically, one of three major drawing areas can be associated with any coordinate system: data area, procedure output area, and graphics output area. This chapter explains the coordinate system that is based on the data area of PROC GANTT.

When annotating a graph produced by any of the graphics procedures, you may find it helpful to use data coordinates that refer to the data values corresponding to the graph that is being annotated. For example, if you want to label a particular activity of a Gantt chart with additional text, you can position the text accurately if you use data coordinates instead of screen coordinates. With respect to PROC GANTT, the Annotate facility uses the time axis and the activity axis of the Gantt chart as the basis for the data coordinate system. To use this feature, create a Annotate data set based on the Schedule data set that is input to the procedure, utilizing Annotate macros whenever possible to simplify the process.

Note:The data coordinate system enables you to annotate the graph even if it spans multiple pages. However, each annotation must be entirely contained within a given page. For example, you cannot annotate a line on the Gantt chart that runs from one page of the chart to another.

In addition to a coordinate system based on the data, you can select a coordinate system based on either the procedure output area or the Graphics output area. You would typically need to use one of these systems, for example, if you want to annotate text outside the chart area.

Using PATTERN Statements

PROC GANTT uses those patterns that are available with the GCHART procedure. PROC GANTT uses a maximum of nine different patterns to denote various phases in an activity’s duration and the various types of schedules that are plotted. Patterns are specified in PATTERN statements that can be used anywhere in your SAS program. Table 8.24 lists the function of each of the first nine PATTERN statements that are used by PROC GANTT.

Any PATTERN statements that you specify are used. If more are needed, default PATTERN statements are used.

You can override any of these patterns at the activity level by using a PATTERN variable in the schedule data set. A PATTERN variable is identified by specifying the PATTERN= option in the CHART statement or by the presence of the default _PATTERN variable.

Refer to the SAS/GRAPH documentation for a detailed description of PATTERN statements. Most of the relevant information is reproduced here for the sake of completeness.

   pattern3;

   pattern c=, v=solid;

   pattern c= v=solid;

   pattern2 c= v=;

Using SYMBOL Statements

You can specify a SYMBOL statement anywhere in your SAS program. SYMBOL statements give PROC GANTT information about the characters to be used for plotting the CHART variables.

See also the section Special Fonts for Project Management and Decision Analysis for a description of some typically used Gantt chart symbols that can be specified using a SYMBOL statement.

Refer to the SAS/GRAPH documentation for a detailed description of SYMBOL statements. Most of the relevant information is reproduced here for the sake of completeness.

   symbol1 c=, v=plus;

   symbol1 c= v=plus;

   symbol4 c= v=;

General options

You can specify the following options in the SYMBOL statement.

COLOR=color

C=color

specifies the color to use for the corresponding plot specification. If you do not specify the C= option in a SYMBOL statement, the procedure uses the value you specified for the CSYMBOL= option in a GOPTIONS statement. If you omit the CSYMBOL= option, the procedure uses the value specified by the V= option with each color in the COLORS= list before it uses the next SYMBOL statement.

FONT=font

F=font

specifies the font from which the symbol corresponding to the value specified with the V= option is to be drawn. If you do not specify a font, the V= option specifies the symbol from the special symbol table .

H=height

specifies the height of the symbol that is to be drawn.

For example, this SYMBOL statement

   symbol1 c=green v=K f=special h=2;

indicates that the symbol at each data point is the letter K from the SPECIAL font (a filled square), drawn in green, the height being twice the bar height.

REPEAT=n

R=n

specifies the number of times the SYMBOL statement is to be reused.

V=special-symbol

V='string'

identifies the symbols from the font specified by the FONT= option in the SYMBOL statement for the corresponding plot specifications. If the FONT= option is not specified, the plot symbol is the symbol corresponding to the value of V= in the special symbol table . Also permitted without a FONT= specification are the letters A through W and the numbers 0 through 9. If the font is a symbol font, such as MARKER, the string specified with the V= option is the character code for the symbol. If the font is a text font, such as SWISS, the string specified with the V= option is displayed as the plot symbol. By default, the value of V= is PLUS, which produces the plus symbol (+) from the special symbol table.

Note that if you use the special symbol comma (,) with the V= option, you must enclose the comma in quotes as illustrated in the following statement:

   symbol1 v=',';

Figure 8.7 Special Symbol Table

Special Fonts for Project Management and Decision Analysis

Two special marker fonts, ORFONT and ORFONTE, are available in versions 6.08 and later. These two fonts are meant to be used with SAS/OR software and provide a variety of symbols that are typically used in Project Management and Decision Analysis. The fonts ORFONT and ORFONTE are shown in Figure 8.8 and Figure 8.9, respectively. The fonts behave like any SAS/GRAPH font providing you with the capability to control attributes such as color and height.

Figure 8.8 ORFONT - A Filled Font

Figure 8.9 ORFONTE - An Empty Font

For example, to use a filled yellow "doghouse" symbol to represent milestones on the Gantt chart, specify the options

   VMILE="H"  FMILE=ORFONT  CMILE=YELLOW

in the CHART statement.

If you wish to represent a CHART variable with an empty blue "circled arrow," then specify the following options in the corresponding SYMBOL statement.

   V="Q"  F=ORFONTE  C=BLUE;