Retrieving and plotting of archived variables
 
updates: 2002-2-20 SG 'tcplot' defined for d0cft
         2002-3-13 SG fast archiver for AFE and Sequencer power supplies
         2002-3-13 SG moved to d0ol37; fast archiver instructions removed

A selection of epics records are archived every 1 minute (other time periods
possible). Currently all records related to cryo control and bias monitoring
for AFE boards are stored.
Use tool number 1 for archive plotting.

To start the archiver, source the script 'auto_startup' on d0ol37:/archive/cft/;
make sure it really is not running (by issuing an 'ls -ltr'), 
since this script will blow the lockfile away!

Time evolution of monitor-records can be displayed graphically (and compiled
for further analysis) using three tools.


1. Using plotting tool 
      setup d0online
      setup chan_archiver
      ./tcplot in d0ol37:/archive/cft
or manually:
   on d0ol37
      cd /archive/cft  
      setup d0online
      setup chan_archiver
      ls -ltr  # to find the latest dir-file, and to check that the archiver
                  has recently updated both the dir and the data file
      Xarr.py <name_of_latest_dir.file> & 


   - get record list with wildcard or regular expression, select records with
     click and shift-click (e.g. 4A7 will yield all records for board 4A7,
     TCD1 will list the TCD1 records for all boards). For an explanation of variables
     see below.
   - select 'Default Timespan'
   - plot records: 'Send to Graph'
     tcplot <n> to select last <n> directory files (useful if the archiver was just restarted)

      make sure you narrow down the time window you want to plot before
      sending channels to the graphics window; otherwise you'll be waiting
      a long time!

==============================================================================================
2. StripTool
   login on linux online node: e.g. d0ol24:
   > cd ~d0cft/commiss/chan_archiver
   > setup d0online
   > StripTool &

This hasn't been tested in a while.

=================================================================================================

  Variables and their meaning:
  AFCK       AFE clock; 0-2**16; turns over roughly every 9 minutes
  MOCK       next time to run monitoring; same scale as ADCK
  PIC0       PIC ADC input device 0 = open pin
  PICL       1/9 (nominal) of reference bandgap
  PICR       reference bandgap
  PICSC      scale factor: PICR - PICL (as PICL is pretty useless,
              this really should be just PICR, but I don't think
              that change request ever made it into EPICS)
  PICT       PIC (=AFE) temperature; raw counts
  TCCK       next time to run temperature control; same scale as ADCK
  TCD1  [8]  temperature process value - set point; ~650 counts = 1 K
  TCIV1 [8]  TC integral value; determines heater output (OV = IV/256)
                    (as long as the gain is set to 1)
  TCOV1 [8]  heater output current: 0-255; 128 is 50mW/module
  TCPV1 [8]  process value = temperature; ~650 counts = 1 K
  TCSP1 [8]  set point; gets rescaled by set2normal once a minute
                   for old (vsn 2) boards
  VLPI1 [8]  VLPC bias current; useless for vsn 2; around 01xx or 02xx for vsn >=4
  VLPU1 [8]  VLPC bias voltage; around 40,000, depending on calibration