Example Program and Statement Details

Overview

The LAYOUT LATTICE statement creates a grid of graphs that automatically aligns plot areas, data display areas, axis labels, and headers across the columns and rows of the layout. The axis data ranges can be scaled, and the axes for individual cells in the layout can be managed by row and by column using COLUMNAXIS and ROWAXIS statements. COLUMNAXIS statements are used within a COLUMNAXES block to externalize column axes for the layout. Similarly, ROWAXIS statements are used within a ROWAXES block to externalize row axes for the layout. For the specifications to take effect,

UNION or UNIONALL data scaling must be set for the affected columns and rows. The data scaling is set with COLUMNDATARANGE= and ROWDATARANGE= options.
Within the COLUMNAXES block, the number of COLUMNAXIS statements must match the number of columns. Within the ROWAXES block, the number of ROWAXIS statements must match the number of rows. If you do not specify enough of either statement, the last statement is used on remaining cells. If you specify too many statements, the extra statements are ignored.

The following example shows COLUMNAXIS statements for a lattice with two columns:

layout lattice / columns=2 columndatarange=union;
  columnaxes;
    columnaxis / griddisplay=on displaysecondary=(ticks tickvalues);
    columnaxis / griddisplay=on displaysecondary=(ticks tickvalues); 
  endcolumnaxes;

/* rest of lattice definition */

endlayout;

COLUMNAXIS and ROWAXIS statements are similar to the XAXISOPTS= and YAXISOPTS= options for LAYOUT OVERLAY, with the following differences:

COLUMNAXIS and ROWAXIS specify a secondary axis by using the DISPLAYSECONDARY= option, which shows a secondary axis on the opposite side of the lattice.
When COLUMNAXIS and ROWAXIS are used, any axis options specified on plots within the affected columns or rows are ignored. All axis features for the external axes must be specified on the COLUMNAXIS or ROWAXIS statement.
When COLUMNAXIS and ROWAXIS are used, any LAYOUT OVERLAYEQUATED layouts specified for cells in the affected columns or rows are implemented as LAYOUT OVERLAY layouts. Equated axes are not supported on external axes.

In the default cases for each plot in the layout, the axis type is always DISCRETE, LINEAR, or TIME. The TYPE= option enables you to specify an axis type that overrides the default. For example, when appropriate for the data, you can request a LOG axis. When you override the default axis type, you must be sure to specify the correct axis type for the plot(s) that you are defining.

Each axis type has features specific to that type, and the following axis options enable you to specify features for the different types: DISCRETEOPTS= , LINEAROPTS= , LOGOPTS= , and TIMEOPTS= . One or more of these options can be specified for an axis, but the specified settings are applied only to the axis type that supports them.

General Options for All Axes in a Lattice

The options that are documented in this section can be used with any of the axis types that are supported within a LATTICE layout. Subsequent sections in the chapter document the axis options that are available only for specific axis types: discrete, linear, log, or time axes.

Statement Option	Description
DISCRETEOPTS	Specifies features for a discrete column axis. This option is not available in the ROWAXIS statement.
DISPLAY	Controls which axis features are displayed on the primary axis.
DISPLAYSECONDARY	Controls which axis features are displayed on the secondary axis.
GRIDATTRS	Specifies the attributes of the grid lines.
GRIDDISPLAY	Specifies whether axis grid lines are displayed.
LABEL	Specifies the axis label.
LABELATTRS	Specifies the color and font attributes of the axis label.
LINEAROPTS	Specifies features for a standard numeric interval axis.
LOGOPTS	Specifies features for a log axis.
OFFSETMAX	Reserves an area at the maximum end of the axis. No tick marks are displayed in the reserved area.
OFFSETMIN	Reserves an area at the minimum end of the axis. No tick marks are displayed in the reserved area.
SHORTLABEL	Specifies an alternate axis label to use if the default or specified axis label is too long for the axis length.
TICKVALUEATTRS	Specifies the color and font attributes of the axis tick values.
TIMEOPTS	Specifies features for a TIME axis.
TYPE	Specifies the type of axis to use.

