
             Kaon-LT and Pion-LT Analysis Tasks and Timeline
			(Updated 8-Jul-2020)

Redmine version: https://redmine.jlab.org/projects/kltexp/wiki/Analysis_Tasks

	Kaon-LT Data taking:  26-Sep-2018 -- 15-Apr-2019
	Pion-LT Data taking:  21-Jun-2019 -- 20-Jul-2019

------------------------------------------------------------------------
REPLAY 0 of data done by shift workers with online calibrations.

1-Aug-2019: Analysis begins

INITIAL CALIBRATION TASKS:

a) BCM calibrations.
                        ---> DJM
   Fall 2018-Spring 2019:
   https://hallcweb.jlab.org/doc-public/ShowDocument?docid=1034
   BCM1,2 are stable, have a small nonlinearity >60uA that remains to be
   calibrated
   Summer 2019:
   https://hallcweb.jlab.org/doc-private/ShowDocument?docid=1037
   BCM1,2 both okay, including small nonlinearity corr.

   Status: Incomplete for Fall-Spring.  Complete for Summer

b) Initial run tables.
			---> ?
   Run tables from shift workers posted on Redmine.  Has anyone gone through
   this to fix erroneous entries?

   Status: Incomplete

c) Beam Energy calibrations.
                        ---> MKJ
   https://hallcweb.jlab.org/wiki/index.php/Table_of_12_GeV_Beam_Energy_Measurements
   This page incorporates May/2019 problem fix that caused to give wrong
   beam energies.
	
   Status: Complete

d) Python analysis scripts
			---> Richard/Stephen
   https://redmine.jlab.org/attachments/download/1000/Analysis_Meeting_14_05_20.pdf
   https://redmine.jlab.org/attachments/download/998/KaonLTMeeting_5_13_20.pdf

   Status: Complete

e) Timing windows and reference times
			---> Richard/Stephen/Vijay/Ali
   This was completed for hodoscopes, drift chambers by Richard/Stephen.
   Every HMS/SHMS channel needs to be re-done for new hcana code.

   Status: Incomplete

f) EDTM Deadtime corrections.
			---> Richard/??
   This has been looked at by various people.  Need links to documentation.

   Richard's study: ??
   DJM's cross-check between EDTM and Hodo-3/4 deadtime:
   https://hallcweb.jlab.org/DocDB/0010/001063/002/Combinatorics%20in%20Estimating%20the%20Hodo%203of4%20Trigger%20Livetimev2.pdf

   Status: Incomplete

g) Drift chamber time-to-distance map calibrations, look at residuals.
			---> Richard/Stephen
   HMS+SHMS: https://redmine.jlab.org/documents/74

   Status: Complete, but probably some recheck needed with new hcana

h) Calorimeter calibrations.
			---> Richard/Stephen
   HMS+SHMS: https://redmine.jlab.org/documents/74
   Redmine lists this task as Ongoing by Hamlet/Richard/Vladimir/Vardan
   Calorimeter calibrations have some wiggles that need to be fixed.

   Bill Henry's 9-Jan-2020 report on calib algorithm improvements
   https://hallcweb.jlab.org/DocDB/0010/001039/001/calorimeterCommis.pdf

   Status: Calibration needs to be rechecked using improved algorithm

i) RF time for SHMS PID
                      ---> Stephen
   1-Apr-2020 Update:
   https://redmine.jlab.org/attachments/download/949/KaonLT_Meeting_01_04_20.pdf
   Still need to set RF gates for each particle type, apply TOF corrections for
   particles other than pion, and check offsets for other settings.
   
   Status: Working but not yet complete

j) SHMS and HMS Optics Improvements
                        ---> MKJ
   SHMS:
   https://hallcweb.jlab.org/DocDB/0010/001044/006/Update%20to%20Optics%20Cuts%20April%202020.pdf
   HMS: Not sure if Mark has posted improved HMS saturation correction yet

   Status: Unsure

k) SHMS HGC calibration, cuts, PID analysis, efficiencies.
                        ---> Vijay
   New calibrations almost done.  Report in progress.
   A position dependent efficiency for pi+ and K+ will have to be implemented.
   This is not yet started.

   Status: Ongoing

l) SHMS Aerogel calibration, cuts, PID analysis, efficiencies.
			---> Vladimir/Richard??
   Redmine lists calibration completed by Vladimir.  Need a link to the
   report.
   Cuts, PID analysis, efficiencies, not yet done.

   Status: Ongoing

m) HMS Cherenkov calibration, cuts, PID analysis, efficiencies.
                        ---> Richard/??
   Calibrations: https://redmine.jlab.org/attachments/download/928/KaonLT_Meeting_11_26.pdf
   PID analysis and efficiencies yet to do.

   Status: Ongoing

n) SHMS tracking algorithm optimization and efficiencies.
                       ---> Ali
   Link to Tracking Efficiencies vs Rate (9-Jun-2020):
   https://redmine.jlab.org/attachments/download/1007/KaonLT_Meeting_Jun_9.pdf

   Status: Ongoing

o) Carbon luminosity scans versus current and rate.
                       ---> Richard/Ali/Vijay
   Need to check if the various luminosity scans give consistent results.
   HMS,SHMS singles: partially done by Richard
   https://logbooks.jlab.org/entry/3645294
   All students need to repeat this work, particularly with new version of
   hcana.
   
   Status: Ongoing

p) LH2 boiling scans versus current and rate.
                       ---> Richard/Ali/Vijay
   Need to check if the various luminosity scans give consistent results.
   HMS singles: 
   SHMS singles: 

   Status: New

q) Physics "luminosity" scans versus current.
                       ---> Richard/Ali/Vijay
   Peter Bosted has looked in detail at our data, leading to significant
   improvements to hcana.  We need to repeat his studies for ourselves.

   Status: New

r) Check stability of cointime peak.  In Fpi-2 it drifted with TDC temperature
   and needed to be adjusted on a run-by-run basis to within 200 ps.
                       ---> ??
   Initial checks so far indicate the peak is stable.
   Cointime resolution will be poorer in fall 2018 run due to DAQ cabling
   issue.  Mark has partial software fix that we need to be sure is
   implemented.
   
   Status: New

s) Initial Heepcheck offset fitting to get corrected E, E', theta'.
                       ---> Richard/Ali/Vijay

   Status: New

t) Initial ep elastic cross-section checks.
                       ---> Richard/Ali/Vijay
   Singles cross-sections, HMS and SHMS.
   Partial look by Burcu:
   https://hallcweb.jlab.org/DocDB/0010/001070/004/HMS_elastic_analysis.pdf
   https://hallcweb.jlab.org/DocDB/0010/001071/001/SHMS_elastic_analysis.pdf
   SHMS delta scans (only peak position checked so far, stability of normalized
   yield ratio not yet checked)
   Coin ep cross-sections.
   Heep from CT experiment looks good with Holly's expert help
   https://hallcweb.jlab.org/DocDB/0010/001072/001/CT_hydrogen_july2020.pdf
   
   In Fpi-2, determing the correct proton absorption correction for normalized
   required some literature review and other digging.

   Status: New
   
u) Check that Heepcheck offsets produce consistent p(e,e'K+)L, p(e,e'pi+)n
   p(e,e'p)omega missing masses.
                       ---> ??

   Status: New

------------------------------------------------------------------------
FULL REPLAY 1 of data, with new calibrations.

   This replay should include all new kinematic offsets, better timing
   and PID calibrations, as well as Mark's most recent HMS and SHMS matrix
   elements.

v) Quality control rechecks with new replay:
   - carbon luminosity scans are flat vs. current and rate
   - LH2 luminosity scans are flat vs. current and rate

w) HMS saturation corrections?

x) Final investigation of SHMS acceptance, optimize acceptance cuts based on
   sieve-slit run analysis, agreement with single-arm MC. 

   Compare data and simulation plots of SHMS yfp,ypfp for various ytar,delta
   bins to identify inconsistencies.

y) Trigger blocking studies.

   Are extra factors needed to correct for missing FADC reference times, or any
   other DAQ related effects?  Initial info from Peter Bosted indicates this is
   likely to be the case.

z) Recheck Heep singles and coin yields to identify and fix problems.

1) Stability checks.  Need some scripts to look at invariant mass vs run
   number, etc., for pi+/K+/p channels.

------------------------------------------------------------------------
FULL REPLAY 2 of data, with improved optics and corrections.

SECOND LEVEL ANALYSIS TASKS with REPLAY 2 ntuples:
a) Final SHMS optic matrix element and acceptance determination.

b) Final HMS optics check.

c) Final Heepcheck offsets.

d) Better detector efficiency determination.
   
e) First check of Bill's L/T separation code.

------------------------------------------------------------------------
FULL REPLAY 3 of data, with final calibrations and offsets.

THIRD LEVEL ANALYSIS TASKS with REPLAY 3 ntuples:
a) Final ep elastic cross-section checks.

b) Look at data in depth, and resolve outstanding problems.

c) First SIMC ntuple generation using new offsets.

d) Detailed Data/SIMC comparisons for HMS and SHMS focal plane and target
   reconstructed quantities, as well as W, Q^2, t, phi.

e) Preliminary L/T separation results.

------------------------------------------------------------------------
FULL REPLAY 4 of data, with outstanding problems resolved.

ADVANCED ANALYSIS TASKS with REPLAY 4 ntuples:
a) Final SIMC ntuple generation using final parameters.

b) Thorough look at L/T/LT/TT separations, consistency checks as necessary.

c) Final look at systematic error contributions.

------------------------------------------------------------------------
Hopefully not necessary, but if we have to: FULL REPLAY 5 of data.

OBTAIN:
d) Separated cross-section results.

e) Form factor determination begins.  Model systematic error tests.
   Use more than one model, if at all possible.

f) Model dependence and other issues in form factor extraction.

------------------------------------------------------------------------
Begin thesis writing, drafts of first papers.
