EsTime     MdcTrack     MdcKalTrack     MdcDedx     ExtTrack    

 

TofTrack     EmcShower     MucTrack     McParticle

 

Unit:   length(cm),   time(ns),   energy(GeV)

 

 

Type

Name

Description

RecEsTime

use EvTimeEvent  EvTimeEvent-*  Event

#include “EvTimeEvent/RecEsTime.h

the following items are only available for REC data

double              

getTest()

event start time

int

getStat()

status of time:  event type,  trigger timing,  get method

getStat()/100=1  colliding events

getStat()/100=2  cosmic events

(getStat()%100)/10=1  trigger timing: TOF

(getStat()%100)/10=2  trigger timing: MDC

getStat()%10=1  from TOF

getStat()%10=2  danger events from TOF

getStat()%10=3  change events before and after MDC recon

getStat()%10=4  from MDC

getStat()%10=5  danger

getStat()%10=6  change

getStat()%10=7  from segment fit

getStat()%10=8  six parameter fit

double

getQuality()

value between measured time and bunch time

 

RecMdcTrack

use MdcRecEvent  MdcRecEvent-*  Mdc

#include “MdcRecEvent/RecMdcTrack.h

the following items are available for both DST and REC data

int

trackId()

track id

int

charge()

track charge

double

helix(int i)

5 track parameters:(dr,f0,k,dz,tanl)

(d0,phi0,kappa,dz,tan(lamda))

double

err(int i)

15 matrix element of track parameter error matrix, 5*5 symmetry matrix saved with 15 element

double

p()

total momentum of track(GeV/c)

double

pxy(),px(),py(),pz()

components of track momentum (GeV/c)

Hep3Vector

p3()

track momentum

HepLorentzVector

p4(double mass)

4 momentum

HepPoint3D

x3(),poca()

point of closest approach to origin on track(cm)

double

x(),y(),z()

coordinate of poca(cm)

double

r()

distance form poca to origin(cm)

double

phi(),theta()

azimuthal and polar angle of track at poca(rads)

double

chi2()

c2(chi2) of track fitting

int

ndof()

degree of freedom for the fit

int

nster()

number of stereo layer hits on track

int

stat()

track fit quality status flag(undefined)

the following items are only available for REC data

HepPoint3D

getPivot()

coordinate of pivot

double

getVX0(),getVY0(),getVZ0()

pivot coordinate of the track

int

getNhits()

number of hits on track

double

getFiterm()

azimuthal angle value at track terminated point

HitRefVec

getVecHits()

vector of hits on track (the type of HitRecVec is SmartRefVector <RecMdcHit>)

 

RecMdcHit

use MdcRecEvent  MdcRecEvent-*  Mdc

#include “MdcRecEvent/RecMdcHit.h

the following items are only available for REC data

int

getId()

id of this hit on track

int

getTrkId()

id of track containing this hit

int

getFlagLR()

hit ambiguity flag indicate left or righ(0:left 1:right  2:ambiguous)

double

getDriftT()

drift time

double

getDriftDistLeft()

drift distance on the left

double

getDriftDistRight()

drift distance on the right

double

getErrDriftDistLeft()

error of drift distance on the left

double

getErrDriftDistRight()

error of drift distance on the right

double

getChisqAdd()

contribution to track fitting c2(chi2)

Identifier

getMdcId()

MDC identifier

double

getTdc()

raw TDC

double

getAdc()

raw ADC

double

getDoca()

distance of closest approach from helix to wire

double

getEntra()

entrance angle in azimuth

double

getZhit()

z coordinate of hit

double

getFltLen()

flight length from pivot to doca

double

getStat()

hit status flag(0:unused in fitting, 1:used int fitting)

 

RecMdcKalTrack

use MdcRecEvent  MdcRecEvent-*  Mdc

#include “MdcRecEvent/RecMdcKalTrack.h

for DST data, All of the interfaces of class RecMdcKalTrack are the same with class RecMdcTrack, which means, for example, you can use p3() to obtain the momentum of RecMdcKalTrack too.

But one important point users should keep in mind, that before use RecMdcKalTrack, set the Pid is required:

RecMdcKalTrack::setPidType(RecMdcKalTrack::muon);

the following items are only available for REC data

HepVector

getFHelix()

the helix parameters of the track at first hit layer

HepVector

getLHelix()

the helix parameters of the track at last hit layer

HepSymMatrix

getFError()

the error matrix of the track parameters at first hit layer

HepSymMatrix

getLError()

the error matrix of the track parameters at last hit layer

HelixSegRefVec

getVecHelixSegs()

Vector of KalHelixSeg of this RecMdcKalTrack

 

 

RecMdcKalHelixSeg

(this class is only for calibration and alignment use)

Identifier 

getMdcId()

