Digits/Digits(axis) - Number of digits of precision

Description:

This attribute specifies how many digits of precision are required by default when a co-ordinate value is formatted for a Frame  axis (e.g. when producing annotated plot axes). Its value may be set either for a Frame as a whole, or (by subscripting the attribute name with the number of an axis) for each axis individually. Any value set for an individual axis will override the value for the Frame as a whole.

Note that the Digits value acts only as a means of determining a default value for the Format  attribute. Its effects are overridden if a Format string is set explicitly for an axis.

The default Digits value for a Frame is 7. If a value fewer than 1 is supplied, then 1 is used instead.

If the Frame is actually a SkyFrame  (e.g.  describes celestial longitude and latitude), then the Digits value specifies the total number of digits in the formatted axis value--that is, the sum of the hours (or degrees), minutes and seconds digits.

Type:

Integer.

Examples:

wcsattrib m51 set digits 4

This sets the Digits attribute to the value 4 for all axes in the current Frame of the NDF m51. This results in axis values being formatted with four digits of precision when they are displayed by any application, so long as no value has been set for the Format attribute.

wcsattrib m51 set digits(1) 4

This is like the previous example, except that the Digits value is only set for the first axis in the current Frame of the NDF.