STANCAM SEQUENCER Command Reference
STANCAM CCD commands (stancam.command in scripts)
(if used with option "-d" extended
debugging information is written to the log):
- teloffset n m
Offsets an object on the
CCD in the X,Y direction by the amount n in the X
direction and m in the Y direction. N,m is given in arcseconds
.
- abort [-d]
Aborts an ongoing exposure (see also expose).
- addtime [-d] nn
Adds 'nn' seconds to an ongoing exposure
(note that 'nn' can be negative too).
- ampl [-d] x
Sets the active amplifier to x. Only 'A' is
a valid value as it is the only amplifier that can be used.
- autosave_off [-d]
Turns off autosave.
- autosave_on [-d]
Turns on autosave.
- bin [-d] n
Stes the binning factor in both X and Y
directions to n.
- beep_on [-d]
Turns on beeps after readout ends. This
is the default when the observing system starts.
- beep_off [-d]
Turns off beeps after readout ends.
- xbin [-d] n
Sets the binning factor in the X direction
to n.
- ybin [-d] n
Sets the binning factor in the Y direction
to n.
- comment [-d] text
Sets the value of the FITS keyword COMMENT
to "text".
If the text contains spaces it MUST be quoted with double
quotes (like this: "text"). Will be cleared after each image.
- comment1 [-d] text
Sets the value of the FITS keyword COMMENT
to "text".
If the text contains spaces it MUST be quoted with double
quotes (like this: "text").
Will not be cleared after each image.
- dark [-d][-t][-f] tt
Makes an dark exposure of tt seconds.
To abort the exposure press "Control-C".
If the '-f' option is used, the command will finish (i.e. the prompt
return) when the exposure is finished and the readout begins.
If the '-t' option is used, a simulated exposure is made. This is
usefull for script testing.
- expose [-d][-t] [-f] tt
Makes an exposure of tt seconds.
To abort the exposure press "Control-C".
If the '-f' option is used, the command will finish (i.e. the prompt
return) when the exposure is finished and the readout begins.
If the exposure time is larger than 300 seconds, the time left until
the rotator reaches its limit will be checked. If there is not time
enough to complete the exposure, an error will be generated and the exposure will not start.
If the '-t' option is used, a simulated exposure is made.
This is usefull for script testing.
- stancam.exit [-d]
Exits the STANCAM BIAS program.
Do not type "exit" as this will close the xterm.
- filename [-d] nn
Sets the default filename to nn.
Has to be 4 characters.
- filenamestd [-d]
Sets the filename back to the default filename.
- filter [-d] n
Selects the CCD (StanCam) filter slot "n". Note that
this command is identical to 'tcs.ccd-filter'.
- ccd-filter [-d] n
Selects the CCD (StanCam) filter slot "n". Note that
this command is identical to 'tcs.ccd-filter'.
- focusexpose [-d] nnnnn mm tt]
Makes a focus exposure. 'nnnnn' is the
focus start value, 'mm' is the focus step size between sub-exposures and
'tt' is the exposure time for each of the sub-exposures. 5 sub-exposures
will be made.
- focus [-d] [-s <nn>] [-a <mode>] [-t <nn>] [-nodefault]
Top level STANCAM focus script that
will slew the telecope to an appropiate focus field, execute the focusexpose command (see above), analyze
the focus image to find optimal focus and adjust the telescope focus accordingly. Found focus will be used
in subsequent setup-tel-stancam commands. Optional parameters:
[-s <nn>] Telescope-focus step size, for the 5 individual exposures. Default is 70.
[-a <mode>]: Acquisition mode. <mode> can be:
- noacq: Use current pointing for focusing.
- nearest: Use nearest focus field from current pointing.
- optimal: Use nearest focus field between 60-70 degrees altitude (default)
[-t <nn>] Expose <nn> seconds. Default is 10.
[-nodefault]: Use the actual focus, rather than default focus, as central focus value for the 5 focus steps.
Focus is always determined with the R filter in the beam (R_Bes 641_148)
- gainhi [-d]
Sets the gain mode to high gain.
- gainho [-d]
Sets the gain mode to low gain.
- impath [-d] text
Sets the path of the image
saving to nn.
- imtype [-d] text
Sets the value of the FITS keyword IMAGETYP
to "text".
- mdark [-d] [-t] [-f] tt nn
Makes nn dark exposure of tt seconds. To abort
the exposures press "Control-C". The image type (IMTYPE keyword) will be
set to "DARK" if the exposure time is non-zero and "BIAS" if it is
zero.
If the '-f' option is used, the command will finish (i.e. the prompt
return) when the exposure is finished and the readout begins.
If used with the "-t" option, the exposure will only be
simulated. This is usefull for testing scripts.
- mexpose [-d] [-t] [-f] tt nn [imtype]
Makes nn exposures of tt seconds. To abort
the exposures press "Control-C". The 'imtype' option (IMTYPE keyword) is
optional and must be a text string without spaces. The IMTYPE is kept
over the multiple exposures and is only cleared after the last.
If the '-f' option is used, the command will finish (i.e. the prompt
return) when the exposure is finished and the readout begins.
If used with the "-t" option, the exposure will only be
simulated. This is usefull for testing scripts.
- object [-d] text
Sets the value of the FITS keyword OBJECT
to "text".
- clearobject [-d]
Clears the value of the FITS keyword
OBJECT.
- observer [-d] text
Sets the value of the FITS keyword OBSERVER
to "text".
- rempath [-d] nn
Sets the remote saving path to nn.
- remsystem [-d] nn
Sets the remote host computer to nn.
- remsave_off [-d]
Turns off remote saving.
- remsave_on [-d]
Turns on remote saving.
- readout [-d]
Closes the shutter and reads out the ccd.
You have to put the exposure in the background first.
- resetxy [-d]
Resets the ccd binning to 1, the X and Y sixe
to maximum and the X and Y beginning to 1.
- save [-d]
Saves an read-out image to disk.
- xbeg [-d] nn
Sets the X beginning to nn.
- ybeg [-d] nn
Sets the Y beginning to nn.
- xbin [-d] n
Sets the binning factor in the X direction
to n.
- ybin [-d] n
Sets the binning factor in the Y direction
to n.
- xsize [-d] nn
Sets the X size to nn.
- ysize [-d] nn
Sets the Y size to nn.
- sethi [-d] nn
Sets highcut to nn.
- setlow [-d] nn
Sets lowcut to nn.
Staff-only commands
|