DISCRETEOPTS=( discrete-axis-options )

specifies one or more options for a discrete X or X2 axis. See Options for Discrete Column Axes Only.

DISPLAY=STANDARD | ALL | NONE | ( display-options )

controls which axis features are displayed on the primary axis.

Default: STANDARD

STANDARD

specifies that the LABEL, LINE, TICKS, and TICKVALUES are displayed

ALL

specifies that the LABEL, LINE, TICKS, and TICKVALUES are displayed

NONE

specifies that no axis features are displayed

(display-options)

a list of space-delimited options, enclosed in parentheses. The list must include one or more of the following:

LABEL	displays the axis label
LINE	displays the axis line
TICKS	displays the tick marks
TICKVALUES	displays the values that are represented by the major tick marks

The default line attributes for the axis line and axis tick marks are defined in the GraphAxisLine style element.

See GRIDDISPLAY= and GRIDATTRS= for setting axis grid lines.

DISPLAYSECONDARY=NONE | ALL | STANDARD | ( display-options )

controls which axis features are displayed on the secondary axis.

Default: NONE

NONE

specifies that no secondary axis features are displayed

STANDARD

specifies that the LABEL, LINE, TICKS, and TICKVALUES are displayed on the secondary axis

ALL

specifies that the LABEL, LINE, TICKS, and TICKVALUES are displayed on the secondary axis

(display-options)

a list of space-delimited options, enclosed in parentheses. The list must include one or more of the following:

LABEL	displays the axis label
LINE	displays the axis line
TICKS	displays the tick marks
TICKVALUES	displays the values that are represented by the major tick marks

The secondary axis is a duplicate of the primary axis (the axis to which the data are mapped). It is on the opposite side of the lattice from the primary axis.

GRIDATTRS=style-element | style-element (line-options) | (line-options)

specifies the attributes of the grid lines. See General Syntax for Attribute Options for the syntax on using a style-element and Line Options for available line-options.

Default: The GraphGridLines style element.

Interaction: This option is ignored if the GRIDDISPLAY= option does not display the grid lines.

GRIDDISPLAY=AUTO_OFF | AUTO_ON | ON | OFF

specifies whether axis grid lines are displayed.

Default: AUTO_OFF

AUTO_OFF

specifies that grid lines are not displayed unless the GraphGridLines element in the current style contains DisplayOpts="ON".

AUTO_ON

specifies that grid lines are displayed unless the GraphGridLines element in the current style contains DisplayOpts="OFF".

specifies that grid lines are always displayed. The current style has no override.

OFF

specifies that grid lines are never displayed. The current style has no override.

This option enables the template to absolutely control the display of grid lines or to allow interaction with the current style to decide whether grid lines are displayed. When displayed, the grids appear in all cells.

Supplied styles use DisplayOpts="AUTO," which means that the style has no "preference" about grid lines and the graphics template setting for grid lines is always used.

Discussion: The following table shows the end results for various combinations of the GRIDDISPLAY= option and the DisplayOpts= attribute of the GraphGridLines style element. Most supplied templates use the default setting AUTO_OFF to indicate a preference for not displaying grid lines, but allowing the style to override.

GRIDDISPLAY= option	DisplayOpts= style attribute	Grid Lines Shown?
AUTO_OFF	AUTO	no
AUTO_OFF	ON	yes
AUTO_OFF	OFF	no
AUTO_ON	AUTO	yes
AUTO_ON	ON	yes
AUTO_ON	OFF	no
ON	any value	yes
OFF	any value	no

LABEL="string" | ( "string" …"string" )

specifies the axis label. The string can be either a string literal or a dynamic. The list form implies that all included string literals or dynamics will be concatenated

Default: The default label is derived from the primary plot in the layout. For more information, see When Plots Share Data and a Common Axis.

Interaction: If the axis label is too long to fit along the axis, it is truncated by default. Use the SHORTLABEL= option to specify an alternate axis label to be used whenever truncation would normally occur.

Interaction: This option is ignored if the DISPLAY= or DISPLAYSECONDARY= option does not display the axis label.