MDC identifier of this helixSeg

double

getDoca_incl()

the doca between the wire and the track with the hit information

double

getDoca_excl()

the doca between the wire and the track without the hit information

double

getRes_incl()

the residual with the hit information

double

getRes_excl()

the residual without the hit information

HepVector 

getHelix()

the helix parameters of this kalman helixSeg

HepSymMatrix

getError()

the error matrix of this kalman helixSeg

 

RecMdcDedx

use MdcRecEvent  MdcRecEvent-*  Mdc

#include “MdcRecEvent/RecMdcDedx.h

the following items are available for both DST and REC data

int

trackId()

track id

int

particleId()

particle ID from dE/dx

int

status()

track fit quality status flag(undefined)

int

truncAlg()

truncate method

double

chi(int i)

Chi_dEdx values for different particles (0: e  1: mu   2: pi  3: K  4:p)

double

chiE()

Chi_dEdx values for electron

double

chiMu()

Chi_dEdx values for muon

double

chiPi()

Chi_dEdx values for pion

double

chiK()

Chi_dEdx values for kaon

double

chiP()

Chi_dEdx values for proton

int

numGoodHits() 

number of good de/dx hits(excluding overflow)

int

numTotalHits() 

number of total de/dx hits(including overflow)

double

probPH()

most probable pulse height from truncated mean

double

normPH() 

normalized pulse height

double

errorPH()

resolution of truncated mean

double

twentyPH()

de/dx value of bitrunction rate equal to 20%

the following items are only available for REC data

double

getDedxExpect(int pid)

expected value of dE/dx for 5 particle hypotheses

double

getSigmaDedx(int pid)

pivot coordinate of the track

double

getSigmaDedx(int pid)

number of hits on track

 

RecMdcDedxHit

use MdcRecEvent  MdcRecEvent-*  Mdc

#include “MdcRecEvent/RecMdcDedxHit.h

the following items are only available for REC data

double

getPathLength()

path length of hit cross the cell

int

getTrkId()

id of track containing this hit

int

getFlagLR()

hit ambiguity flag indicate left or righ(0:left 1:right  2:ambiguous)

Identifier

getMdcId()

MDC identifier

 

RecExtTrack

use ExtEvent  ExtEvent-*  Event

#include “ExtEvent/RecExtTrack.h

the following items are available for both DST and REC data

int

trackId()

Track ID

Information when particle enters the 1st layer of TOF:

Hep3Vector

tof1Position()

Position of the particle

Hep3Vector

tof1Momentum()

Momentum of the particle

string

tof1VolumeName()

Volume name of the scintillator which the particle enters

int

tof1VolumeNumber()

Volume number of the scintillator which the particle enters

double

tof1()

Time of flight

double

tof1Path()

Path of flight

double

tof1PosSigmaAlongZ()

Projection of the position error on Z axis

double

tof1PosSigmaAlongT()

Projection of the position error on the direction which is on transverse plane and is perpendicular to radial of position

double

tof1PosSigmaAlongX()

Projection of the position error on X axis

double

tof1PosSigmaAlongY()

Projection of the position error on Y axis

HepSymMatrix

tof1ErrorMatrix()

Error matrix of position and momentum (6 * 6)

Information when particle enters the 2ed layer of TOF:

Hep3Vector

tof2Position()

Position of the particle

Hep3Vector

tof2Momentum()

Momentum of the particle

string

tof2VolumeName()

Volume name of the scintillator which the particle enters

int

tof2VolumeNumber()

Volume number of the scintillator which the particle enters

double

tof2()

Time of flight

double

tof2Path()

Path of flight

double

tof2PosSigmaAlongZ()

Projection of the position error on Z axis

double

tof2PosSigmaAlongT()

Projection of the position error on the direction which is on transverse plane and is perpendicular to radial of position

double

tof2PosSigmaAlongX()

Projection of the position error on X axis

double

tof2PosSigmaAlongY()

Projection of the position error on Y axis

HepSymMatrix

tof2ErrorMatrix()

Error matrix of position and momentum (6 * 6)

Information when particle enters EMC:

Hep3Vector

emcPosition()

Position of the particle

Hep3Vector

emcMomentum()

Momentum of the particle

string

emcVolumeName()

Volume name of the crystal which the particle enters

int

emcVolumeNumber()

Volume number of the crystal which the particle enters

double

emcPosSigmaAlongTheta()

Projection of the position error on the polar angle direction

double

emcPosSigmaAlongPhi()

Projection of the position error on the azimuth angle direction

double

emcPath()

The path of flight in crystals

HepSymMatrix

emcErrorMatrix()

Error matrix of position and momentum (6 * 6)

Information when particle enters MUC:

Hep3Vector

mucPosition()

Position of the particle

Hep3Vector

mucMomentum()

