The TCS Module will read an entry on its configuration file called "file",
under the [HDRINFO] section. Thi file there should be a template
for formating the information coming from the TCS to the headers of the image.
If the entry and/or section are not found, then it will try reading a default
configuration file ($ARCVIEWROOT/ConfigFile/TCSINFO.hdr) . If the default
file is not found either, then the template will be empty, and all the keywords
from the TCS will be written to the headers. Note that the result of this
is uncertain, since the names that the TCS uses for the keywords may not
be compatible with the maximum 8 characters than the fits format requieres;
because of this it is strongly recommended to provide a template file.
The present document describes how to generate such a template file.
Symbols used
< > : denotes a requiered field
[ ] : denotes an optional field
File Description
The file should be just a list of entries with the following sintax:
HDRKEY = '<tcs_name> [argx]' / '[comment]
where
HDRKEY :the name as it will appear on
the headers. This name should have 8 characters maximum. More than that will
be truncated.
tcs_name :the name of the variable according
to the tcs,
argx
:which argument inside the value provided by the tcs (defaults to
first argument, that is, arg1)
comment :the comment which will appear
on the headers for that keyword
All the parameters are case insensitive
Example:
DATE = 'UTC 1' /date
of obs
/* get the first value on the utc tcs field */
TIME = 'UTC 2'
/time of obs
/* get
the second value on the tcs utc field*/
RA = 'RA'
/ra position
/*value on the tcs RA field*/
DEC = 'DEC'
/dec position
/*value on the tcs DEC field*/
AIRMASS = 'air mass' /air mass
/*value on the tcs
"air mass" field*/
If the response from the TCS to the INFO command is, for example:
utc = 161 14:22:51 <separator> ra=23 <separator>
dec= 56 <separator> air mass=1.03
(<separator> can be new line (\n), comma (,) , or semicolon (;). Between the key and the "equal" sign can be an space or not)
With the above response, the corrspondent entries on the image headers
would be:
DATE = '161' /date
of obs
/* first value on the utc field */
TIME = '14:22:51'
/time of obs
/* second value on the utc field*/
RA = '23'
/ra position
DEC = '56'
/dec position
AIRMASS = '1.03' /air mass