LABELATTRS=style-element | style-element (text-options) | (text-options)

specifies the color and font attributes of the axis label. See General Syntax for Attribute Options for the syntax on using a style-element and Text Options for available text-options.

Default: The GraphLabelText style element.

Interaction: This option is ignored if the DISPLAY= or DISPLAYSECONDARY= option does not display the axis label.

LINEAROPTS=( linear-axis-options )

specifies one or more linear-axis-options for a numeric interval axis. See Options for Linear Axes Only.

LOGOPTS=( log-axis-options )

specifies one or more log-axis-options for a log axis. See Options for Log Axes Only.

OFFSETMAX=AUTO | AUTOCOMPRESS | number

Reserves an area at the maximum end of the axis. No tick marks are displayed in the reserved area. For more information, see Adjusting Axis Offsets.

Default: AUTO

Range: 0 - 1. The sum of OFFSETMAX= and OFFSETMIN= should not be more than 1.

AUTO

Reserves just enough area to fully display markers and other graphical features near the maximum end of an axis.

AUTOCOMPRESS

Automatic offset applied that prevents axis labels and tick values from extending beyond the axis length.

number

The offset is expressed as a decimal proportion of the full axis length.

OFFSETMIN=AUTO | AUTOCOMPRESS | number

Reserves an area at the minimum end of the axis. No tick marks are displayed in the reserved area. For more information, see Adjusting Axis Offsets.

Default: AUTO

Range: 0 - 1. The sum of OFFSETMAX= and OFFSETMIN= should not be more than 1.

AUTO

Reserves just enough area to fully display markers and other graphical features near the maximum end of an axis.

AUTOCOMPRESS

Automatic offset applied that prevents axis labels and tick values from extending beyond the axis length.

number

The offset is expressed as a decimal proportion of the full axis length.

SHORTLABEL="string"

specifies an alternate axis label. This label is used when the default axis label or label specified by the LABEL= option is too long for the axis length.

Default: no default

Interaction: This option is ignored if the DISPLAY= or DISPLAYSECONDARY= option does not display the axis label.

If the specified label is itself too long for the axis, it is truncated in the display.

TICKVALUEATTRS=style-element | style-element (text-options) | (text-options)

specifies the color and font attributes of the axis tick values. See General Syntax for Attribute Options for the syntax on using a style-element and Text Options for available text-options.

Default: The GraphValueText style element.

Interaction: This option is ignored if the DISPLAY= or DISPLAYSECONDARY= option does not display the axis label.

TIMEOPTS=( time-axis-options )

specifies one or more time-axis-options for a time axis. See Options for Time Axes Only.

TYPE=AUTO | DISCRETE | LINEAR | TIME | LOG

specifies the type of axis to use.

Default: AUTO

AUTO

Requests that the axis type be automatically determined, based on the overlay contents. For more information, see When Plots Share Data and a Common Axis.

DISCRETE

Use a DISCRETE X or X2 axis if possible. This setting is not available on a ROWAXIS statement. The data for discrete axes can be character or numeric. For a column axis, you can add a DISCRETEOPTS= ( ) option list to customize this axis type.

LINEAR

Use a LINEAR axis if possible. You can add a LINEAROPTS= ( ) option list to customize this axis type.

TIME

Use a TIME axis if possible. Data for this axis must be SAS time, SAS date, or SAS datetime values. You can add a TIMEOPTS= ( ) option list to customize this axis type.

LOG

Use a LOG axis if possible. You can add a LOGOPTS= ( ) option list to customize this axis type.

Options for Discrete Column Axes Only

DISCRETEOPTS=( discrete-axis-options )

specifies one or more options for a discrete X or X2 axis. This option is not available in the ROWAXIS statement. Options must be enclosed in parentheses. Each option is specified as a name = value pair and each pair is space separated.

Interaction: This option is ignored if the axis type is not DISCRETE.

TICKVALUEFITPOLICY=ROTATE | other-policy

specifies a policy for avoiding tick value collision on a column axis.

Default: ROTATE

The following fit policies are available:

