As a minimal check on effects caused by any changes to reconstruction code, the following code and procedures are to be exercised:
A suite of datasets has been selected which should serve as a reference basis for any changes. These datasets include:
Real data from Run 7 AuAu at 200 GeV
Simulated data using year 2007 geometry with AuAu at 200 GeV
Real data from Run 8 pp at 200 GeV
Simulated data using year 2008 geometry with pp at 200 GeV
These datasets should be processed with BFC as follows to generate historgrams in a hist.root file:
root4star -b -q -l
root4star -b -q -l
root4star -b -q -l
?
The RecoQA.C macro generates CINT files from the hist.root files
root4star -b -q -l 'RecoQA.C("st_physics_8113044_raw_1040042.hist.root")'
root4star -b -q -l 'RecoQA.C("rcf1296_02_100evts.hist.root")'
root4star -b -q -l 'RecoQA.C("st_physics_9043046_raw_2030002.hist.root")'
?
The CINT files are then useful for comparison to the previous reference, or storage as the new reference for a given code library. To view these plots, simply execute the CINT file with root:
root -l st_physics_8113044_raw_1040042.hist_1.CC
root -l st_physics_8113044_raw_1040042.hist_2.CC
root -l rcf1296_02_100evts.hist_1.CC
root -l rcf1296_02_100evts.hist_2.CC
root -l st_physics_9043046_raw_2030002.hist_1.CC
root -l st_physics_9043046_raw_2030002.hist_2.CC
?
One can similarly execute the reference CINT files for visual comparison:
root -l $STAR/StRoot/qainfo/st_physics_8113044_raw_1040042.hist_1.CC
root -l $STAR/StRoot/qainfo/st_physics_8113044_raw_1040042.hist_2.CC
root -l $STAR/StRoot/qainfo/rcf1296_02_100evts.hist_1.CC
root -l $STAR/StRoot/qainfo/rcf1296_02_100evts.hist_2.CC
root -l $STAR/StRoot/qainfo/st_physics_9043046_raw_2030002.hist_1.CC
root -l $STAR/StRoot/qainfo/st_physics_9043046_raw_2030002.hist_2.CC
?
Steps 1-3 above should be followed immediately upon establishing a new code library. At that point, the CINT files should be placed in the appropriate CVS directory, checked in, and then checked out (migrated) into the newly established library:
cvs co StRoot/qainfo mv *.CC StRoot/qainfo cvs ci -m "Update for library SLXXX" StRoot/qainfo cvs tag SLXXX StRoot/info/*.CC cd $STAR cvs update StRoot/info
Missing information will be filled in soon. We may also consolidate some of these steps into a single script yet to come.