Overview

The at_cid.py acceptance test checks the QIE card's CID rotation using the uHTR SPY function.

Procedure

To run this acceptance test, run

python at_cid.py -t [teststand_name] -n [n_reads]

where [teststand_name] represents the name of the teststand as recorded in teststands.txt (the default is 904at) and [n_reads] is the integer number of groups of 100 BXs that will be analyzed per clock phase setting.

Results

Each time you run the test, the following items are written to the data/at_results/[unique_id]/at_cid/yymmdd_hhmmss directory:

• yymmdd_hhmmss_cid.png - An image containing the following:
  • A histogram for each QIE's CID rotation error rate for each clock phase setting. (24 histograms total)
• yymmdd_hhmmss_cid.root - A ROOT file containing the above histograms.

Analysis

A good board should say something like the following at the end of the test:

====== SUMMARY ============================
Teststand: 904at
QIE card: 0x67000000 0x9b32c370 (FE Crate 2, Slot 2)
BXs/phase setting: 100
[OK] There were no errors!
===========================================

and the plots should be completely green.

A bad board will say something like this at the end:

====== SUMMARY ============================
Teststand: 904at
QIE card: 0x67000000 0x9b32c370 (FE Crate 2, Slot 2)
BXs/phase setting: 100
[!!] Errors: (indexed by phase setting)
	* Link 20, Channel 0: error rates = [0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75]
	* Link 20, Channel 1: error rates = [0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75]
	* Link 18, Channel 2: error rates = [0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75, 0.75]
===========================================

and there will be red in at least one histogram.

More details:

• An error rate of 0.75 usually means the CID is a reasonable value (0, 1, 2, or 3) but isn't rotating.
• An error rate of 1.00 usually means the CID always -1.