AXIS Statement

The AXIS statement controls the location, values, and appearance of the axes in plots and charts .

Used by:

• GBARLINE, GCHART, GCONTOUR, GPLOT, and GRADAR procedures

Global

Description

AXIS statements specify the characteristics of an axis, including:

• the way the axis is scaled

• how the data values are ordered

• the location and appearance of the axis line and the tick marks

• the text and appearance of the axis label and major tick mark values.

AXIS definitions are used only when they are explicitly assigned by an option in a procedure that produces graphs with axes.

Figure 7.1 on page 125 illustrates the terms associated with the various parts of axes.

Figure 7.1: Parts of Axes

Syntax

AXIS <1...99>< options >;

option(s) can be one or more options from any or all of the following categories:

• axis scale options:

  • INTERVAL=EVEN UNEVEN PARTIAL

  • LOGBASE= base E PI

  • LOGSTYLE=EXPAND POWER

  • ORDER=( value-list )

• appearance options:

  • COLOR = axis-color

  • LENGTH= axis-length < units >

  • NOBRACKETS

  • NOPLANE

  • OFFSET=(< n1 ><, n2 >)< units > (< n1 < units >><, n2 < units >>)

  • ORIGIN=<( x ><, y >)< units > (< x < units >><, y < units >>)

  • STYLE= line-type

  • WIDTH= thickness -factor

• tick mark options:

  • MAJOR=( tick-mark-suboption(s) ) NONE

  • MINOR=( tick-mark-suboption(s) ) NONE

• text options:

  • LABEL=( text-argument(s) ) NONE

  • REFLABEL=( text-argument(s) ) NONE

  • SPLIT=" split-char "

  • VALUE=( text-argument(s) ) NONE

Options

When the syntax of an option includes units , use one of these:

CELLS	character cells
CM	centimeters
IN	inches
PCT	percentage of the graphics output area
PT	points

If you omit units , a unit specification is searched for in this order:

1. GUNIT= in a GOPTIONS statement

2. the default unit, CELLS.

COLOR= axis-color

C= axis-color

• specifies the color for all axis components (the axis line, all tick marks, and all text) unless you include a more explicit AXIS statement color specification. Any of these color specifications override COLOR= for the specified item:

  Table 7.1

  Option	Items Affected
  AXIS statement:	axis label
  LABEL=(COLOR= color )	reference-line labels
  REFLABEL=(COLOR= color )	major tick mark values
  VALUE=(COLOR= color )
  calling procedure: CTEXT=	all axis text (AXIS label and major tick mark value descriptions)
  CAXIS=	axis line and major and minor tick marks

  If you omit all color options, the AXIS statement looks for a color specification in this order:

  1. the CTEXT= graphics option in a GOPTIONS statement.

  2. If CTEXT= is not used, the color of all axis components is the first color in the colors list, except for PROC GCONTOUR, which uses the second color.

• Featured in: Example 1. Ordering Axis Tick Marks with SAS Datetime Values on page 226.

INTERVAL=EVEN UNEVEN PARTIAL

• The INTERVAL option affects the LOGBASE option on the AXIS statement. Specifying the option INTERVAL=UNEVEN and LOGBASE=10, permits non-base10 values to be specified for the ORDER option, while retaining a logarithmic scale for the axis.

LABEL=( text-argument(s) ) NONE

• modifies an axis label. Text-argument(s) defines the appearance or the text of an axis label, or both. NONE suppresses the axis label. Text-argument(s) can be one or more of these:

  • text-string

    • provides up to 256 characters of label text. By default, the text of the axis label is either the variable name or a previously assigned variable label. Enclose each string in quotes. Separate multiple strings with blanks.

  • text-description-suboption

    • modifies a characteristic such as the font, color, or size of the text string(s) that follows it. Text-description-suboption can be

      • ANGLE= degrees

      • COLOR= text-color

      • FONT= font NONE

      • HEIGHT= text-height < units >

      • JUSTIFY=LEFT CENTER RIGHT

      • ROTATE= degrees

      • See Text Description Suboptions on page 135 for a complete description.

• Specify as many text strings and text description suboptions as you want, but enclose them all in one set of parentheses.

