EMCal Offline Data Analysis Documentation

This page presents a list of the EMCal analysis modules and data tables (with links to CVS) currently being used in the offline analysis (for an older page take a look here). A description of the simul+real event merging which is now being developed within this framework appears at the end.

List of typical tables contained in:

Real DST
Simul DST
PISA hits file
rawrel.root (relational GEANT tables produced by camresp*.C for evaluation purposes).

1. Real DST production [from real PRDF using preco]:

	Analysis Module	Function	Data Tables
1	mEmcEvent	Gets the actual vertex in a real event	IN: dBbcOut OUT: dEmcEvent
2	mEmcGeometry	Builds the geometry	IN: OUT: dEmcGeometry
3	mEmcCalibrator	Calibrates EMCal towers (via rdo->mdo->cdo and access to the DB) from prdf data	IN: dEmcRawData, dEmcGeometry, dEmcEvent INTERM: emcRawDataObject, emcMixedDataObject, emcCalibratedDataObject OUT: dEmcCalibTower(and dEmcGeometry, dEmcEvent)
4	mEmcClusterNew	EMCal basic clustering	IN: dEmcCalibTower, dEmcGeometry, dEmcEvent OUT: dEmcClusterLocal, dEmcClusterLocalExt

The final DST contains the following tables:

dEmcClusterLocal, dEmcClusterLocalExt, dEmcCalibTower

Comment: there are a few obsolete modules (like mEmcDefGeom) and tables (like dEmcRecoPar) which still appear at CVS but are not used anymore (in the former cases e.g. due to the changes of mEmcClusterLocalChi2 to mEmcClusterNew).

2.a. Simul DST production [from simulated PRDF using preco]:

	Analysis Module	Function	Data Tables
1	EmcGetDCM	(phdcm package) Gets prdf data and fills dEmcDCMData	IN: Event OUT: dEmcDCMData
2	mEmcDCMToRaw	Converts the data in DCM (Long) format into a generic raw data format for input of the reconstruction.	IN: dEmcDCMData, OUT: dEmcRawData,
3	mEmcGeaEvent	Gets the PISA vertex information	IN: header OUT: dEmcEvent
4	mEmcGeometry	Builds the geometry	IN: OUT: dEmcGeometry
5	mEmcCalibTower	Makes calibrated data (GeV, ns) from the raw data by trivial subtraction of pedestal and multiplication with a fixed gain.	IN: dEmcRawData, dEmcGeometry, dEmcEvent OUT: dEmcCalibTower(and dEmcGeometry, dEmcEvent)
6	mEmcClusterNew	EMCal basic clustering	IN: dEmcCalibTower, dEmcGeometry, dEmcEvent OUT: dEmcClusterLocal, dEmcClusterLocalExt
7	mEmcGeaClusterEval	Evaluator module for EMCal	IN: dEmcEvent, dEmcGeaTrack , dEmcGeaTowerTrack, dEmcClusterLocalExt OUT: dEmcGeaTrackCluster, dEmcGeaClusterTrack

The final DST contains the following tables:

dEmcGeaTrackCluster, dEmcGeaClusterTrack [in the evaNode. For "Evaluation" analysis using step 7. In that case one needs the rawrel.root file containing the relational tables produced with the simulated PDRF].
dEmcClusterLocal, dEmcClusterLocalExt, dEmcCalibTower [in the dstNode. For straight comparison with real DST (not going further than step 6.)].

2.b. Simul DST production [from PISA hits file using the (full way) camTask*.C macros]:

	Analysis Module	Function	Data Tables
1	EmcGetGEA	(gea package): Retrieves Geant data (from GEA and PAR nodes) for EMCal	IN: OUT: emcpar, dEmcGeaHit
2	mEmcGeaParams	Fills dEmcGeometry table with PISA geometry and dEmcGeaParams with Geant parameters	IN: emcpar OUT: dEmcGeaParams, dEmcGeometry
3	mEmcGeaMakeRaw	Core module for EMCal response	IN: header, dEmcGeaHit, dEmcGeaParams,dEmcRespPar,dEmcGeometry OUT: dEmcGeaTrackTower, dEmcGeaTowerTrack, dEmcRawData
4	mEmcGeaTrack	Writes input MC simulation information (fkin data plus ancestors) to each track	IN: dEmcGeaTrackTower OUT: dEmcGeaTrack
5	mEmcGeaEvent	Gets the PISA vertex information	IN: header OUT: dEmcEvent
6	mEmcGeometry	Builds the geometry	IN: OUT: dEmcGeometry
7	mEmcCalibTower	Makes calibrated data (GeV, ns) from the raw data by trivial subtraction of pedestal and multiplication with a fixed gain.	IN: dEmcRawData, dEmcGeometry, dEmcEvent OUT: dEmcCalibTower(and dEmcGeometry, dEmcEvent)
8	mEmcClusterNew	EMCal basic clustering	IN: dEmcCalibTower, dEmcGeometry, dEmcEvent OUT: dEmcClusterLocal, dEmcClusterLocalExt
9	mEmcGeaClusterEval	Evaluator module for EMCal	IN: dEmcEvent, dEmcGeaTrack , dEmcGeaTowerTrack, dEmcClusterLocalExt OUT: dEmcGeaTrackCluster, dEmcGeaClusterTrack

The final DST contains the following tables:

dEmcGeaTrackCluster, dEmcGeaClusterTrack [in the evaNode. For "Evaluation" analysis using step 9. In that case one needs the rawrel.root file containing the relational tables produced by mEmcGeaTrack and by mEmcGeaMakeRaw].
dEmcClusterLocal, dEmcClusterLocalExt, dEmcCalibTower [in the dstNode. for straight comparison with real DST (not going further than step 8.)].

2.c Production of simulated PRDF [from PISA hits file using camresp*.C macros]:

Schematically, "[camTask*.C] ~ [camresp*.C] + [camrec*.C or preco]". If you run separately the response and reco chains (i.e. if you go through 2.a instead of 2.b), the steps 1-4 of 2.b are done by the camresp*.C macros which produce the simulated PRDF using the following modules to output it in a proper format:

	Analysis Module	Function	Data Tables
1	mEmcRawToFEM	Converts the "raw" output data of the simulation response chain artificially into data in the FEM format	IN: dEmcRawData, OUT: dEmcFEMData, dEmcDCMLongData (**)
2	mEmcFEMToDCM	Converts FEM channel information into DCM channel information	IN: dEmcFEMData OUT: dEmcDCMData, dEmcDCMLongData (**)
3	EmcPutDCM EmcPutLong (**)	(gea package): Fills the raw data node with DCM (Long)data	IN: dEmcDCMData OUT: PHRawDataNode

(**) Year 2 PRDF long data format. Steps 1 and 2 are just done (in a one-step way ?) using mEmcRawToLong .

3. Simul+Real merging [from DST real and DST simul containing calibrated towers info]:

	Analysis Module	Function	Data Tables
1	mEmc(Gea)Event	Gets the PISA or Real vertex information	IN: header or dBbcOut OUT: dEmcEvent
2	mEmcGeometry	Builds the geometry	IN: OUT: dEmcGeometry
3	mEmcClusterNew	EMCal basic clustering	IN: dEmcCalibTower, dEmcGeometry, dEmcEvent OUT: dEmcClusterLocal, dEmcClusterLocalExt
4	mEmcGeaClusterEval	Evaluator module for EMCal	IN: dEmcEvent, dEmcGeaTrack , dEmcGeaTowerTrack, dEmcClusterLocalExt OUT: dEmcGeaTrackCluster, dEmcGeaClusterTrack

The cdo (or dEmcCalibtower) merging takes place between steps 2 and 3 above. The final DST may contain the following tables:

dEmcGeaTrackCluster, dEmcGeaClusterTrack [in the evaNode. For "Evaluation" analysis. In that case one needs the rawrel.root file containing the relational tables.].
dEmcClusterLocal, dEmcClusterLocalExt, and dEmcCalibTower independently for each Real and Simul event, plus GEANT input kinematics [in the dstNode. For afterwards "Evaluation", then step 4 above is not needed, but one needs the original GEANT input info].

D.d'E. Home page
D.d'E. Drafts
D.d'E Publish

enterria@in2p3.fr, denterri@bnl.gov

Last modified: Sun Jul 22 22:41:48 EDT 2001