Catalogs

Source and line catalogs are plain text files. The default file extensions are .cat for source catalogs and .line_cat for line catalogs. The UIP CATALOG command looks for catalogs first in the current directory, then the user's private catalog directory (~/.uip/cat), and finally in the system's default catalog directory (/opt/uip/cat).

The source catalog format is a subset of the GILDAS ASTRO format. Each source is entered on a single line,

SOURCE_NAME COORDINATE_TYPE LONGITUDE,PM_LONGITUDE LATITUDE,PM_LATITUDE VELOCITY_TYPE VELOCITY

• SOURCE_NAME is the source name. No spaces are allowed. Aliases may be entered, separated by |.
• COORDINATE_TYPE is the coordinate system: EQ for equatorial of epoch, GA for Galactic II, DA for apparent equatorial, or HO for horizontal. For the equatorial coordinate system, the epoch must follow EQ, i. e., EQ 2000 for J2000.0 or EQ 1950 for B1950.0.
• LONGITUDE is the longitude-like coordinate. For the equatorial system, the right ascension must be in hours. For other systems, the longitude is in degrees. It may be in sexagesimal notation, hh:mm:ss.ss or hh:mm.mmmm, or simply in decimal notation, hh.hhhhhh.
• LATITUDE is the latitude-like coordinate, in degrees. Same format as LONGITUDE.
• PM_LONGITUDE and PM_LATITUDE are the rates of change of the corresponding coordinates. These are optional. For equatorial coordinates, the units of PM_LONGITUDE are s yr^–1 and of PM_LATITUDE are arcsec yr^–1.
• VELOCITY_TYPE is the velocity reference: “LSR”, “HEL” for Solar system barycenter, “EA” for geocentric, or “OB” for topocentric. Velocity information is optional. But if a VELOCITY_TYPE is specified, then a numeric VELOCITY must also be specified.
• VELOCITY is the velocity in km s^–1.

As an example, a few entries from the system default source catalog:

O_CET   EQ 1950.00 02:16:49.040,-0.00080 -03:12:13.39,-0.2330 LSR  46.80
W3OHUH  EQ 1950.00 02:23:16.700           61:38:54.01         LSR -47.40
NGC1333 EQ 2000.00 03:29:03.700           31:16:02.70         LSR   0.00
ORIUH   EQ 1950.00 05:32:47.000          -05:24:21.00         LSR   9.00
W51UH   EQ 1950.00 19:21:27.001           14:24:30.00         LSR  57.10

Designated Off positions may be named freely, as the /DESIGNATED_OFF option of the OFF_POSITION, OO_SCAN, OTF_MAP, TCAL, and TEXAS commands takes a source name as an optional argument. By default, these commands look for a source named SOURCE_NAME:off_position in the open catalogs, where SOURCE_NAME is the name of the current ON source. Suffixes other than :off_position do not have any special meaning. For example:

a_star              eq 2000 23:59:59 09:59:59 lsr  99
a_star:off_position eq 2000 23:58:58 09:58:58 lsr  99

Any text following ! is ignored, allowing for comments.

Each spectral line is entered on a single line:

LINE_NAME FREQUENCY FREQUENCY_UNIT SIDEBAND

• LINE_NAME is the line name. No spaces are allowed. Aliases may be entered, separated by |.
• FREQUENCY is the line frequency of the line in GHz.
• FREQUENCY_UNIT is the frequency unit and must be GHz.
• SIDEBAND is the sideband to put the line in and may be either USB for upper sideband or LSB for lower sideband. (All CSO heterodyne receivers are double sideband.)

As an example, a few entries from the system default line catalog:

12CO2-1 230.5379700 GHz LSB
12CO3-2 345.7959900 GHz USB
12CO4-3 461.0408110 GHz LSB
12CO6-5 691.4729800 GHz USB
12CO7-6 806.6517200 GHz LSB

Any text following ! is ignored, allowing for comments.

These catalogs are automatically loaded by the UIP.