• Featured in: Example 1. Ordering Axis Tick Marks with SAS Datetime Values on page 226, Example 2. Specifying Logarithmic Axes on page 229 , and Example 7. Using BY- group Processing to Generate a Series of Charts on page 240

• Not supported by: Java (partial), ActiveX (partial)

LENGTH= axis length < units >

• specifies the length of the axis in number of units. If you request a length that cannot fit the display, an error message is issued and no graph is drawn.

  This option is not supported by the GRADAR Procedure.

• Featured in: Example 2. Specifying Logarithmic Axes on page 229 and Example 9. Combining Graphs and Reports in a Web Page on page 248 .

• Not supported by: Java, ActiveX

LOGBASE= base E PI

• scales the axis values logarithmically according to the value specified. Base must be greater than 1. How the values are displayed on the axis depends on the LOGSTYLE= option. For example, LOGBASE=E with the default LOGSTYLE=EXPAND generates an axis like the one in Figure 7.2 on page 128.

Figure 7.2: Axis Generated with LOGBASE=E and LOGSTYLE=EXPAND

• This option is not supported by the GRADAR Procedure.

• Featured in: Example 2. Specifying Logarithmic Axes on page 229.

• Not supported by: Java

LOGSTYLE=EXPAND POWER

• specifies whether the values displayed on the logarithmic axis are the values of the base or the values of the power. LOGSTYLE= is meaningful only when you use LOGBASE=.

• LOGSTYLE=EXPAND specifies that the values displayed are the values of the base raised to successive powers and that the minor tick marks are logarithmically placed. For example, if the base is 10, the values displayed are 10, 100, 1000, 10000, and so on. The default is LOGSTYLE=EXPAND. This statement generates an axis like the one in part (a) of Figure 7.3 on page 128:

   axis logbase=10 logstyle=expand; 

  
  Figure 7.3: Axes Generated with the LOGSTYLE=option

• LOGSTYLE=POWER specifies that the values displayed are the powers to which the base is raised (for example, 1, 2, 3, 4, 5, and so on). For example, this statement generates an axis like the one in part (b) of Figure 7.3 on page 128:

   axis logbase=10 logstyle=power; 

• If you use ORDER= with a logarithmic axis, the values specified by ORDER= must match the style specified by LOGSTYLE=. For example, if you specify a logarithmic axis with a base of 2 and you want to display the first five expanded values, use this statement:

   axis logbase=2 logstyle=expand       order=(2 4 8 16 32); 

• If you use LOGSTYLE=POWER, the values in ORDER= must represent the powers to which the base is raised, as in this example:

   axis logbase=2 logstyle=power order=(1 2345); 

• If the values that are specified by ORDER= do not match the type of values specified by LOGSTYLE=, the request for a logarithmic axis is ignored.

• This option is not supported by the GRADAR Procedure.

• Featured in: Example 2. Specifying Logarithmic Axes on page 229 .

• Not supported by: Java

MAJOR=( tick-mark-suboption(s) ) NONE

• modifies the major tick marks. Tick-mark-suboption(s) defines the color, size, and number of the major tick marks. NONE suppresses all major tick marks, although the values represented by those tick marks are still displayed. Tick-mark-suboption can be

  • COLOR= tick-color

  • HEIGHT= tick-height < units >

  • NUMBER= number-of- ticks

  • WIDTH= thickness-factor

• See Tick Mark Description Suboptions on page 139 for complete descriptions. List all suboptions and their values within the parentheses.

• AXIS definitions assigned to the group axis of a bar chart by the GAXIS= option ignore MAJOR= because the axis does not use tick marks.

• Note: By default, tickmarks are now placed at three intervals on the spokes of a GRADAR chart. They are placed at the minimum value, maximum value, and at one value in between. The tick marks on the 12 o clock spoke are also labeled by default.

• HEIGHT is not supported by Java or ActiveX. WIDTH is not supported by Java.

• Featured in: Example 1. Ordering Axis Tick Marks with SAS Datetime Values on page 226 , Example 2. Specifying Logarithmic Axes on page 229, and Example 7. Using BY-group Processing to Generate a Series of Charts on page 240.

• Not supported by: Java (partial), ActiveX (partial).

MINOR=( tick-mark-suboption(s) ) NONE