ROTATE	Tick values are rotated 45 degrees.
ROTATETHIN	Attempt ROTATE policy and then THIN policy.
STAGGER	Tick values alternate between two rows.
STAGGERROTATE	Attempt STAGGER policy and then ROTATE policy.
STAGGERTHIN	Attempt STAGGER policy and then THIN policy.
STAGGERTRUNCATE	Attempt STAGGER policy and then TRUNCATE policy.
TRUNCATE	Tick values are shortened when they exceed a certain number of characters.
TRUNCATEROTATE	Attempt TRUNCATE policy and then ROTATE policy.
TRUNCATESTAGGER	Attempt TRUNCATE policy and then STAGGER policy.
TRUNCATETHIN	Attempt TRUNCATE policy and then THIN policy.
THIN	Some tick values are removed.

Options for Linear Axes Only

LINEAROPTS=( linear-axis-options )

specifies one or more linear-axis-options for a numeric interval axis. Options must be enclosed in parentheses. Each option is specified as a name = value pair and each pair is space separated.

Interaction: This option is ignored if the axis type is not LINEAR.

Linear-Axis-Option	Description
INTEGER	Specifies that evenly spaced integer values are used for tick marks.
THRESHOLDMAX	Specifies a bias for including one more tick mark at the maximum end of the axis.
THRESHOLDMIN	Specifies a bias for including one more tick mark at the minimum end of the axis.
TICKVALUEFITPOLICY	Specifies a policy for avoiding tick value collision on an X or X2 axis. This option is not available in the ROWAXIS statement.
TICKVALUEFORMAT	Specifies how to format the values for major tick marks.
TICKVALUELIST	Specifies the order of the tick values for a linear axis as list.
TICKVALUEPRIORITY	Specifies whether an axis tick specification can extend the axis data range.
TICKVALUESEQUENCE	Specifies the tick values for a linear axis by start, end, and increment.
VIEWMAX	Specifies the maximum data value to include in the display.
VIEWMIN	Specifies the minimum data value to include in the display.

INTEGER=boolean

specifies that evenly spaced integer values are used for tick marks.

Default: FALSE

Interaction: This option is overridden by the TICKVALUELIST= or TICKVALUESEQUENCE= option.

Interaction: This option overrides the MAXDECIMALS= and PREFERREDDECIMALS= suboptions of the TICKVALUEFORMAT= option

THRESHOLDMAX= number

specifies a bias for including one more tick mark at the maximum end of the axis. For more information, see Adjusting Axis Thresholds.

Default: .30

Range: 0 - 1

Interaction: This option is ignored if the TICKVALUELIST= or TICKVALUESEQUENCE= option is used.

THRESHOLDMIN= number

specifies a bias for including one more tick mark at the minimum end of the axis. For more information, see Adjusting Axis Thresholds.

Default: .30

Range: 0 - 1

Interaction: This option is ignored if the TICKVALUELIST= or TICKVALUESEQUENCE= option is used.

TICKVALUEFITPOLICY=THIN | other-policy

specifies an ordered list of strategies to avoid tick value collision on an X or X2 axis. This option is not available in the ROWAXIS statement.

Default: THIN

The fit policy can be any one of the following:

THIN	Eliminate alternate tick values. Available for the COLUMNAXIS but not for the ROWAXIS.
ROTATE	Tick values are rotated 45 degrees.
ROTATETHIN	Attempt ROTATE policy and then THIN policy.
STAGGER	Tick values alternate between two columns.
STAGGERROTATE	Attempt STAGGER policy and then ROTATE policy.
STAGGERTHIN	Attempt STAGGER policy and then THIN policy.

If more than one strategy is used, the values in the list are formatted according to the TICKVALUEFORMAT= option.

TICKVALUEFORMAT=( format-options ) | DATA | format

specifies how to format the values for major tick marks.

Default: ( MAXWIDTH=8, MAXDECIMALS=6, PREFERREDDECIMALS=2, EXTRACTSCALE=FALSE)

(format-options)

specifies one or more major tick value formatting options. Together, these options provide parameters for determining an optimal format ( w.d, Ew., BESTw.) for displaying major tick values.

