Many spectral coordinate systems have some additional free parameters which serve to identify a particular coordinate system from amongst a broader class of related coordinate systems. For example, the velocity systems are all parameterised by a rest frequency--the frequency which defines zero velocity, and all coordinate systems are qualified by a `standard of rest'' which indicates the rest frame to which the values refer.
In AST, these free parameters are represented by additional SpecFrame attributes, each of which has a default appropriate to (i.e. defined by) the setting of the main System attribute. Each of these qualifying attributes may, however, be assigned an explicit value so as to select a particular coordinate system.
The main SpecFrame attributes which qualify the System attribute are:
- Epoch
This attribute is inherited from the Frame class. It gives the moment in time when the coordinates are correct for the astronomical source under study (usually the date of observation). It is needed in order to calculate the Doppler shift produced by the velocity of the observer relative to the centre of the earth, and of the earth relative to the sun.- StdOfRest
This specifies the rest frame in which the coordinates are correct. Transforming between different standards of rest involves taking account of the Doppler shift introduced by the relative motion of the two standards of rest.- RestFreq
Specifies the frequency which correspond to zero velocity. When setting a value for this attribute, the value may be supplied as a wavelength (including an indication of the units being used, ``nm'' ``Angstrom'', etc. ), which will be automatically be converted to a frequency.- RefRA
Specifies the RA (FK5 J2000) of the source. This is used when converting between standards of rest. It specifies the direction along which the component of the relative velocity of the two standards of rest is taken.- RefDec
Specifies the Dec (FK5 J2000) of the source. Used in conjunction with REFRA.- GeoLon
Specifies the longitude of the observer (assumed to be on the surface of the earth). This allows the relative velocity of the observer and the centre of the earth to be calculated for use in converting between standards of rest.- GeoLat
Specifies the latitude of the observer. Use in conjunction with GeoLon.- SourceVel
This defines the ``source'' standard of rest. This is a rest frame which is moving towards the position given by RefRA and RefDec, at a velocity given by SourceVel. The velocity is stored internally as a heliocentric velocity, but can be given in any of the other supported standards of rest.
For further details of these attributes you should consult their
descriptions in and for details of
the System settings for which they are relevant, see the description
of the System attribute (also in
).
Note that it does no harm to assign values to qualifying attributes which are not relevant to the main System value. Any such values are stored, but are not used unless the System value is later set so that they become relevant.
AST A Library for Handling World Coordinate Systems in Astronomy