• modifies the minor tick marks that appear between major tick marks. Tick-mark-suboption(s) defines the color, number, or size of the minor tick marks. NONE suppresses all minor tick marks. Tick-mark-suboption can be

  • COLOR= tick-color

  • HEIGHT= tick-height < units >

  • NUMBER= number-of-ticks

  • WIDTH= thickness-factor

• See Tick Mark Description Suboptions on page 139 for complete descriptions. List all suboptions and their values within the parentheses.

• AXIS definitions assigned to the group axis of a bar chart by the GAXIS= option ignore MINOR= because the axis does not use tick marks.

• This option is not supported by the GRADAR Procedure.

• HEIGHT is not supported by Java or ActiveX.

• Featured in: Example 1. Ordering Axis Tick Marks with SAS Datetime Values on page 226, Example 2. Specifying Logarithmic Axes on page 229, and Example 7. Using BY-group Processing to Generate a Series of Charts on page 240.

• Not supported by: Java (partial), ActiveX (partial)

NOBRACKETS

• suppresses the printing of group brackets drawn around the values on the group axis in a bar chart. NOBRACKETS applies only to the group axis of bar charts.

• This option is not supported by the GRADAR Procedure.

• See also: GROUP= on page 805 and GAXIS= on page 805.

• Not supported by: Java, ActiveX

NOPLANE

• removes either the horizontal or vertical 3D axis plane in bar charts produced by the HBAR3D and VBAR3D statements. NOPLANE affects only the axis to which the AXIS statement applies.

• To remove selected axis elements such as lines, values or labels, use specific AXIS statement options. To remove all axis elements except the 3D planes use the NOAXIS option in the procedure. To remove the backplane, use the NOFRAME option in the procedure.

• This option is not supported by the GRADAR Procedure.

• Featured in: Example 7. Using BY-group Processing to Generate a Series of Charts on page 240.

OFFSET=(< n1 ><, n2 >)< units > (< n1 < units >><, n2 < units >>)

• specifies the distance from the first and last major tick marks or bars to the ends of the axis line.

• The value of ( n1 )is the distance from the beginning (origin) of the axis line to the first tick mark or middle of the first bar, and the value of ( n2 )is the distance from the end of the axis line to the last tick mark or middle of the last bar.

• On a horizontal axis, the ( n1 ) offset is measured from the left end of the axis line and the ( n2 ) offset is measured from the right end. On a vertical axis, the ( n1 ) offset is measured up from the bottom of the axis line and the ( n2 ) offset is measured down from the top of the line.

• To specify the same offset for both n1 and n2 , use one value, with or without a following comma. For example, either option sets both n1 and n2 to 4 centimeters:

   offset=(4 cm)  offset=(4 cm,) 

• To specify different offsets, use two values, with or without a comma separating them. For example,

   offset=(4 cm, 2 cm) 

• To specify only the second offset, use only one value preceded by a comma. This option offsets the last major tick mark or bar 3 centimeters from the right-hand end of the axis line:

   offset=(,3 cm) 

• You can specify units for the n1 , n2 pair or for the individual offset values.

• This option is not by the GRADAR Procedure .

• Featured in: Example 1. Ordering Axis Tick Marks with SAS Datetime Values on page 226.

• Not supported by: Java

ORDER=( value-list )

• specifies the order in which data values appear on the axis. The values specified by ORDER= are the major tick mark values. You can modify the appearance of these values with the VALUE= option.

