Search
Text Size:
Smaller Text Normal Text Larger Text

Facebook page

Twitter profile

YouTube channel

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.


Back to top Last modified: December 12 2022