FIES SEQUENCER Command Reference

• 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 xx yy|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 xx yy: Moves slide to encoder positions xx yy
  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
• etalon-shutter [open|close|info]
  Command to control the etalon-shutter unit.
  info: Get information on current position
  open: Move slide to first open position
  close: Home slide to close position

• 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.

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][-n] 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.

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

• 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.
• expmstopcount
  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.
• expmresetcount
  Resets the counting that has been started using the command 'expcount', to zero. The counting will continue.
• fies.expmservers-restart
  Restart the FIES expmeter server programs. This may be necessary if the exposure meter is not counting when it should.
  The restarting of the servers may take up to 45 seconds. Regarding the exposure-meter servers, this command is equivalent to restarting the obssystem.
  Note that the exposuremeter will not automatically count after restarting the servers, it has to be commanded to start counting (again), e.g. with the expmcount command above.

• 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.
• 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.