Directory description

This directory contains scripts to test the output of your current version of WCSim with the version on GitHub. The purpose of these scripts is to ensure that the changes being committed will not accidentally change the output of the WCSim code.

Description of scripts in this directory

verification_HitsChargeTime.C:

This script will test a .root output file from your version of WCSim against the committed version of the code. This test plots the number of digitized hits, the average charge, and the average time. A ks test is printed to the screen. This test also prints to the screen a comparison of the first event in the files to see if the number of hit tubes, number of digitized tubes, and number of pe hit times match.

Usage

To use the verification_HitsChargeTime test in the default method, do the following steps:

• clone a copy of the current code from GitHub into a directory called WCSim_clean. Compile the code.
• Go to WCSim_clean/verification-test-scripts and run electrontest.mac by typing: ../bin/Linux-g++/WCSim electrontest.mac. This should produce an output file called wcsimtest.root in the verification-test-scripts directory of WCSim_clean.
• Go to the verification-test-scripts directory of your local WCSim (with your changes you wish to commit) and run the macro electrontest.mac in WCSim by typing ../bin/Linux-g++/WCSim electrontest.mac. This should produce a file called wcsimtest.root in your verification-test-scripts directory.
• Still in the verification-test-scripts of your local WCSim directory, type: root verification_HitsChargeTime.C

You can also use this test to compare any two files from any two directories. To use the script this way type:

• root
• .x verification_HitsChargeTime.C("/path/to/first_file", "/path/to/second_file")

verification-test-scripts/complete_comparison.C

This script will test a .root output file from your version of WCSim against the committed version of the code. All variables within WCSimRootEvent are tested

Usage

To use the complete_comparison test in the default method, do the following steps:

• clone a copy of the current code from GitHub into a directory called WCSim_clean. Compile the code.
• Go to WCSim_clean/verification-test-scripts and run electrontest.mac by typing: ../bin/Linux-g++/WCSim electrontest.mac . This should produce an output file called wcsimtest.root in the verification-test-scripts directory of WCSim_clean.
• Go to the verification-test-scripts directory of your local WCSim (with your changes you wish to commit) and run the macro electrontest.mac in WCSim by typing ../bin/Linux-g++/WCSim electrontest.mac. This should produce a file called wcsimtest.root in your verification-test-scripts directory.
• Still in the verification-test-scripts of your local WCSim directory, type: root complete_comparison.C

You can also use this test to compare any two files from any two directories. To use the script this way type:

• root
• .x complete_comparison.C("/path/to/first_file", "/path/to/second_file")

printSizes.C:

This script will test a .root output file from your version of WCSim against the committed version of the code. This test prints to the screen the size of the output trees and top-level branches. The optional verbose boolean flag allows sub-branch sizes to be printed.

Usage

To use the printSizes test in the default method, do the following steps (note that the first 3 steps are equvialent to that for verification_HitsChargeTime.C):

• clone a copy of the current code from GitHub into a directory called WCSim_clean. Compile the code.
• Go to WCSim_clean/verification-test-scripts and run electrontest.mac by typing: ../bin/Linux-g++/WCSim electrontest.mac. This should produce an output file called wcsimtest.root in the verification-test-scripts directory of WCSim_clean.
• Go to the verification-test-scripts directory of your local WCSim (with your changes you wish to commit) and run the macro electrontest.mac in WCSim by typing ../bin/Linux-g++/WCSim electrontest.mac. This should produce a file called wcsimtest.root in your verification-test-scripts directory.
• Still in the verification-test-scripts of your local WCSim directory, type: root printSizes.C

You can also use this test to compare any two files from any two directories. To use the script this way type:

• root
• .x printSizes.C("/path/to/first_file", "/path/to/second_file",verbose)