next up previous
Next: GeoLat - The geodetic latitude of the observer
Up: AST Attribute Descriptions
Previous: Full - Set level of output detail

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

Description:
This attribute controls the appearance of an annotated coordinate grid (drawn with the astGrid function) by determining the 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 interval between major values along the second axis.

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
Next: GeoLat - The geodetic latitude of the observer
Up: AST Attribute Descriptions
Previous: Full - Set level of output detail

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

Copyright (C) 2003 Central Laboratory of the Research Councils