====== 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''). 

===== Source Catalogs =====

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<sup>–1</sup> and of PM_LATITUDE are arcsec yr<sup>–1</sup>. 
  * ''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<sup>–1</sup>. 

As an example, a few entries from the system default source catalog:
<code>
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
</code>

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:
<code>
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
</code>



Any text following ''!'' is ignored, allowing for comments.

=====  Line Catalogs =====

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:
<code>
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
</code>

Any text following ''!'' is ignored, allowing for comments.

=====  System Catalogs =====

These catalogs are automatically loaded by the UIP.

| ''/opt/uip/cat/default_catalog.cat''   | Popular sources  |
| ''/opt/uip/cat/co_point_star.cat''  | Stars suitable for CO pointing measurements  |
| ''/opt/uip/cat/sharccal.cat''  | Calibrators for Sharc observations  |
| ||
| ''/opt/uip/cat/default_catalog.line_cat''  | Popular spectral lines  |
| ||
| ''/opt/uip/cat/bright_star.cat''  | Bright stars for optical pointing  | 
| ''/opt/uip/cat/tycho.cat''  | Synonym for ''bright_star.cat'' |