MAXWIDTH = integer	Specifies the maximum width for displayed tick values. Values might be rounded or converted to E-notation to fit into this width.
MAXDECIMALS = integer	Specifies the maximum number of decimals for displayed tick values. Values might be rounded or converted to E-notation to fit into this width. MAXWIDTH > MAXDECIMALS
PREFERREDDECIMALS = integer	Specifies the number of decimal places desired for most values. The actual number might vary based on other constraints.
EXTRACTSCALE = boolean	Specifies whether to extract some factor of ten from all tick values in order to reduce the overall width of the tick values and improve legibility. The extracted factor is concatenated to the existing axis label. Example of revised axis label: Number Sold (x1000)

DATA

use the format that has been assigned to the variable(s) contributing to the axis (or BEST6. if no format is assigned) to control the formatting of the major tick values.

format

use this format to control how the major tick values are formatted.

Restriction: The format-options are used only when no format has been assigned to the variable(s) that contribute to the axis or when the assigned format(s) are w.d, Ew. or BESTw.

Restriction: GTL currently honors most but not every SAS format. For details, see SAS Formats Not Supported.

Interaction: If the axis label is not displayed, the EXTRACTSCALE=TRUE format-option is ignored.

TICKVALUELIST=( numeric-list )

specifies the tick values for a linear axis as list.

Default: An internal algorithm determines the tick marks based on the actual axis data range or the data range established by the VIEWMIN= and VIEWMAX= options. By default when this option is used, the only tick values that appear are those in numeric-list that fall within the explicit data range (set by VIEWMIN= and VIEWMAX=) or implicit data range (set by the actual data minimum and data maximum).

Requirement: The numeric-list must be enclosed in parentheses and each item separated by a blank.

Interaction: This option overrides the INTEGER=

Interaction: This option is ignored if the TICKVALUESEQUENCE= option is specified, or if the DISPLAY= or DISPLAYSECONDARY= option does not display the tick values.

Interaction: The VIEWMIN= and VIEWMAX= options alter the axis data range. If the VIEWMIN= option is set to the minimum tick list value and the VIEWMAX= option is set to the maximum tick list value, all ticks in the tick list are displayed.

Interaction: If the TICKVALUEPRIORITY= is set to TRUE, 1) the VIEWMIN= and VIEWMAX= options are ignored if they are fully enclosed by the numeric-list, and 2) the tick numeric-list can extend the implicit data range of the axis, but never reduce it.

The values in the list are formatted according to the setting for the TICKVALUEFORMAT= option.

TICKVALUEPRIORITY=boolean

specifies whether an axis tick specification (TICKVALUELIST= or TICKVALUESEQUENCE= ) can extend the axis data range.

Default: FALSE.

FALSE

the only tick values that appear are the user-specified tick values that fall within the explicit data range (set by VIEWMIN= and VIEWMAX= ) or implicit data range (set by the actual data minimum and data maximum).

TRUE

the axis data range might be extended (but not reduced) to include the minimum and maximum specified by either the TICKVALUELIST= or TICKVALUESEQUENCE= option. If minimum and maximum of the user-specified values are within the data range, this option has no effect.

Interaction: When this option is set to TRUE, the VIEWMIN= and VIEWMAX= options are ignored if they are fully enclosed by value range set by the TICKVALUELIST= or TICKVALUESEQUENCE= option.

Interaction: This option is ignored if the DISPLAY= or DISPLAYSECONDARY= option does not display the tick values.

TICKVALUESEQUENCE=( sequence-options )

specifies the tick values for a linear axis by start, end, and increment.

Default: An internal algorithm determines the tick marks based on the actual axis data range or the data range established by the VIEWMIN= and VIEWMAX= options. By default when this option is used, the only tick values that appear are those that fall within the explicit data range (set by VIEWMIN= and VIEWMAX=) or implicit data range (set by the actual data minimum and data maximum).

(sequence-options)

Three settings that control major tick values. All three must be provided.

