Search
Text Size:
Smaller Text Normal Text Larger Text

Facebook

Follow us on Twitter

FIES SEQUENCER Command Reference


FIES Instrument commands (fies.command in scripts)
(if used with option "-d" extended debugging information is written to the log):

  • calshutter [-d] nn|'open'|'close'
    Opens the calibration fiber shutter for nn deciseconds. For example 'calshut 50' opens the calibration shutter for 5 seconds.
    If used with the argument 'open' the shutter is opened and if used with 'close' the shutter is closed.
  • fiesfocus [-d] nn   Staff only !
    Moves the internal spectrograph focus to position nn.
  • lamp n 'on'|'off'
    Turns calibration lamp number n on or off. Lamps 1-4 are located at the spectrograph and connected via a fiber and the calshutter to the spectrograph. Lamps 6 and 7 are located at the fiberhead.
    lamp 1 Bottom calib-unit Halogen     Fiber #5
    lamp 4     Bottom calib-unit ThAr     Fiber #5
    lamp 6 Top calib-unit Halogen     Fibers #1-#4
    lamp 7 Top calib-unit ThAr     Fibers #1-#4
  • calmove nn
    Moves the lamp selector to calibration lamp 1-4. Not relevant for lamp 6 and 7.
  • arm [nn|goto nn|gophy nn|ppos|pos|init|info]
    Low level command to control the fiberhead FIES XY slide.
    info : Get information on available positions
    nn or goto nn: Moves slide to indexed position nn
    gophy nn: Moves slide to encoder position nn
    pos: Get current indexed position
    ppos: Get current encoder position
    init: Initialize the XY slide. UNSTABLE
  • mask [nn|goto nn|gophy nn|ppos|pos|init|info]
    Low level command to control the fiberhead rotary mask unit.
    info : Get information on available positions
    nn or goto nn: Moves mask to indexed position nn
    gophy nn: Moves mask to encoder position nn
    pos: Get current indexed position
    ppos: Get current encoder position
    init: Initialize the mask unit. UNSTABLE

FIES CCD commands (fies.command in scripts)
(if used with option "-d" extended debugging information is written to the log):

  • 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. Valid values are A, B, AB, C, BC, D, AD, CD and DEFAULT
  • autosave_on [-d]
    Turns on autosave.
  • autoshow_on [-d]
    Turns on the DS9 image preview. The DS9 window used to display the image on readout will appear.
  • autoshow_off [-d]
    Turns off the DS9 image preview. The DS9 window used to display the image on readout will be closed.
  • bin [-d] n
    Stes the binning factor in both X and Y directions to n.
  • 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.
  • dark [-d][-t][-f] tt
    Makes an dark exposure of tt seconds. Remnant removal will be done before the exposure starts. 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 '-n' option is used, no remnant removal is done.
    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. Remnant removal will be done before the exposure starts. 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 '-n' option is used, no remnant removal is done.
    If the '-t' option is used, a simulated exposure is made. This is usefull for script testing.
  • exp-count [-d][-t][-m][-f][-n] wanted-count max-tint
    Makes an exposure of 'max-tint' seconds, counting with the exposure meter. Remnant removal will be done before the exposure starts. When 'wanted-count' has been reached the exposure will end and the image is read out. If 'wanted-count' has not been reached in 'max-tint' seconds the exposure will end and the image is read out.

    If the image is forcefully read out, using the commands "addtime -n" (negative number as argument) and "readout" the exposuremeter has to be stopped manually with the command "fies.expmstopcount".

    Maximum value of 'wanted-count' is 1.7E308, but the underlying exposure meter system only counts to a maximum of 2147483647 (as can be seen from the messages logged in the talker log).

    Options are:

    -d: Debug information on.

    -t: Test mode on. No real action is taken. Usefull for testing scripts.

    -m: The "wanted-count" argument is specified in millions. This can be a fractional decimal between 0 and 300.

    -f: Fast mode on. The prompt will be returned when the exposure time is over and before the readout begins.

    -n: No remnant cleaning. Do NOT clean remnants before the exposure.

  • 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. Remnant removal will be done before each sub-exposure. 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 the '-n' option is used, no remnant removal is done.
    If the '-t' option is used, a simulated exposure is made. This is usefull for script testing.
  • mexpose [-d][-t][-f] tt nn [imtype]
    Makes nn exposures of tt seconds. Remnant removal will be done before each sub-exposure. To abort the exposures press "Control-C".The 'imtype' option (IMTYPE keyword) is optional and must be a text string without spaces.
    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 '-n' option is used, no remnant removal is done.
    If the '-t' option is used, a simulated exposure is made. This is usefull for script testing.
  • 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".
  • 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.
  • filenamestd [-d]
    Sets the filename back to the default filename.
  • 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.
  • 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.
  • remove_remnants [-d]
    Remove remnants from the CCD.
  • readspeed [-d] readout_speed
    Sets the CCD readout speed to readout_speed kpix/second. Valid values for readout_speed are 100, 200, 400 or 800.

FIES exposure meter commands (fies.command in scripts)
(if used with option "-d" extended debugging information is written to the log):

Be warned that permanent damage to the exposuremeter can occur if operated in strong light conditions (i.e. lights on in the FIES room)!!

  • exp-count [-d][-t][-m][-f] wanted-count max-tint
    Makes an exposure of 'max-tint' seconds, counting with the exposure meter. When 'wanted-count' has been reached the exposure will end and the image is read out. If 'wanted-count' has not been reached in 'max-tint' seconds the exposure will end and the image is read out.

    If the image is forcefully read out, using the commands "addtime -n" (negative number as argument) and "readout" the exposuremeter has to be stopped manually with the command "fies.expmstopcount".

    Options are:

    -d: Debug information on.

    -t: Test mode on. No real action is taken. Usefull for testing scripts.

    -m: The "wanted-count" argument is specified in millions. This can be a fractional decimal between 0 and 300.

    -f: Fast mode on. The prompt will be returned when the exposure time is over and before the readout begins.


  • expmcount [-d] counts-wanted max-tint
    Start counting with the exposuremeter. The exposuremeter shutter will open and the counting will continue until either 'counts-wanted' or 'max-tint' are reached. Then the exposuremeter shutter is closed.
  • expmdark [-d] tint
    Make a dark integration of 'tint' seconds with the exposure meter.
  • expmexpose [-d] tint
    The exposuremeter shutter will open. Starts counting with the exposuremeter, and makes an exposure of 'tint' seconds. Then the exposuremeter shutter is closed.
  • expmshutter [-d] [open|close|tint]
    Control the exposure meter shutter. 'open' opens it, 'close' closes it and 'tint' specifies an opening time in seconds.
  • expmstopcount [-d]
    Stops the counting that has been started using the commands 'exp-count', 'expmcount', 'expmdark' or 'expmexpose', as if the timer/counter has reached its originally requested limit.

  • expmclose [-d]
    Closes the exposure meter down to a secure state.
  • expmpower [-d] [on|off]   Engineering only !
    Turns the power to the PMT on or off.
  • expmenable [-d] [on|off]   Engineering only !
    Enable ('on') or disable ('off') the exposure meter.
  • expmstop [-d]   Engineering only !
    Close down the 'eserver' program and exit.

Back to top Last modified: 20-Jul-2017