NAME

coordinator - converts raw coordinates to detector and sky coordinates

USAGE

coordinator eventfile attfile teldef

DESCRIPTION

This is a mission-independent tool for taking raw coordinate columns in an event file and converting them to detector and sky coordinates. In other words it fills the appropriate coordinate columns. Note that the details of which columns to read and write are specified in the "teldef" calibration file.

PARAMETERS

eventfile [string]
This is the name of the event file containing raw coordinates and to which detector and sky coordinates will be written.

(eventext = EVENT) [string]
This is the name of the FITS file extension containing the event list.

(timecol = TIME) [string]
This is the name of the FITS column containing time values.

(skyxnull = 0) [integer]
"Null" value to be written to the sky X column when the coordinates are outside the field of view or if the current attitude is unknown.

(skyynull = 0) [integer]
"Null" value to be written to the sky Y column when the coordinates are outside the field of view or if the current attitude is unknown.

attfile [filename]
Name of the attitude file to be used to fill the sky coordinate columns. If set to "NONE", the sky coordinate columns will not be filled.

teldef [filename]
Name of the "Telescope Definition" calibration file or CALDB.

(aberration = yes) [boolean] Should the effects of aberration be taken into account when calculating the sky coordinate values? Aberration is the apparent bending of light due to the Earth's orbit around the Sun. This is at most a ~20 arcsec effect.

(follow_sun = yes) [boolean] Should aberration be recalculated for each event time? If set to "no" the aberration at the time given by the MJDOBS keyword will be used for all events. Setting this to "no" is acceptable except for very long observations and will make the program run slightly faster. The "yes" setting should be used for highest accuracy.

ra [real]
This is the Right Ascension in decimal degrees of the point to appear in the center of sky coordinate images.

dec [real]
This is the Declination in decimal degrees of the point to appear in the center of sky coordinate images.

(randomize = yes) [boolean]
If this is set to "no" the program will assume that each event occured at the center of its raw coordinate pixel. If it is set to "yes", the detector and sky coordinates will be calculated assuming a random location within the raw pixel. In general this should be set to "yes", however, randomization may be undesirable if the raw pixels are much larger than the detector or sky pixels.

(seed = -1956) [integer]
Random number generator seed to be used if the "randomize" flag is set to "yes". For a given seed value, the same results will be produced each time the program is run.

(timemargin = 32.0) [real]
Allowed time to extrapolate the spacecraft attitude before the first or after the last row in the attitude file. Events beyond the time margin will have their coordinates set to the "skyxnull" and "skyynull" values.

(interpolation = LINEAR) [string]
Attitude interpolation method. The value LINEAR results in the attitude being linearly interpolated to the event time. The value CONSTANT results in the attitude being taken from the nearest attitude record.

(history = yes) [boolean]
Write parameter history?

(chatter = 1) [enumerated integer]
Standard HEAdas chatter parameter.

EXAMPLES

SEE ALSO

LAST MODIFIED

September 2005