• The way you specify value-list depends on the type of variable:

  • For numeric variables , value-list is either an explicit list of values or a starting and an ending value with an interval increment, or a combination of both forms:

    • n < ...n >

    • n TO n <BY increment >

    • n <... n > TO n <BY increment > < n < ...n >>

    If a numeric variable has an associated format, the specified values must be the unformatted values.

    Values must be listed in either ascending or descending order. By default the increment value is 1. You can use a negative integer for increment to specify a value list in descending order. In all forms, multiple n values can be separated by blanks or commas. Here are some examples:

     order=(2 4 6)  order=(6,4,2)  order=(2 to 10 by 2)  order=(50 to 10 by -5) 

    If the specified range is not evenly divisible by the increment value, the highest value displayed on the axis is the last incremental value below the ending value for the range. For example, this value list produces a maximum axis value of 9:

     order=(0 to 10 by 3) 

  • For character variables , value-list is a list of unique character values enclosed in quotes and separated by blanks:

    • value-1 <... value-n >

    If a character variable has an associated format, the specified values must be the formatted values for PROC GCHART and the unformatted values for PROC GPLOT.

    Character values can be specified in any order, but the character strings must match exactly the variable values in case and spelling. For example,

     order=('Paris' 'London' 'Tokyo') 

    Observations can be inadvertently excluded if entries in the value-list are misspelled or if the case does not match exactly.

  • For date and time values , value-list can have the following forms:

    • SAS-value i <... SAS-value i >

    • SAS-value i TO SAS-value i <BY interval >

      • SAS-value i

        • is any SAS date, time, or datetime value described for the SAS functions INTCK and INTNX. Enclose the value in quotes and specify one of the following for i :

          D	date
          T	time
          DT	datetime

      • interval

        • is one of the valid arguments for the INTCK or INTNX functions. These are the default intervals:

          DAY	default interval for date
          SECOND	default interval for time
          DTSECOND	default interval for datetime

    These value lists use SAS date and time values:

     order=(25MAY98d 04JUL98d 07SEP98d)  order=(01JUL97d to 01AUG97d)  order=(01JUL97d to 01JAN98d by week)  order=(9:25t to 11:25t by minute)  order=(04JUN97:12:00:00dt to         10JUN9712:00:00dt by dtday) 

    With SAS date and time values, use a FORMAT statement so that the tick mark values have an understandable form. For more information on SAS date and time values, see the SAS Language Reference: Dictionary .

• With any type of value-list , specifying values that are not distributed uniformly or are not in ascending or descending order, generates a warning message in the SAS log. The specified values are spaced evenly along the axis even if the values are not distributed uniformly.

• Using ORDER= to restrict the values displayed on the axis may result in clipping. For example, if the data range is 1 to 10 and you specify ORDER=(3 TO 5), only the data values from 3 to 5 appear on the plot or chart. For charts, the omitted values are still included in the statistic calculation.

• Note: Values out of range do not always produce a warning message in the SAS log.

• CAUTION:

  • The ORDER= option does not calculate midpoint values; as a result it is not interchangeable with the MIDPOINTS= option in the GCHART procedure.

• You can use ORDER= to specify the order in which the midpoints are displayed on a chart, but do not use it to calculate midpoint values. Be sure that the values you specify match the midpoint values that are calculated either by default by the GCHART procedure or by the MIDPOINTS= option. For details, see the description of MIDPOINTS= for the appropriate statement in Chapter 29, The GCHART Procedure, on page 773.

• ORDER= overrides the suboption NUMBER= described in Tick Mark Description Suboptions on page 139.

• ORDER= is not valid with the ASCENDING, DESCENDING and NOZEROS options used with the bar chart statements in the GCHART procedure.

• This option is not supported by the GRADAR procedure.

• Note: The Java applet supports ORDER= for numeric axes, but does not support ORDER= for categorical, character, midpoint, or group axes.

• The ActiveX control supports only simple order lists. Non-uniform interval values, such as dates, are not supported. Only max and min values are supported with a default interval of one day.

• Featured in: Example 1. Ordering Axis Tick Marks with SAS Datetime Values on page 226, Example 5. Filling the Area between Plot Lines on page 236, and Example 7. Using BY-group Processing to Generate a Series of Charts on page 240

• Not supported by: Java (partial), ActiveX (partial)

ORIGIN=(< x ><, y >)< units >(< x < units >><, y < units >>)

• specifies the x coordinate and the y coordinate of the origin of the axis. The origin of the horizontal axis is the left end of the axis, and the origin of the vertical axis is the bottom of the axis. ORIGIN= explicitly positions the axis anywhere on the graphics output area.

• If you specify only one value, with or without a comma following it, only the x coordinate is set to that value. For example, this specification sets x to 4 centimeters:

   origin=(4 cm,) 

• If you specify two values, with or without a comma separating them, the first value sets the x coordinate and the second value sets the y coordinate, as in this example:

   origin=(2 pct, 4 pct) 

• If you specify one value preceded by a comma, only the y coordinate is set to that value, as shown here:

   origin=(,3 pct) 

• You can specify units for the x , y pair or for the individual coordinates.

• This option is not supported by the GRADAR Procedure.

• Not supported by: Java, ActiveX

