NOTcam SEQUENCER Command Reference
NOTcam Commands
BIAS Commands
Postprocess Commands
Auxiliary Commands
NOTcam spectrograph commands (notcam.command in scripts) (if used with option "-d"
extended debugging information is written to the log):
All these commands will actively check that the element has arrived at the
requested position. If not, an error will be written to the Talker log and the
command sets the return code to a non-zero number.
- aperture [-d] n
Move aperture wheel to slot no. 'n', where 'n' is [1-12]
- filter1 [-d] n
Move filter wheel no. 1 to slot no. 'n', where 'n' is [1-16]
- filter2 [-d] n
Move filter wheel no. 2 to slot no. 'n', where 'n' is [1-16]
- stop [-d] n
Move stop wheel to slot no. 'n', where 'n' is [1-16]
- grism [-d] n
Move grism wheel to slot no. 'n', where 'n' is [1-16]
- lens [-d] n
Move lens wheel to slot no. 'n', where 'n' is [1-6]
- notcamfocus [-d] n
Move NOTcam internal focus to step pos. 'n', where 'n' is [0-6100].
Reserved for staff use only.
NOTcam array commands (notcam.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]
The command has been discarded because the detector controller
cannot abort an exposure properly. The user should use "Ctrl-C"
to abort any script and then wait for the on-going (multi)exposure
to finish.
- autosave_off [-d]
Turns off autosave.
- autosave_on [-d]
Turns on autosave.
- 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] tt
Makes an dark exposure of tt seconds.
The ongoing exposure cannot be aborted.
Please wait until it finishes. The 'IMTYPE' keyword is set to 'DARK.
If the '-t' option is used, a
simulated exposure is made. This is usefull for script testing.
- expose [-d][-t] tt
Makes an exposure of tt seconds. The timing
is controlled by the shutter.
The ongoing exposure cannot be aborted.
Please wait until it finishes. If the '-t' option is used, a
simulated exposure is made. This is usefull for script testing.
- frames [-d][-t] tt n
Uses the ramp-sampling readout mode. Makes an integration of tt*n seconds where the array is read out non-destructively n times separated by t seconds. The integration time is not controlled by the shutter, but by the difference between last and first reads.
The ongoing exposure cannot be aborted.
Please wait until it finishes. If the '-t' option is used, a
simulated exposure is made. This is usefull for script testing.
- dframes [-d][-t] tt n
This command is used to take darks using the ramp-sampling readout mode. Works otherwise as frames above.
The ongoing exposure cannot be aborted.
Please wait until it finishes. The 'IMTYPE' keyword is set to 'DARK.
If the '-t' option is used, a
simulated exposure is made. This is usefull for script testing.
- clear [-d]
Clears the NOTcam array.
- notcam.exit [-d]
Exits the NOTcam 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.
- 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 [-t] 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 used with the "-t" option, the exposure will only be
simulated. This is usefull for testing scripts.
- mexpose [-t] 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.
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".
- piname [-d] text
Sets the value of the FITS keyword PINAME
to "text".
- propid [-d] text
Sets the value of the FITS keyword PROPID
to "text".
- proptitl [-d] text
Sets the value of the FITS keyword PROPTITL
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.
- save [-d]
Saves an read-out image to disk.
- sethi [-d] nn
Sets highcut to nn.
- setlow [-d] nn
Sets lowcut to nn.
TCS commands (if used with option "-d" extended debugging information
is written to the log):
Note that the commands below are not needed for normal use, but can be
practical for more advanced use.
NOTcam aux. commands (notcam.command in scripts) (if used with option "-d"
extended debugging information is written to the log):
- wait_notcam_ready [-d]
This command waits until all of the following items are ready (i.e.
not moving) :
aperture, filter1, filter2, stopm, grism, lens and NOTcam focus
- wait-shutter-closed
Waits for the shutter of NOTCam to be closed.
- aperture [-d] pos
Returns the slot position (1-12) of the element in the light path.
- aperture [-d] step
Returns the step position (0-112500) of the element in the light path.
- aperture [-d] name
Returns the name of the element in the light path.
- aperture [-d] id
Returns the NOT ID of the element in the light path.
- aperture [-d] ready
Returns '0' if the element is moving. '1' if it is ready
- filter1 [-d] pos
Returns the slot position (1-16) of the element in the light path.
- filter1 [-d] step
Returns the step position (0-112500) of the element in the light path.
- filter1 [-d] name
Returns the name of the element in the light path.
- filter1 [-d] id
Returns the NOT ID of the element in the light path.
- filter1 [-d] ready
Returns '0' if the element is moving. '1' if it is ready
- filter2 [-d] pos
Returns the slot position (1-16) of the element in the light path.
- filter2 [-d] step
Returns the step position (0-112500) of the element in the light path.
- filter2 [-d] name
Returns the name of the element in the light path.
- filter2 [-d] id
Returns the NOT ID of the element in the light path.
- filter2 [-d] ready
Returns '0' if the element is moving. '1' if it is ready
- stop [-d] pos
Returns the slot position (1-16) of the element in the light path.
- stop [-d] step
Returns the step position (0-112500) of the element in the light path.
- stop [-d] name
Returns the name of the element in the light path.
- stop [-d] ready
Returns '0' if the element is moving. '1' if it is ready
- grism [-d] pos
Returns the slot position (1-16) of the element in the light path.
- grism [-d] step
Returns the step position (0-112500) of the element in the light path.
- grism [-d] name
Returns the name of the element in the light path.
- grism [-d] ready
Returns '0' if the element is moving. '1' if it is ready
- lens [-d] pos
Returns the slot position (1-6) of the element in the light path.
- lens [-d] step
Returns the step position (0-112500) of the element in the light path.
- lens [-d] name
Returns the name of the element in the light path.
- lens [-d] ready
Returns '0' if the element is moving. '1' if it is ready
- notcamfocus [-d] ready
Returns '0' if the element is moving. '1' if it is ready
- notcamfocus [-d] step
Returns the step position (0-6100) of the of the NOTcam internal focus.
|