START = number	Specifies the value for the first tick mark.
END = number	Specifies the value for the last tick mark.
INCREMENT = number	Specifies the increment for intermediate tick marks between the first and last tick marks. The END value always controls the last tick mark. The interval between the last tick mark and the previous tick mark might not necessarily be the INCREMENT value.

Interaction: This option overrides the INTEGER= option.

Interaction: The VIEWMIN= and VIEWMAX= options alter the axis data range. If the VIEWMIN= option is set to the START= option value and the VIEWMAX= option is set to the END= option value, all ticks in the tick sequence are displayed.

Interaction: If the TICKVALUEPRIORITY= option is set to TRUE, the tick sequence might extend the explicit data range of the axis, but never reduce it.

Interaction: This option is ignored if the DISPLAY= or DISPLAYSECONDARY= option does not display tick marks.

The values in the sequence are formatted according to the setting for the TICKVALUEFORMAT= option.

See also: TICKVALUELIST= option as an alternative for customizing tick marks.

VIEWMAX= number

specifies the maximum data value to include in the display (the value might be adjusted by the threshold calculation). For more information, see Adjusting the Axis View.

Default: The maximum value in the data for the specified axis.

Interaction: This option does not determine the maximum axis tick value displayed. The THRESHOLDMAX= value is used to determine the maximum tick value.

Interaction: This option has no effect if the TICKVALUEPRIORITY= is set to TRUE.

Setting a VIEWMAX= or VIEWMIN= value does not alter the original data or any calculations on it.

VIEWMIN= number

specifies the minimum data value to include in the display (the value might be adjusted by the threshold calculation). For more information, see Adjusting the Axis View.

Default: The minimum value in the data for the specified axis.

Interaction: This option does not determine the minimum axis tick value displayed. The THRESHOLDMIN= value is used to determine the maximum tick value.

Interaction: This option has no effect if the TICKVALUEPRIORITY= is set to TRUE.

Setting a VIEWMAX= or VIEWMIN= value does not alter the original data or any calculations on it.

Options for Log Axes Only

LOGOPTS=( log-axis-options )

specifies one or more log-axis-options for a log axis. Options must be enclosed in parentheses. Each option is specified as a name = value pair and each pair is space separated.

Interaction: This option is ignored if the axis type is not LOG.

Log-Axis-Option	Description
BASE	Specifies the base of the logarithmic scale for the axis values.
MINORTICKS	Specifies whether minor ticks are displayed.
TICKINTERVALSTYLE	Specifies how to scale and format the values for major tick marks.
VIEWMAX	Specifies the maximum data value to include in the display.
VIEWMIN	Specifies the minimum data value to include in the display.

BASE=10 | 2 | E

specifies the base of the logarithmic scale for the axis values.

Default: 10

MINORTICKS=boolean

specifies whether minor ticks are displayed:

Default: FALSE

Restriction: Minor ticks can be displayed only when BASE=10 and TICKINTERVALSTYLE= is LOGEXPAND or LOGEXPONENT.

If this option is set to TRUE, the number of minor ticks is automatically determined.

TICKINTERVALSTYLE=AUTO | LOGEXPAND | LOGEXPONENT | LINEAR

specifies how to scale and format the values for major tick marks.

Default: AUTO

AUTO

A LOGEXPAND, LOGEXPONENT, or LINEAR representation is chosen automatically based on the range of the data. When the data range is small (within an order of magnitude), a LINEAR representation is typically used. Data ranges that encompass several orders of magnitude typically use the LOGEXPAND or LOGEXPONENT representation.

LOGEXPAND

Major ticks are placed at uniform intervals at integer powers of the base. The tick values are expanded as follows:

Base=10

Base=2

Base=E

LOGEXPONENT

Major ticks are placed at uniform intervals at integer powers of the base. The tick values are only the integer exponents for all bases.

major ticks are integer exponents for the base

LINEAR

Major tick marks are placed at non-uniform intervals that cover the range of the data.

Restriction: For LOGEXPAND and LOGEXPONENT, formats on data columns contributing to the axis are ignored. For LINEAR, ticks values are automatically formatted when the column format is not assigned or one of w.d, Ew. or BESTw. Other formats (SAS defined or user-defined) are used if specified.

