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
  Moves the calibration lamp arm to fiber nn. Valid arm positions can be seen by pressing 'Ctrl-P' in the FIES status display.
• mask nn
  Moves the fiber mask to position nn. Valid fiber mask positions can be seen by pressing 'Ctrl-P' in the FIES status display. This is an alias for the command called 'fiber'.
• init
  Initializes the arm and fiber mask in the fiberhead. Use this command if you are uncertain about the positions of these elements.

• 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, AC.
• 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.
• 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". Will be cleared after each image.
• comment1 [-d] text
  Sets the value of the FITS keyword COMMENT to "text". Will not be cleared after each image.
• dark [-d][-t] tt
  Makes an dark exposure of tt seconds. To abort the exposure press "Control-C".If the '-t' option is used, a simulated exposure is made. This is usefull for script testing.
• fies.exit [-d]
  Exits the STANCAM BIAS program.
• expose [-d][-t] tt
  Makes an exposure of tt seconds. To abort the exposure press "Control-C".If the '-t' option is used, a simulated exposure is made. This is usefull for script testing.
• 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".

  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.

• gainhi [-d]
  Sets the gain mode to high gain.
• gainho [-d]
  Sets the gain mode to low gain.
• imtype [-d] text
  Sets the value of the FITS keyword IMAGETYP to "text".
• mdark [-d] 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.
• mexpose [-d] 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.
• 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".
• 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.
• wait-camera-state idle|integrating|readout|pending
  The command waits until the CCD camera is in the requested state.
• 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.
• seth [-d] nn
  Sets highcut to nn.
• setl [-d] nn
  Sets lowcut 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.

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.