ING Banner
Home > Astronomy > ISIS > Cookbook


The ISIS user guide

  1. Preliminaries
  2. Starting up the system
  3. Controlling ISIS mechanisms
  4. ISIS observing commands
  5. Afternoon settings and calibrations
  6. Observing with ISIS
  7. Writing data tapes

1. Preliminaries

1.1 Instrument and telescope control system

As an ISIS observer you will use the following two computers:

  • taurus, from which we run the instrument control system (ICS) and which controls both the instrument and the A&G box mechanisms.
  • whtdrpc1, for other miscellaneous tasks, e.g. to see and examine the data.
In addition there is the telescope control system (TCS) computer.  As its name implies, this controls the telescope which on the WHT is operated solely by the Observing Support Assistant (OSA).

1.2 Preparing the catalogue file

If you are planning to observe many targets, it is recommended to create your own catalogue before your observing run, to avoid coordinates typos and save the time.

  • Write your object list in the format:

    NAME ra(hh mm ss.ss) dec(dd mm ss.ss) equinox

    where NAME can have up to 20 characters and equinox specifies the equinox of the source coordinates ("B1950", "J2000" or "APPARENT").


    Example:

    M33       01 33 51.02  30 39 36.70   J2000
    NGC157    00 32 14.40 -08 40 20.00   B1950
    GJ398.2   10 39 36.74 +43 06 09.25   J2000

  • Save the file with extension .cat (e.g. mylist.cat).

  • Once you are at the telescope, copy mylist.cat onto directory /wht/cat.

  • Tell the telescope operator to include mylist.cat as an user catalogue into the TCS.


Back to the top

2. Starting up the system


2.1 Starting up the observing system

The observing system at taurus should be started in the afternoon and is usually started prior to your run by the operations team. Taurus has three monitors, and there should be several windows open on them:

  • An xterm pink window (labeled "WHTICS"). This is a unix terminal to introduce the UltraDAS commands.
  • A window with the "mimic" display should be open in the left monitor, which by default usually shows a summary of the state of ISIS and A&G Box with a trace of the light path.
  • Several xterm orange windows. This terminals are for the DAS control of the cameras and you do not need to deal with, it is better to minimize them; 
  • An "identify" window. Enter your name and proposal identification at the begining of the night.
  • The observing log. The log is automatically updated each time a new file is written to disk. To put comments on a line click once with the mouse on the line and a box appears where you can type shorts comments.
  • Two detector information displays,  one for the blue and other for the red arm of ISIS (if other cameras are operative, typically the Aux Port, other displays will be open) and one summary detector information display.
  • The "talker" window (it displays messages from the observing system to the user). 
  • If you wish, you can also bring up a telescope info display window. Type:

    TO>tcsinfo&


If this is not the case or something goes wrong with the system ask the TO, the SA or the DE.  (Instructions for starting up and shutting down the observing system can be found here.)


2.2 Starting up a data reduction session

Log on to whtdrpc1, the sparc station dedicated to data reduction (one monitor to the right of taurus):

  • LOGIN: whtguest
  • PASSWORD: provided by your support astronomer. 
  • Open up an xgterm (type xgterm -sb&). 
  • Open up Ximtool (type ximtool&) or ds9 (type ds9&). 
  • Start an IRAF session (type cl, ncl or ecl) from the home directory (/home/whtguest), in the xgterm window. 
  • Change to the disk and directory where the data are going to be stored (e.g. cl>cd /obsdata/whtb/20020407). 
  • Type: cl>ing to initialize ING specific packages (includes routines for checking focus, rotation and tilt of the detectors).

If you plan to reduce your data on the fly please consider that you can't work with the images stored in the /obsdata directory. You can create a directory in the /scratch filesystem (e.g. /scratch/whta/20040110) and copy the images there to proceed.

Back to the top

3. Controlling ISIS mechanisms 

3.1 The MIMIC display