Restriction: GTL currently honors most but not every SAS format. For details, see SAS Formats Not Supported.

Interaction: When BASE=10 and LOGEXPAND or LOGEXPONENT is used, an intermediate tick is added whenever the axis data range is less than or equal to 1.5 powers of 10.

If you use TICKINTERVALSTYLE=LOGEXPONENT, you might want to include information in the axis label about which base is used.

VIEWMAX= number

specifies the maximum data value to include in the display. For more information, see Adjusting the Axis View.

Default: The maximum value in the data for the specified axis.

Setting a VIEWMAX= or VIEWMIN= value does not alter the original data or any calculations on it.

VIEWMIN= number

specifies the minimum data value to include in the display. For more information, see Adjusting the Axis View.

Default: The minimum value in the data for the specified axis.

Setting a VIEWMAX= or VIEWMIN= value does not alter the original data or any calculations on it.

Options for Time Axes Only

TIMEOPTS=( time-axis-options )

specifies one or more time-axis-options for a time axis.

Variables associated with a time axis must be in SAS time, SAS date, or SAS datetime units and have an associated SAS time, date, or datetime format.

Options must be enclosed in parentheses. Each option is specified as a name = value pair and each pair is space separated.

Interaction: This option is ignored if the axis type is not TIME.

Time-Axis-Option	Description
INTERVAL	Specifies the time interval between major tick marks.
MINORTICKS	Specifies whether minor tick marks are displayed.
SPLITTICKVALUE	Specifies whether to split the tick values on column axes, if possible. This option is not available in the ROWAXIS statement.
TICKVALUEFITPOLICY	Specifies a policy for avoiding tick value collision on column axes. This option is not available in the ROWAXIS statement.
TICKVALUEFORMAT	Specifies how to format the values for major tick marks.
TICKVALUELIST	Specifies the order of the tick values for a time axis as list.
TICKVALUEPRIORITY	Specifies whether an axis tick specification can extend the axis data range.
VIEWMAX	Specifies the maximum data value to include in the display.
VIEWMIN	Specifies the minimum data value to include in the display.

INTERVAL=interval

specifies the time interval between major ticks. Valid interval keywords are AUTO, SECOND, MINUTE, HOUR, DAY, TENDAY, WEEK, SEMIMONTH, MONTH, QUARTER, SEMIYEAR, YEAR.

The data column(s) mapped to a time axis must be in the same duration units: TIME, DATE, or DATETIME. The selection of an interval must be consistent with the duration unit. For example, if the data are in time units, you can select only AUTO, SECOND, MINUTE, HOUR.

Default: AUTO. An appropriate interval is chosen based on the data.

Interaction: This option is ignored if the TICKVALUELIST= option is used.

INTERVAL	Unit	Tick interval	Default tick value format
AUTO	DATE, TIME, or DATETIME	automatically chosen	automatically chosen
SECOND	TIME or DATETIME	second	TIME8.
MINUTE	TIME or DATETIME	minute	TIME8.
HOUR	TIME or DATETIME	hour	TIME8.
DAY	DATE or DATETIME	day	DATE9.
TENDAY	DATE or DATETIME	10 days	DATE9.
WEEK	DATE or DATETIME	7 days	DATE9.
SEMIMONTH	DATE or DATETIME	1st and 16th of each month	DATE9.
MONTH	DATE or DATETIME	month	MONYY7.
QUARTER	DATE or DATETIME	3 months	YYQC6.
SEMIYEAR	DATE or DATETIME	6 months	MONYY7.
YEAR	DATE or DATETIME	year	YEAR4.

MINORTICKS=boolean

specifies whether minor tick marks are displayed.

Default: FALSE

Interaction: The number of minor ticks is dependent on the value of the INTERVAL= option. For example, on a row axis, if INTERVAL=YEAR, there would be four minor ticks (one per quarter).

Interaction: This option is ignored if the TICKVALUELIST= option is used, or if the DISPLAY= or DISPLAYSECONDARY= option does not display the tick marks.

SPLITTICKVALUE=boolean

