User Guide for New User Interface Program
H. Yoshida
Caltech Submillimeter Observatory
1 Introduction
User Interface Program (UIP) is an application program to control the
telescope and take heterodyne receiver data at the Caltech
Submillimeter Observatory (CSO). The original UIP was written mostly
in PASCAL, with a small portion in FORTRAN and C. It ran on the VMS
operating system. A new UIP, described in this memo, is written in
C++ and meant to be run on modern Linux/UNIX operating systems. The
original UIP utilized the DEC Command Language (DCL) as a command line
interpreter. As a result, its interface was essentially the same with
the VMS operating system itself. On the other hand, the new UIP is
built upon the GILDAS Sympathique Interpréteur de Commandes (SIC).
Its look and feel are similar to the DCL, but there are some syntactic
differences.
2 Running New UIP
Although technically it can run on any Linux computers at the summit,
namely
kilauea,
puuoo,
lapakahi, and
others, the new UIP should only be started on
kilauea.
Each user account on
kilauea is set up to have an immediate
access to the new UIP. There is a common user account named
observer which can also be used to run the new UIP. Log
on to
kilauea directly from the console or using a secure
shell. Type
uip then
RETURN to start the new
UIP. Note that the path of the actual program to run is
/opt/uip/bin/uip.bin. The "
uip" is an alias
to execute the above with appropriate options.
A set of UIP commands can be executed automatically when the UIP is
started by placing them in
~/.gag/init/init.uip.
2.1 Warm Start
For regular use, simply log on to
kilauea and run the new UIP.
The communication link with the antenna should already be open, and you
should be able to move the antenna. If you are getting exceptions
like "TRANSIENT", try the following UIP command:
ANTENNA_LOAD /RESTART.
2.2 Cold Start
The new UIP requires various network services to be present on
kilauea in order to be able to communicate with the antenna,
spectrometers, and other telescope control subsystems. For technical
reasons, these services can not be started automatically at boot time
or manually by regular users. Instead, they must be started once
interactively by the superuser. If the main control workstation
kilauea has been rebooted for whatever reason, the services
have to be initialized and started by the following script:
/opt/uip/sbin/rcuip start. Then the communication link
between the new UIP and antenna has to be reset by the following UIP
command:
ANTENNA_LOAD /RESTART. If one of the facility
heterodyne receivers and spectrometers are in use, the following
command should be used instead:
ANTENNA_LOAD /RESTART /NOSYNCHRONIZE, and the communication
links with the spectrometers and IF processor should also be reset
using the following commands:
SPECTROMETER ... /RESTART and
LO ....
2.3 Restart
When the new UIP is having troubles communicating with the antenna or
one of other telescope control subsystems, and
ANTENNA_LOAD /RESTART,
SPECTROMETER ... /RESTART,
etc. do not fix the problem, the above mentioned script can be used
as a last resort to reinitialize and restart the network services
needed by the new UIP:
/opt/uip/sbin/rcuip restart. This has to be done by the
superuser. All instances of the new UIPs will be terminated. Once the
services are restarted, the communication links have to be reset by
following the instructions for cold start above.
3 Catalogs
Source and line catalogs are in plain text format. Existing entries
can be edited and new entries can be added directly using any text
editor. (
SOURCE and
LINE commands are no longer
available.)
Catalog filenames must be all in lower case letters. The default
filename extension is
.cat for source catalogs and
.line_cat for line catalogs. The location of system's default
catalogs is
kilauea:/opt/uip/cat, and the location of user's
private catalogs is
kilauea:~/.uip/cat. The
CATALOG
command looks for a catalog in the current directory, user's private
catalog directory, then system's default catalog directory, in that
order.
3.1 Source Catalogs
The format of source catalogs is a derivative of GILDAS ASTRO's.
The simplest form, suitable for continuum sources, is:
-
SOURCE_NAME COORDINATE_TYPE LONGITUDE LATITUDE
SOURCE_NAME is the name(s) of the source. Two or more names
are separated by "
|".
COORDINATE_TYPE is the type of
the coordinate system and it has to be either "
EQ" for
equatorial, "
GA" for Galactic II, "
DA" for apparent
equatorial, or "
HO" for horizontal coordinates. If the
coordinate system is equatorial, the keyword "
EQ" has to be
followed by the epoch of the coordinate system, or equinox, like
"
EQ 2000" for J2000.0 or "
EQ 1950" for B1950.0.
LONGITUDE is the longitude-like coordinate and it has to be
either in sexagesimal notation like "
hh:mm:ss.ss" or
"
hh:mm.mmmm" or simply in hours or degrees like
"
hh.hhhhhh".
LATITUDE" is the latitude-like
coordinate and it has to be in the same format as
LONGITUDE.
When the source has a proper-motion, the following form is used:
-
SOURCE_NAME COORDINATE_TYPE LONGITUDE,PM_LONGITUDE LATITUDE,PM_LATITUDE
PM_LONGITUDE and
PM_LATITUDE are the rate of change of
the coordinate value in the longitude-like and latitude-like axes,
respectively. For the equatorial coordinates,
PM_LONGITUDE is
in s yr
−1 and
PM_LATITUDE is in
′′ yr
−1.
The most commonly used form is:
-
SOURCE_NAME COORDINATE_TYPE LONGITUDE LATITUDE VELOCITY_TYPE VELOCITY
VELOCITY_TYPE is the type of the velocity and it has to be
either "
LS" for the LSR, "
HE" for the Solar-system
barycentric, "
EA" for the geocentric, or "
OB" for
the topocentric velocity.
VELOCITY is the velocity in
km s
−1.
As an example, a few entries from the system default source catalog
are shown below:
-
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 can 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.
3.2 Line Catalogs
The format of line catalogs is:
-
LINE_NAME FREQUENCY FREQUENCY_UNIT SIDEBAND
LINE_NAME is the name(s) of the line. Two or more names are
separated by "
|".
FREQUENCY is the frequency of the
line in GHz.
FREQUENCY_UNIT is the unit of the frequency and
it has to be "
GHz".
SIDEBAND is the sideband to put
the line in (all the CSO heterodyne receivers are double sideband) and
it has to be either "
USB" for upper sideband or
"
LSB" for lower sideband.
As an example, a few entries from the system default line catalog are
shown below:
-
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
4 Ephemerides
Ephemerides for Solar System objects are plain text files with entries
in the following format:
-
DATE RIGHT_ASCENSION DECLINATION RANGE RANGE_RATE
DATE is the universal time (UTC) in Julian day format.
RIGHT_ASCENSION is the geocentric apparent right ascension in
sexagesimal notation "
hh mm ss.ss" or alternatively
"
hh:mm:ss.ss".
DECLINATION is the geocentric apparent
declination in sexagesimal notation "
+dd mm ss.s" or
alternatively "
+dd:mm:ss.s".
RANGE is the geocentric
range in AU.
RANGE_RATE is the geocentric range rate in
km s
−1.
As an example, a few entries from the ephemeris file for Titan are
shown below:
-
2454832.500000000 11 33 04.8430 +05 08 56.079 9.00952445513056 -29.4049816
2454832.625000000 11 33 05.4242 +05 08 58.749 9.00739372774336 -29.6222299
2454832.750000000 11 33 05.9865 +05 09 01.449 9.00524749734546 -29.8343300
2454832.875000000 11 33 06.5286 +05 09 04.179 9.00308615465248 -30.0407553
2454833.000000000 11 33 07.0492 +05 09 06.937 9.00091012827573 -30.2409828
Ephemeris files in the above format can be generated using JPL's
HORIZONS system. The example shown above has been generated through
the HORIZONS web-interface using the following settings then removing
everything from
$$SOE and before and from
$$EOE and after:
|
| Observer Location | : | Geocentric [500] |
| Table Settings | : | QUANTITIES=2,20; date/time format=JD; |
| | extra precision=YES; object page=NO |
| Display/Output | : | plain text |
Alternatively, a utility program
kilauea:/opt/uip/bin/ephemeris_generator can be used to
generate ephemerides in the above format, or the
PLANET command
with the
/JPL_HORIZONS option can generate ephemerides
on-the-fly.
Ephemeris filenames must be all in lower case letters. The default
filename extension is
.dat. The location of system's default
ephemerides is
kilauea:/opt/uip/eph, and the location of user's
private ephemerides is
kilauea:~/.uip/eph. The
PLANET
command looks for an ephemeris in the current directory, user's
private ephemeris directory, then system's default ephemeris
directory, in that order.
5 Command Procedures (Macros)
Command procedures (macros), or observing scripts, are realized by
underlying GILDAS SIC's scripting capability. Command procedures are
executed using the
SIC\@ command. For details, please see the
SIC Manual.
Command procedure filenames must be all in lower case letters. The
default filename extensions are
.uip and
.pro. The
location of system procedures is
kilauea:/opt/uip/pro, and the
location of user's private procedures is
kilauea:~/.uip/pro.
The
SIC\@ command does
not automatically look for
procedures in the above mentioned directories, however. A full path
must be specified if a procedure is not in the current directory. The
search path of the
SIC\@ command can be changed by the
SIC\SIC MACRO command. For example, to let the
SIC\@
command search procedures in the current directory, user's private
directory, and system directory, in that order, add a following
command to
kilauea:~/.gag/init/init.uip:
-
sic\sic macro "./;~/.uip/pro/;$UIP_ROOT/pro/;"
6 User Defined Commands and Symbols (Aliases)
User defined commands and symbols (aliases) are capabilities provided
by underlying GILDAS SIC. The
SIC\DEFINE COMMAND command
allows to define a new command with optional help. The
SIC\SYMBOL command allows to define an alias, or shorthand, for
any text string.
One use case of user defined commands and symbols is as a shorthand
for command procedures. For example, the system defines a new command
fazo as "
sic\@ $UIP_ROOT/pro/fazo.uip", as shown
below:
-
sic\define command fazo "sic\@ $UIP_ROOT/pro/fazo.uip" $UIP_ROOT/pro/fazo.hlp
Thus the command procedure
fazo.uip, which is not in the
current directory, can be executed by simply typing
fazo. A
similar result can be obtained by defining a symbol
fazo as
"
sic\@ $UIP_ROOT/pro/fazo.uip", as shown below:
-
sic\symbol fazo "sic\@ $UIP_ROOT/pro/fazo.uip"
System commands and symbols are defined in
kilauea:$GAG_ROOT_DIR/pro/define.uip, and user's
private commands and symbols are defined in
kilauea:~/.gag/init/init.uip.
A References
B Revision History
- 1.0 (July 8, 2009) HY - Initial release.
- 1.1 (August 17, 2009) HY - Updated information about user accounts.
- 1.2 (August 31, 2009) HY - Actual inclusion of command help texts.
- 1.3 (October 5, 2009) HY - Detailed information about source
catalog format.
- 1.4 (July 12, 2010) HY - Instructions for (re)starting CORBA
and UIP services.
- 1.5 (October 12, 2010) HY - Instruction for starting the
weather logging services.
- 1.6 (June 17, 2011) HY - Added sections for ephemerides,
command procedures, symbols, and user defined commands.
- 1.7 (June 21, 2011) HY - File naming rules.
- 1.8 (June 30, 2011) HY - Favors user defined commands over
plain symbols.
C Command Help
This section was automatically generated from the latest help file.
C.1 Language
UIP\ Command Language Summary
C.2 _NEW_POSITION
[UIP\]_NEW_POSITION
C.3 _OFF_POSITION
[UIP\]_OFF_POSITION [/CLEAR [/ONLY_OFF]]
C.3.1 _OFF_POSITION /CLEAR
C.3.2 _OFF_POSITION /ONLY_OFF
C.4 _ON_POSITION
[UIP\]_ON_POSITION [/CLEAR [/ONLY_ON]]
C.4.1 _ON_POSITION /CLEAR
C.4.2 _ON_POSITION /ONLY_ON
C.5 _TAKE_DATA
[UIP\]_TAKE_DATA [/LEAVE]
C.5.1 _TAKE_DATA /LEAVE
C.6 ACQUIRE_LIMITS
[UIP\]ACQUIRE_LIMITS [ON_TOLERANCE [OFF_TOLERANCE]]
Allows you to set, independently, the acquisition limits for the ON and
OFF positions. The smaller these values are, the longer it will take
the antenna to decide it has acquired the source, and the slower your
data taking will be.
Typing this command with no parameters will result in the current values
being typed on the terminal.
C.6.1 ACQUIRE_LIMITS ON_TOLERANCE
The acquisition limit for ON scans, in arc seconds.
C.6.2 ACQUIRE_LIMITS OFF_TOLERANCE
The acquisition limit for OFF scans, in arc seconds.
C.7 ADJUST_ATTN
[UIP\]ADJUST_ATTN
Tells the backend to automatically set its attenuator at this time. It
only sets it once per invocation, no automatic updating is done. This
command currently only works if the AOS or FFTS is the backend.
C.8 ALTAZ
[UIP\]ALTAZ
Tells the antenna computer to switch to altazimuthal pointing mode. The
values given with the AZ and EL commands are used. The telescope will
not be idle, and it will continuously try to stay at the requested
position.
C.9 ANTENNA_LOAD
[UIP\]ANTENNA_LOAD /RESTART [/NOSYNCHRONIZE]
[UIP\]ANTENNA_LOAD /SHUTDOWN
[UIP\]ANTENNA_LOAD
Allows you to restart various server processes running on the antenna
computer as well as their client processes which are needed for proper
operation of the telescope.
C.9.1 ANTENNA_LOAD /RESTART
If /RESTART is specified, client processes on kilauea (antenna messenger
and event handler), and servers and other processes on the antenna com-
puter will be restarted in an appropriate order.
C.9.2 ANTENNA_LOAD /SHUTDOWN
If /SHUTDOWN is specified, client processes on kilauea (antenna messen-
ger and event handler), and servers and other processes on the antenna
computer will be stopped. This is useful, for example, when the sec-
ondary mirror needs to be homed.
C.9.3 ANTENNA_LOAD /NOSYNCHRONIZE
If /NOSYNCHRONIZE is specified, no messages will be sent to the backend
computer. This will prevent the ANTENNA_LOAD command from hanging when
the spectrometer related processes are not running on the backend com-
puter.
C.10 ANWAIT
[UIP\]ANWAIT
Causes the UIP to pause until the antenna computer has acquired the
source it is trying to track. It is primarily of use in synchronizing
command file (schedule) execution.
If this command is executed interactively, it can be aborted via ^C.
This is also true if the ANWAIT command appears in a DEFINEd macro, such
as IAZ or IZA. Note that canceling ANWAIT in this manner will also
force any other process to continue if it was waiting for the antenna to
acquire the requested position.
C.11 ATLST
[UIP\]ATLST TIME [/SLACK_TIME SLACK_TIME]
Halts execution until the specified local sidereal time. It is used to
control the execution of schedules.
C.11.1 ATLST TIME
The local sidereal time in the format HH:MM:SS.
C.11.2 ATLST /SLACK_TIME
If the specified LST is earlier than the current LST, but not by more
than SLACK_TIME seconds, execution continues without halting. For
instance if ATLST 12:00:00 is executed at 12:05:00 LST, and SLACK_TIME =
3600, then execution will continue. However if SLACK_TIME = 60 in the
example above, then execution would have halted until the next day.
C.12 ATUT
[UIP\]ATUT TIME [DATE]
Halts execution until the specified coordinated universal time. It is
used to control the execution of schedules.
C.12.1 ATUT TIME
The coordinated universal time in the format HH:MM:SS.
C.12.2 ATUT DATE
The date in the format YYYY‐MM‐DD.
C.13 DB
[UIP\]DB ATTENUATION [/ADD | /SUBTRACT] [/AOS5] [/FFTS1]
[UIP\]DB /MAXIMUM [/AOS5] [/FFTS1]
[UIP\]DB /SAVE [/AOS5] [/FFTS1]
[UIP\]DB /RESTORE [/AOS5] [/FFTS1]
[UIP\]DB [/AOS5] [/FFTS1]
Sets the programmable attenuator in the currently active backend to a
new value. This command currently only works with the AOS and FFTS
backend, and, with the AOS backend, only when manual attenuation is dis-
abled on the front panel.
C.13.1 DB ATTENUATION
The attenuation to insert in dB. Valid values are integers between 0
and 63 for the AOS5, or integers between 0 and 20 for the FFTS1.
C.13.2 DB /ADD
Causes the ATTENUATION to be added to the current attenuation.
C.13.3 DB /SUBTRACT
Causes the ATTENUATION to be subtracted the current attenuation.
C.13.4 DB /MAXIMUM
Causes the attenuator to be set to its maximum possible value.
C.13.5 DB /SAVE
Causes the current attenuator value to be saved so that it can temporar-
ily be changed and later be restored.
C.13.6 DB /RESTORE
Causes the attenuator to be restored to the previously saved value.
C.13.7 DB /AOS5
Causes the attenuator for the AOS5 to be set, regardless of which spec-
trometer is currently active.
C.13.8 DB /FFTS1
Causes the attenuator for the FFTS1 to be set, regardless of which spec-
trometer is currently active.
C.14 AZ
[UIP\]AZ [ANGLE]
Sends a new azimuth angle to the antenna computer. The command AZ auto-
matically selects altazimuthal coordinates.
C.14.1 AZ ANGLE
The new azimuth angle to be sent to the antenna computer.
C.15 AZO
[UIP\]AZO [OFFSET] [/FIXED FIXED_OFFSET] [/MAPPING MAPPING_OFFSET]
[/FIELD FIELD_OFFSET] [/TEXAS TEXAS_OFFSET] [/CHOPPING CHOPPING_OFFSET]
[UIP\]AZO [/FIXED | /MAPPING | /FIELD | /TEXAS | /CHOPPING]
[UIP\]AZO /LHS_BEAM | /RHS_BEAM
Sends a new azimuth offset to the antenna computer.
C.15.1 AZO OFFSET
The new azimuth offset in arc seconds.
C.15.2 AZO /FIXED
Modifies or prints the fixed offset.
C.15.3 AZO FIXED_OFFSET
The new fixed azimuth offset in arc seconds.
C.15.4 AZO /MAPPING
Modifies or prints the mapping offset.
C.15.5 AZO MAPPING_OFFSET
The new mapping azimuth offset in arc seconds.
C.15.6 AZO /FIELD
Modifies or prints the field offset.
C.15.7 AZO FIELD_OFFSET
The new field azimuth offset in arc seconds.
C.15.8 AZO /TEXAS
Modifies or prints the Texas offset. The Texas switching mode is acti-
vated (that moves the telescope ON and OFF source based on a digital
input signal to the antenna computer) if the offset is given.
C.15.9 AZO TEXAS_OFFSET
The new Texas azimuth offset in arc seconds.
C.15.10 AZO /CHOPPING
Modifies or prints the chopping offset. This offset is intended
primarily for use in bolometer mode. It is NOT recorded in spectral
line data files.
C.15.11 AZO CHOPPING_OFFSET
The new chopping azimuth offset (CAZO) in arc seconds.
C.15.12 AZO /LHS_BEAM
Modifies the chopping azimuth offset (CAZO) such that the LHS beam is
pointed toward the source. This is to be used in bolometer mode.
C.15.13 AZO /RHS_BEAM
Modifies the chopping azimuth offset (CAZO) such that the RHS beam is
pointed toward the source. This is to be used in bolometer mode.
C.16 BEWAIT
[UIP\]BEWAIT [/UNINTERRUPTIBLE]
Causes the UIP to pause until the backend computer has finished its cur-
rent integration. It is primarily of use in synchronizing command file
(schedule) execution.
If this command is executed interactively, it can be aborted via ^C.
This is also true if the BEWAIT command appears in a DEFINEd macro.
Note that canceling BEWAIT in this manner will also force any other
process to continue if it was waiting for an integration to complete.
C.16.1 BEWAIT /UNINTERRUPTIBLE
If this option is specified, BEWAIT cannot be interrupted by ^C.
C.17 BSWITCH
[UIP\]BSWITCH
C.17.1 BSWITCH /FOCUS_ADJUST
C.17.2 BSWITCH /LEVEL_ADJUST
C.18 BEEP
[UIP\]BEEP COUNT [MESSAGE]
[UIP\]BEEP /SCAN_BEEP | /NOSCAN_BEEP
[UIP\]BEEP
Causes the terminal to beep.
C.18.1 BEEP COUNT
The number of times the terminal should beep.
C.18.2 BEEP MESSAGE
The message to be typed out after the beep.
C.18.3 BEEP /SCAN_BEEP
Specifying /SCAN_BEEP will result in the control terminal beeping each
time a scan is completed.
C.18.4 BEEP /NOSCAN_BEEP
Specifying /NOSCAN_BEEP will turn off the automatic beep at the end of
each scan.
C.19 UCB_SCAN
[UIP\]UCB_SCAN [RAO1 [RAO2]] [/START | /SETUP]
[UIP\]UCB_SCAN /STOP
Enables switching of the telescope between two right ascension offset
positions and drift‐scanning according to a signal at the digital input
1 of the antenna computer. A high‐low‐high‐low sequence at the input
will result in a pair of drift‐scans starting from the two offset posi-
tions. The first high at the input 1 will cause the antenna to move to
the offset RAO1. The subsequent low at the input will start a drift
scan from this offset. The next high at the input will cause a move to
RAO2, then the low will start a drift scan from there.
C.19.1 UCB_SCAN RAO1
The first right ascension offset in arc seconds.
C.19.2 UCB_SCAN RAO2
The second right ascension offset in arc seconds.
C.19.3 UCB_SCAN /START
Enables the UCB control of drift‐scanning.
C.19.4 UCB_SCAN /STOP
Disables the UCB control of drift‐scanning.
C.19.5 UCB_SCAN /SETUP
Sets up the antenna for the UCB instrument.
C.20 BOX_SCAN
[UIP\]BOX_SCAN X_SIZE Y_SIZE SCAN_VELOCITY [SCAN_DIRECTION] [/ORDER
ORDER] [/TIME_OFFSET TIME_OFFSET] [/POSITION_ANGLE POSITION_ANGLE]
[/ALTAZIMUTHAL | /EQUATORIAL]
[UIP\]BOX_SCAN /STOP
[UIP\]BOX_SCAN
Implements a track‐and‐box‐scan observing mode for SHARC II. This co
mand generates a *billiard‐ball* trajectory using the following paramet-
ric equations:
ORDER
‐‐‐
dx(t) = 4 X_SIZE / pi ^ 2 > Ci sin Fi Wx (t + TIME_OFFSET)
‐‐‐
i = 1
ORDER
‐‐‐
dy(t) = 4 Y_SIZE / pi ^ 2 > Ci sin Fi Wy (t + TIME_OFFSET)
‐‐‐
i = 1
Wx = pi SCAN_VELOCITY / X_SIZE cos pi SCAN_DIRECTION / 180
Wy = pi SCAN_VELOCITY / Y_SIZE sin pi SCAN_DIRECTION / 180
Fi = 2 i ‐ 1
Ci = ‐1 ^ (i ‐ 1) / Fi ^ 2
C.20.1 BOX_SCAN X_SIZE
The size of the scan box along the X axis in arc seconds.
C.20.2 BOX_SCAN Y_SIZE
The size of the scan box along the Y axis in arc seconds.
C.20.3 BOX_SCAN SCAN_VELOCITY
The scan velocity in arc seconds per second.
C.20.4 BOX_SCAN SCAN_DIRECTION
The initial scan direction, in arc degrees, measured from +X through +Y.
The default is 45.
C.20.5 BOX_SCAN /ORDER
The number of terms in the sine series to use. The default is 3. The
valid range is [1, 16].
C.20.6 BOX_SCAN /TIME_OFFSET
The time offset in seconds. This may be useful to restart patterns with
a long period. The default is 0.
C.20.7 BOX_SCAN /POSITION_ANGLE
The orientation of the scan coordinates relative to the sky coordinates.
It is defined as an angle, in arc degrees, between the X axis of the
scan and +AZ, +RA, or +L, measured through +EL, +DEC, or +B. The
default is 0, i.e., the scan coordinates (+X, +Y) correspond to the sky
coordinates (+AZ, +EL), (+RA, +DEC), or (+L, +B). Note this definition
is not sky right.
C.20.8 BOX_SCAN /ALTAZIMUTHAL
The scan coordinates will be altazimuthal. This is the default.
C.20.9 BOX_SCAN /EQUATORIAL
The scan coordinates will be apparent equatorial.
C.20.10 BOX_SCAN /STOP
Will stop the scan.
C.21 VANE
[UIP\]VANE [/OUT | /IN | /SPIN | /STOP | /SKY0 | /LOAD90 | /SKY180 |
/LOAD270]
Allows you to move the temperature calibration vane in and out of the
beam.
C.21.1 VANE /OUT
Moves the temperature calibration vane out of the beam.
C.21.2 VANE /IN
Moves the temperature calibration vane in the beam.
C.21.3 VANE /SPIN
Spins the temperature calibration vane.
C.21.4 VANE /STOP
Stop spinning the temperature calibration vane.
C.21.5 VANE /SKY0
Positions the temperature calibration vane at 0 degree angle so that the
ambient load is out of the beam ‐ same as /OUT.
C.21.6 VANE /LOAD90
Positions the temperature calibration vane at 90 degree angle so that
the ambient load is in the beam ‐ same as /IN.
C.21.7 VANE /SKY180
Positions the temperature calibration vane at 180 degree angle so that
the ambient load is out of the beam.
C.21.8 VANE /LOAD270
Positions the temperature calibration vane at 270 degree angle so that
the ambient load is in the beam.
C.21.9 VANE /RESTART
C.22 CATALOG
[UIP\]CATALOG [NAME] [/CLOSE]
[UIP\]CATALOG /LINE [LINE_NAME] [/CLOSE]
Opens or closes a file for use as a source catalog or line catalog.
More than one catalogs may be open at once, and they are searched in the
order opposite the order in which they were opened. The source catalog
CAT_DIR:DEFAULT_CATALOG.CAT and line catalog CAT_DIR:DEFAULT_CATA-
LOG.LINE_CAT are always open, and are searched last. In addition, each
user automatically has private source and line catalogs. Their names
are
PRIVATE_CATALOG.CAT
PRIVATE_CATALOG.LINE_CAT
Entering CATALOG without any arguments results in the listing of all the
currently open catalogs.
If you do not specify the directory in which the catalog resides, the
program will search for the catalog by searching first the current
directory, then the home directory, and finally CAT_DIR:. If no file
extension is given, .CAT is assumed for the source catalog, and
.LINE_CAT is assumed for the line catalog.
C.22.1 CATALOG NAME
The name of the source catalog.
C.22.2 CATALOG /LINE
Specifies that a line catalog is to be opened, closed or listed.
C.22.3 CATALOG LINE_NAME
The name of the line catalog.
C.22.4 CATALOG /CLOSE
Closes the named or last catalog file opened.
C.23 CELES
[UIP\]CELES
Tells the antenna computer to switch to celestial pointing mode. The
most recently supplied RA and DEC positions will be used.
C.24 CHICAGO
[UIP\]CHICAGO [AZOFF1 [AZOFF2]]
[UIP\]CHICAGO /STOP
Enables switching of the telescope between two azimuth offset positions
according to pulses received at the digital inputs 1 and 2 of the
antenna computer. A positive pulse of at least 20 ms at the input 1
will cause the antenna to move to the offset AZOFF1, while a similar
pulse at the input 2 will cause a move to AZOFF2.
C.24.1 CHICAGO AZOFF1
The first azimuth offset position in arc seconds.
C.24.2 CHICAGO AZOFF2
The second azimuth offset position in arc seconds.
C.24.3 CHICAGO /STOP
Disables the Chicago control of position switching.
C.25 CHOP_SLEWY
[UIP\]CHOP_SLEWY [CYCLES] [/ASYMMETRIC [/LHS_BEAM | /RHS_BEAM]]
[/EFFICIENCY EFFICIENCY] [/NOFOCUS_ADJUST] [/NOLO_ADJUST] [/NOATTENUA-
TOR_ADJUST] [/CALIBRATE_AT_START | /NOCALIBRATE_AT_START]
[/PAUSE_AFTER_CAL [TIME] | /NOPAUSE_AFTER_CAL]
The data taking command for observing with the chopping secondary. It
commands the antenna and backend computers to take ON‐OFF data by
repeating one of three basic patterns ‐ by default, it performs a sym-
metric set of measurements with the pattern + ‐ ‐ +. Using the /ASYM-
METRIC option, you can get + + (/LHS_BEAM ‐ default) or ‐ ‐ (/RHS_BEAM
C.25.1 CHOP_SLEWY CYCLES
The number of times the basic pattern should be repeated. The default
is 1.
C.25.2 CHOP_SLEWY /ASYMMETRIC
Tells CHOP_SLEWY to take data using a + + or ‐ ‐ pattern on the sky. By
default, + + is used unless the /RHS_BEAM option is specified.
C.25.3 CHOP_SLEWY /LHS_BEAM
Tells CHOP_SLEWY that the basic asymmetric pattern will be + +, which is
the default.
C.25.4 CHOP_SLEWY /RHS_BEAM
Tells CHOP_SLEWY that the basic asymmetric pattern will be ‐ ‐ rather
than + +.
C.25.5 CHOP_SLEWY /EFFICIENCY
Overrides the chopping efficiency value used by the AOS5. For example,
specifying /EFFICIENCY 80 will force the AOS5 to integrate 80 % of the
time in each chop phase, regardless of a true chopping efficiency
reported by the chopper controller.
C.25.6 CHOP_SLEWY /NOFOCUS_ADJUST
Tells CHOP_SLEWY not to adjust the focus at the beginning of each cycle.
C.25.7 CHOP_SLEWY /NOLO_ADJUST
Tells CHOP_SLEWY not to adjust the phase lock frequency at the beginning
of each cycle, to allow for Doppler tracking.
C.25.8 CHOP_SLEWY /NOATTENUATOR_ADJUST
Tells CHOP_SLEWY not to adjust the programmable attenuator at the begin-
ning of a scan.
C.25.9 CHOP_SLEWY /CALIBRATE_AT_START
Tells CHOP_SLEWY to take a temperature calibration scan before taking
any source data. The default action is to calibrate at the start only
if no valid temperature calibration scan is already available.
C.25.10 CHOP_SLEWY /NOCALIBRATE_AT_START
Tells CHOP_SLEWY not to take a temperature calibration scan even if no
valid calibration scan is available.
C.25.11 CHOP_SLEWY /PAUSE_AFTER_CAL
Allows the observer to specify a number of seconds to wait after the
temperature calibration scan, before taking the source’s data. This is
desirable if the thermal load of the calibration vane seems to affect
the receiver’s performance for some period after taking a temperature
calibration scan. For example, /PAUSE_AFTER_CAL 5 will result in a 5
second pause between temperature calibration and data taking. This
option is selected by default, and the default time is 20 seconds.
C.25.12 CHOP_SLEWY /NOPAUSE_AFTER_CAL
Tells CHOP_SLEWY not to pause after the temperature calibration scan.
C.26 DATA_FILE
[UIP\]DATA_FILE NAME [SCAN_NUMBER [OBSERVATION_NUMBER]] [/NOARCHIVE]
Opens a data file into which the scans will be written. If a file with
the specified name exists, it is reopened otherwise a new file is cre-
ated.
C.26.1 DATA_FILE NAME
The name of the new file.
C.26.2 DATA_FILE SCAN_NUMBER
The first scan number in the file.
C.26.3 DATA_FILE OBSERVATION_NUMBER
The first observation number in the file.
C.26.4 DATA_FILE /NOARCHIVE
This option causes the data not to be written to the observatory’s
SYBASE database. Observers should not specify this option ‐ it is
intended to be used only when engineering scans are being taken.
C.27 DECO
[UIP\]DECO [OFFSET] [/MAPPING MAPPING_OFFSET] [/FIELD FIELD_OFFSET]
[/TEXAS TEXAS_OFFSET]
[UIP\]DECO [/MAPPING | /FIELD | /TEXAS]
Sends a new declination offset to the antenna computer.
C.27.1 DECO OFFSET
The new declination offset in arc seconds.
C.27.2 DECO /MAPPING
Modifies or prints the mapping offset.
C.27.3 DECO MAPPING_OFFSET
The new mapping declination offset in arc seconds.
C.27.4 DECO /FIELD
Modifies or prints the field offset.
C.27.5 DECO FIELD_OFFSET
The new field declination offset in arc seconds.
C.27.6 DECO /TEXAS
Modifies or prints the Texas offset. The Texas switching mode is acti-
vated (that moves the telescope ON and OFF source based on a digital
input signal to the antenna computer) if the offset is given.
C.27.7 DECO TEXAS_OFFSET
The new Texas declination offset in arc seconds.
C.28 DRIFT_SCAN
[UIP\]DRIFT_SCAN SCAN_LENGTH [NUMBER_OF_SCANS] [/STEP_SIZE
STEP_SIZE] [/OFFSET X_OFFSET [Y_OFFSET]] [/SETTLING_TIME SETTLING_TIME]
[/NOFOCUS_ADJUST] [/NOROTATOR_ADJUST]
[UIP\]DRIFT_SCAN /CANCEL
[UIP\]DRIFT_SCAN
Implements a drift scan observing mode for bolometers.
C.28.1 DRIFT_SCAN SCAN_LENGTH
The scan length in arc seconds.
C.28.2 DRIFT_SCAN NUMBER_OF_SCANS
The number of scans to be performed. The default is 1.
C.28.3 DRIFT_SCAN /STEP_SIZE
The latitudinal separation, in arc seconds, between two adjacent scans.
The default is 0, i.e., all scans will be repeated at the same latitude.
C.28.4 DRIFT_SCAN /OFFSET
The initial scan offsets in arc seconds.
C.28.5 DRIFT_SCAN X_OFFSET
The initial longitudinal offset in arc seconds. The default is ‐
SCAN_LENGTH / 2.
C.28.6 DRIFT_SCAN Y_OFFSET
The initial latitudinal offset in arc seconds. The default is ‐
STEP_SIZE (NUMBER_OF_SCANS ‐ 1) / 2.
C.28.7 DRIFT_SCAN /SETTLING_TIME
The settling time in seconds. The default is 10.
C.28.8 DRIFT_SCAN /NOFOCUS_ADJUST
Will not adjust the secondary mirror focus position. By default, the
secondary mirror focus is adjusted at the beginning of each scan.
C.28.9 DRIFT_SCAN /NOROTATOR_ADJUST
Will not adjust the instrument rotator position. By default, the
instrument rotator is adjusted at the beginning of each scan.
C.28.10 DRIFT_SCAN /CANCEL
Will cancel the scan.
C.29 EL
[UIP\]EL [ANGLE]
Sends a new elevation angle to the antenna computer. The command EL
automatically selects altazimuthal coordinates.
C.29.1 EL ANGLE
The new elevation angle to be sent to the antenna computer.
C.30 ELO
[UIP\]ELO [OFFSET] [/FIXED FIXED_OFFSET] [/MAPPING MAPPING_OFFSET]
[/FIELD FIELD_OFFSET]
[UIP\]ELO [/FIXED | /MAPPING | /FIELD]
Sends a new elevation offset to the antenna computer.
C.30.1 ELO OFFSET
The new elevation offset in arc seconds.
C.30.2 ELO /FIXED
Modifies or prints the fixed offset.
C.30.3 ELO FIXED_OFFSET
The new fixed elevation offset in arc seconds.
C.30.4 ELO /MAPPING
Modifies or prints the mapping offset.
C.30.5 ELO MAPPING_OFFSET
The new mapping elevation offset in arc seconds.
C.30.6 ELO /FIELD
Modifies or prints the field offset.
C.30.7 ELO FIELD_OFFSET
The new field elevation offset in arc seconds.
C.31 EQU
[UIP\]EQU RIGHT_ASCENSION DECLINATION [EQUINOX
[PROPER_MOTION_IN_RIGHT_ASCENSION [PROPER_MOTION_IN_DECLINATION
[ANNUAL_PARALLAX [RADIAL_VELOCITY [EPOCH]]]]]]
Sends new equatorial coordinates to the antenna computer.
C.31.1 EQU RIGHT_ASCENSION
The new right ascension in hours, or in the format HH:MM:SS.
C.31.2 EQU DECLINATION
The new declination in degrees, or in the format +DD:MM:SS.
C.31.3 EQU EQUINOX
The epoch of the coordinate system in Julian or Besselian year.
C.31.4 EQU PROPER_MOTION_IN_RIGHT_ASCENSION
The proper motion in right ascension in seconds per year.
C.31.5 EQU PROPER_MOTION_IN_DECLINATION
The proper motion in declination in arc seconds per year.
C.31.6 EQU ANNUAL_PARALLAX
The annual parallax in arc seconds.
C.31.7 EQU RADIAL_VELOCITY
The radial velocity with respect to the Solar system barycenter in kilo-
meters per second.
C.31.8 EQU EPOCH
The epoch of the position in Julian or Besselian year.
C.32 FAST_TRACK
[UIP\]FAST_TRACK [FACTOR [LENGTH]]
Allows you to examine and modify the variables used in the FAST_TRACK
scan mode. In the FAST_TRACK scan mode, the antenna is told to track at
some multiple of the sidereal rate. Data are then taken as if a drift
scan had been requested. This allows scanning a source in constant dec-
lination strips at a faster rate than would be possible with drift
scans. Scans are initiated with the command TAKE_DATA /FAST_TRACK.
Typing this command with no parameters will result in the current param-
eter values being typed on the terminal.
C.32.1 FAST_TRACK FACTOR
This multiple of the sidereal rate will be added to the LST. A speed‐up
factor of 0 results in the normal tracking rate. If you want to scan
over the source at 5 times the sidereal rate, you can use a speed‐up
factor of 5 (for an east to west scan) or ‐5 (for a west to east scan).
A speed‐up factor of ‐1 will freeze the antenna’s position, and all
the sky to drift by.
C.32.2 FAST_TRACK LENGTH
The length of the scan, in arc seconds. Once the antenna has moved by
this amount from the position at which the scan started, the antenna
will revert to the normal sidereal rate, and re‐acquire the initial
position.
C.33 FIVE_POINT
[UIP\]FIVE_POINT OFFSET [HALF_WIDTH [/CENTER CENTER]] [/AOS5 |
/FFTS1 | /FFTS2] [/ONE_OFF | /ASYMMETRIC] [/SAVE_SCANS] [/NOQUERY]
[/APPLY] [/NOGAUSS]
Allows you check the pointing on a strong line or continuum source. It
will command the antenna to the source’s nominal position, and to four
surrounding positions in the AZ and EL directions. Data will be taken
at each position, and the line will be integrated. Finally, the inte-
grated line strengths will be displayed, along with new suggested point-
ing offsets.
You must supply an offset step size and a line half‐width over which to
integrate. The width must be given in channels. Here is an example:
FIVE_POINT 30 25 ! Step around by 30 arcsecond steps
The individual integrations are performed by the OO_SCAN command. In
chopping mode, FIVE_POINT uses CHOP_SLEWY. In heterodyne chopping mode,
FIVE_POINT will measure the throw also.
A linear baseline can be removed in the backend computer prior to calcu-
lating the line integral. The SPECTROMETER command allows you to set
the windows for this baseline. FIVE_POINT requires pretty good base-
lines to give good results.
The corrections are calculated in one of two ways. In most cases, fit-
ting a three parameter Gaussian is appropriate (one for AZ and one for
EL). In this case, for EL
‐ offset { ln(Ip) ‐ ln(Im) }
delta EL = ‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
2 { ln(Ip) ‐ 2 ln(Ic) + ln(Im) }
where Ip, Im, and Ic are the measurements from positive, negative, and
zero offset points respectively. If /NOGAUSS is selected, then a more
conservative, centroiding calculation is used to calculate the offsets.
The formula in this case is
offset ( Ip ‐ Im )
delta EL = ‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
Ip + Ic + Im
This approach is useful if for some reason the receiver is giving fluxes
with both positive and negative values, because a Gaussian is never neg-
ative.
Gaussian fitting is the default. With either type of fitting, the rou-
tine will refuse to suggest any pointing corrections unless the center
position is the strongest.
The results of five points will be logged in a file together with the
pointing constants, T terms, refraction and weather parameters in use.
C.33.1 FIVE_POINT OFFSET
The size of the steps to be taken, in arc seconds.
C.33.2 FIVE_POINT HALF_WIDTH
The number of channels, on either side of the center channel, over which
integration should be performed. If this argument is not specified,
then integration will take place over all the channels between the high
limit of the low baseline window and the low limit of the high baseline
window. For instance if you specified the baseline windows by issuing
the command
SPECTROMETER /BASELINE 400 500 520 620
and you did not pass a second argument to FIVE_POINT, then channels 501
through 519 will be summed to produce the line integral.
If no baseline window has been given, then a warning will be printed,
and all channels will be summed to form the integral.
C.33.3 FIVE_POINT /CENTER
Allows you to tell the backend computer to center the integration over a
specific channel.
By default, the integration is centered on the center channel found when
the last frequency calibration scan (FCAL) was processed. If no infor-
mation is available from an FCAL, a warning message will be issued, and
the default center channel defined for each spectrometer will be used.
C.33.4 FIVE_POINT /RANGE
Allows you to specify the range of channels over which integration
should be performed.
FIVE_POINT 15 /RANGE 501 519
is equivalent to
FIVE_POINT 15 9 /CENTER 510
C.33.5 FIVE_POINT /AOS5
Specifies that the 4 GHz array AOS is to be used for pointing (only one
spectrometer can be used at a time). By default, one is selected from
the active spectrometers using the following order of precedence: AOS5,
FFTS1, then FFTS2.
C.33.6 FIVE_POINT /FFTS1
Specifies that the 1 GHz FFTS is to be used for pointing (only one spec-
trometer can be used at a time). By default, one is selected from the
active spectrometers using the following order of precedence: AOS5,
FFTS1, then FFTS2.
C.33.7 FIVE_POINT /FFTS2
Specifies that the 8 GHz FFTS is to be used for pointing (only one spec-
trometer can be used at a time). By default, one is selected from the
active spectrometers using the following order of precedence: AOS5,
FFTS1, then FFTS2.
C.33.8 FIVE_POINT /ONE_OFF
If /ONE_OFF is specified, then only one OFF position data will be taken
at the beginning of FIVE_POINT. All five ON points will share this same
OFF position data. This procedure will save something like a factor of
2 in time, at the expense of poorer baselines.
C.33.9 FIVE_POINT /ASYMMETRIC
If /ASYMMETRIC is specified in heterodyne chopping mode, FIVE_POINT uses
asymmetric chopping to measure the chopper throw as well as to determine
pointing corrections.
C.33.10 FIVE_POINT /SAVE_SCANS
Causes all five scans taken to be stored in the current data file.
/SAVE_SCANS CENTER tells FIVE_POINT to just save the central position
scan, the other four will be discarded.
C.33.11 FIVE_POINT /NOQUERY
If /NOQUERY is specified, you will not be asked if you want the calcu-
lated FAZO and FZAO to be sent to the antenna computer.
C.33.12 FIVE_POINT /APPLY
Causes the newly calculated FAZO and FZAO to be sent to the antenna com-
puter.
C.33.13 FIVE_POINT /NOGAUSS
Causes centroiding calculation to be used instead of Gaussian fitting to
find pointing offsets.
C.34 FLSIGNAL
[UIP\]FLSIGNAL VALUE [/MASK MASK]
[UIP\]FLSIGNAL 0 | 1 /BIT BIT
Changes the state of the digital outputs of the antenna computer. There
are 8 digital outputs, numbered from 1 through 8. They can be addressed
by an 8‐bit value and an 8‐bit mask, or by a bit number and a bit value.
Bits are numbered from 0 (LSB) through 7 (MSB). The bit 0 corresponds
to the digital output 1.
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
|MSB Value/Mask Bit LSB|
| 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
| Digital Output |
| 8 | 7 | 6 | 5 | 4 | 3 | 2 | 1 |
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
Setting a bit will cause the corresponding digital output to become
high. Clearing a bit will cause the output to become low.
C.34.1 FLSIGNAL VALUE
The new value to be sent to the digitial outputs. Valid values are
integers between 0 and 255.
C.34.2 FLSIGNAL /MASK
The mask to be applied to the VALUE argument. Valid values are integers
between 0 and 255. For example, FLSIGNAL 128 /MASK 192 will set the
digital output 7 (bit 6) to low and the digital output 8 (bit 7) to
high.
C.34.3 FLSIGNAL /BIT
The bit number to be set or cleared. Valid values are integers between
0 and 7. The specified bit will be cleared if the VALUE argument is 0,
otherwise the bit will be set.
C.35 FLWAIT
[UIP\]FLWAIT VALUE [/MASK MASK]
[UIP\]FLWAIT 0 | 1 /BIT BIT
Waits until the state of the digital inputs and outputs of the antenna
computer matches the specified pattern. There are 8 digital inputs,
numbered from 1 through 8, and 8 digital outputs, also numbered from 1
through 8. They can be addressed by a 16‐bit value and a 16‐bit mask,
or by a bit number and a bit value. Bits are numbered from 0 (LSB)
through 15 (MSB). The bits 0 though 7 correspond to the digital outputs
1 though 8, and the bits 8 thgouth 15 correspond to the digital inputs 1
though 8, respectively.
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
|MSB Value/Mask Bit LSB|
| 15| 14| 13| 12| 11| 10| 9 | 8 | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
| Digital Input | Digital Output |
| 8 | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 8 | 7 | 6 | 5 | 4 | 3 | 2 | 1 |
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
A high at a digital input or output will cause the corresponding bit to
be set. A low at an input or output will cause the bit to be cleared.
C.35.1 FLWAIT VALUE
The value at the digitial inputs and outputs to wait for. Valid values
are integers between 0 and 65535.
C.35.2 FLWAIT /MASK
The mask to be applied to the VALUE argument. Valid values are integers
between 0 and 65535. For example, FLWAIT 384 /MASK 448 will cause the
execution to pause until the digital input 1 becomes high while the dig-
ital outputs 7 and 8 are (programmed to be) high and low, respectively.
C.35.3 FLWAIT /BIT
C.36 FOCUS
[UIP\]FOCUS [POSITION | /CONSTANT_UPDATES | /STEALTHY_UPDATES]
[/OFFSET OFFSET] [/SET_OFFSET] [/POINTING_UPDATE]
Allows the user to control the focusing of the secondary mirror. One
can set the mirror at a fixed point, or enable auto‐focusing via a focus
curve. If auto‐focusing is chosen, an offset may be applied, and the
timing of the focus changes may be controlled.
If FOCUS is entered without any arguments or options, and if the antenna
is in STEALTHY mode, the antenna will be instructed to adjust the focus
and Y tilt based on its pointing curve. Note that this is done automat-
ically at the beginning of an OO_SCAN, OBSERVE or PLANET command.
C.36.1 FOCUS POSITION
If this optional argument is specified, it will be sent to the antenna
computer and used as a fixed focus position. The antenna computer will
not update the position.
C.36.2 FOCUS /CONSTANT_UPDATES
Tells the antenna computer to update the position of the secondary when-
ever the position should be changed. In this mode, the secondary might
be moved when an integration is taking place.
C.36.3 FOCUS /STEALTHY_UPDATES
Tells the antenna computer to update the position of the secondary only
when data is not being taken, so that during a given integration the
focus will remain fixed.
C.36.4 FOCUS /OFFSET
Allows you to specify a fixed offset which will be added to the value
from the focus curve when the antenna computer updates the secondary
position.
C.36.5 FOCUS /SET_OFFSET
This option, which should be used alone, is used to calculate the offset
which should be applied to the focus curve. First one should find the
best focus position, using the FOCUS command to send the secondary to
specific positions. Then when the focus is good, invoke FOCUS with this
qualifier, and the offset will be calculated. Then invoke FOCUS with
either the /STEALTHY_UPDATES or the /CONSTANT_UPDATES option to tell the
antenna to use the focus curve.
C.36.6 FOCUS /POINTING_UPDATE
Tells the computer to adjust the TAZO and TZAO to where they should be
at the present elevation angle. Note that when the antenna is in /CON-
STANT_UPDATES or /STEALTHY_UPDATES mode, these constants will be updated
automatically every time the focus position is changed.
C.37 FCAL
[UIP\]FCAL [/NOATTENUATOR_ADJUST]
Takes a frequency calibration scan.
C.37.1 FCAL /NOATTENUATOR_ADJUST
Without this option, the programmable attenuator will be adjusted after
a frequency calibration.
C.38 FSWITCH
[UIP\]FSWITCH SEPARATION [CYCLES] [/NOFOCUS_ADJUST] [/NOATTENUA-
TOR_ADJUST] [/CALIBRATE_AT_START | /NOCALIBRATE_AT_START]
[/PAUSE_AFTER_CAL [TIME] | /NOPAUSE_AFTER_CAL]
The data taking command for observing with the frequency switching mode.
The actual frequency change takes place at the first LO.
C.38.1 FSWITCH SEPARATION
The size of the frequency step in MHz. The two line images will be sep-
arated by twice the amount, symmetrically offset from 0.
C.38.2 FSWITCH CYCLES
The number of times the frequency switch cycle should be repeated. The
default is 1.
C.38.3 FSWITCH /NOFOCUS_ADJUST
Tells FSWITCH not to adjust the focus.
C.38.4 FSWITCH /NOATTENUATOR_ADJUST
Tells FSWITCH not to adjust the programmable attenuator.
C.38.5 FSWITCH /CALIBRATE_AT_START
Tells FSWITCH to take a temperature calibration scan before taking any
source data. The default action is to calibrate at the start only if no
valid temperature calibration scan is already available.
C.38.6 FSWITCH /NOCALIBRATE_AT_START
Tells FSWITCH not to take a temperature calibration scan even if no
valid calibration scan is available.
C.38.7 FSWITCH /PAUSE_AFTER_CAL
Allows the observer to specify a number of seconds to wait after the
temperature calibration scan, before taking the source’s data. This is
desirable if the thermal load of the calibration vane seems to affect
the receiver’s performance for some period after taking a temperature
calibration scan. For example, /PAUSE_AFTER_CAL 5 will result in a 5
second pause between temperature calibration and data taking. This
option is selected by default, and the default time is 20 seconds.
C.38.8 FSWITCH /NOPAUSE_AFTER_CAL
Tells FSWITCH not to pause after the temperature calibration scan.
C.39 GAL
[UIP\]GAL LONGITUDE LATITUDE
Sends new Galactic coordinates to the antenna computer.
C.39.1 GAL LONGITUDE
The new Galactic longitude in degrees.
C.39.2 GAL LATITUDE
The new Galactic latitude in degrees.
C.40 GBO
[UIP\]GBO [OFFSET] [/MAPPING MAPPING_OFFSET] [/FIELD FIELD_OFFSET]
[UIP\]GBO [/MAPPING | /FIELD]
Sends a new Galactic latitude offset to the antenna computer.
C.40.1 GBO OFFSET
The new Galactic latitude offset in arc seconds.
C.40.2 GBO /MAPPING
Modifies or prints the mapping offset.
C.40.3 GBO MAPPING_OFFSET
The new mapping Galactic latitude offset in arc seconds.
C.40.4 GBO /FIELD
Modifies or prints the field offset.
C.40.5 GBO FIELD_OFFSET
The new field Galactic latitude offset in arc seconds.
C.41 GLO
[UIP\]GLO [OFFSET] [/MAPPING MAPPING_OFFSET] [/FIELD FIELD_OFFSET]
[UIP\]GLO [/MAPPING | /FIELD]
Sends a new Galactic longitude offset to the antenna computer.
C.41.1 GLO OFFSET
The new Galactic longitude offset in arc seconds.
C.41.2 GLO /MAPPING
Modifies or prints the mapping offset.
C.41.3 GLO MAPPING_OFFSET
The new mapping Galactic longitude offset in arc seconds.
C.41.4 GLO /FIELD
Modifies or prints the field offset.
C.41.5 GLO FIELD_OFFSET
The new field Galactic longitude offset in arc seconds.
C.42 IDLE
[UIP\]IDLE
Stops the drive motors and applies the brakes. This is the state when
the computer is first turned on. The status display shows ’IDLE’. To
observe a source, you must type TRACK. Note that the IDLE stops the
servo loop entirely, and applies the brakes when the telescope comes to
rest. The telescope will not necessarily come to rest at the point it
was tracking. To stop the telescope at the current position, e.g., to
do a drift scan, switch from celestial coordinates to altazimuthal coor-
dinates by typing ALTAZ.
C.43 INSTRUMENT
[UIP\]INSTRUMENT [NAME] [/BACKEND BACKEND[,...]]
Selects a new instrument.
C.43.1 INSTRUMENT NAME
The name of the new instrument. Currently the following instruments are
supported: RX230, RX345, RX460, RX690, RX805, RX230X, RX345X, SHARC2,
BOLOCAM, ZSPEC, FTS, BOLOMETER, ZEUS, and MUSIC.
C.43.2 INSTRUMENT /BACKEND
The name of the new backend(s) to be used with the new instrument.
C.44 JOY_STICK
[UIP\]JOY_STICK STEP_SIZE [/ALTAZIMUTHAL [/FIXED_OFFSET] | /EQUATO-
RIAL | /GALACTIC]
Is intended to aid in the manual tweaking of the telescope offsets. It
allows you to change the offsets by using the arrow keys on the termi-
nal, rather than explicitly typing in the offsets. The following keys
have special functions when you are executing this command:
E Exits this command
H Prints this help message
L Logs the current values in file
O Allows a new source to be selected
R Resets the offsets to their original values
S Changes the step size
V Verifies the position of a source
Z Zeros the offsets in play
<Arrow keys> Changes the offsets
C.44.1 JOY_STICK STEP_SIZE
Specifies, in arc seconds, how large a step is to be taken each time an
arrow key is hit.
C.44.2 JOY_STICK /ALTAZIMUTHAL
Causes the arrow keys to effect the AZ and EL offsets. This is the
default.
C.44.3 JOY_STICK /EQUATORIAL
Causes the arrow keys to effect the RA and DEC offsets, rather than the
AZ and EL offsets which are changed by default.
C.44.4 JOY_STICK /GALACTIC
Causes the arrow keys to effect the GL and GB offsets, rather than the
AZ and EL offsets which are changed by default.
C.44.5 JOY_STICK /FIXED_OFFSET
Causes the arrow keys to effect the fixed altazimuthal offsets.
C.45 LIMB_POINTING
[UIP\]LIMB_POINTING SEMIMAJOR_AXIS [SEMIMINOR_AXIS [SCAN_LENGTH
[STEP_SIZE]]] [/INTEGRATION_TIME INTEGRATION_TIME] [/OFFSET OFFSET]
[/AOS5 | /FFTS1 | /FFTS2] [/RANGE MIN MAX] [/POSITION_ANGLE
POSITION_ANGLE] [/ONE_OFF]
Allows you to check the telescope pointing using the limb of a large,
disk‐like object. Four scans across the limb at 9, 3, 12, and 6 o’clock
positions are taken to determine the distances to the limb from the cur-
rent nominal pointing center. The actual scans are taken by stepping
the telescope beam by the specified amount and integrating at each posi-
tion. The limb is determined by finding in each scan the position where
the gradient of the integrated intensity peaks. In practice, the dif-
ference between two consecutive positions is used to estimate the gradi-
ent at midpoint. Three such neighboring gradient values are then inter-
polated to determine the peak position.
C.45.1 LIMB_POINTING SEMIMAJOR_AXIS
The semi‐major axis, or the equatorial semi‐diameter, of the pointing
object in arc seconds.
C.45.2 LIMB_POINTING SEMIMINOR_AXIS
The semi‐minor axis, or the polar semi‐diameter, of the pointing object
in arc seconds. The default is equal to the semi‐major axis.
C.45.3 LIMB_POINTING SCAN_LENGTH
The length of the scans across the limb in arc seconds. The default is
four times the telescope beam size.
C.45.4 LIMB_POINTING STEP_SIZE
The size of the steps in arc seconds. The default is half the telescope
beam size.
C.45.5 LIMB_POINTING /INTEGRATION_TIME
The integration time per step in seconds. The default is equal to the
integration time for the OFF integrations, which is set by the SPECTROM-
ETER command.
C.45.6 LIMB_POINTING /OFFSET
The azimuth offset for the OFF integrations. The default is ten times
the telescope beam size away from the limb.
C.45.7 LIMB_POINTING /AOS5
Specifies that the AOS5 is to be used when more than one spectrometers
are active.
C.45.8 LIMB_POINTING /FFTS1
Specifies that the FFTS1 is to be used when more than one spectrometers
are active.
C.45.9 LIMB_POINTING /FFTS2
Specifies that the FFTS2 is to be used when more than one spectrometers
are active.
C.45.10 LIMB_POINTING /RANGE
The range of the spectrometer channels to integrate. This option
requires two values ‐ for example /RANGE 1 1024. The default is [1,
8192] or [4097, 6144] for the AOS5, depending on the receiver it is
working with, [1, 8192] or [1, 16384] for the FFTS1, depending on the
spectrometer configuration, and [1, 32768] for the FFTS2.
C.45.11 LIMB_POINTING /POSITION_ANGLE
The position angle of the scans in degrees. It is measured anticlock-
wise from the north. The default is zero ‐ no rotation.
C.45.12 LIMB_POINTING /ONE_OFF
Specifies that only one OFF integration is to be taken, which is then
shared by the four ON scans.
C.46 LO
[UIP\]LO [NAME] [/FREQUENCY FREQUENCY] [/RECEIVER RECEIVER[,IF_CHAN-
NEL[,LO_CHANNEL]]] [/SIDEBAND SIDEBAND] [/MULTIPLIER MULTIPLIER] [/IF
IF] [/F_OFFSET F_OFFSET] [/V_OFFSET V_OFFSET] [/LOCK_LOOP
LOCK_LOOP[,MODULE]] [/LOOP_NUMBER LOOP_NUMBER] [/RADIAL_VELOCITY
RADIAL_VELOCITY | /NORADIAL_VELOCITY] [/FORCE_RECEIVER_CHANGE [NOMIR-
RORS]] [/ANTENNA_ONLY] [/RESTART]
[UIP\]LO /GUNN_ON | /NOGUNN_ON
[UIP\]LO /LOG
Sends information to the antenna computer that is needed to calculate
the phase lock loop frequency. It can be used to center the bandpass on
a line from the line catalog, or with an arbitrary frequency. Default
values for such things as sideband may be overridden with options. If
LO is executed with no arguments or options, the antenna computer is
instructed to recalculate the phase lock frequency.
This command is executed automatically when the OBSERVE command is
given. Whenever the LO characteristics are changed, the new values are
logged in the log file.
C.46.1 LO NAME
The name of the spectral line you wish the bandpass to be centered on.
It must be a line in the catalog.
C.46.2 LO /FREQUENCY
This option may be used with or without the NAME argument, to load in a
specific frequency. It takes a value, which is the desired frequency in
GHz.
C.46.3 LO /RECEIVER
The name of the receiver you will be using (RX230, RX345, RX460, and
RX690 for the SideCab receivers, RX805 for the 850 GHz receiver, RX230X
for Frank Rice’s receiver, and RX345X for Barney). If not specified,
the computer will select the default receiver for the observing fre-
quency and IF. For the 1‐2 GHz IF receivers, the IF and LO channel num-
bers can be overridden by specifying them immediately after the receiver
name, separated by commas, for example ’LO /RECEIVER RX805,1,1’.
C.46.4 LO /SIDEBAND
Specifies a sideband. This will override any default value found in the
line catalog. The valid values are ’LOWER’, ’UPPER’, and ’DOUBLE
C.46.5 LO /MULTIPLIER
This option takes an argument which is an integer specifying what har-
monic of the Gunn oscillator output is to be used as the first LO.
C.46.6 LO /IF
Allows you to specify a different intermediate frequency (IF). The unit
is GHz.
C.46.7 LO /F_OFFSET
Allows a frequency offset to be sent to the antenna computer. It is
specified in GHz.
C.46.8 LO /V_OFFSET
Allows a velocity offset to be sent to the antenna computer. It is
specified in km/s.
C.46.9 LO /LOCK_LOOP
This option, which is sticky, allows you to specify which method you are
using to phase lock the LO system. The valid values are ’DEFAULT_PLL’
(Sidecab), ’SMA_PLL’ (Cassegrain), and ’NONE’ (synthesized LO).
When more than one SMA phase lock modules are present, the argument
’SMA_PLL’ can immediately be followed by the module number separated by
comma, for example ’LO /LOCK_LOOP SMA_PLL,2’. The default module number
is 1. The modules currently in use are tabulated in
kilauea:/opt/uip/etc/sma_plls.txt.
C.46.10 LO /LOOP_NUMBER
Allows you to specify the harmonic number for the Gunn PLL. The Gunn
oscillator is locked to a certain harmonic (+ LO) of the reference sig-
nal generated by the synthesizer. By default the antenna computer
chooses a harmonic number so that the synthesizer frequency is close to
7.5 GHz for the SMA PLL or 6 GHz for the default PLL. Unless explicitly
specified using this option, it will automatically be updated whenever a
new line name, line frequency, intermediate frequency, sideband, multi-
plier harmonic number, frequency offset, or velocity offset is sent by
the LO command.
C.46.11 LO /RADIAL_VELOCITY
Allows you to specify a radial velocity that you have calculated your-
self. It disables the radial velocity calculation that the antenna com-
puter normally performs, and substitutes for it the value you specify
with this option. Automatic radial velocity calculation will be sus-
pended until you issue an LO command with the /NORADIAL_VELOCITY option.
The unit is km/s, and a negative value indicates approach. The OBSERVE
and PLANET commands implicitly execute the LO /NORADIAL_VELOCITY command
unless the /NOLO option is used.
C.46.12 LO /NORADIAL_VELOCITY
Resumes automatic radial velocity calculation.
C.46.13 LO /FORCE_RECEIVER_CHANGE
By default, the computer will not attempt to reprogram the LO Matrix Box
if it does not think it needs to. This option allows you to force the
computer to reprogram the box. It is primarily for use by other UIP
commands, but it will certainly work if given manually. The computer
will also inquire whether or not you want to move the sidecab mirrors,
unless the NOMIRRORS argument is given.
C.46.14 LO /ANTENNA_ONLY
If /ANTENNA_ONLY is specified, commands will be sent only to the antenna
computer. No messages will be sent to the backend computers. Note that
this means the IF down converter will not be configured, so there is a
very good chance that if you use this qualifier, the IF will not be
plumbed to the spectrometers correctly.
C.46.15 LO /RESTART
Causes the process for the IF down converter to be restarted.
C.46.16 LO /GUNN_ON
The antenna computer will be instructed to turn on the Gunn oscillator.
No other action (such as recalculating the sky frequency) will be taken.
C.46.17 LO /NOGUNN_ON
The antenna computer will be instructed to turn off the Gunn oscillator.
No other action (such as recalculating the sky frequency) will be taken.
C.46.18 LO /LOG
Causes the current LO parameters to be printed on the terminal. All the
other arguments and options will be ignored.
C.47 LOG
[UIP\]LOG ["MESSAGE"] [/STAMP]
[UIP\]LOG /OPEN [NAME]
[UIP\]LOG /CLOSE
[UIP\]LOG
Writes a text to the current log file.
C.47.1 LOG MESSAGE
The text to be written.
C.47.2 LOG /STAMP
A time stamp is written before the text is written into the file.
C.47.3 LOG /OPEN
Opens a new log file and records the time and date. While the log file
is open, significant events, such as source changes, are recorded in
this file.
C.47.4 LOG NAME
The name of the log file. The default is username_yyyy‐mm‐
ddThh:mm:ss.log, for instance observer_2009‐01‐01T04:00:00.log.
C.47.5 LOG /CLOSE
Closes the current log file. No other log file is automatically opened,
so unless a LOG /OPEN command is given, events will not be logged.
C.48 OBSERVE
[UIP\]OBSERVE NAME [/NOLO_ADJUST] [/NOFCAL_AUTO] [/NOTCAL_INVALI-
DATE]
Looks up the coordinates of an object, and sends them to the antenna
computer. The currently open source catalogs are searched in the
reverse of the order in which they where opened. If the object is
found, its name and coordinates will be sent to the antenna computer.
C.48.1 OBSERVE NAME
The name of the object.
C.48.2 OBSERVE /NOLO_ADJUST
Without this option, the LO frequency will be updated after the new
source position has been entered. This option has no effect if you are
not observing in spectral line mode.
C.48.3 OBSERVE /NOFCAL_AUTO
Without this option, the backend will take a frequency calibration scan
if you are going to slew more than 40 degrees in azimuth. This option
has no effect if you are not observing in spectral line mode. A fre-
quency calibration scan will not be taken if the OBSERVE command is exe-
cuted in a command file.
C.48.4 OBSERVE /NOTCAL_INVALIDATE
Without this option, the current temperature calibration will be invali-
dated after the new source position has been entered. This option has
no effect if you are not observing in spectral line mode.
C.49 OFF_POSITION
[UIP\]OFF_POSITION X_OFFSET [Y_OFFSET] [/ALTAZIMUTHAL | /EQUATORIAL
| /GALACTIC] [/SYMMETRIC | /ASYMMETRIC]
[UIP\]OFF_POSITION /DESIGNATED_OFF [NAME]
[UIP\]OFF_POSITION
Allows you to specify the default OFF position used by the OO_SCAN,
OTF_MAP, and TCAL commands.
C.49.1 OFF_POSITION X_OFFSET
The longitudinal offset in arc seconds.
C.49.2 OFF_POSITION Y_OFFSET
The latitudinal offset in arc seconds. The default is 0.
C.49.3 OFF_POSITION /ALTAZIMUTHAL
Specifies that the X_OFFSET and Y_OFFSET are in altazimuthal coordi-
nates. This is the default.
C.49.4 OFF_POSITION /EQUATORIAL
Specifies that the X_OFFSET and Y_OFFSET are in equatorial coordinates.
C.49.5 OFF_POSITION /GALACTIC
Specifies that the X_OFFSET and Y_OFFSET are in Galactic coordinates.
C.49.6 OFF_POSITION /SYMMETRIC
Specifies that the symmetric pattern should be used by the OO_SCAN com-
mand. The OFF positions to be used are (+X_OFFSET, +Y_OFFSET) and
(‐X_OFFSET, ‐Y_OFFSET).
C.49.7 OFF_POSITION /ASYMMETRIC
Specifies that the asymmetric pattern should be used by the OO_SCAN com-
mand. The OFF position to be used is (X_OFFSET, Y_OFFSET).
C.49.8 OFF_POSITION /DESIGNATED_OFF
Specifies that the designated OFF position should be used by the
OO_SCAN, OTF_MAP, and TCAL commands.
C.49.9 OFF_POSITION NAME
The name of the designated OFF position.
C.50 OO_SCAN
[UIP\]OO_SCAN [CYCLES] [/STEP X_STEP [Y_STEP] | /DESIGNATED_OFF
[NAME]] [/ALTAZIMUTHAL | /EQUATORIAL | /GALACTIC] [/ASYMMETRIC]
[/REVERSE] [/ALTERNATE] [/NOFOCUS_ADJUST] [/NOLO_ADJUST] [/NOATTENUA-
TOR_ADJUST] [/CALIBRATE_AT_START | /NOCALIBRATE_AT_START]
[/PAUSE_AFTER_CAL [TIME] | /NOPAUSE_AFTER_CAL]
The data taking command for observing with the position switching mode.
It commands the antenna and backend computers to take ON‐OFF data by
repeating one of two basic patterns ‐ symmetric or asymmetric. By
default, it performs a symmetric set of measurements. The basic symmet-
ric pattern is
+OFF ON ON ‐OFF.
If the argument CYCLES is set to 2, the actual pattern will be
+OFF ON ON ‐OFF ‐OFF ON ON +OFF.
The basic asymmetric pattern is just
ON OFF.
If the argument CYCLES is set to 2, the actual pattern will be
ON OFF OFF ON.
Unlike in the legacy UIP, the arguments and options of OO_SCAN are not
sticky. Exceptions are the /(NO)REVERSE and /(NO)ALTERNATIVE options.
C.50.1 OO_SCAN CYCLES
The number of times the basic pattern should be repeated. The default
is 1.
C.50.2 OO_SCAN /STEP
Specifies the size of the step, in arc seconds, to get to the OFF posi-
tion. This option is normally used with the /ALTAZIMUTHAL, /EQUATORIAL,
or /GALACTIC option. If none is given, the offset is assumed to be in
altazimuthal coordinates.
C.50.3 OO_SCAN /DESIGNATED_OFF
Tells OO_SCAN to search the open source catalogs for a designated OFF
position for the object being observed. Such OFF positions must have
the object’s name followed by ":off_position", or they must be named
explicitly as an argument of the /DESIGNATED_OFF option.
C.50.4 OO_SCAN NAME
The name of the designated OFF position.
C.50.5 OO_SCAN /ALTAZIMUTHAL
Specifies that the offset given by the STEP option is in altazimuthal
coordinates. This is the default.
C.50.6 OO_SCAN /EQUATORIAL
Specifies that the offset given by the STEP option is in equatorial
coordinates.
C.50.7 OO_SCAN /GALACTIC
Specifies that the offset given by the STEP option is in Galactic coor-
dinates.
C.50.8 OO_SCAN /ASYMMETRIC
Tells OO_SCAN to use only one OFF position.
C.50.9 OO_SCAN /REVERSE
Tells OO_SCAN to reverse the order in which ONs and OFFs are taken. The
basic asymmetric pattern becomes
OFF ON
and the basic symmetric pattern becomes (for CYCLES = 2)
ON +OFF +OFF ON ON ‐OFF ‐OFF ON
Note that the number of cycles must be even in the symmetric case, or
you will have uneven numbers of +OFF and ‐OFF integrations. This option
is sticky.
C.50.10 OO_SCAN /NOREVERSE
Tells OO_SCAN not to /REVERSE. This option is sticky.
C.50.11 OO_SCAN /ALTERNATE
Every other OO_SCAN will be taken /REVERSE. This option is sticky.
C.50.12 OO_SCAN /NOALTERNATE
Tells OO_SCAN not to /ALTERNATE. This option is sticky.
C.50.13 OO_SCAN /NOFOCUS_ADJUST
Tells OO_SCAN not to adjust the focus at the beginning of each cycle.
C.50.14 OO_SCAN /NOLO_ADJUST
Tells OO_SCAN not to adjust the phase lock frequency at the beginning of
each cycle, to allow for Doppler tracking.
C.50.15 OO_SCAN /NOATTENUATOR_ADJUST
Tells OO_SCAN not to adjust the programmable attenuator at the beginning
of a scan.
C.50.16 OO_SCAN /CALIBRATE_AT_START
Tells OO_SCAN to take a temperature calibration scan before taking any
source data. The default action is to calibrate at the start only if no
valid temperature calibration scan is already available.
C.50.17 OO_SCAN /NOCALIBRATE_AT_START
Tells OO_SCAN not to take a temperature calibration scan even if no
valid calibration scan is available.
C.50.18 OO_SCAN /PAUSE_AFTER_CAL
Allows the observer to specify a number of seconds to wait after the
temperature calibration scan, before taking the source’s data. This is
desirable if the thermal load of the calibration vane seems to affect
the receiver’s performance for some period after taking a temperature
calibration scan. For example, /PAUSE_AFTER_CAL 5 will result in a 5
second pause between temperature calibration and data taking. This
option is selected by default, and the default time is 20 seconds.
C.50.19 OO_SCAN /NOPAUSE_AFTER_CAL
Tells OO_SCAN not to pause after the temperature calibration scan.
C.51 OTF_MAP
[UIP\]OTF_MAP LONGITUDE_SIZE LATITUDE_SIZE [SCAN_SPEED [RAMP_UP_TIME
[LONGITUDE_RESOLUTION [LATITUDE_RESOLUTION]]]] [/DIMENSION NCOLUMNS
NROWS] [/POSITION_ANGLE POSITION_ANGLE | /SIDEWAYS] [/SKEW OFFSET]
[/ZIGZAG] [/SKIP N] [/ALTAZIMUTHAL | /EQUATORIAL | /GALACTIC] [/NOFO-
CUS_ADJUST] [/NOROTATOR_ADJUST] [/NOLO_ADJUST] [/NOATTENUATOR_ADJUST]
[/CALIBRATE [N] | /NOCALIBRATE] [/PAUSE_AFTER_CAL [TIME] |
/NOPAUSE_AFTER_CAL] [/OFFSET X_OFFSET [Y_OFFSET] | /AZO OFFSET | /DESIG-
NATED_OFF [NAME]] [/MOVE_ONLY]
Maps an area surrounding the source position. Data are taken continu-
ously while the telescope is scanning the source, rather than acquiring
individual offset positions. In some cases this can result in a factor
of 2 or more increase in the observing duty‐cycle.
The considerations involved in using OTF_MAP are fairly complex, partic-
ularly for spectral line work. You should consult with a CSO staff mem-
ber before using this mapping mode.
C.51.1 OTF_MAP LONGITUDE_SIZE
The size of the map in the longitude‐like coordinate (right ascension,
azimuth, or Galactic longitude) in arc seconds.
C.51.2 OTF_MAP LATITUDE_SIZE
The size of the map in the latitude‐like coordinate (declination, eleva-
tion, or Galactic latitude) in arc seconds.
C.51.3 OTF_MAP SCAN_SPEED
The speed at which the telescope should move across the sky, in arc sec-
onds per second of time. In heterodyne receiver mode, the SPEED and
LONGITUDE_RESOLUTION arguments determine the intergration time for each
cell:
INTEGRATION_TIME = LONGITUDE_RESOLUTION / SPEED.
The default is LONGITUDE_RESOLUTION arc seconds per second. The scan
proceeds from negative values of the longitude‐like coordinate towards
positive. This argument must be positive.
C.51.4 OTF_MAP RAMP_UP_TIME
The time in seconds to wait for the antenna computer to acquire the new
moving position. Data will not be taken during this time. The default
RAMP_UP_TIME is 10 seconds, which is adequate for speeds of up to sev-
eral times the sidereal rate. For speeds below about 5 arc seconds per
second, substantially smaller values of RAMP_UP_TIME may be used. At
very slow speeds (about 1 arc second per second), RAMP_UP_TIME may be
set to 0.
C.51.5 OTF_MAP LONGITUDE_RESOLUTION
The step size in the longitude‐like coordinate, in arc seconds. This
argument is optional, if not specified, 1/2 the beam width, rounded to
the nearest arc second, will be used. This argument must be positive.
C.51.6 OTF_MAP LATITUDE_RESOLUTION
The step size in the latitude‐like coordinate, in arc seconds. This
argument is optional, if not specified, the value of the argument LONGI-
TUDE_RESOLUTION will be used. This argument can be either positive or
negative. If the argument is positive, the map is started at the bottom
(negative declination, elevation, or Galactic latitude).
C.51.7 OTF_MAP /DIMENSION
Specifies the number of columns (cells in the scan direction) and rows
in the map. This option, together with the LONGITUDE_RESOLUTION and
LATITUDE_RESOLUTION arguments, is an alternative way of specifying the
OTF map geometry. The LONGITUDE_SIZE and LATITUDE_SIZE arguments are
ignored. They are instead calculated as:
LONGITUDE_SIZE = NCOLUMNS * | LONGITUDE_RESOLUTION |
and
LATITUDE_SIZE = NROWS * | LATITUDE_RESOLUTION |.
LATITUDE_RESOLUTION can be zero when /DIMENSION is specified, in which
case a (single‐row) scan will be repeated NROWS times along the same
strip.
C.51.8 OTF_MAP NCOLUMNS
C.51.9 OTF_MAP NROWS
C.51.10 OTF_MAP /POSITION_ANGLE
Causes the telescope to be scanned in the direction specified by the
position angle in degrees, which is measured from north through east.
If the position angle is 0, for example, south to north scans will be
taken. If the position angle is 45, scans will go from south‐west to
north‐east. If no position angle is given, the source is scanned from
west to east, which is equivalent to a position angle of 90.
C.51.11 OTF_MAP /SIDEWAYS
Causes the map to be scanned in elevation, rather than in azimuth.
C.51.12 OTF_MAP /SKEW
Causes each row to be offset from the previous row by the specified step
in arc seconds. This will result in a parallelogram‐shaped map.
C.51.13 OTF_MAP /ZIGZAG
Causes the scan direction to be alternated by reversing the position
angle for even number rows. For example, rows 2, 4, 6, 8, ... will be
taken from east to west instead of from west to east when the position
angle is set to 90 degrees.
C.51.14 OTF_MAP /SKIP
/SKIP N tells OTF_MAP to skip the first N rows of your map.
C.51.15 OTF_MAP /ALTAZIMUTHAL
Causes the map area to be scanned in altazimuthal coordinates. The
default is /EQUATORIAL.
C.51.16 OTF_MAP /EQUATORIAL
Causes the map area to be scanned in equatorial coordinates of date.
This is the default.
C.51.17 OTF_MAP /GALACTIC
Causes the map area to be scanned in Galactic coordinates. The default
is /EQUATORIAL. *** This option is NOT working yet!!! ***
C.51.18 OTF_MAP /NOFOCUS_ADJUST
Tells OTF_MAP not to adjust the focus at the beginning of each row.
C.51.19 OTF_MAP /NOROTATOR_ADJUST
Tells OTF_MAP not to adjust the instrument rotator at the beginning of
each row.
C.51.20 OTF_MAP /NOLO_ADJUST
Tells OTF_MAP not to adjust the phase lock frequency at the beginning of
each row, to allow for Doppler tracking.
C.51.21 OTF_MAP /NOATTENUATOR_ADJUST
Tells OTF_MAP not to adjust the programmable attenuator at the beginning
of each row.
C.51.22 OTF_MAP /CALIBRATE
Tells OTF_MAP to take a temperature calibration scan before taking any
source data. The default action is to calibrate at the start only if no
valid temperature calibration scan is already available. If an optional
argument is given to this option as /CALIBRATE N, then a temperature
calibration will be taken at the beginning and also before every Nth
row.
C.51.23 OTF_MAP /NOCALIBRATE
Tells OTF_MAP not to take a temperature calibration scan even if no
valid calibration scan is available.
C.51.24 OTF_MAP /PAUSE_AFTER_CAL
Allows the observer to specify a number of seconds to wait after the
temperature calibration scan, before taking the source’s data. This is
desirable if the thermal load of the calibration vane seems to affect
the receiver’s performance for some period after taking a temperature
calibration scan. For example, /PAUSE_AFTER_CAL 5 will result in a 5
second pause between temperature calibration and data taking. This
option is selected by default, and the default time is 20 seconds.
C.51.25 OTF_MAP /NOPAUSE_AFTER_CAL
Tells OTF_MAP not to pause after the temperature calibration scan.
C.51.26 OTF_MAP /OFFSET
Allows you to specify the OFF position by the offset, in arc seconds,
from the center of the map in the mapping coordinate system.
C.51.27 OTF_MAP /AZO
Allows you to specify the OFF position by the offset, in arc seconds,
from the center of the row being scanned. The duration of the OFF inte-
gration will be whatever integration time was specified in the most
recent SPECTROMETER command. Temperature calibration scans will be
taken with this same azimuth offset, relative to the center of the map.
This option may not be used with /DESIGNATED_OFF.
C.51.28 OTF_MAP /DESIGNATED_OFF
If /DESIGNATED_OFF is specified, OFF data will be taken at a designated
OFF position after each row has been scanned. This is useful if no
region of the area you are mapping is free of signal, and you know of a
particular position which is clean. See OO_SCAN for more information on
how to set up a designated OFF position in the source catalog. The
duration of the OFF integration will be whatever integration time was
specified in the SPECTROMETER command. Any temperature calibration
scans requested with the map will be taken at the designated OFF posi-
tion, and an extra OFF integration will be taken after each temperature
calibration scan. This option may not be used with /AZO.
C.51.29 OTF_MAP NAME
The name of the designated OFF position.
C.51.30 OTF_MAP /MOVE_ONLY
When /MOVE_ONLY is specified, the antenna will perform the rastering
movements, but no data will be taken. This can be helpful for determin-
ing what amount of time is needed for ramping up (see RAMP_UP_TIME). It
can also be handy when you scan an area to find your beam on the strip‐
chart recorder.
C.52 OPTICAL_POINTING
[UIP\]OPTICAL_POINTING NAME [/EXPOSURE_TIME EXPOSURE_TIME]
[/REPEAT_COUNT REPEAT_COUNT] [/OFFSET X_OFFSET Y_OFFSET]
[UIP\]OPTICAL_POINTING [/AZIMUTH AZIMUTH] [/ELEVATION ELEVATION |
/ZENITH_ANGLE ZENITH_ANGLE] [/DISTANCE_LIMIT DISTANCE_LIMIT] [/NEAREST |
/BRIGHTEST] [/EXPOSURE_TIME EXPOSURE_TIME] [/REPEAT_COUNT REPEAT_COUNT]
[/OFFSET X_OFFSET Y_OFFSET]
Allows you to check the pointing with the optical telescope. You can
specify the name of a star to point on, or the system can search for a
suitable guide star near the current telescope position, or near the sky
position you specify. Once a star has been selected, the optical tele-
scope will be commanded to take an exposure. The optical telescope will
then take an exposure, and find the star within the frame. The offsets
will then be reported.
C.52.1 OPTICAL_POINTING NAME
The name of the star to point on.
C.52.2 OPTICAL_POINTING /AZIMUTH
Allows you to enter an azimuth value for a star for optical pointing. A
star will be chosen near this azimuth.
C.52.3 OPTICAL_POINTING /ELEVATION
Allows you to enter an elevation value for a star for optical pointing.
A star will be chosen near this elevation.
C.52.4 OPTICAL_POINTING /ZENITH_ANGLE
Similar to the /ELEVATION option, but the angle is specified in zenith
distance. It can be abbreviated as /ZA.
C.52.5 OPTICAL_POINTING /ZA
C.52.6 OPTICAL_POINTING /DISTANCE_LIMIT
Allows you specify the maximum angular distance, in degrees to search
for a star for optical pointing. The default is 5 degrees.
C.52.7 OPTICAL_POINTING /NEAREST
Tells the system to use the nearest star within the DISTANCE_LIMIT for
optical pointing.
C.52.8 OPTICAL_POINTING /BRIGHTEST
Tells the system to use the brightest star within the DISTANCE_LIMIT for
optical pointing.
C.52.9 OPTICAL_POINTING /EXPOSURE_TIME
Allows you to specify the duration, in milliseconds, of exposures taken
for optical pointing.
C.52.10 OPTICAL_POINTING /REPEAT_COUNT
Allows you to specify how many exposures and fits should be taken when
doing an optical pointing.
C.52.11 OPTICAL_POINTING /OFFSET
Allows you to give the CCD camera initial guesses for the X and Y posi-
tions of the star in the CCD frame.
C.53 PAGE
[UIP\]PAGE
C.54 PLANET
[UIP\]PLANET NAME [/JPL_HORIZONS] [/DOPPLER] [/NOLO_ADJUST] [/NOF-
CAL_AUTO] [/NOTCAL_INVALIDATE]
Looks up the coordinates of an object in the ephemeris file called
cat_dir:NAME.dat, where NAME is the name of the object, and passes three
consecutive lines of information to the antenna computer. The three
lines are those closest to the current time and are used by the antenna
computer for a quadratic fit to compute the actual position of the
object. Each line of the file should contain the following four quanti-
ties: UTC epoch in JD, right ascension, declination, range (distance) in
AU, and range rate (radial velocity) in km/s. The right ascension, dec-
lination, range, and range rate should be geocentric. For example:
2451525.5 09:20:00.07 ‐01:31:02.2 0.8536949382 ‐21.92113
2451526.5 09:21:20.10 ‐01:42:13.3 0.8410722778 ‐21.78948
2451527.5 09:22:39.58 ‐01:53:21.4 0.8285261389 ‐21.65616
The lines should be in chronological order.
C.54.1 PLANET NAME
The name of the object.
C.54.2 PLANET /JPL_HORIZONS
Produces an ephemeris on‐the‐fly using the JPL HORIZONS system.
C.54.3 PLANET /DOPPLER
Causes the antenna computer to Doppler track the object using the radial
velocity information in the ephemeris file.
C.54.4 PLANET /NOLO_ADJUST
Without this option, the LO frequency will be updated after the new
source position has been entered. This option has no effect if you are
not observing in spectral line mode.
C.54.5 PLANET /NOFCAL_AUTO
Without this option, the backend will take a frequency calibration scan
if you are going to slew more than 40 degrees in azimuth. This option
has no effect if you are not observing in spectral line mode. A fre-
quency calibration scan will not be taken if the PLANET command is exe-
cuted in a command file.
C.54.6 PLANET /NOTCAL_INVALIDATE
Without this option, the current temperature calibration will be invali-
dated after the new source position has been entered. This option has
no effect if you are not observing in spectral line mode.
C.55 POINTING
[UIP\]POINTING [NAME]
Loads a file of pointing constants into the antenna computer, to facili-
tate changing pointing modes. For instance
POINTING optical
will load in the most recent set of pointing constants for optical
pointing, and
POINTING 345_side
will load in the most recent parameters for the 345 GHz SIS receiver in
the sidecab.
C.55.1 POINTING NAME
The name of the pointing setup such as OPTICAL or BOLOMETER.
C.56 PSWITCH
[UIP\]PSWITCH
C.56.1 PSWITCH /FOCUS_ADJUST
C.56.2 PSWITCH /LEVEL_ADJUST
C.57 PUNDIT
[UIP\]PUNDIT [STATUS]
By default, only one process running the UIP can issue commands which
affect the observatory’s operation. If another terminal is running the
UIP, you will not be allowed to issue any command which communicates
with the antenna or backend computers, or changes the data acquisition
setup. However, the PUNDIT command allows you to override this feature.
Typing ’PUNDIT TRUE’ will tell the UIP to allow your terminal to issue
all UIP commands. ’PUNDIT FALSE’ disables this feature. Typing ’PU
DIT’ by itself will tell you whether you are a pundit or a pleb.
C.57.1 PUNDIT STATUS
A TRUE or FALSE response.
C.58 RASTER_SCAN
[UIP\]RASTER_SCAN SCAN_VELOCITY SCAN_LENGTH [NUMBER_OF_SCANS]
[/STEP_SIZE STEP_SIZE] [/OFFSET X_OFFSET [Y_OFFSET]] [/POSITION_ANGLE
POSITION_ANGLE] [/ALTERNATE_DIRECTION] [/ALTAZIMUTHAL | /EQUATORIAL]
[/SETTLING_TIME SETTLING_TIME] [/NOFOCUS_ADJUST] [/NOROTATOR_ADJUST]
[UIP\]RASTER_SCAN /CANCEL
[UIP\]RASTER_SCAN
Implements a raster scan observing mode for bolometers.
C.58.1 RASTER_SCAN SCAN_VELOCITY
The scan velocity in arc seconds per second.
C.58.2 RASTER_SCAN SCAN_LENGTH
The scan length in arc seconds.
C.58.3 RASTER_SCAN NUMBER_OF_SCANS
The number of scans to be performed. The default is 1.
C.58.4 RASTER_SCAN /STEP_SIZE
The latitudinal separation, in arc seconds, between two adjacent scans.
The default is 0, i.e., all scans will be repeated at the same latitude.
C.58.5 RASTER_SCAN /OFFSET
The initial scan offsets in arc seconds.
C.58.6 RASTER_SCAN X_OFFSET
The initial longitudinal offset in arc seconds. The default is ‐
SCAN_LENGTH / 2.
C.58.7 RASTER_SCAN Y_OFFSET
The initial latitudinal offset in arc seconds. The default is ‐
STEP_SIZE (NUMBER_OF_SCANS ‐ 1) / 2.
C.58.8 RASTER_SCAN /POSITION_ANGLE
The direction of the scan, in arc degrees, measured from north through
east. The default is 90, i.e., scans will be taken from west to east.
C.58.9 RASTER_SCAN /ALTERNATE_DIRECTION
Will reverse the direction of every other scan.
C.58.10 RASTER_SCAN /ALTAZIMUTHAL
The scan coordinates will be altazimuthal. This is the default.
C.58.11 RASTER_SCAN /EQUATORIAL
The scan coordinates will be apparent equatorial.
C.58.12 RASTER_SCAN /SETTLING_TIME
The settling time in seconds. The default is 10.
C.58.13 RASTER_SCAN /NOFOCUS_ADJUST
Will not adjust the secondary mirror focus position. By default, the
secondary mirror focus is adjusted at the beginning of each scan.
C.58.14 RASTER_SCAN /NOROTATOR_ADJUST
Will not adjust the instrument rotator position. By default, the
instrument rotator is adjusted at the beginning of each scan.
C.58.15 RASTER_SCAN /CANCEL
Will cancel the scan.
C.59 REPEAT_COMMAND
[UIP\]REPEAT_COMMAND NUM_ITERATIONS "COMMAND_LINE" [/BEEP_AT_END]
Allows you to repeat a command several times.
C.59.1 REPEAT_COMMAND NUM_ITERATIONS
The number of times to repeat the command.
C.59.2 REPEAT_COMMAND COMMAND_LINE
The command to be executed.
C.59.3 REPEAT_COMMAND /BEEP_AT_END
Will beep 3 times when finished.
C.60 RAO
[UIP\]RAO [OFFSET] [/MAPPING MAPPING_OFFSET] [/FIELD FIELD_OFFSET]
[/TEXAS TEXAS_OFFSET]
[UIP\]RAO [/MAPPING | /FIELD | /TEXAS]
Sends a new right ascension offset to the antenna computer.
C.60.1 RAO OFFSET
The new right ascension offset in arc seconds.
C.60.2 RAO /MAPPING
Modifies or prints the mapping offset.
C.60.3 RAO MAPPING_OFFSET
The new mapping right ascension offset in arc seconds.
C.60.4 RAO /FIELD
Modifies or prints the field offset.
C.60.5 RAO FIELD_OFFSET
The new field right ascension offset in arc seconds.
C.60.6 RAO /TEXAS
Modifies or prints the Texas offset. The Texas switching mode is acti-
vated (that moves the telescope ON and OFF source based on a digital
input signal to the antenna computer) if the offset is given.
C.60.7 RAO TEXAS_OFFSET
The new Texas right ascension offset in arc seconds.
C.61 ROTATOR
[UIP\]ROTATOR [POSITION | /CONSTANT_UPDATES | /NOCONSTANT_UPDATES |
/STEALTHY_UPDATES | /NOSTEALTHY_UPDATES] [/LHS | /RHS | /BOLOCAM |
/NONE] [/OFFSET OFFSET]
Allows the user to control the motion of the Cassegrain instrument rota-
tors. One can set the rotator at a fixed angle, or enable auto adjust-
ment to follow the parallactic angle. If auto adjustment is selected,
an offset may be applied, and the timing of the angle changes may be
controlled.
If ROTATOR is entered without any arguments or options, and if the
antenna is in STEALTHY mode, the antenna will be instructed to adjust
the rotator based on the parallactic angle.
C.61.1 ROTATOR POSITION
If this optional argument is specified, it will be sent to the antenna
computer and used as a fixed rotator position.
C.61.2 ROTATOR /CONSTANT_UPDATES
Tells the antenna computer to update the position of the rotator when-
ever the position should be changed. In this mode, the rotator might be
moved when an integration is taking place.
C.61.3 ROTATOR /NOCONSTANT_UPDATES
Disables /CONSTANT_UPDATES.
C.61.4 ROTATOR /STEALTHY_UPDATES
Tells the antenna computer to update the position of the rotator only
when data is not being taken, so that during a given integration the
rotator will remain fixed.
C.61.5 ROTATOR /NOSTEALTHY_UPDATES
Disables /STEALTHY_UPDATES.
C.61.6 ROTATOR /LHS
Activates the left (as seen from the control room) rotator. Only one
rotator can be active at a time.
C.61.7 ROTATOR /RHS
Activates the right (as seen from the control room) rotator. Only one
rotator can be active at a time.
C.61.8 ROTATOR /BOLOCAM
Activates the rotator of BOLOCAM.
C.61.9 ROTATOR /NONE
Deactivates the any active rotator.
C.61.10 ROTATOR /OFFSET
Allows you to specify a fixed offset which will be added to the paral-
lactic angle when the antenna computer updates the rotator position.
C.62 SECONDARY
[UIP\]SECONDARY THROW FREQUENCY [ON_TOLERANCE [OFF_TOLERANCE]]
[/ANALOG_PID_ONLY | /TTL_SYNC | /SQUARE_WAVE | /FORCE] [/MEASURED_THROW
MEASURED_THROW]
[UIP\]SECONDARY /RESTART [/FORCE] [/MEASURED_THROW MEASURED_THROW]
[UIP\]SECONDARY /STOP
[UIP\]SECONDARY /MEASURED_THROW MEASURED_THROW
[UIP\]SECONDARY
Controls the chopping secondary mirror. It allows the chop throw and
frequency to be specified, as well as where in the chop cycle the system
will acquire data.
By default, the SECONDARY command will use the digital, self‐tuning con-
troller. It may take a few minutes for the controller to acquire an
initial solution. Subsequently the self‐tuning process can be skipped
by reloading the existing solution. It needs to be retuned whenever the
chop throw or frequency is changed.
The digital controller utilizes the analog PID controller to shape the
closed loop response of the chopping secondary mirror. It must be pre-
set as follows PRIOR TO issuing this command:
=========================================
Throw P I D G
‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
‐ 150.0 2.00 4.40 4.60 4.20
150.0 ‐ 210.0 1.70 4.20 4.60 4.20
210.0 ‐ 330.0 1.60 3.90 4.60 4.20
330.0 ‐ 1.30 3.40 4.60 3.20
‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐
C.62.1 SECONDARY THROW
The separation of two beams on the sky in arc seconds. The maximum
throw is 480 arc seconds when the digital controller is used or 540 arc
seconds otherwise.
C.62.2 SECONDARY FREQUENCY
The chopping frequency in Hz. The minimum frequency is 0.1 Hz, and the
maximum frequency is 4 Hz when the digital controller is used or 5 Hz
otherwise.
C.62.3 SECONDARY ON_TOLERANCE
The pointing error tolerance for the ON beam in arc seconds. The
default is 10.
C.62.4 SECONDARY OFF_TOLERANCE
The pointing error tolerance for the OFF beam in arc seconds. The
default is the same as the ON_TOLERANCE.
C.62.5 SECONDARY /MEASURED_THROW
The measured (actual) beam separation on the sky in arc seconds.
C.62.6 SECONDARY /ANALOG_PID_ONLY
Will use the analog PID controller only.
C.62.7 SECONDARY /TTL_SYNC
Will use the analog PID controller in TTL‐sync mode.
C.62.8 SECONDARY /SQUARE_WAVE
Will use the digital controller in square wave mode.
C.62.9 SECONDARY /RESTART
Will restart chopping. When the digital controller has not been tuned
recently, the SECONDARY command will suggest you to retune it. Specify-
ing /FORCE along with /RESTART will force keeping the current tuning.
C.62.10 SECONDARY /FORCE
Will force keeping the current tuning or retuning of the digital con-
troller.
C.62.11 SECONDARY /STOP
Will stop the secondary mirror from chopping and park it at the rest
position.
C.63 SHUTTER
[UIP\]SHUTTER /OPEN [APERTURE]
[UIP\]SHUTTER /CLOSE
[UIP\]SHUTTER /STOP
[UIP\]SHUTTER /SHADOW [COVERAGE]
[UIP\]SHUTTER /ALARMOFF
[UIP\]SHUTTER
Controls the dome shutter and its security alarm. If no option is spec-
ified, it prints the current status of the shutter,
C.63.1 SHUTTER /OPEN
Starts the open or close cycle of the shutter. Without the optional
APERTURE argument, it starts the open cycle. The shutter will be fully
opened unless SHUTTER /STOP command is issued or the stop switch on the
control panel is pressed manually. If the optional APERTURE argument,
in %, is given, it starts either the open or close cycle depending on
the current aperture. Then the shutter will be held in a position which
realizes the specified aperture.
C.63.2 SHUTTER /CLOSE
Starts the close cycle of the shutter. The shutter will be fully closed
unless SHUTTER /STOP command is issued or the stop switch on the control
panel is pressed manually.
C.63.3 SHUTTER /STOP
Stops the open or close cycle of the shutter.
C.63.4 SHUTTER /SHADOW
Starts the closed loop control of the shutter. The shutter position
will be adjusted continuously so that at least COVERAGE % of the primary
dish surface is in shadow. This may or may not result in a partial or
total brokage of the telescope beam. The default value for COVERAGE is
100 %. THIS FEATURE IS NOT WORKING YET.
C.63.5 SHUTTER /ALARMOFF
Resets the security alarm which monitors the shutter opening area on the
first floor.
C.64 SPECTROMETER
[UIP\]SPECTROMETER [INTEGRATION_TIME] [/AOS5 [OFFSET1 [OFFSET2 OFF-
SET3 OFFSET4]] | /NOAOS5] [/FFTS1W [OFFSET] | /FFTS1N [OFFSET] |
/NOFFTS1] [/FFTS2 [OFFSET1 OFFSET2 [OFFSET3 OFFSET4]] | /NOFFTS2]
[/RESTART] [/DISPLAY DISPLAY] [/LOCK_IGNORE | /NOLOCK_IGNORE]
[/ACQUIRED_IGNORE | /NOACQUIRED_IGNORE] [/IDLE_IGNORE | /NOIDLE_IGNORE]
[/ON_SAVE | /NOON_SAVE] [/OFF_SAVE | /NOOFF_SAVE] [/DARK_SAVE |
/NODARK_SAVE] [/BASELINE WINDOW1 WINDOW2 WINDOW3 WINDOW4 | /NOBASELINE]
Allows you to change the integration time and certain other parameters
of the AOS and FFTS backends. It also informs the system that you will
be observing in spectroscopy mode (as opposed to bolometer mode). Typ-
ing SPECTROMETER without any arguments results in the current parameters
being displayed. All parameters, except the baseline parameters, are
sticky.
SPECTROMETER also allows you to specify which AOS and FFTS backends are
active and to position them within the IF passband.
C.64.1 SPECTROMETER INTEGRATION_TIME
How long the AOS and FFTS backends should integrate, in seconds. It may
not be possible to integrate for precisely the time you request since
the true integration time must be a multiple of the Reticon/CCD/FPGA
readout time.
C.64.2 SPECTROMETER /AOS5
Tells the system that the AOS5 (4 GHz) should be active.
An array of four 1.1 GHz AOS segments covers the 4 GHz passband of the
wideband receivers. The segments are by default centered at 4.5, 5.5,
6.5, and 7.5 GHz. They can be moved independently by specifying four
offsets in GHz as the optional arguments. The legal range of each off-
set is ‐0.10 to 0.10 GHz. Only one of the four AOS segments is used to
cover the 1 GHz passband of the narrowband receivers. It can be moved
by specifying the offset in GHz as the optional argument.
C.64.3 SPECTROMETER /NOAOS5
Tells the system that the AOS5 (4 GHz) should be deactivated.
C.64.4 SPECTROMETER /FFTS1W
Tells the system that the FFTS1 should be active in the wideband mode (1
GHz).
The optional argument specifies the offset in GHz relative to the IF
where the FFTS1 should be positioned. The legal range is ‐2.00 to 2.00
GHz for the wideband receivers and ‐0.50 to 0.50 GHz for the narrowband
receivers.
C.64.5 SPECTROMETER /FFTS1N
Tells the system that the FFTS1 should be active in the narrowband mode
(500 MHz).
The optional argument specifies the offset in GHz relative to the IF
where the FFTS1 should be positioned. The legal range is ‐2.00 to 2.00
GHz for the wideband receivers and ‐0.50 to 0.50 GHz for the narrowband
receivers.
C.64.6 SPECTROMETER /FFTS1
[DEPRECATED] Tells the system that the FFTS1 (1 or 0.5 GHz) should be
active.
The optional argument specifies the offset in GHz relative to the IF
where the FFTS1 should be positioned. The legal range is ‐2.00 to 2.00
GHz for the wideband receivers and ‐0.50 to 0.50 GHz for the narrowband
receivers.
C.64.7 SPECTROMETER /NOFFTS1
Tells the system that the FFTS1 (1 or 0.5 GHz) should be deactivated.
C.64.8 SPECTROMETER /BANDWIDTH
[DEPRECATED] Specifies the bandwidth of the FFTS1 in GHz. It can be
configured to cover either 1 or 0.5 GHz with 8192 channels. The default
is 1 GHz.
C.64.9 SPECTROMETER /FFTS2
Tells the system that the FFTS2 (8 GHz) should be active.
Four FFTS segments of 2 GHz wide each conver the maximum 8 GHz passband.
The segments 1 and 2 are by default centered at 5 and 7 GHz, respec-
tively, in the first 4‐8 GHz IF channel for the wideband receivers. The
segments 3 and 4 are by default centered at 5 and 7 GHz, respectively,
in the second 4‐8 GHz IF channel. The segments 3 and 4 are only used
with Frank Rice’s receiver, and their default center frequencies (5 and
7 GHz) correspond to 11 and 9 GHz, respectively, in the original IF
passband of the receiver (4‐16 GHz).
Each segment can be positioned anywhere within the 4‐8 GHz passband of
the IF channel it is connected by specifying four offsets in GHz as the
optional arguments. Note that the segments 3 and 4 are ’inverted’ in
frequency. Shifting them higher in the down‐converted 4‐8 GHz IF moves
them lower in the original 8‐12 GHz IF.
For the narrowband receivers, the segments 1 and 2 are both by default
centered at 7 GHz, which corresponds to 1 GHz in the original passband
of the receivers (1‐2 GHz). The segments 1 and 2 can be repositioned by
specifying two offsets in GHz as the optional arguments. Note that the
spectra are ’inverted’ in frequency, but the offsets are not, i.e., the
offsets are relative to 1.5 GHz in the 1‐2 GHz IF of the receivers.
C.64.10 SPECTROMETER /NOFFTS2
Tells the system that the FFTS2 (8 GHz) should be deactivated.
C.64.11 SPECTROMETER /RESTART
Causes the processes for the active AOS and FFTS backends to be
restarted. This is sometimes useful if the AOS and FFTS processes in
the backend computer have become messed up.
C.64.12 SPECTROMETER /DISPLAY
Allows you to redirect the real‐time display for each spectrometer,
which shows the current integration. This option must be given an argu-
ment, and it must be a domain name or an IP address of the X server,
followed by a colon and a display number (which is usually 0), then
optionally a dot and a screen number (beginning at 0). For example,
/DISPLAY kilauea:0.1 will redirect the real‐time display of the active
spectrometers to the second screen of kilauea.
C.64.13 SPECTROMETER /LOCK_IGNORE
Tells the backend computer to ignore the LO lock signal from the antenna
computer. The default action is not to ignore the LO lock signal. It
is selected by default when the synthesized LO is being used.
C.64.14 SPECTROMETER /NOLOCK_IGNORE
Tells the backend computer not to ignore the LO lock signal. This is
the default action.
C.64.15 SPECTROMETER /ACQUIRED_IGNORE
Tells the backend computer to ignore the acquired signal from the
antenna computer. The default action is not to ignore the acquired sig-
nal.
C.64.16 SPECTROMETER /NOACQUIRED_IGNORE
Tells the backend computer not to ignore the acquired signal. This is
the default action.
C.64.17 SPECTROMETER /IDLE_IGNORE
Tells the backend computer to integrate even if the antenna is idle.
The default action is not to integrate when the antenna is idle.
C.64.18 SPECTROMETER /NOIDLE_IGNORE
Tells the backend computer not to integrate if the antenna is idle.
This is the default action.
C.64.19 SPECTROMETER /ON_SAVE
Specifies that the ON position scan should be stored separately after an
integration.
C.64.20 SPECTROMETER /NOON_SAVE
Specifies that the ON position scan should not be stored separately.
This is the default action.
C.64.21 SPECTROMETER /OFF_SAVE
Specifies that the OFF position scan should be stored separately after
an integration.
C.64.22 SPECTROMETER /NOOFF_SAVE
Specifies that the OFF position scan should not be stored separately.
This is the default action.
C.64.23 SPECTROMETER /DARK_SAVE
Specifies that the DARK scan should be stored separately after an inte-
gration.
C.64.24 SPECTROMETER /NODARK_SAVE
Specifies that the DARK scan should not be stored separately. This is
the default action.
C.64.25 SPECTROMETER /BASELINE
Activates the linear baseline. This baseline only affects the display
and the line integrals calculated by the FIVE_POINT command. The data
written to data files are not affected. Four channel numbers, specify-
ing two windows, must be given as the arguments.
C.64.26 SPECTROMETER /NOBASELINE
Turns off the baseline. The baseline is automatically erased when you
change sources.
C.65 STATUS
[UIP\STATUS]
Prints the current values of certain system parameters relating to log-
ging, command and data file status.
C.66 STOW
[UIP\]STOW [/ZENITH]
Causes the antenna to be driven to a random azimuth in a roughly eastern
direction. The reason is that if the dome is parked at a fixed azimuth
every day, the electrical slip rings, powering the dome, will wear
unevenly. The antenna is driven to an elevation angle of 60, and the
antenna is idled.
If the file kilauea:/opt/uip/etc/stow.txt exists, and if it contains a
valid elevation angle, the antenna will be stowed at that elevation
angle.
C.66.1 STOW /ZENITH
The antenna is driven to zenith.
C.67 SWEEP
[UIP\]SWEEP X_AMPLITUDE X_PERIOD [X_PHASE] [/Y_COORDINATE Y_AMPLI-
TUDE [Y_PERIOD [Y_PHASE]]] [/POSITION_ANGLE POSITION_ANGLE] [/ALTAZ-
IMUTHAL | /EQUATORIAL]
[UIP\]SWEEP /STOP
[UIP\]SWEEP
Implements a track‐and‐sweep observing mode for SHARC II. This command
generates a Lissajous trajectory using the following parametric equa-
tions:
dx(t) = X_AMPLITUDE cos 2 pi (t / X_PERIOD + X_PHASE / 360)
dy(t) = Y_AMPLITUDE sin 2 pi (t / Y_PERIOD + Y_PHASE / 360)
C.67.1 SWEEP X_AMPLITUDE
The amplitude of the sweep along the X axis in arc seconds.
C.67.2 SWEEP X_PERIOD
The period of the sweep along the X axis in seconds.
C.67.3 SWEEP X_PHASE
The initial phase of the sweep along the X axis in arc degrees.
C.67.4 SWEEP /Y_COORDINATE
C.67.5 SWEEP Y_AMPLITUDE
The amplitude of the sweep along the Y axis in arc seconds. The default
is 0.
C.67.6 SWEEP Y_PERIOD
The period of the sweep along the Y axis in seconds. The default is
X_PERIOD.
C.67.7 SWEEP Y_PHASE
The initial phase of the sweep along the Y axis in arc degrees. The
default is 0.
C.67.8 SWEEP /POSITION_ANGLE
The orientation of the sweep coordinates relative to the sky coordi-
nates. It is defined as an angle, in arc degrees, between the X axis of
the sweep and +AZ, +RA, or +L, measured through +EL, +DEC, or +B. The
default is 0, i.e., the sweep coordinates (+X, +Y) correspond to the sky
coordinates (+AZ, +EL), (+RA, +DEC), or (+L, +B). Note this definition
is not sky right.
C.67.9 SWEEP /ALTAZIMUTHAL
The sweep coordinates will be altazimuthal. This is the default.
C.67.10 SWEEP /EQUATORIAL
The sweep coordinates will be apparent equatorial.
C.67.11 SWEEP /STOP
Will stop the sweep.
C.68 TCAL
[UIP\]TCAL [/OFFSET X_OFFSET [Y_OFFSET] | /DESIGNATED_OFF [NAME]]
[/ALTAZIMUTHAL | /EQUATORIAL | /GALACTIC] [/INTEGRATION_TIME INTEGRA-
TION_TIME] [/MANUAL] [/NOATTENUATOR_ADJUST] [/DB ATTENUATION]
[/STAY_OFF]
Takes a temperature calibration scan.
C.68.1 TCAL /OFFSET
Specifies how many arc seconds to step off the source before taking the
calibration scan.
C.68.2 TCAL /DESIGNATED_OFF
Tells TCAL to search the open source catalogs for a designated OFF posi-
tion for the object being observed. Such OFF positions must have the
object’s name followed by ":off_position", or they must be named explic-
itly as an argument of the /DESIGNATED_OFF option.
C.68.3 TCAL NAME
The name of the designated OFF position.
C.68.4 TCAL /ALTAZIMUTHAL
Specifies that the offset given by the OFFSET option is in altazimuthal
coordinates. This is the default.
C.68.5 TCAL /EQUATORIAL
Specifies that the offset given by the OFFSET option is in equatorial
coordinates.
C.68.6 TCAL /GALACTIC
Specifies that the offset given by the OFFSET option is in Galactic
coordinates.
C.68.7 TCAL /INTEGRATION_TIME
Specifies the time, in seconds, that the spectrometer will integrate for
both the HOT and SKY spectra. The default is 5 seconds.
C.68.8 TCAL /MANUAL
If /MANUAL is specified, no commands will be sent to the chopper wheel.
Instead, the user will be prompted to insert and remove the hot load
manually. This option is sticky.
C.68.9 TCAL /NOATTENUATOR_ADJUST
Tells TCAL not to adjust the programmable attenuator at the beginning of
a scan.
C.68.10 TCAL /DB
Causes the current programmable attenuator setting to be incremented by
the specified amount before the hot load is inserted. This new value
remains in place until the calibration scan is completed, at which time
the attenuator is returned to its original state. The default is 3 dB.
C.68.11 TCAL /STAY_OFF
Will keep the antenna at the OFF source position after the calibration
scan.
C.68.12 TCAL /NOMOVE_OFF
Internal use only. Indicates that the telescope is already OFF the
source.
C.68.13 TCAL /OTF
Internal use only. Keeps the OTF map grid from being erased when a tem-
perature calibration scan is taken.
C.69 TERTIARY
[UIP\]TERTIARY /SIDECAB
[UIP\]TERTIARY /NASMYTH2
[UIP\]TERTIARY /CASSEGRAIN | /STOW
[UIP\]TERTIARY
Moves the tertiary mirrors to one of the pre‐configured positions. If
no option is specified, it prints the current status of the tertiary
mirrors.
C.69.1 TERTIARY /SIDECAB
Configures the tertiary mirrors for the Side Cabin receivers.
C.69.2 TERTIARY /NASMYTH2
Configures the tertiary mirrors for the instruments at the second Nas-
myth focus.
C.69.3 TERTIARY /CASSEGRAIN
Configures the tertiary mirrors for the instruments at the Cassegrain
focus.
C.69.4 TERTIARY /STOW
Same as /CASSEGRAIN ‐ configures the tertiary mirrors for the instru-
ments at the Cassegrain focus.
C.70 TEXAS
[UIP\]TEXAS [AZOFF]
[UIP\]TEXAS /DESIGNATED_OFF [NAME]
[UIP\]TEXAS /STOP
Enables switching of the telescope between the source and OFF positions
according to a signal at the digital input 1 of the antenna computer.
The antenna will be moved to the OFF position if the digital input 1 is
low. If the input is high, the offset will be removed.
C.70.1 TEXAS AZOFF
The azimuth offset for the OFF position in arc seconds.
C.70.2 TEXAS /DESIGNATED_OFF
Uses the designated OFF positition instead of the azimuth offset.
C.70.3 TEXAS NAME
The name of the designated OFF position.
C.70.4 TEXAS /STOP
Disables the Texas control of position switching.
C.71 THETA_POSITION
[UIP\]THETA_POSITION [POSITION] [/OFFSET OFFSET] [/SET_OFFSET]
Allows the user to control the rotation of the secondary mirror. If an
absolute position is specified, then auto‐focusing is disabled. An off-
set can also be specified to be added to the stored focus curve.
C.71.1 THETA_POSITION POSITION
If this optional argument is specified, it will be sent to the antenna
computer and used as a fixed THETA position. The antenna computer will
not update the position.
C.71.2 THETA_POSITION /OFFSET
Allows you to specify a fixed offset which will be added to the value
from the focus curve when the antenna computer updates the secondary
position.
C.71.3 THETA_POSITION /SET_OFFSET
This option, which should be used alone, is used to calculate the offset
which should be applied to the focus curve. First one should find the
best THETA position, using the THETA_POSITION command to send the sec-
ondary to specific positions. Then when the focus is good, invoke
THETA_POSITION with this option, and the offset will be calculated.
Then invoke FOCUS with either the /STEALTHY_UPDATES or the /CON-
STANT_UPDATES option to tell the antenna to use the focus curve.
C.72 TILT_CURVE
[UIP\]TILT_CURVE [STEP_SIZE [SETTLE_TIME]] [/FILE_NAME FILE_NAME]
[/RETROGRADE]
Takes the dome for a spin, and reads the tilt meters, generating a curve
of tilt vs azimuth. New tilt meter zeros are determined and sent to the
antenna.
C.72.1 TILT_CURVE STEP_SIZE
How many degrees the dome and antenna are stepped between tilt meter
readings.
C.72.2 TILT_CURVE SETTLE_TIME
Number of seconds to wait for the reading to settle. The values brought
back from the antenna are smoothed values. This necessitates waiting at
each point to allow the average to drift to its proper value.
C.72.3 TILT_CURVE /FILE_NAME
The name of the file to write values into.
C.72.4 TILT_CURVE /RETROGRADE
Normally the curve is taken going from AZ ‐20 to AZ 340. /RETROGRATE
causes the curve to be taken in the reverse direction.
C.73 TOANTENNA
[UIP\]TOANTENNA "MESSAGE"
Sends a text message to the antenna computer.
C.73.1 TOANTENNA MESSAGE
The text to be sent.
C.74 TO_DWNCVTR
[UIP\]TO_DWNCVTR "MESSAGE"
Sends a text message to the down converter process on the backend com-
puter.
C.74.1 TO_DWNCVTR MESSAGE
The text to be sent.
C.75 TO_SPECTROMETER
[UIP\]TO_SPECTROMETER "MESSAGE" [/AOS5] [/FFTS1] [/FFTS2]
Sends a text message to the AOS or FFTS process on the backend computer.
C.75.1 TO_SPECTROMETER MESSAGE
The text to be sent.
C.75.2 TO_SPECTROMETER /AOS5
The message is to be sent to an AOS process which runs the AOS5.
C.75.3 TO_SPECTROMETER /FFTS1
The message is to be sent to a FFTS process which runs the FFTS1.
C.75.4 TO_SPECTROMETER /FFTS2
The message is to be sent to a FFTS process which runs the FFTS2.
C.76 TRACK
[UIP\]TRACK
Causes the telescope to slew to the requested position and then track
that position, adjusting the pointing of the telescope as necessary.
C.77 VERIFY
[UIP\]VERIFY NAME [/NODEFAULT] [/BRIEF | /LONG] [/ALTAZIMUTH] [/ELE-
VATION ELEVATION | /ZENITH_ANGLE ZENITH_ANGLE] [/PARALLACTIC_ANGLE PAR-
ALLACTIC_ANGLE]
[UIP\]VERIFY /LINE LINE_NAME [/NODEFAULT] [/BRIEF | /LONG]
Allows you to inspect entries in either one of the source catalogs, or
one of the spectral line catalogs. Catalogs are searched in the reverse
of the order in which they were opened. Wildcards may be used for the
name. VERIFY will also work on planets, and other Solar system objects
with associated ephemeris files.
C.77.1 VERIFY NAME
The name of the source.
C.77.2 VERIFY /LINE
Tells VERIFY to look in the spectral line catalog, rather than the
source catalog, to find the entry named by the LINE_NAME argument.
C.77.3 VERIFY LINE_NAME
The name of the line.
C.77.4 VERIFY /NODEFAULT
Tells VERIFY not to search the default catalog. This is particularly
useful if you want to get a listing of your personal file, without a
copy of the default catalog appended to the end.
C.77.5 VERIFY /BRIEF
Selects the short form of output. It is automatically selected when
wildcards are used.
C.77.6 VERIFY /LONG
Selects the short form of output. It is automatically selected when
wildcards are not used.
C.77.7 VERIFY /ALTAZIMUTH
Tells VERIFY to display the altitude and azimuth of the source, as well
as the hour angle and parallactic angle.
C.77.8 VERIFY /ELEVATION
Tells VERIFY to calculate the UT at which the source will rise to this
elevation angle, and when it will set below this angle. Specify the
angle in degrees.
C.77.9 VERIFY /ZENITH_ANGLE
Similar to the /ELEVATION option, but the angle is specified in zenith
distance. It can be abbreviated as /ZA.
C.77.10 VERIFY /ZA
C.77.11 VERIFY /PARALLACTIC_ANGLE
Tells VERIFY to calculate the UT at which the source will cross this
parallactic angle. Specify the angle in degrees.
C.78 WEATHER
[UIP\]WEATHER TEMPERATURE HUMIDITY PRESSURE [/AUTOMATIC | /NOAUTO-
MATIC] [/FAHRENHEIT]
Enables the user to send weather parameters to the antenna computer, so
that the refraction corrections can be made accurately.
C.78.1 WEATHER TEMPERATURE
The ambient temperature in degrees Celsius.
C.78.2 WEATHER HUMIDITY
The relative humidity in percents.
C.78.3 WEATHER PRESSURE
The barometric pressure in millibars.
C.78.4 WEATHER /AUTOMATIC
The antenna computer will automatically update the weather using values
from the weather station.
C.78.5 WEATHER /NOAUTOMATIC
The antenna computer will NOT automatically update the weather using
values from the weather station.
C.78.6 WEATHER /FAHRENHEIT
The ambient temperature is taken to be in degrees Fahrenheit.
C.79 X_POSITION
[UIP\]X_POSITION [POSITION] [/OFFSET OFFSET] [/SET_OFFSET]
Allows the user to control the focusing of the secondary mirror, by mov-
ing it perpendicular to the optical axis. If an absolute position is
specified, then auto‐focusing is disabled. An offset can also be speci-
fied to be added to the stored focus curve.
C.79.1 X_POSITION POSITION
If this optional argument is specified, it will be sent to the antenna
computer and used as a fixed X position. The antenna computer will not
update the position.
C.79.2 X_POSITION /OFFSET
Allows you to specify a fixed offset which will be added to the value
from the focus curve when the antenna computer updates the secondary
position.
C.79.3 X_POSITION /SET_OFFSET
This option, which should be used alone, is used to calculate the offset
which should be applied to the focus curve. First one should find the
best X position, using the X_POSITION command to send the secondary to
specific positions. Then when the focus is good, invoke X_POSITION with
this option, and the offset will be calculated. Then invoke FOCUS with
either the /STEALTHY_UPDATES or the /CONSTANT_UPDATES option to tell the
antenna to use the focus curve.
C.80 Y_POSITION
[UIP\]Y_POSITION [POSITION] [/OFFSET OFFSET] [/SET_OFFSET]
Allows the user to control the focusing of the secondary mirror, by mov-
ing it perpendicular to the optical axis. If an absolute position is
specified, then auto‐focusing is disabled. An offset can also be speci-
fied to be added to the stored focus curve.
C.80.1 Y_POSITION POSITION
If this optional argument is specified, it will be sent to the antenna
computer and used as a fixed Y position. The antenna computer will not
update the position.
C.80.2 Y_POSITION /OFFSET
Allows you to specify a fixed offset which will be added to the value
from the focus curve when the antenna computer updates the secondary
position.
C.80.3 Y_POSITION /SET_OFFSET
This option, which should be used alone, is used to calculate the offset
which should be applied to the focus curve. First one should find the
best Y position, using the Y_POSITION command to send the secondary to
specific positions. Then when the focus is good, invoke Y_POSITION with
this option, and the offset will be calculated. Then invoke FOCUS with
either the /STEALTHY_UPDATES or the /CONSTANT_UPDATES option to tell the
antenna to use the focus curve.
C.81 ZA
[UIP\]ZA [ANGLE]
Sends a new zenith distance to the antenna computer. The command ZA
automatically selects altazimuthal coordinates.
C.81.1 ZA ANGLE
The new zenith distance to be sent to the antenna computer.
C.82 ZAO
[UIP\]ZAO [OFFSET] [/FIXED FIXED_OFFSET] [/MAPPING MAPPING_OFFSET]
[/FIELD FIELD_OFFSET]
[UIP\]ZAO [/FIXED | /MAPPING | /FIELD]
Sends a new zenith distance offset to the antenna computer.
C.82.1 ZAO OFFSET
The new zenith distance offset in arc seconds.
C.82.2 ZAO /FIXED
Modifies or prints the fixed offset.
C.82.3 ZAO FIXED_OFFSET
The new fixed zenith distance offset in arc seconds.
C.82.4 ZAO /MAPPING
Modifies or prints the mapping offset.
C.82.5 ZAO MAPPING_OFFSET
The new mapping zenith distance offset in arc seconds.
C.82.6 ZAO /FIELD
Modifies or prints the field offset.
C.82.7 ZAO FIELD_OFFSET
The new field zenith distance offset in arc seconds.
File translated from
TEX
by
TTH,
version 4.03.
On 21 Feb 2012, 13:20.