The status of ISIS is displayed in the "mimic"  window.   There are 4 possible displays to select in this window; CAGB1, CAGB2, SUMMARY and AUX.    One simply clicks on the appropriate box with the mouse to select a mode.  The SUMMARY display is the most commonly used and usually the default.  It displays a simplified view of the ISIS instrument components and their status, as well as a schematic of the light path through the instrument  (picture).  The status flags are colour coded, red means there is a problem, blue means that a mechanism is moving, while green means that a mechanism is ok. (Note that  at present each camera shutter's status is red, however in this case this does not denote a fault since the cameras are now controlled from the observing system rather than the ICL system.) Before we are ready to observe with ISIS we must first set up ISIS and window the CCDs to suitable sizes.


3.2  ISIS & AG box common commands

ISIS mechanisms can now controlled from the SUN station and in two different ways: (1) by using the same commands used in the old ICL computer from the "WHTICS" term or (2) by using the GUI. WHTICS is a unix window, thus commands can run in background and can be combined with Ultra-DAS commands to write scripts. The most usual operations the observer will do are:

- Select which arm(s) to observe with  the following commands

    TO> bfold 0      (to observe in the red arm only, dichroic and mirror out of the beam)
    TO> bfold 1      (to observe in the blue arm only, mirror in the beam)
    TO> bfold 2        (to observe in both arms simultaneously, dichroic in the beam)

- Set the gratings to the correct central wavelengths as in the following example
    TO> cenwave blue 4500          (sets the central wavelength in the blue arm to 4500 Å)
    TO> cenwave red 6500              (sets the central wavelength in the red arm to 6500 Å)

- Select the slit width

    TO> slitarc 1.0    (sets slit width to 1.0 arcseconds.  Maximum possible width is 22.0 arcseconds.)

- Select the dekker mask. Note that the long slit module of ISIS has a slit length of 4.0 arcminutes.

Whilst observing a dekker slide is normally inserted above the slit to mask off the slit ends.  This reduces ghosting in ISIS and it is therefore recommended that the dekker is used. To check if the dekker is in place ask your support astronomer or, looking at the mimic display, check that the dekker status CLEAR and not OUT.    If the dekker is OUT you may move the dekker slide into the beam at the correct position using the command

    TO> dekker 8

- Introduce a blue blocking filter in the red arm of ISIS. Your support astronomer will advise if one is needed to prevent contamination of the red spectrum by second order light.  The status of below slit filter slides which contain these filters can be checked on the mimic display.


    TO> rfilta 3  (introduce the GG495 blocking filter)

- Select slit mode to observe (remove the comparison mirror in case it is in)

    TO> agslit

- Select comparison mode to take lamps (introduce a mirror in the beam to drive the light from the lamps into the spectrograph)

    TO> agcomp

3.2  Controlling ISIS mechanisms from the GUI

In addition to the control of ISIS mechanisms from the WHTICS console command, there is a GUI that also allows to control them. Manuals of the new ISIS Control System and the A&G Control System that explain how to use the GUIs can be found here and here.

The use of the GUI is very simple, A number of icons buttons are used throughout the GUI in order to perform specific tasks.
buttons 1

button 2


The GUI has several windows, the relevant for the ISIS user is here


Back to the top

Note that all UltraDAS commands are introduced in a unix window ("WHTICS"), thus can be executed in background mode (with an & at the end of the command line). This is important as able you to take images simultaneously with both, red and blue arms. Also UltraDAS commands can be combined with ISIS commands to create scripts.  A complete list and description of the commands can be found in the command dictionary of the UltraDas Software manual. A summary of the most commonly used commands is given here for a quick reference:

  • Data acquisition commands
    Some of the most important commands related to data acquisition are listed below (arguments are denoted by <>):

    • run <camera> <int time> <"title">
      Takes a run and saves it in: rxxxxxx.fit.
      E.g. run blue 600 "N157 B", takes a 600s exposure with the blue arm and store it in the output file (e.g. r240976.fit). The title of the fits file is set to "N157 B".

    • multrun <camera> <m> <int time> <"title">
      Same as run but repeats the run sequence m times and generates m output files.

    • flat <camera> <int time> <"title">
      Takes a run and set the OBSTYPE header parameter to FLAT.

    • multflat <camera> <m> <int time> <"title">
      Same as flat but repeats the run sequence m times and generates m output files.

    • arc <camera> <int time> <"title">
      Takes a run and set the OBSTYPE header parameter to ARC.

    • multarc <camera> <m> <int time> <"title">
      Same as arc but repeats the run sequence m times and generates m output files.

    • bias <camera> <"title">
      Takes a run and set the OBSTYPE header parameter to BIAS.

    • multbias <camera> <m>  <"title">
      Same as run but repeats the bias sequence m times and generates m output files.

    • glance <camera> <int time>
      Takes an exposure and saves it in s1.fit. This file is overwritten when a new glance is taken.

    • scratch <camera> <k> < int time> <"title">
      Takes a run and saves it in: sk.fit.k is an integer within the range 1-99. The scratch file sk.fit is overwritten when a new scratch<k> is taken.

    • abort <camera>
      Abort an exposure. The data is not saved to disk.

    • finish <camera>
      Terminates an exposure and save the data to disk.

    • newtime <camera> <int time>
      Change the length of an exposure (e.g. newtime 900)

    The arguments above stand for

       < camera>    Indicates which CCD you want to use, the red or blue ones. Enter red or blue.

       < int time>    Integration time in seconds.

       < "title">        Title of the exposure recorded in the image header (optional argument).


Back to the top

5. Afternoon settings and calibrations


5.1
Setting the CCDs from the observing system (WHTICS)

Before starting the calibration images in the afternoon you should have to set the redout speed and the windowing of the CCD camera.

- Set the detector readout speed to slow or fast (as desired) by typing for example:

    TO> rspeed <camera> slow

Have a look at the blue and red for details on the operational characteristics for each readout speed.  Normal observations are usually done using the slow readout speed. Be careful as the default velocity is fast and you have to set to slow before starting to take your calibrations in the afternoon.

- Windowing the CCDs. Note that the ISIS detectors cover more than 4 arcminutes in the spatial direction. It is therefore necessary to window each CCD to an appropriate length by defining an effective slit length

    TO> window red 1 "[585:1550,1:4200]"   (3.5 arcminutes for red arm+REDPLUS)

    TO> window blue 1 "[585:1550,1:4200]"   (3.2 arcminutes for blue arm+EEV12).

- Binning the CCDs.

    TO> bin red 1 2   will bin x1 in the spatial direction and x2 in the dispersion direction.

Once the CCD windows have been defined, the system will automatically create and save two files, one for each CCD, which contain the window, bin and readout speed parameters. The default file names are udas_REDPLUS.cfg and udas_EEV12.cfg. Different names can be used with:

    TO> saveccd <camera> <filename>

To load the CCD parameters use:

    TO> setccd <camera> <filename>

To load the default CCD configuration files just omit the field <filename>.

Please bear in mind that other useful data as both collimator focuses are not saved. The setccd command is especially useful after issuing a dasreset. This command resets the software and hardware of a CCD camera (e.g. when one camera stops working):

    TO> dasreset <camera>

After a dasreset the bin, window and readout speed data of the reset camera will be lost.


5.2 Taking arcs

    TO> agcomp

    TO> complamps cuar+cune

and take a test exposure:

    TO> arc red 5 test

This exposure will allow you to compute the exposure time to obtain a reasonable intense arc and to define the CCD window such that no dekker vignetting is seen. The same procedure with the blue arm. Take into account that usually long exposure times are needed in the blue.

5.3 Taking lamp flats

Before taking flats turn off all the dome lights and close the courtains in the control room.

    TO> agcomp

    TO> complamps w

and take a test exposure:

    TO> flat red 1 test

This exposure will allow you to compute the exposure time to obtain a reasonable intense flat. Flats should not be brighter than 42000 ADUs. DO NOT MAKE exposures shorter than 1 s. When using low resolution gratings in the red arm, the use of a neutral density filter is needed. ND filters can be put in place with e.g.

    TO> compnd 0.8   (to remove the ND filters just do   TO> compnd 0)

Once the proper neutral density filter and exposure time is set, do a multflat:

    TO> multflat red 11 5 "good flat"&

5.4 Taking bias

Before taking bias turn off all the dome lights and close the courtains in the control room.

    TO> agcomp

    TO> complamps off

    TO> multbias red 11&

    TO> multbias blue 11&

5.5 Taking sky flats

In case you need sky flat you should fo them in twilight. Ask the TO to open the telescope and point it to a blanck field and do

    TO> agslit

and take a test exposure to decide the exposure time:

    TO> sky red 1 test

Note that the sky brightness varies very fast and you will probably have to change your exposure time between exposures.

Back to the top

6. Observing with ISIS


6.1 Focusing the telescope

To focus the telescope point to a bright star (V=9-10, it can be one of your standards) and open the slit to 8 arcsecs

    TO>slitarc 8.0

In this way the profile of the spectrum will be defined by the seeing not by the slit. Take an image with one of the arms

    TO>agslit

    TO>run red 5 test &

Look at the image to check if the level of counts is correct and execute

   TO>focusrun <camera> <num_exposures> <exp_time><start_position> <focus_increment>

Typical values are

   TO>focusrun red 9 5 97.7 0.05

This will take 9 images of 5s exp. time changing the focus of the telescope between images starting with focus 97.7 and incrementing by 0.05 the focus value before every image. All images are saved and you can determine the best focus by analyzing the spectral profile of them. Once the value of the focus is determined (e.g. 97.85) set the value of the focus by

   TO> focus 97.85

6.2 Taking spectra of an object

First select the slit mode and slit width 

   TO> slitarc 1.0

   TO> agslit

Ask the TO to point to the object (you can give him in advance an object list with the coordinates of the objects you plan to observe during your run). Also tell him the Position Angle you want for the slit. The TO will take an image of the slit with the TV camera and will use it to center your object in slit. If your objects are faint (V>20) it is a good practice to center a brighter object in the field close to the target and do offsets. In this case compute the astrometric offsets in advance to save time. Once your object is in the slit do

   TO> run red <exp_time> "<comment>" &

   TO> run blue <exp_time> "<comments>"&

6.3 Night calibrations

If you need arcs of lamp flats during the night proceed as in #5.

6.4 Observing bright targets

If you need to observe bright targets you can use the main neutral density filters in the light path, common for both red and blue arm. Take into account that these neutral density filters are not uniform, mostly outside the useful area of the chip. The table below indicates the area of the chip in pixels where the filters were observed to be "gray". In addition to the non-uniformity all these filters have small-scale structures, difficult to be removed by flat-field correction. If there is a need to use these filters, flat-fields should be taken to mask regions with small-scale structures out. To insert the main neutral density filter, use the command:

   TO> mainfiltnd 2

to insert 0.3 neutral density filter (see the table below). The available options are the following:
mainfiltnd ND useful window
1 0 -
2 0.3 [500:1600,1400:2800]
3 0.9 [500:1600,1900:3000]
4 1.3 [600:1600,1400:3000]
5 1.8 [500:1600,1400:2800]
6 3.0 [1050:1550,1900:3000]

6.5 Quick-look spectrum extraction

Run the ISIS quick-look script at IRAF with e.g.:

   ecl> ing

   ing> isis

   isis> isis_ql r1234567 252

where the image name is given without the '.fit' extension, and the last number on the line is the approximate x position of the spectrum on the CCD (not dependent on binning). The script carries out an optimal extraction (takes ~ 1 sec) and displays the spectrum in the iraf graphics window using splot, so all the usual keystrokes are available. No wavelength calibration is provided.

Back to the top

7. Writing/saving data 


You can either write your data on a DVD (~4 Gb)
  • Get a DVD from your support astronomer or TO, and put the DVD in the DVD burner (located in the computer room)
  • Just follow the instructions.
OR on a DAT tape (~12.5 Gb)
  • Get a DAT tape from your support astronomer or TO, and put the tape in the DAT drive in whtdrpc2
  • Open up an xterm and cd /obsdata/wht?/YYYYMMDD
  • Use the tar command to write the data tape; e.g. : tar -cvf /dev/rmt/0lbn .


Top | Back


ISIS Instrument Specialist
Last modified: 03 October 2011