specifies whether to split the tick values on column axes, if possible (this option is not available in the ROWAXIS statement). For example, with INTERVAL=MONTH, this is how tick values are split:

Default: TRUE

TRUE

axis tick values are split into two lines allowing more tick values to appear

FALSE

typically, fewer tick values fit, causing thinning, rotation, or staggering of the values. See the TICKVALUEFITPOLICY= option.

Interaction: This option is ignored if the TICKVALUELIST= or TICKVALUEFORMAT= option is specified.

specifies a policy for avoiding tick value collision on column axes. This option is not available in the ROWAXIS statement.

Default: THIN

The fit policy can be any one of the following policies:

THIN	Some tick values are removed.
ROTATE	Tick values are rotated 45 degrees.
ROTATETHIN	Attempt ROTATE policy and then THIN policy.
STAGGER	Tick values alternate between two columns.
STAGGERROTATE	Attempt STAGGER policy and then ROTATE policy.
STAGGERTHIN	Attempt STAGGER policy and then THIN policy.

Interaction: When SPLITTICKVALUE= TRUE, this option is ignored and only the THIN policy is used.

TICKVALUEFORMAT=format | DATA

specifies how to format the values for major tick marks.

Default: The default format used by the INTERVAL= option. The default does not apply if TICKVALUELIST= is specified.

format

A SAS date, time, or datetime format to control how the major tick values are displayed. This format should be in the same duration units as the data column(s) mapped to a time axis: TIME, DATE, or DATETIME, and should be appropriate for the value of the INTERVAL= option. For example, if INTERVAL=MONTH and there are two years of data displayed on the axis, choosing TICKVALUEFORMAT=YEAR. would result in several ticks having the same year value.

DATA

Use the SAS date, time, or datetime format associated with the data column assigned to the axis to control how the major tick values are displayed.

Restriction: GTL currently honors most but not every SAS format. For details, see SAS Formats Not Supported.

Interaction: If this option is specified, the SPLITTICKVALUE= option is ignored.

TICKVALUELIST=( time-constant-list | date-constant-list | datetime-constant-list | numeric-list )

specifies the tick values for a time axis as list.

Default: An internal algorithm determines the tick values.

Requirement: The list must be enclosed in parentheses and each item separated by a blank. The items in the list must be in the same duration units as the data mapped to the axis: TIME, DATE, or DATETIME. The values can be expressed as SAS TIME, DATE, or DATETIME constants (for example, "13:23"T, "11MAY06"D, or "11MAY06:13:23"DT) or their numeric equivalents.

Restriction: If TICKVALUEPRIORITY= is set to FALSE, this option does not extend the data range of the axis. If the values fall within the default data range or that specified by the VIEWMIN= or VIEWMAX= options, they are used.

The values in the list are formatted according to the setting for the TICKVALUEFORMAT= option. If TICKVALUEFORMAT= is not used, the values are formatted according to the column format (the default TICKVALUEFORMAT value is not applied to these values).

See also: TICKVALUESEQUENCE= option as an alternate to customizing tick marks.

TICKVALUEPRIORITY=boolean

specifies whether an axis tick specification (TICKVALUELIST= ) can extend the axis data range.

Default: FALSE

FALSE

TRUE

the axis data range might be extended (but not reduced) to include the minimum and maximum specified by the TICKVALUELIST= option. If minimum and maximum of the user-specified values are within the data range, this option has no effect.

Interaction: When this option is set to TRUE, the VIEWMIN= or VIEWMAX= options might have no effect.

Interaction: This option is ignored if the DISPLAY= or DISPLAYSECONDARY= option does not display tick marks.

VIEWMAX= number

specifies the maximum data value to include in the display. For more information, see Adjusting the Axis View.

Default: The maximum value in the data for the specified axis.

Setting a VIEWMAX= or VIEWMIN= value does not alter the original data or any calculations on it.

VIEWMIN= number

specifies the minimum data value to include in the display. For more information, see Adjusting the Axis View.

Default: The minimum value in the data for the specified axis.

Setting a VIEWMAX= or VIEWMIN= value does not alter the original data or any calculations on it.