Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision | |||
|
cso:telescope:uip:catalog [2014-10-28 03:07] sradford |
cso:telescope:uip:catalog [2015-06-04 02:21] (current) sradford [Source Catalogs] |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | ====== 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'' | | ||
