RLR: Runlog Reader

The Runlog Reader reads a range of RLG data structures back from the database to permit SNOMAN based analysis of the RLOG and permanent banks. RLAI banks created by the Runlog Analysis RAA subprocessor are also read and connected to the RLOG data structure. It also reads the Data Analysis Mask Numbers banks and creates the DAMN bits Histograms on the fly (optional; can be suppressed by a word in the TRLR titles bank). These, along with the HIDx HBOOK banks from the analysis are output into an HBOOK file by the RLO.

The essential commands are:-

        $processor_list 'rlr anl rlo end'
either  $rlr_run_range 12345 67890
    or  $rlr_date_range 19990101 0 20010101 0
    or  $rlr_run_list
either  $rlr_app_damn_hist_id 8000   *define Applied Histogram ID
    or  $rlr_app_damn_hist_id -1     *(to suppress DAMN Bits Hists)
        file rlo 1 my_file.hbook

As the above example suggests, the user can select a range of RLG structures based either on run number or date/time. RLR reads them back one at a time allowing SNOMAN analysis of the RLG data structure. RLR can also use a run list. In this case the run list must be specified at the end of the TRLR titles bank found in rlr_control.dat . The list should start at word 21 and continue until the end of the titles bank. No other user control is needed as SNOMAN will calculate the posision of the end of the runlist automatically.

The user can also select the id(s) of the DAMN bits histograms. In addition to the Applied Mask Histogram, there are 3 Result Mask Histograms:-

1. The Result DAMN Mask - Number of Events Histogram
   

   The value of every channel is the number of events in this run that passed the test defined by this bit.

2. The Result DAMN Mask - Rate of Events Histogram
   

   The value of every channel is the rate of events (in events/sec) in this run that passed the test defined by this bit. This is merely the number of events that passed each test divided by the run duration.

3. The Result DAMN Mask - Percentage of Events Histogram
   

   The value of every channel is the percentage of events that passed the test defined by this bit compared to the total number of events in this run.

Their ids are set to app_damn_hist_id+1, +2, and +3 respectively (8001, 8002 and 8003 in the above example).The user can also select to suppress all four histograms by setting the app_damn_hist_id to -1.

This processor is also a context setter and updates the current context to the middle of current run. This allows the user to load titles banks corresponding to the current run using the validity range.