REFLABEL=( text-argument(s) ) NONE

• creates and defines the appearance of a reference-line label. Text-argument(s) defines the appearance or the text of the label, or both. NONE suppresses the reference-line label. Text-argument(s) can be one or more of these:

  • text-string

    • provides up to 256 characters of label text. By default, a reference line does not have a label. Enclose each string in quotes. Separate multiple strings with blank spaces; the strings are applied to the reference lines consecutively along the axis, from the plot origin to the end of the axis.

  • text-description-suboption

    • modifies a characteristic such as the font, color, or size of the text string(s) that follows it. Text-description-suboption can be

      • ANGLE= degrees

      • AUTOREF

      • COLOR= text-color

      • FONT= font NONE

      • HEIGHT= text-height < units >

      • JUSTIFY=LEFT CENTER RIGHT

      • POSITION=TOP MIDDLE BOTTOM

      • ROTATE= degrees

      • T= n

      • See Text Description Suboptions on page 135 for a complete description.

• Specify as many text strings and text description suboptions as you want, but enclose them all in one set of parentheses.

• REFLABEL is not supported by the GRADAR Procedure.

• Not supported by: Java, ActiveX.

SPLIT=" split-char "

• specifies the split character that the AXIS statement uses to break axis values into multiple lines. Split-char can be any character value that can be specified in a SAS character variable. The split character must be embedded in the variable values in the data set or in an associated format. When the AXIS statement encounters the split character, it automatically breaks the value at that point and continues on the next line. For example, suppose the data set contains the value Berlin , Germany , and you specify SPLIT=",". The value would appear on the axis as

   Berlin  Germany 

  Note that the split character itself is not displayed.

  Axis values specified with VALUE= do not use the split character. For example, suppose you specify this statement:

   axis1 spilt="," value=(t1=December, 1999); 

  The value will appear on the axis on one line as December, 1999 . However, any other axis values containing a comma would honor the split character.

  This option is not supported by the GRADAR Procedure.

• Featured in: Example 7 on page 856

• Not supported by: Java, ActiveX

STYLE= line-type

• specifies a line type for the axis line. Valid values for line-type are 0 through 46. If you specify STYLE=0, the axis line is not drawn. The default is 1, a solid line.

• Note: In order for the axis line to be altered by the STYLE= option, the NOFRAME option must also be set. If only the STYLE=option is set, the axis frame will be modified.

• Note: This option overrides the LineStyle attribute in graph styles. For more information on graph styles, see SAS Output Delivery System: User s Guide .

• Note: See also: Figure 7.22 on page 208 for examples of the available line types.

  
  Figure 7.22: Line Types

VALUE=( text-argument(s) ) NONE

• modifies the major tick mark values. That is, this option modifies the text that labels the major tick marks on the axis. Text-argument(s) defines the appearance or the text of a major tick mark value, or both. NONE suppresses the major tick mark values, although the major tick marks are still displayed. Text-argument(s) can be one or more of these:

  • text-string

    • provides up to 256 characters of text for the major tick mark value. By default, the value is either the variable value or an associated format value. Enclose each string in quotes and separate multiple strings with blanks.

    • Specified text strings are assigned to major tick marks in order. If you specify only one text string, only the first tick mark value changes, and all the other tick mark values display the default. If you specify multiple strings, the first string is the value of the first major tick mark, the second string is the value of the second major tick mark, and so forth. For example, to change default tick mark values 1, 2, and 3 to First , Second , and Third , use this option:

       value=(First Second Third) 

    • Note: Although VALUE= changes the text displayed at a major tick mark, it does not affect the actual value represented by the tick mark. To change the tick mark values, use ORDER=. Also note that with client-side rendering using Java or ActiveX, it is necessary to use ORDER= to ensure that the same number of tick marks are displayed as with server-rendered graphics. For example, specify ORDER=(1 to 12) to ensure that tick marks for all twelve months are displayed on the client.

    • To change the value of midpoints in bar charts produced with the GCHART procedure, use the MIDPOINTS= option in the procedure.

  • text-description-suboption

    • modifies a characteristic such as the font, color, or size of the text string(s) that follows it. Text-description-suboption can be

      • ANGLE= degrees

      • COLOR= text-color

      • FONT= font NONE

      • HEIGHT= text-height < units >

      • JUSTIFY=LEFT CENTER RIGHT

      • ROTATE= degrees

      • TICK= n .

      • For a complete description, see Text Description Suboptions on page 135.

      • Place text description suboptions before the text strings they modify.

    • Suboptions not followed by a text string affect the default values. To specify and describe the text for individual values or to produce multi-line text, use the TICK= suboption.

  • Specify as many text strings and text description suboptions as you want, but enclose them all in one set of parentheses.

  • Note: If an end-user viewing a graph in the Java applet or ActiveX control zooms in on a particular part of a graph for which VALUE= is specified, the values are not readjusted in coordination with the zooming.

  • Featured in: Example 2. Specifying Logarithmic Axes on page 229, Example 7. Using BY-group Processing to Generate a Series of Charts on page 240, and Example 9. Combining Graphs and Reports in a Web Page on page 248.

  • Not supported by: Java (partial), ActiveX (partial)

