----------------------------------
Starting tutorial on running otcom
----------------------------------

Here's a simple session you might carry out which will illustrate most
of the important features of OPTIC.  What you type is indicated by a
>> prompt.

Start up otcom:

% otcom

  OTCOM v2.1
  
  logonly: Found SDSU card at /dev/lotuspci0, fd=3
  Interface is alive,logonly: Fiber reset to SDSU GEN2 mode
   interface is reset
  
   Controller alive, please download DSP code!
  
  Reading tel_config info from /usr/local/inst/config/tel_config
  Tel: 3.5m at f/6.3, Scale: 0.141"/p, Inst: OPTIC: 4-10-2 & 4-3-2
  
  Reading from filter file /usr/local/inst/config/filters.def
  Filter #0 is 'V', ZP = 26.50
  Filter #1 is 'R', ZP = 26.50
  Filter #2 is 'U', ZP = 24.00
  Filter #3 is 'z', ZP = 25.10
  Filter #4 is 'W022', ZP = 25.00
  Filter #5 is 'B', ZP = 26.40
  Filter #6 is 'I', ZP = 26.40
  Filter #7 is 'W021', ZP = 25.00
  Setting default params.
  cmdqueue: Communications to clients started on port 9511
  error: Can't read symbol ST_SH...  Have you downloaded yet?
  001> selectserver: new connection from 127.0.0.1 on socket 5
  Client 0 on descriptor 0 from server stdin (127.0.0.1)
  
Download the DSP code as requested:

 >> df
  High voltage off...
  info: Downloading ./optic4.lod...
  logonly: 477 symbols defined
  info: Verifying downloaded code...
  info: Downloading /usr/local/inst/dsp/opticlub.lod...
  logonly: 730 symbols defined
  info: Verifying downloaded code...
  warn: P:0x000091 -- 0x000004 sent, 0x053779 received 
  logonly: P:0x000091 -- 0x053779 OK now
  Found all the symbols, proceeding with clock rewrite...
  Boot code updated to allow >7 arguments...
  info: Filter is positioned at 3
  Frame: 001   File prefix: '/tmp/ccd'   Filter 3 'z'   Shutter 0
  Science:   bin 2x2, origin (0,0), size (1024,1026), 32 bias, 4 amp, texp 1.00
  Guide:     bin 2x2, origin (1,1), size (16,16), geom 0,0 0,0, texp 0.050
  GS at:     0.0 0.0   0.0 0.0   0.0 0.0   0.0 0.0
  Params:    nwipe 1, shut 1, read 1, wrdat 1, track 0, wrot 0, wrvid 0 
  OT track:  alg 10, wait 5, gain 1.00, max 8, regions 11111111, wgt -1.00, bias 1
  Tel guide: on? 0, rmin 2.0, tmin 1.0, gain 0.50, PA top 0.0, EccwN? 1
  	
Turn on the high voltage:

 >> pon
  High voltage on...
  status: 0 p5v 5.05  p15v 16.4  m15v -16.4  p35v 36.0
 
Check that it happened:

 >> volt
  status: 0 p5v 5.05  p15v 16.4  m15v -16.4  p35v 36.0

Set the temperature regulation to -105C (necessary every new download):

 >> temp -105.000000
  status: 0 tccd -104.9  tset -105.0  telec 22.1  hperc 0
 
Set the file prefix and file number:

 >> fp /b0/optic/021217/f
  status: 0 fp /b0/optic/021217/f

 >> fn 24
  status: 0 fn 24

Check out the status of everything
 >> st
  Frame: 024   File prefix: '/b0/optic/021217/f'   Filter 3 'z'   Shutter 0
  Science:   bin 1x1, origin (0,0), size (2048,2052), 32 bias, 4 amp, texp 20.00
  Guide:     bin 2x2, origin (1,1), size (32,32), geom 0,0 0,0, texp 0.050
  GS at:     0.0 0.0   0.0 0.0   0.0 0.0   0.0 0.0
  Params:    nwipe 1, shut 1, read 1, wrdat 1, track 0, wrot 0, wrvid 0 
  OT track:  alg 10, wait 5, gain 1.00, max 8, regions 13331111, wgt -1.00, bias 1
  Tel guide: on? 0, rmin 2.0, tmin 2.5, gain 0.50, PA top 180.0, EccwN? 0

Set up for a dome flat, full chip, unbinned, 32 bias, 6 sec exposure:

 >> auto 1 1 1 1 0 0 0
 >> sf 1 1 0 0 2048 2052 32
 >> et 6

Take an image and write to /b0/optic/021217/f.024:

 >> go

Take a snapshot of a field where you want to guide.  (If all you
want to do is use OPTIC as a conventional CCD with telescope
guiding, this is all you need to ever do.)

 >> auto 1 1 1 1 0 0 0
 >> sf 2 2 0 0 1024 1026 32
 >> et 2
 >> go

After examining it, move the telescope to place a suitable guide star
in position.  It was found at 412 611 and you want it at 100 100,
these coordinates being of the previous image which is binned by 2:

 >> telescope xyoff 412 611 100 100 2

Find the guide star(s) and mark them with a 4 second snapshot:

 >> fgs 4

This pops up an image of just the "lower" regions, binned 2x2, so you
get an image which is 2048 wide by 512 tall, and it is displayed with
a 2x compression so you see 1024 x 256.  The four "lower" regions are 
delineated with a green cross.  You then make a selection in each of
the four lower regions, either hitting "e" in the displayed image to
make no star selection or "x" to choose a star.  (A current bug
will cause the selection to fail if the star has saturated to the
point of pushing the data to 0.  If this happens, use "C" on the
nearest bit of non-zero star.)

When you hit the fourth key (either "e" or "x") the window disappears
and a new status display should show you non-zero numbers for the
guide stars you have selected.  If for some reason a selected star is
not given reasonable coordinates, try fgs again.

You are now ready to take an OT image.  Set the auto parameters,
choose a 200 second exposure time and a full frame, unbinned readout,
a 50 msec guide star exposure time (plus overhead), and go!

 >> auto 1 1 1 1 1 1 1
 >> sf 1 1 0 0 2048 2052 32
 >> et 200
 >> gt 50
 >> go

This will pop up a new window called XOPTIC which has lots of
interesting features described in Manual_xoptic.  It is for your
amusement and is not important for the exposure and star tracking.  In
previous versions it was possible to change things such as bin factor
and guide star exposure time on the fly; they will probably be
restored someday.

When the exposure finishes the auto parameters will cause the shutter
to close, the CCD to read out, the image to write to f.026 (f.024 was
the dome flat, f.025 the snapshot; the fgs image is called f_fgs.026),
and various other data files pertaining to the tracking to f_*.026
(described below).