Refactoring of anaUltraScurve.py and additional output distributions

[bdorney]

Description

Refactoring of anaUltraScurve.py with updates/additions to supporting tools.

All distributions created will now be in fC. The output TFile will have relevant s-curve parameters stored in fC. The default behavior is to use the vfat2 VCAL to fC conversion that has been hard coded for some time. The user can supply an external text file which specifies the conversion between the CAL DAC (either vfat2 or vfat3) to fC using the --calFile argument. The expected format of this file is shown as:

vfatN/I:slope/F:intercept/F
0   0.2692  -2.629748
1   0.238106    -2.65316
2   0.2532  -2.193826
3   0.276783    -2.477547
...
5   1.000000    0.000000    
...
...

If one prefers to stick in terms of DAC units simply supply a slope of 1.0 with an intercept of 0.0 as in the above example (e.g. a chip where the calibration is not known or was not possible).

The fitting class ScanDataFitter is now also capable of working with quantities in terms of fC but the default behavior of this class will be in DAC units to preserve compatibility with trimChamber.py. Supplying additional arguments at construction (as is done now in anaUltraScurve.py) will enable the fitter to parse input information, and return output results, in terms of fC.

Additionally a series of new distributions have been added:

1. ScurveMeanSummary.png, shows the distribution of s-curve mean positions (after fitting) for all VFATs in the standard grid layout,
2. ScurveWidthSummary.png, shows the distribution of s-curve width positions (after fitting) for all VFATs in the standard grid layout.
3. scurves_vfatX, a TCanvas for VFATX showing all 1D scurves on the same TPad for a given vfat (as shown by the VFAT3 production team in a recent DAQ meeting)
4. scurvesNoMaskedChan_vfatX, as item 3 but omitting curves from masked channels.
5. canvScurveFits_vfatX, as item 4 but instead here the fitted TF1 objects are plotted.

Additionally the TObjects used in items 1 & 2 are also stored in the output TFile in a TDirectory VFATX where X is the VFAT position. Items 3-5 are available in the output TFile but are not stored as images in the output directory.

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)

Motivation and Context

Originally wanted to add a few distributions to the analysis routine but the code was pretty hacked together and it was unclear where certain things defined or what units they were in (e.g. DAC units or fC).

Address comments about unnecessary sub-process calls that were brought up here

How Has This Been Tested?

Extensive analysis and testing.

Screenshots (if appropriate):

Example TFile output structure now (note the TTree structure has not changed):

Summary.png:

PrunedSummary.png:

fitSumnmary.png:

ScurveMeanSummary.png:

ScurveWidthSummary.png:

TCanvas scurves_vfat0:

TCanvas scurvesNoMaskedChan_vfat0

TCanvas canvScurveFits_vfat0

Checklist:

• My code follows the code style of this project.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have added tests to cover my changes.
• All new and existing tests passed.

[bdorney]

Will also correctly assign error bars for scurve plots using the:

• TH1::SetBinContent(), and
• TH1::SetBinError()

methods; therefore partially resolving #61 for the case of anaUltraScurve.py.