next up previous contents index
Next: Observing Modes Up: OBS E A User's Previous: Catalogs

Special VERBS and ADVERBS

  There are ADVERBS that have no reference to or from a verb. One can list their related parameters with the SHOW command followed by the adverbs name. If one uses the SET_DEFAULT command with one of these ADVERBS name (and provide some parameters), a SIC command file is executed which updates parameters of other adverbs or parameters in the passive option field. The default values of some of the adverbs are SAVEd and the appropriate action is re-executed in RESTORE.

These adverbs are used for passing parameters that do not relate to a specific observing command, like the change of an operator or an update of manual input for the ambient temperature or pressure.

SET_DEFAULT OPERATOR
   < operator > < observer > < project-ID >
four characters are used for operator's and observer's names, six for the project identification
EXAMPLE:
SET_DEFAULT OPERATOR * * PROJCT
changes the project identification to PROJCT, starting with the next observation
SET_DEFAULT AMBIENT
   < temperature > < pressure > < humidity > < use station >
If < use station > is set to NO, the observer can enter values for temperature, pressure and humidity for the calculation of the refractive index. In this case he can update the values individually by typing * for the ones that do not change
EXAMPLE:
SET_DEFAULT AMBIENT 20.0 960 80 NO
uses 20 degrees centigrade, 960 hPa and 80 percent humidity for the calculation of the refraction in the pointing model.
SET_DEFAULT AMBIENT * * 70
now uses 20 degrees centigrade, 960 hPa and 70 percent humidity for the calculation of the refraction in the pointing model. The fourth parameter, < use station > , remains unchanged (NO).
Any other input for < use station > defaults to use the values from the weather station to calculate the refractive index.
A different application of these separate adverbs arises in the attempt to make the commands compatible with the standard IRAM OBS commands. There, the commands for PSWITCH and PRASTER (and CONOFF) use the same definition of the reference positions. Similarly FSWITCH and FRASTER should have the same definition of the frequency switching parameters. In order to transfer these parameters to all relevant verbs with one command, there exist two special adverbs, REF_POS and REF_FRQ.
SET_DEFAULT REF_POS
< ref_long > < ref_lat > < ref_sys > < ref_orig >
  For a definition of the parameters see the CONOFF, PRASTER and PSWITCH description of section 9.9. The SET REF_POS command sets the default values for all three procedures, current values used in a command will overwrite the default values for the one execution of the observing command.
EXAMPLE:
SET_DEFAULT REF_POS 200 -20 LAM ORIGIN
will select an OFF (the reference) position shifted by 200" / cos(latitude) and -20" of the origin as defined by the source longitude and latitude.
PRASTER
will set up the observation with this reference position.
PRASTER * * * NO
will set up the observation with a reference relative to the raster position. The value for < ref_orig > is a current value and used only in this observation
PRASTER or also CONOFF
will set up the observation relative to the source position again.
SET_DEFAULT REF_FRQ
   < delta_f > < switch_mode >
For a definition of the frequency switching parameters see the FRASTER and
FSWITCH description of section 9.9. The SET REF_FRQ command sets the default values for both procedures, current values used in a command will overwrite the default values for the one execution of the observing command.

Normally observations (except a calibration procedure) are shifted by offsets, defined by the SET_DEFAULT OFFSETS command. This shift of the field center can be suppressed by adding the ADVERB /NOOFFSET to the observing command. More details one can find in section 9.1.

SET_DEFAULT OFFSETS
< off_lon > < off_lat > < ofc2 > < off_sys > < ref_radvel >
< off_lon > and < off_lat >
are offsets in true angle in longitude and latitude. The basis system for the offset coordinates is defined by < off_sys > .
< ofc2 >
is an additional offset to the axial focus in mm.
< off_sys >
The coordinate system for the offsets can be specified either in the source coordinate system and epoch of the catalog (possibly rotated if a descriptive system is used), or in the horizontal system of azimut/elevation. The first two characters of < off_sys > are tested to define the observing system.
< ref_radvel >
Per default the calculation of the radial velocity is made for the ON- and the OFF-measurement independently, if nothing is specified. For O(n) the raster ON-point is the reference for calculating the radial velocity, but for C(enter) the map-center (i.e. the source-position) is the reference-point for the radial velocity calculation (For detailed information, see section 9.1).

As mentioned before the TOOLBOX- and the CLASS-software packages are used to graphically display the measured data on an on-line display. They also create temporary files for the off-line data reduction at the telescope site. These outputs are controlled by the OBSERVE-process via mailboxes in the (VAX-)VMS system environment. Sometimes it may be useful for the observer to control the on-line display, or the outputs these packages produce, differently from the on-line display tasks. Therefore the following verbs have been created. They directly send a parameter string to the on-line software packages (TOOLBOX or CLASS) via the mailboxes. That can be a single command or for example the command to read a file with special commands for the reduction. There exist three independent mailboxes for the three programs CONT2 (continuum), SPEC2 (line) and EFF+CLASS (line), which are controlled by OBSERVE.

MBTOOL
< string >
  sends the command-string < string > to the on-line data reduction program cont2 of the TOOLBOX. The cont2-program is responsible for the data reduction of continuum-data monitored by the 80-channel continuumbackend.
MBSPEC
< string >
  sends the command-string < string > to the on-line data reduction program spec2 of the TOOLBOX. The spec2-program reduces and displays the spectral data taken by the 1024-channel autocorrelator.
MBCLAS
< string >
  sends the command-string < string > to the on-line data reduction program EFF and CLASS. These programs can reduce and display continuum and spectral-line data to produce an output compatible to the CLASS data structure.
These strings send to the programs are interpreted, as if they were put in via the keyboard of a normal terminal, where the cont2-, spec2- or EFF-program is running.


next up previous contents index
Next: Observing Modes Up: OBS E A User's Previous: Catalogs
Juergen Neidhoefer
12/22/1997