This is a list of all available user commands as of November 2, 2004 by Heidy Moreno ( ).
A full list including engineering commands can be found in the internal section.

Mechanism commands and monitoring GUI
Thermal commands
Thermal monitoring GUI
Lamps commands
Lamps monitoring GUI
LIRIS Real Time Display (UDASRTD)
Imaging scripts
Spectroscopy scripts
Acquisition scripts
Other scripts
UltraDAS commands
Telescope remote control commands
Diagnostic commands

Starts the LIRIS Mechanisms Monitoring GUI.
It should be noted that this command expects the EPICS environment to be correctly set.

[ag_]mdither <ndit> <exp_time> [title] [-ncyc=int] [-nruns=int] [-xoffset=int] [-yoffset=int] [-jitter=float] [-clean]

Default values for command-options:

nruns=1, ncyc=1, xoffset=12 arcsec, yoffset = 12 arcsec, jitter= 0.0,

Use –clean to discard the first 3 images before runs.

Repeats a dither pattern <ncyc> times using a jitter box to randomly generate new TCS offsets. Scripts prefixed 'ag_' perform telescope guiding at each dither point. ndit indicates how many dither points are used.

The [-nruns=int] command-option indicates if a multrun or a single run command is going to be used for the data acquisition at each dither point. If the [-jitter=float] command-option is given, the different ditter points will be randomly generated to lie in a box of "jitter" size.

The basic telescope move patterns are 2, 3, 4, 5, 8 and 9 point patterns. Scripts always start and end with the telescope at the same point in space, at the centre of the pattern.

For ndit = 3, 5 and 9 the data acquisition positions are as follows:

                               3                             3         4                         4   5   6
                        1                                         1                               3   1   7
                 2                                          2         5                          2   9   8

For ndit = 2, 4, and 8 the acquisition at the central position is dropped. Thus:

                            2                               2        3                            3    4    5
                                                                                                    2          6
                     1                                      1        4                            1    8    7

[ag_]mdither_ext  <ndit> <exp_time> <sky_offset> <pa_offset> [title] [-nruns=int] [-xoffset=int]

 [ncyc=int] [-yoffset=int] [-jitter=float] [-clean]

Default values for command-options:

nruns=1, xoffset=12 arcsec, yoffset = 12 arcsec, jitter= 0.0,

Use –clean to discard the first 3 images before runs.

Alternatively switches between the object and the sky positions taking at both points an [ag_]mdither pattern. The starting sky position is given by the "pa_offset" angle and the "sky_offset" distance parameters.

mfiltphot <filter_conf1> <exp_time_1> [ filter_conf1] [exp_time_2] ... [ filter_confN] [exp_time_N] [title][-nruns=int] [-xoffset=int] [-yoffset=int]

Default values for command-options:

nruns = 1, xoffset = 12 arcsec, yoffset = 12 arcsec

Takes a 4 dither pattern for each given filter configuration. Different exposure times may be used for each filter configuration.

mosaic <ncycles> <exp_time> <nptx> <npty> [title] [-nruns=int] [-step= int] [-clean]

Default values for command-options:

nruns = 1, step = 180 arcsec

Use –clean to discard the first 3 images before runs.

Moves the WHT in a (nptx, npty) mosaic pattern using LIRIS to take exposures of type "run" or "multrun" at each point depending on the value of the [-nruns=int] command-option. The pattern is repeated "ncycles" times. The [-step= int] command-option indicates the separation between consecutive points. 

For nptx = 5, npty = 4, the acquisition pattern is as follows:

mdithermosaic <ndither> <exp_time> <nptx> <npty> [title] [-nruns=int] [-step=int] [xoffset=int] [-yoffset=int]
                              [-jitter=float] [-clean]

Default values for command-options:

nruns = 1, step = 180 arcsec, xoffset = 12 arcsec, yoffset = 12 arcsec and jitter = 0.0

Use –clean to discard the first 3 images before runs.

Moves the WHT in a (nptx, npty) mosaic pattern taking a dither<N> pattern at each mosaic point, (same as mosaic pattern, but takes a dither at each point ).

spec_nod  <ncycles> <exp_time> [title] [-nruns=int] [-offset=int] [-jitter=float] [-clean]

Default values for command-options:

nruns=1, offset=12, jitter= 0.0,

Use –clean to discard the first 3 images before runs.

Moves the WHT in a pattern such that the telescope nods the object between two positions (A,B) along the slit. Positions are separated "offset" arc seconds. Assuming the object is centred on the first position A = (0,0) , the first exposure will be just around there and the second exposure will be around B= (0, offset). 

The [-nruns=int] command-option indicates if a multrun or a single run command is going to be used for the data acquisition at each point.  If [-jitter=float] command–option is given, the A and B positions will be randomly generated to lie within a segment that is centred at each position. The dimension of the segment is the given "jitter" value.

