COMMAND TYPE : UTILITY
This command loads in DIRA a catalogue written on tape or on disk in FITS format (XTENSION='TABLE'). Some catalogues written in FITS are distributed from computer centers, moreover some packages,i.e. ESO MIDAS, write tables data in this format, so the user can load in DIRA this tables. The command adjusts the catalogue data, and update the DIRA system. When the sky coordinates in the FITS catalogue do not agree with DIRA coordinate convention, the command converts these automatically.
The command DB_TOFITS : writes DIRA catalogue in a FITS format. When the task DB_FROMFT recognizes catalogue written by DB_TOFITS : it works in a fully automatically way and inserts catalogue in the data base without more instruction. So the use of the commands DB_TOFITS : and DB_FROMFT is the best way to interchange DIRA catalogues between computer centers.
Input FITS File name
Example : MSA0:
Example : Y
Output : Catalogue File Name
Example : CATNEW.DAT
Tape: File No.
Example : 17
When coordinates in the input file are not in a standard format, or when the user enter T to convert the format of the input coordinate the command opens two new windows on the screen. In the bottom window the first ten records of the catalogue are shown. In the top window are written the FITS keywords related with the fields.
The first column of the catalogue in the bottom window is shown in reverse, while in the top window the values of the FITS key of this column are shown. The user, with the left and right keyboard arrows can select other columns and read other FITS keys in the top window. So he can examine all the catalogue fields to understand the formats of the coordinates.
Then the user can mark the coordinates entering C key. The task will ask for the coordinate class (first coordinate = longitude or second coordinate = latitude) and for coordinate type (degrees, HH MM SS, radians and so on). When the user has defined the type of input coordinates he must use the keyboard arrows to select, in the bottom window, the field that contains the coordinate values. If the input catalogue has the coordinate written on more fields (i.e. hours, minutes, seconds) the command will ask to mark the hours field, then the minutes field and finally the seconds fields.
The user must mark all the coordinate fields that he needs to convert, (remember that DIRA can handle coordinates that are in a unique field). Then he can use E to start with the conversion and the output file writing. The CTRL-Z key will abort the task.