The following describes the most significant changes which
occurred in the AST library between versions V5.1 and V5.2:
- A new method called
astSetFitsCMastSetFitsCM
has been added to the FitsChanFitsChan class. It stores a pure comment card in a
FitsChan (that is, a card with no keyword name or equals sign).
- A new attribute called ObsAltObsAlt has been added to the FrameFrame class. It
records the geodetic altitude of the observer, in metres. It defaults to
zero. It is used when converting times to or from the TDB timescale, or
converting spectral positions to or from the topocentric rest frame, or
converting sky positions to or from horizon coordinates. The FitsChan
class will include its effect when creating a set of values for the
OBSGEO-X/Y/Z keywords, and will also assign a value to it when reading a
set of OBSGEO-X/Y/Z keyword values from a FITS header.
- The TimeMapTimeMap conversions “TTTOTDB” and “TDBTOTT”, and the SpecMapSpecMap
conversions “TPF2HL” and “HLF2TP”, now have an additional argument -
the observer's geodetic altitude.
- The PolygonPolygon class has been modified to make it consistent with the
IVOA STC definition of a Polygon. Specifically, the inside of a polygon
is now the area to the left of each edge as the vertices are traversed in
an anti-clockwise manner, as seen from the inside of the celestial sphere.
Previously, AST used the anti-clockwise convention, but viewed from the
outside of the celestial sphere instead of the inside. Any Polygon saved
using previous versions of AST will be identified and negated automatically
when read by AST V5.2.
- A new class of ChannelChannel, called StcsChanStcsChan, has been added that allows
conversion of suitable AST Objects to and from IVOA STC-S format.
- A new method called
astRemoveRegionsastRemoveRegions
has been added to the MappingMapping class. It searches a (possibly compound)
Mapping (or Frame) for any instances of the AST RegionRegion class, and either
removes them, or replaces them with UnitMaps (or equivalent Frames). It
can be used to remove the masking effects of Regions from a compound
Mapping or Frame.
- A new method called
astDownsizeastDownsize
has been added to the Polygon class. It produces a new Polygon that
contains a subset of the vertices in the supplied Polygon. The subset is
chosen to retain the main features of the supplied Polygion, in so far
as that is possible, within specified constraints.
- A new constructor called
astOutline
has been added to the Polygon class. Given a 2D data array, it identifies
the boundary of a region within the array that holds pixels with
specified values. It then creates a new Polygon to describe this boundary
to a specified accuracy.
- A new set of methods, called
astMapGetElem<X>
has been added to the KeyMapKeyMap class. They allow a single element of a vector
valued entry to be returned.
- A new attribute called KeyErrorKeyError has been added to the KeyMap ClassClass. It
controls whether the
astMapGet...
family of functions report an error if an entry with the requested key does
not exist in the KeyMap.