Momentum of the particle

string

mucVolumeName()

Volume name of the module of MUC which the particle enters

int

mucVolumeNumber()

Volume number of the module of MUC which the particle enters

double

mucPosSigmaAlongZ()

Projection of the position error on Z axis

double

mucPosSigmaAlongT()

Projection of the position error on the direction which is on transverse plane and is perpendicular to radial of position

double

mucPosSigmaAlongX()

Projection of the position error on X axis

double

mucPosSigmaAlongY()

Projection of the position error on Y axis

HepSymMatrix

mucErrorMatrix()

Error matrix of position and momentum (6 * 6)

the following items are only available for REC data

ExtMucHitVec

getExtMucHitVec()

A vector type collection of information about track extrapolation on each layer of MUC which it can reach

 

RecTofTrack

use TofRecEvent  TofRecEvent-*  Tof

#include “TofRecEvent/RecTofTrack.h

the following items are available for both DST and REC data

int

trackID()

Track ID

int

tofID()

TOF Counter ID

int

tofTrackID()

Cluster(Group of TOF Hits) ID

unsigned int

status()

Raw/Readout/Counter/Track

End/Layer/Barrel

double

path()

Distance of flight

double

zrhit()

Hit position, for barrel, it is z, for endcap, it is r

double

ph()

Pulse height (adc) unit: channel

double

tof()

Time of flight, unit: to be determined

double

errtof()

Error of time of flight

double

beta()

Beta value of the particle

double

texp(int i)

Expected time of flight.

i: 0 electron, 1 muon, 2 pion, 3 kaon, 4 proton

double

texpElectron()

Expected time of flight of electron

double

texpMuon()

Expected time of flight of muon

double

texpPion()

Expected time of flight of pion

double

texpKaon()

Expected time of flight of kaon

double

texpProton()

Expected time of flight of proton

double

toffset(int i)

Time offset for each sort of particle

i: 0 electron, 1 muon, 2 pion, 3 kaon, 4 proton, 5 antiproton

double

toffsetElectron()

Time offset of electron

double

toffsetMuon()

Time offset of muon

double

toffsetPion()

Time offset of pion

double

toffsetKaon()

Time offset of kaon

double

toffsetProton()

Time offset of proton

double

toffsetAntiProton()

Time offset of anti-proton

double

sigma(int i)

Time resolution(sigma) for each sort of particle

i: 0 electron, 1 muon, 2 pion, 3 kaon, 4 proton, 5 antiproton

double

sigmaElectron()

Time resolution(sigma) of electron

double

sigmaMuon()

Time resolution(sigma) of muon

double

sigmaPion()

Time resolution(sigma) of pion

double

sigmaKaon()

Time resolution(sigma) of kaon

double

sigmaProton()

Time resolution(sigma) of proton

double

sigmaAntiProton()

Time resolution(sigma) of anti-proton

int

quality()

Data quality of reconstruction.

  1: good charged track

  2: neutral track with good hit

  0: ZT-ZTDC didnot match

  3: no hit in counter

  4: two hits in counter

  5: more than two hits in counter

  6: only single end output of one layer

  7: two hits in counter with bad match with ZTDC

  10: initialize

double

t0()

Event start time

double

errt0()

Error of event start time

double

errz()

Error of hit position (for neutral track)

double

phi()

Hit position, phi angle (barrel) (for neutral track)

double

errphi()

Error of phi angle(barrel) (for neutral track)

double

energy()

Energy deposit in TOF (for neutral track)

double

errenergy()

Error of energy deposit in TOF (for neutral track)

 

RecEmcShower

use EmcRecEventModel  EmcRecEventModel-*  Emc

#include “EmcRecEventModel/RecEmcShower.h

the following items are available for both DST and REC data

int

trackId()

Not used for EMC now.

int

numHits()

Number of crystals in the shower

int

status()

status=1: single seed cluster;
status=2: splitted from multi-seeds cluster.

int

cellId()

Central crystal’s identifier

int

module()

module=0: east endcap;  module=1: barrel;  module=2: west endcap.

HepPoint3D

position()

Shower position.

double

x()

Shower x coordinate.

double

y()

Shower y coordinate.

double

z()

Shower z coordinate.

double

theta()

Shower theta coordinate.

double

phi()

Shower phi coordinate.

double

dx()

Error for x coordinate.

double

dy()

Error for y coordinate.

double

dz()

Error for z coordinate.

double

dtheta()

Error for theta coordinate.

double

dphi()

Error for phi coordinate.

HepSymMatrix

errorMatrix()

Error matrix for x, y, z.

double

energy()

Shower energy after correction.

double

dE()

Error for shower energy.

double

eSeed()

Seed’s energy.

double

e3x3()

Energy sum of 3x3 crystal around seed.

double

e5x5()

