Background

The ESI software includes a sophisticated regression test suite which can be used to verify that the various stages are functioning properly. The full test requires several hours to run and involves expert human interpretation. This document describes how to run the test and how to interpret the results.

Running the tests

  1. Log into the ESI host computer (kanaha) as user kics.
  2. Go to directory /u/kics/cvs/kroot/kss/esi/ktest.
  3. Execute the command 
    KtRun esi.cfg
    to launch the script that runs the tests.
The testing should complete in 3-4 hours.

Analyzing the tests

  1. Log into the ESI host computer (kanaha) as user kics.
  2. Go to directory /u/kics/cvs/kroot/kss/esi/ktest/Runs.
  3. Find the new subdirectory for the current test; e.g., for the first ktest run on 2005-Nov-22, the subdirectory is 2005_11_22_1.
  4. Inspect the files LastRunList.2005_11_22_1.PASS and LastRunList.2005_11_22_1.FAIL to see the list of tests that passed and failed.
  5. Inspect the file LastRunResults.2005_11_22_1.FAIL to see details on the failed tests.
  6. Generate a comparison of results for the last N ktest runs using the command: 
    KtSeries last N
    This generates the file MultiKtest.report.

Plotting results

Plots are a very useful diagnostic for the health of the triple wheel assembly. To view plots:
  1. Log into the ESI host computer (kanaha) as user kics.
  2. Go to directory ~/ktest-notes.
  3. Ensure that DISPLAY envar is set.
  4. Execute the following commands: 
    plot_renishaw.tcl APMSK
plot_renishaw.tcl DWFIL
plot_renishaw.tcl SLMSK
    Each will generate a window with a plot showing the latest run's results in red. Ideally, the renishaw voltages should be around 9.0V at all positions.