If the pattern is to be repeated, the acquisition pattern is as follows:

For "ncycles" = 5,    AB BA AB BA AB.

ag_spec_nod <ncycles> <exp_time> [title] [-nruns=int] [-offset=int] [-jitter=float] [-clean]

Default values for command-options:

nruns=1, offset=12, jitter= 0.0,

Use –clean to discard the first 3 images before runs.

Same as "spec_nod" pattern, but the autoguider is guiding at each point.

ag_spec_nod3 <ncycles> <exp_time> [title] [-nruns=int] [-offset=int] [-jitter=float] [-clean]

Default values for command-options:

nruns=1, offset=12 arcsec, jitter= 0.0,

Use –clean to discard the first 3 images before runs.

Moves the WHT in a pattern such that the telescope nods the object between three positions (B, A, C) along the slit. The A, B and A, C positions are separated "offset" arc seconds. Assuming the object is centred on position A = (0, 0), the first exposure will be just around there, the second exposure will be around B = (0, offset) and the third will be around position C = (0, -offset).

The [-nruns=int] command-option indicates if a multrun or a single run command is going to be used for the data acquisition at each point.  If [-jitter=float] command–option is given, the A,B and C positions will be randomly generated to lie within a segment that is centred at each position. The dimension of the segment is the given "jitter" value.

If the pattern is to be repeated, the acquisition pattern is as follows:

For "ncycles" = 4,    ABC,  ABC, ABC, ABC

ag_spec_ext <ncycles> <exp_time> <sky_offset> [title] [-nruns=int] [-jitter=float] [-invert] [-clean]

Default values for command-options:

nruns =1, jitter= 0.0

Use –invert command-option to reverse offset direction

Use –clean to discard the first 3 images before runs.

Moves the WHT in a pattern such that the telescope switches between the OBJECT and SKY.  Exposures at OBJECT positions are done with the autoguider ON.
If the pattern is to be repeated, the SKY positions are randomly generated to lie on a 15 arcsec segment perpendicular to the slit centred at (sky_offset, 0).

The [-nruns=int] command-option indicates if a multrun or a single run command is going to be used for the data acquisition at each point.  If [-jitter=float] command–option is given, the OBJECT positions will be randomly generated to lie within a segment of "jitter" value size along the direction of the slit.

For "ncycles" = 4,  the acquisition pattern is as follows: 

Obj Sky₁   Obj Sky₂  Obj Sky₃   Obj Sky₄

Example: For "sky_offset" = 30 arcsec and "ncycles" = 3

ag_spec_map <ncycles> <exp_time> <npts> <step> <sky_offset> [title] [-nruns=int] [invert] [-cycle] [-clean]

Default values for command-options:

nruns =1

Use –invert command-option to reverse sky offset direction

Use –cycle to repeat each sequence of OBJn, SKYn

Use –clean to discard the first 3 images before runs.

Moves the WHT in a pattern such that the telescope makes a map switching between OBJECT and SKY positions.  Exposures at OBJECT positions are done with the autoguider ON. 

The [-nruns=int] command-option indicates if a multrun or a single run command is going to be used for the data acquisition at each point. 

Successive OBJECT positions are separated "step" arcs seconds in the direction perpendicular to the slit. SKY positions are taken at a distance of "sky_offset" arc seconds from its corresponding OBJECT pair.

The acquisition pattern will be as follows:

obj₁ sky₁  obj₂ sky₂  obj₃ sky₃ ....... obj_n sky_n

If "-cycles" is given then each objN, skyN pair is repeated, resulting in an acquisition pattern as follows:

obj₁ sky₁  obj₁ sky₁  obj₂ sky₂  obj₂ sky₂  obj₃ sky₃ obj₃ sky_{3 ......} obj_n sky_n obj_n sky_n

lobject_inslit_map <slit ID> <x₁> <y₁> [<x₂> <y₂>..... <x_n> <y_n>]  [-fslitmap=string] [-ncor] [-useioff]

Default Values for command-options:

fslitmap = /wht/var/liris_slitdb_pos.dat

Use –nocor command-option to NOT perform telescope corrections due to flexures.

Use –useioff command-option to activate TCS Yoffset adjustment, otherwise Yoffset is 0.

Centres an object in a given <x,y> position within a slit by adjusting the WHT position.

If more than one x ,y positions are given then a multi slit is assumed.

lpos_mult  <slit position file> <exp_time(s)> <title> [-dbdir=string] [-fcent=string] [-run=int]

Default values for command-options:

dbdir = /wht/var/

fcent = liris_rotcent_pos.dat

nrun = 1

lsleep 

Place LIRIS in sleep mode. Wheels are moved to their "blank" locations. Temperature control loop is turned OFF and all calibration lamps are turned off.

coave liris <Nc>

Under the "user" command LIRIS scripts use the following TCS commands: