OSIRIS user script lgdither

lgdither --

NAME

lgdither --
dither filename [scaleX [scaleY]] [n=Nexp] [laser=/-1/0/1]

takes a series of exposures at different telescope positions.
Objects in the field will appear shifted by the amounts specified
in the dither pattern file "filename", with the moves scaled by
the optional arguments "scaleX" and "scaleY".

The optional "n=Nexp" argument allows Nexp exposures to be taken
at each dither position. (Nexp = 1 by default.) Note that this
argument can be positioned anywhere in the argument list.

The dither file must be set up as follows:

first line contains one of: "absolute" or "relative", specifying
whether the moves are absolute, (0,0) being the starting position
of the telescope, or relative to the previous position.
NOTE THAT THE FIRST (x,y) PAIR GIVEN WILL BE THE POSITION OF THE
FIRST IMAGE. The first image is hence only taken at the starting
position if 0 0 is specified as the first position.
NOTE ALSO THAT THE TELESCOPE WILL ALWAYS BE MOVED BACK TO ITS
ORIGINAL POSITION. It does this using the mark and gomark commands.

second line contains one of: "pixel" or "arcsec", specifying
whether the offsets are in pixels or arcsec.

subsequent lines should have pairs of numbers, corresponding to the
desired positions of the objects on the image.

Example:

absolute
arcsec
0 0
0 5.5
5.5 0
5.5 5.5

This six-line file will move in a 5.5 arcsec square with the starting
position at one corner. Four images will be taken.

NOTE: some dither patterns are in arbitrary units, and really are meant
to be scaled by some user-specified "step size". Generally the step
size you will see if you forget to scale is 1 arcsec.

History:
20?? Original version
2010-may-03 MK Mods: 1) added motchill and wfao right before dithers start
2) call xy with -s option to skip wfao check
3) call goi with -s option to skip motchill
2011-May-4 MK Added -w flag to goi commands. See goi script for details.
2018-Sep-29 CAAI Remove control of the LBWFS
2018-Sep-30 CAAI Undo remove control of the LBWFS
2019-May-08 jlyke Adapt for OSIRIS imager
2020-Jul-05 jlyke Add setting of dither offset keywords
#-------------------------------------------------------------------------
Boiler plate for "-h" support for command autohelp.
Now make sure we have all of the parameters.
Set global dither keywords
Dump the file contents into "argList".
Done checking first two lines.
check AO observing mode
echo "AO operation mode: " $aoopsmode
echo "Laser mode is : " $laser

set dither parameters for FSM, TSS and Laser M3
inform operator on observing time

if AO OPS mode = 0 (full NGS)
there is no laser
we do not use the TSS
- we force the laser not to move
- we force TSS not to move
- we calculate and print the observing efficiency
if AO OPS mode = 1 (NGS with TSS)
there is no laser
we use TSS
- we force the laser not to move
- we force TSS to move
- we calculate and print the observing efficiency
- we set the LBWFS looping parameters
if AO OPS mode = 2 (LGS with TSS)
there is a laser
we use TSS
- we check the laser= value
if laser= was in the command line,
we set laser move accordingly
else if leave it as it is
- we force TSS to move
- we calculate and print the observing efficiency
- we set the LBWFS looping parameters
setlbwfstime n=$Nexp
for daytime testing of the script, uncomment
exit 1
ensure we have the imager focus
check that AO system is ready
reset the old offset values
set error = $status
if ($error != 0) then
osirisScriptMsg -t $idnum -T -W "${cmd}: There was a problem setting"\
"the dither offset keywords (dtotoff and dlstoff) in the FITS"\
"headers. They may be incorrect for position ${scount} of"\
"dataset #${setnum}."
endif
modify -s osiris scriptrun=0
if ($aoopsmode == "2") then
endif

lgdither --

NAME

See Also