WIDTH= thickness-factor

• specifies the thickness of the axis line. Thickness increases directly with the value of thickness-factor . By default, WIDTH=1.

• Note: In order for the axis line to be altered by the WIDTH= option, the NOFRAME option must also be set. If only the WIDTH=option is set, the axis frame will be modified.

• Java does not support WIDTH. ACTIVEX ignores the WIDTH option for the vertical axis of an AXIS statement with GPLOT and GCONTOUR.

• Featured in: Example 1. Ordering Axis Tick Marks with SAS Datetime Values on page 226.

• Not supported by: Java, ActiveX (partial)

Text Description Suboptions

Text description suboptions are used by the LABEL=, REFLABEL=, and VALUE= options to change the color, height, justification, font, and angle of either default text or specified text strings. See LABEL= on page 127, REFLABEL= on page 133, and VALUE= on page 134.

ANGLE= degrees

A= degrees

• specifies the angle of the baseline with respect to the horizontal. A positive value for degrees moves the baseline counterclockwise; a negative value moves it clockwise. By default, ANGLE=0 (horizontal) unless the text is automatically angled or rotated to avoid overlapping. For an illustration of the effect of ANGLE=, see Figure 7.24 on page 213.

  
  Figure 7.24: Positioning Titles with the ANGLE= Option

• Note: Changing the angle of a vertical axis-label can result in the label being positioned above the graph when using client-side rendering with Java or ActiveX.

• See also: the ROTATE= suboption on page 138

• Featured in: Example 7 on page 856 .

• Not supported by: Java (partial)

AUTOREF

• automatically labels each reference line on an axis with the response value at the reference line s position. AUTOREF is only used with the REFLABEL= option. The automatic labels are applied only to reference lines that do not have specific labels assigned to them. For example, the following option uses the response-axis value as the label for every reference line except the second reference line, which is assigned the label two :

   reflabel=(autoref t=2 "two") 

• Note, however, that if at the same time you also request automatic labeling with a PLOT or BUBBLE statement (using the AUTOHREF or AUTOVREF option), then the automatic labeling of the PLOT or BUBBLE statement can write on top of your custom label specified with t he AXIS statement. You must ensure that your custom labels specified with the AXIS statement are not at the same position as automatic labels requested with a different statement.

• Not supported by: Java, ActiveX, GIF

COLOR= text-color

C= text-color

• specifies the color for the text. If you omit the COLOR= suboption, a color specification is searched for in this order:

  1. the CTEXT= option for the procedure

  2. the CTEXT= option in a GOPTIONS statement

  3. the default, the first color in the colors list.

FONT= font NONE

F= font NONE

• specifies the font for the text. See Chapter 5, SAS/GRAPH Fonts, on page 75 for details on specifying font . If you omit FONT=, a font specification is searched for in this order:

  1. the FTEXT= option in a GOPTIONS statement

  2. the default hardware font, NONE.

• Not supported by: Java (partial)

HEIGHT= text-height < units >

H= text-height < units >

• specifies the height of the text characters in number of units. By default, HEIGHT=1 CELL . If you omit HEIGHT=, a text height specification is searched for in this order:

  1. the HTEXT= option in a GOPTIONS statement

  2. the default value, 1.

JUSTIFY=LEFT CENTER RIGHT

J=L C R