Energy sum of 5x5 crystal around seed.

double

secondMoment()

Second moment for shower shape.

double

latMoment()

Lateral moment for shower shape.

double

A20Moment()

Zernike-20 moment for shower shape.

double

A42Moment()

Zernike-42 moment for shower shape.

the following items are only available for REC data

Identifier

getShowerId()

Shower’s identifier.

Identifier

getClusterId()

Cluster’s identifier.

RecEmcCluster*

getCluster()

Cluster’s point the shower belongs to.

RecEmcIDVector

getCellId3x3()

Vector contains 3x3 crystal id around seed.

RecEmcIDVector

getCellId5x5()

Vector contains 5x5 crystal id around seed.

RecEmcFractionMap

getFractionMap()

Map of RecEmcFraction in the shower. RecEmcFraction is inherited from RecEmcHit, with an extra member of energy fraction.

RecEmcFractionMap

getFractionMap3x3()

Map of 3x3 RecEmcFraction in the shower.

RecEmcFractionMap

getFractionMap5x5()

Map of 5x5 RecEmcFraction in the shower.

double

getTime()

Time of central crystal in the shower.

double

getEAll()

Energy sum of all crystals in the shower.

 

RecEmcHit

use EmcRecEventModel EmcRecEventModel-*  Emc

#include “EmcRecEventModel/RecEmcHit.h

the following items are only available for REC data

Identifier

getCellId()

Crystal’s identifier.

double

getEnergy()

Crystal’s energy.

double

getTime()

Crystal’s time.

HepPoint3D

getCenter()

Crystal center.

HepPoint3D

getFrontCenter()

Crystal front center.

 

 

 

RecEmcFraction

use EmcRecEventModel EmcRecEventModel-*  Emc

#include “EmcRecEventModel/RecEmcFraction.h

RecEmcFraction inherits from RecEmcHit

the following items are only available for REC data

double

getFraction()

Energy fraction of this hit.

 

RecEmcCluster

use EmcRecEventModel  EmcRecEventModel-*  Emc

#include “EmcRecEventModel/RecEmcCluster.h

the following items are available only for REC data

Identifier

getClusterId()

Cluster’s identifier.

double

getEnergy()

Cluster’s energy.

HepPoint3D

getPosition()

Cluster center.

double

getSecondMoment()

Second moment for cluster shape.

int

getShowerSize()

Number of showers in the cluster.

 

RecMucTrack

use MucRecEvent  MucRecEvent-*  Muc

#include “MucRecEvent/RecMucTrack.h

the following items are available for both DST and REC data

int

trackId()

id of ext track

int

id()

id of this muc track

int

status()

status of the track. 1: 3D line.

int

type()

seed mode. 0: ext, 1: emc, 2: muc

int

startPart()

start position of track locates in which part

int

endPart()

end position of track locates in which part

int

brLastLayer()

last layer with hits in barrel

int

ecLastLayer()

last layer with hits in end cap

int

numHits()

total hits on the track

int

numLayers()

number of layers with hits

int

maxHitsInLayer()

max number of hits in layers

double

depth()

depth of the track transport in iron

double

chi2()

c2 of track fitting

int

dof()

degree of freedom for the fit

double

rms()

track fit quality status flag(undefined)

double

xPos(),yPos(),zPos()

position on the start of track in muc (mm)

double

xPosSigma(),yPosSigma(),zPosSigma()

error of position on the start of track in muc (mm)

double

px(),py(),pz()

momentum on the start of track in muc

double

distance()

distance between ext track and fired strip in 1st layer of MUC

double

deltaPhi()

delta phi between mdc momentum and direction of MUC track

the following items are only available for REC data

vector<int>

getVecHits()

hit list of attached strip in this track

vector<int>

getExpHits()

hit list of expected strip in this track

vector<float>

getDistHits()

distance between hit and the track

 

McParticle

use McTruth  McTruth-*  Event

#include “McTruth/McParticle.h

int

trackIndex()

index of this particle

int

particleProperty()

particle’s PDG code

bool

primaryParticle()

whether this is a primary particle.

for primary particle, the mother is itself

bool

leafParticle()

whether this is a leaf particle, there’s no daughter for leaf particle

bool

decayFromGenerator()

whether this particle decayed from generator

bool

decayInFlight()

whether this particle by Geant4 decayed during flight

int

vertexIndex0()

the start vertex index of this particle

int

vertexIndex1()

the end vertex index of this particle

HepLorentzVector

initialPosition()

position at start vertex

HepLorentzVector

finalPosition()

position at end vertex

HepLorentzVector

initialFourMomentum()

initial 4-momentum at start vertex

McParticle

mother()

mother particle. For primary particle, the mother is itself

SmartRefVector<McParticle>

daughterList()

list of its daughter particles