next up previous 264
Next: Grf - Use Grf routines registered through AST_GRFSET?
Up: AST Attribute Descriptions
Previous: Full - Set level of output detail


Gap(axis) - Interval between linearly spaced major axis values of a Plot

Description:
This attribute controls the appearance of an annotated coordinate grid (drawn with the AST_GRID routine) by determining the linear interval between the "major" axis values of a Plot, at which (for example) major tick marks are drawn. It takes a separate value for each physical axis of the Plot so that, for instance, the setting "Gap(2)=3.0" specifies the difference between adjacent major values along the second axis. The Gap attribute is only used when the LogTicks attribute indicates that the spacing between major axis values is to be linear. If major axis values are logarithmically spaced then the gap is specified using attribute LogGap.

The Gap value supplied will usually be rounded to the nearest "nice" value, suitable (e.g.) for generating axis labels, before use. To avoid this "nicing" you should set an explicit format for the axis using the Format(axis) or Digits/Digits(axis) attribute. The default behaviour is for the Plot to generate its own Gap value when required, based on the range of axis values to be represented.

Type:
Floating point.
Class Applicability:
Plot
All Plots have this attribute.
Notes:
  • The Gap value should use the same units as are used internally for storing coordinate values on the corresponding axis. For example, with a celestial coordinate system, the Gap value should be in radians, not hours or degrees.

  • If no axis is specified, (e.g. "Gap" instead of "Gap(2)"), then a "set" or "clear" operation will affect the attribute value of all the Plot axes, while a "get" or "test" operation will use just the Gap(1) value.


next up previous 264
Next: Grf - Use Grf routines registered through AST_GRFSET?
Up: AST Attribute Descriptions
Previous: Full - Set level of output detail

AST A Library for Handling World Coordinate Systems in Astronomy
Starlink User Note 210
R.F. Warren-Smith & D.S. Berry
24th May 2011
E-mail:ussc@star.rl.ac.uk

Copyright (C) 2009 Science \& Technology Facilities Council