• specifies the alignment of the text. The default depends on the option with which it is used and the text it applies to.

  • With the LABEL= option:

    • for a left vertical axis label, the default is JUSTIFY=RIGHT

    • for a right vertical axis label, the default is JUSTIFY=LEFT

    • for a horizontal axis label, the default is JUSTIFY=CENTER.

  • With the REFLABEL= option:

    • for a vertical axis, the default is JUSTIFY=CENTER. RIGHT places the text string on the right end of the line, CENTER in the middle of the line, and LEFT to the left of the line.

    • for a horizontal axis label, the default is JUSTIFY=RIGHT. RIGHT places the text string just to the right of the line, CENTER is centered on top of the line, and LEFT places the text string just to the left of the line.

  • With the VALUE= option:

    • for numeric variables on a vertical axis, the default is JUSTIFY=RIGHT

    • for character variables on a vertical axis, the default is JUSTIFY=LEFT

    • for all variables on a horizontal axis, the default is JUSTIFY=CENTER.

  Note: With client-side output using Java and ActiveX, text justification is relative to the text string, not the tick mark. For example, left justification means that the left end of the text string is justified with respect to the drawing location, as well as other strings in a multiline label ”which may be to the right of a tick mark.

  You can use JUSTIFY= to print multiple lines of text by repeating JUSTIFY= before the text string for each line. You can also use JUSTIFY= to specify multi-line text at specified major tick marks. For example, this statement produces an axis label and major tick mark values like those shown in Figure 7.4 on page 138.

   axis label=('Current' justify=c              'Sales Projections')       value=(tick=1 'JAN' justify=c '1997'              tick=2 'FEB' justify=c '1997'              tick=3 'MAR' justify=c '1997'              tick=4 'APR' justify=c '1997'              tick=5 'MAY' justify=c '1997'); 

  
  Figure 7.4: The JUSTIFY= suboption

• Specify additional suboptions before any string.

• See also: the suboption TICK= on page 138.

• Not supported by: Java

POSITION=TOP MIDDLE BOTTOM

• specifies the position of a reference-line label relative to the reference line. The default is TOP for both vertical and horizontal reference lines. POSITION= is only available on the REFLABEL= option.

  • For horizontal reference lines, TOP places the label just above the reference line, MIDDLE places the label on the reference line, and BOTTOM places the label just under the reference line.

  • For vertical reference lines, TOP places the label at the top end of the reference line, MIDDLE places the label in the middle of the line, and BOTTOM places the label at the bottom end of the line.

• Not supported by: Java, ActiveX

ROTATE= degrees

R= degrees

• specifies the angle at which each character of text is rotated with respect to the baseline of the text string. A positive value for degree rotates the character counterclockwise; a negative value moves it clockwise. By default, ROTATE=0 (parallel to the baseline) unless the text is automatically angled or rotated to avoid overlapping. For an illustration of the effect of ROTATE=, see Figure 7.31 on page 222.

  
  Figure 7.31: Tilting Characters with the ROTATE= Option

• See also: the suboption ANGLE= on page 136

• Not supported by: Java (partial)

TICK= n

T= n

• specifies the n reference line or tick mark value. Used only with REFLABEL= or with VALUE=. If neither one is specified, then T= is ignored.

  • With REFLABEL=, T= specifies the n th reference line. It is used to limit modifications to individual reference lines when there are multiple reference lines on an axis. For example, the following option changes the color of only the third reference line s label and leaves all other reference-line labels unchanged:

     reflabel=(autoref t=3 color=red) 

    Suboptions that precede T= affect all the reference-line labels on an axis. Suboptions that follow T= affect only the specified line s label. For example, the following option assigns the color green to all the reference-line labels on an axis, but left-justifies only the third reference line s label:

     reflabel(c=green "one" "two" t=3 j=left "three") 

    For the options to be applied to a text string, they must precede the quoted string. In the following option, the j=left is ignored because it follows the string:

     reflabel(c=green "one" "two" t=3 "three" j=left) 

  • Note: Client-side rendering with the Java applet or ActiveX control does not support the REFLABEL option.

    With VALUE=, TICK= specifies the n th major tick mark value. It is used to designate the tick mark value whose text and appearance you want to modify. For example, the following option changes the color of only the third tick mark value and leaves all others unchanged:

     value=(tick=3 color=red) 

    Suboptions that precede TICK= affect all the major tick mark values. Suboptions that follow TICK= affect only the specified value. For example, the following option makes all the major tick mark values 4 units high and colors all of them blue except for the third one, which is red:

     value=(height=4 color=blue tick=3 color=red) 

• Not supported by: Java, ActiveX

Using Text Description Suboptions

Text description suboptions affect all the strings that follow them unless the suboption is changed or turned off. If the value of a suboption is changed, the new value affects all the text strings that follow it. Consider this example:

 label=(font=swiss height=4 Weight         justify=right height=3 (in tons)) 

FONT=SWISS applies to both Weight and ( in tons ). HEIGHT=4 affects Weight , but is respecified as HEIGHT=3 for (in tons) . JUSTIFY=RIGHT affects only (in tons) .

Tick Mark Description Suboptions

Tick mark description suboptions are used by MAJOR= and MINOR= to change the color, height, width, and number of the tick marks to which they apply. See MAJOR= and MINOR=.

COLOR= tick-mark-color

C= tick-mark color

• colors the tick marks. If you omit the COLOR= suboption, a color specification is searched for in this order:

  1. the COLOR= option in the AXIS statement

  2. the CAXIS= option for the procedure

  3. the default, the first color in the colors list.

HEIGHT= tick-height < units >

H= tick-height < units >

• specifies the height of the tick mark. The defaults for the HEIGHT= suboption depend on the option with which it is used:

  • With MAJOR= the default height .5 CELLS.

  • With MINOR= the default height .25 CELLS.

• If you specify a negative number, tick marks are drawn inside the axis.

• Not supported by: Java, ActiveX

NUMBER= number-of-ticks

N= number-of-ticks

• specifies the number of tick marks to be drawn. With MAJOR=, number-of-ticks must be greater than 1. With MINOR=, number-of-ticks must be greater than 0.

• With MAJOR=, the NUMBER= suboption can be overridden by a major tick mark specification in the procedure, which in turn can be overridden by ORDER=.

• With MINOR=, the NUMBER= suboption can be overridden by a minor tick mark specification in the procedure.

• NUMBER= is not valid with logarithmic axes.

WIDTH= thickness-factor

W= thickness-factor

• specifies the thickness of the tick mark, where thickness-factor is a number. Thickness increases directly with thickness-factor . By default, WIDTH=1.

• Not supported by: Java (partial)

Using the AXIS Statement

AXIS statements can be defined anywhere in your SAS program. They are global and remain in effect until redefined, canceled , or until the end of your SAS session. AXIS statements are not applied automatically, and must be explicitly assigned by an option in the procedure that uses them.

You can define up to 99 different AXIS statements. If you define two AXIS statements of the same number, the most recently defined one replaces the previously defined statement of the same number. An AXIS statement without a number is treated as an AXIS1 statement.

Cancel individual AXIS statements by defining an AXIS statement of the same number without options (a null statement):

 axis4; 

Canceling one AXIS statement does not affect any other AXIS definitions. To cancel all current AXIS statements, use the RESET= option in a GOPTIONS statement:

 goptions reset=axis; 

Specifying RESET=GLOBAL or RESET=ALL cancels all current AXIS definitions as well as other settings.

To display a list of current AXIS definitions in the LOG window, use the GOPTIONS procedure with the AXIS option:

 proc goptions axis nolist;  run; 

Assigning AXIS Definitions

AXIS definitions must always be explicitly assigned by the appropriate option in the statement that generates the graph. The following table lists the procedures and statements that generate axes, the type of axis, and the statement option that assigns an AXIS definitions to that axis:

Procedure	Statement that generates an axis	Type of axis	Option that assigns an AXIS definition
GCHART	HBAR VBAR	group axis midpoint axis response axis	GAXIS= MAXIS= RAXIS=
GCONTOUR	PLOT	horizontal axis vertical axis	HAXIS= VAXIS=
GPLOT	PLOT	horizontal axis vertical axis	HAXIS= VAXIS=
GRADAR	CHART	star axis	STARAXIS=

Some types of axes cannot use certain AXIS statement options:

• group and midpoint axes ignore LOGBASE=, MAJOR=, and MINOR=

• midpoint, horizontal and vertical axes ignore NOBRACKETS.