Glossary of Leaf Meanings in the NtpSR Tree

Edition 1.0, August 2003

To use this glossary, use the ^F (CTRL+F) feature of your browser to search for the terms you want to use. Start with the NtpSR prefix at the top to select the correct array, then scroll down to the array's leaves and select the one whose description is the closest match to what you want, and so on.
Variables are called by their tree prefix and leaf variable names, in the form prefix.variable in the NtpSR tree, e.g. trk.momentum.qp for the track momentum by curvature.


Tree Branches

Tree

Header File

Branch

Type

Description






NtpSR

NtpSRRecord






evthdr

NtpSREventSummary

event summary data



vetohdr

NtpSRShieldSummary

veto shield summary data



crhdr

NtpSRCosmicRay

cr data, filled from last recons. trk vertex



dmxstatus

NtpSRDmxStatus

status of demux








vetostp

TClonesArray*

-> array of veto shield strips



stp

TClonesArray*

-> array of strips



slc

TClonesArray*

-> array of slices



shw

TClonesArray*

-> array of showers



trk

TClonesArray*

-> array of tracks



evt

TClonesArray*

-> array of events



Twigs

Tree Prefix

Header File

Leaf Variable

Type

Description






evthdr.

NtpSREventSummary






ndigit

UInt_t

number of digits



nstrip

UInt_t

number of strips



nslice

UShort_t

number of slices



ntrack

UShort_t

number of tracks



nshower

UShort_t

number of showers



nevent

UShort_t

number of events



trigtime

Double_t

fractional second



ph

NtpSRPulseHeight

summed digit pulse height



date

NtpSRDate

utc date






vetohdr.

NtpSRShieldSummary






digits

ShieldSummary

ShieldSummary digits are classified as pretrigger (0), in trigger (1), or



trigger

post

post trigger (2). ndigit,nplank,adc,dx,dxvetostp store data for each of



3

these

these 3 timezones. Time is relative to track vertex, and corrected for



walk

time

time walk and optical fiber propagation delay.



ndigit[3]

UInt_t

number of digits



scintillator

Contiguous

Contiguous scintillator strips in the shield are grouped together and read



by

out

out by a single PMT pixel. These sets (mostly of 8 strips) are referred to



planks.

as

as planks.



nplank[3]

UInt_t

number of planks



adc[3]

Int_t

summed adc count



dx[3]

Float_t

spatial res.(m) between proj. track and nearest vs hit



dxvetostp[3]

Int_t

index in vetostp array of nearest shield hit



dcos

Float_t

normal direction cosine to shield at intercept



projx

Float_t

x coordinate of projected track position (m)



projy

Float_t

y coordinate of projected track position (m)



projz

Float_t

z coordinate of projected track position (m)



ishit

Bool_t

projection is within boundaries of shield plane






crhdr.

NtpSRCosmicRay






zenith

Float_t

zenith angle (degrees)



azimuth

Float_t

azimuthal angle measured easterly from north (degrees)



ra

Float_t

right ascension (degrees)



rahourangle

Float_t

right ascension (hours)



dec

Float_t

declination (degrees)



juliandate

Double_t

julian date (days since Jan 1, 4713 BC 12h UT)



locsiderialtime

Float_t

local sidereal time (hours)






dmxstatus.

NtpDmxStatus






ismultimuon

UChar_t

flag (0 or 1) for multiple muon event



nonphysicalfail

UChar_t

flag (0 or 1) for non-physical solution failure



validplanesfail

UChar_t

flag (0 or 1) for too few valid planes failure



vertexplanefail

UChar_t

flag (0 or 1) for no vertex failure



ustrayplanes

UShort_t

number of planes off dmx best fit (u-view)



vstrayplanes

UShort_t

number of planes off dmx best fit (v-view)



uvalidplanes

UShort_t

number of valid planes used in dmx (u-view)



vvalidplanes

UShort_t

number of valid planes used in dmx (v-view)



avgtimeoffset

Float_t

measure of dmx validity from timing (sec)






vetostp.

NtpSRShieldStrip






ndigit

Int_t

number of digits (1 or 2) associated with strip



pln

Int_t

plane number



plank

Int_t

strip number of first PlexStripEndId



x

Float_t

x position of shield strip center (m)



y

Float_t

y position of shield strip center (m)



z[2]

Float_t

z position of shield strip end (m) (0 = S end, 1 = N end)



adc[2]

Int_t

0=S, 1=N



pmtindex[2]

Int_t

0=S, 1=N



pmtpixel[2]

Int_t

0=S, 1=N



wlspigtail[2]

Float_t

0=S, 1=N



clearlen[2]

Float_t

0=S, 1=N



time[2]

Double_t

3-d corrected time - event trigger time (sec) 0=S,1=N



timeraw[2]

Double_t

raw time - event trigger time (sec) 0=S,1=N

Contiguous scintillator strips in the shield are grouped together and read out by a single PMT pixel. These sets (mostly of 8 strips) are referred to as planks.

The 3-d time correction includes a pulse height dependent time walk correction and corrections for optical fiber propagation delays.



Tree Prefix

Header File

Leaf Variable

Type

Description






stp.

NtpSRStrip






index

Int_t

index of this strip in strip array



planeview

Char_t

planeview (ala PlaneView::EPlaneView)



ndigit

UShort_t

number of digits on strip



demuxveto

UShort_t

demux veto flag



strip

UShort_t

strip number



plane

UShort_t

plane number



tpos

Float_t

transverse position (m)



z

Float_t

z position (m)



pmtindex0

Int_t

crate*108+varcId*36+vmm*6+vaAdcSel*3+vaChip (east)



pmtindex1

Int_t

crate*108+varcId*36+vmm*6+vaAdcSel*3+vaChip (west)



time0

Double_t

charge weighted mean (sec) (east)



time1

Double_t

charge weighted mean (sec) (west)



ph0

NtpSRPulseHeight

digit pulse height (east)



ph1

NtpSRPulseHeight

digit pulse height (west)






slc.

NtpSRSlice






index

UShort_t

index of this slice in slice array



ndigit

Int_t

number of digits in slice



nstrip

Int_t

number of strips in slice



stp

Int_t*

[nstrip] indices of associated strips in strip array



ph

NtpSRPulseHeight

summed digit pulse height



plane

NtpSRPlane

range of planes






shw.

NtpSRShower






index

UShort_t

index of this shower in shower array



ndigit

Int_t

number of digits in shower



nstrip

Int_t

number of strips in shower



stp

Int_t*

[nstrip] indices to associated strips in strip array



ph

NtpSRStripPulseHeight

summed strip pulse height



plane

NtpSRPlane

range of planes



vtx

NtpSRVertex

vertex - not filled?






trk.

NtpSRTrack






index

UShort_t

index of this track in track array



ndigit

Int_t

number of digits in track



nstrip

Int_t

number of strips in track



*stp

Int_t

[nstrip] indices of assoc. strips in strip array



*stpfit

Bool_t

[nstrip] 1 if hit strip was used in final track fit



positional

Track

Track positional information at plane associated with each strip



*stpu

Float_t

[nstrip] U-position of track at strip plane (m)



*stpv

Float_t

[nstrip] V-position of track at strip plane (m)



*stpx

Float_t

[nstrip] Z-position of track at strip plane (m)



*stpy

Float_t

[nstrip] Y-position of track at strip plane (m)



*stpz

Float_t

[nstrip] Z-position of track at strip plane (m)



*stpds

Float_t

[nstrip] track path length from track end (m)



*stpfitchi2

Float_t

[nstrip] final chi2 at strip plane



*stpfitprechi2

Float_t

[nstrip] pre chi2 from Kalman filter at strip plane



*stpfitqp

Float_t

[nstrip] charge over momentum at strip plane (GeV)



*stpph0sigmap

Float_t

[nstrip] ph corrected for fiber attenuation (east)



*stpph0mip

Float_t

[nstrip] ph in MIPs (east)



*stpph0gev

Float_t

[nstrip] ph in GeV (east)



*stpph1sigmap

Float_t

[nstrip] ph corrected for fiber attenuation (west)



*stpph1mip

Float_t

[nstrip] ph in MIPs (west)



*stpph1gev

Float_t

[nstrip] ph in GeV (west)



*stpattn0c0

Float_t

[nstrip] C0 from mapper results (east)



*stpattn1c0

Float_t

[nstrip] C0 from mapper results (west)



*stpt0

Double_t

[nstrip] 3-d time corr. for propagation delays (sec) (E)



*stpt1

Double_t

[nstrip] 3-d time corr. for propagation delays (sec) (W)



*stptcal0t0

Double_t

[nstrip] T0 offset (sec) (east)



*stptcal1t0

Double_t

[nstrip] T0 offset (sec) (west)



ds

Float_t

total path length of track from vertex to end (m)



range

Float_t

amount of material traversed from vertex to end (g



cputime

Float_t

CPU time to create track list which contains this track



ph

NtpSRStripPulseHeight

summed strip pulse height



plane

NtpSRTrackPlane

range of planes, timing used to determine start



vtx

NtpSRVertex

vertex coordinates



end

NtpSRVertex

coordinates at end plane



lin

NtpSRVertex

coordinates from linear fit



fidvtx

NtpSRFiducial

containment information for vertex



fidend

NtpSRFiducial

containment information for track end



fidall

NtpSRFiducial

containment information for distance of closest



over

approach

approach over all 3D points on the track



time

NtpSRTrackTime

track timing data



momentum

NtpSRMomentum

track momentum data



fit

NtpSRFitTrack

data from track fit






evt.

NtpSREvent






index

UShort_t

index of this event in event array



ndigit

Int_t

number of digits in event



nstrip

Int_t

number of strips in event



stp

Int_t*

[nstrip] indices to associated strips in strip array



nshower

Int_t

number of showers in event



shw

Int_t*

[nshower] indices to associated showers in shower array



ntrack

Int_t

number of tracks in event



trk

Int_t*

[ntrack] indices to associated tracks in track array



ph

NtpSRStripPulseHeight

summed strip pulse height



plane

NtpSRPlane

range of planes



vtx

NtpSRVertex

vertex



end

NtpSRVertex

event end point, set to end of primary track



Tree Leaves

Tree Prefix

Header File

Leaf Variable

Type

Description






evthdr.date.

NtpSRDate






year

UShort_t

year, e.g. 1997



month

Char_t

month (1-12)



day

Char_t

day (1-31)



hour

Char_t

hour (0-23)



minute

Char_t

minute (0-59)



sec

Double_t

sec (0-60) (potential for leap seconds)



utc

UInt_t

utc seconds relative to Jan 1, 1970 00:00:00 UTC



.begreadout from either end. planeall.n is determined as the number ofplanes within this range with non-zero readout from either end.range of planes all digitsplane.begwith a summed ph > 3 pe across both ends. The minimum plane of the firstsuch group and the maximum plane of the last such group form plane.begand plane.end respectively. plane.n is the number of planes betweenplane.beg and plane.end with non-zero readout from either end.Within these boundaries, the uto the mindigits above threshold (nominally 3 pe)date.sec is filled with (the vldtimestamp->GetSec() +the digitlisthandle -> GetAbsTime())



Tree Prefix

Header File

Leaf Variable

Type

Description








trk.fidall.

NtpSRFiducial




trk.fidend.


dr

Float_t

minimum transverse distance to the detector edge (m)

trk.fidvtx.




positive => contained within the detector.



dz

Float_t

minimum longitudinal distance to the detector edge (m)





If a magnetic track fitting package has been used, "trace" variables





represents swum values in the magnetic field



trace

Float_t

path length (m) between the track vtx and detector edge



tracez

Float_t

path length (m) between the track vtx and z-edge(m)



nplane

Int_t

number of planes extrapolated to beg



nplaneu

Int_t

number of planes extrapolated to beg



nplanev

Int_t

number of planes extrapolated to beg






trk.fit.

NtpSRFitTrack






pass

Bool_t




ndof

Int_t




niterate

Int_t




nswimfail

Int_t




chi2

Float_t




cputime

Float_t

execution time in seconds






?

NtpSRMCTruth






inu

Int_t

PDG id of neutrino



inunoosc

Int_t

PDG id of un-oscillated neutrino



itg

Int_t

PDG id of target nucleon



iboson

Int_t

PDG id of exchange boson



iresonance

Int_t

resonance number



iaction

Int_t

0=NC 1=CC (2=QE 3=QE+pi)



a

Float_t

nucleus A



z

Float_t

nucleon Z



sigma

Float_t

cross section for this interaction



x

Float_t

x



y

Float_t

y



q2

Float_t

Q**2



w2

Float_t

W**2



emfrac

Float_t

fraction of "shower" energy which is EM



vtxx

Float_t




vtxy

Float_t




vtxz

Float_t




p4neu[4]

Float_t




p4neunoosc[4]

Float_t




p4tgt[4]

Float_t




p4shw[4]

Float_t




p4mu1[4]

Float_t




p4mu2[4]

Float_t




p4el1[4]

Float_t




p4el2[4]

Float_t




p4tau[4]

Float_t







trk.momentum.

NtpSRMomentum






range

Float_t

momentum (GeV) of track from range (same for stop as not)



qp

Float_t

momentum (GeV) from curvature in the magnetic field



eqp

Float_t

uncertainty from qp fit






*.plane.

NtpSRPlane






n

UShort_t

number of planes



nu

UShort_t

number of u planes



nv

UShort_t

number of v planes



beg

UShort_t

begin plane number



begu

UShort_t

begin u-plane number



begv

UShort_t

begin v-plane number



end

UShort_t

end plane number



endu

UShort_t

end u-plane number



endv

UShort_t

end v-plane number






*.ph.

NtpSRPulseHeight






raw

Float_t

raw adc count (CalDigit



siglin

Float_t

corrected for nonlinearities (CalDigit



sigcor

Float_t

normalized strip response (CalDigit



pe

Float_t

photoelectrons (CalDigit






?

NtpSRStdHep






IstHEP

Int_t

status code



IdHEP

Int_t

particle ID (PDG standard)



mass

Float_t




p4[4]

Float_t




vtx[4]

Float_t







stp.ph0.

NtpSRStripPulseHeight



stp.ph1.


sigmap

Float_t

charge using CalStripType::kSigMapped



mip

Float_t

charge using CalStripType::kMIP



gev

Float_t

charge using CalStripType::kGeV






trk.plane.

NtpSRTrackPlane






ntrklike

UShort_t

number of "clean" hit planes in the track

A clean plane is one in which the plane is free from the presence of non-track associated hits

Tree Prefix

Header File

Leaf Variable

Type

Description






trk.time.

NtpSRTrackTime






ndigit

UShort_t

no. of digits used to determine track dir. from timing



chi2

Float_t

chi2 of fit done on track direction determination



hold

u0,u1,v0,v1

u0,u1,v0,v1 hold the mean values of the fully calibrated and propagation



corrected

delay

delay corrected times for the separate views and strip ends



u0

Float_t

time (sec) u-view east



u1

Float_t

time (sec) u-view west



v0

Float_t

time (sec) v-view east



v1

Float_t

time (sec) v-view west



cdtds

Float_t

c (speed of light) x time x distance



du

Float_t

diff(m) between timing based position and spatial position



dv

Float_t

diff(m) between timing based position and spatial position



dtds

Double_t

unnormalized slope from time fit used to determine beta



t0

Double_t

offset from time fit used to determine beta






*.vtx.

NtpSRVertex






plane

Int_t

plane number



u

Float_t

U-coordinate (m)



v

Float_t

V-coordinate (m)



x

Float_t

X-coordinate (m)



y

Float_t

Y-coordinate (m)



z

Float_t

Z-coordinate (m)



t

Float_t

Time (sec)



dcosu

Float_t

Direction cosine-U



dcosv

Float_t

Direction cosine-V



dcosx

Float_t

Direction cosine-X



dcosy

Float_t

Direction cosine-Y



dcosz

Float_t

Direction cosine-Z



eu

Float_t

Error on u-coordinate (m)



ev

Float_t

Error on v-coordinate (m)



ex

Float_t

Error on x-coordinate (m)



ey

Float_t

Error on y-coordinate (m)



edcosu

Float_t

Error on direction cosine-U



edcosv

Float_t

Error on direction cosine-V



edcosx

Float_t

Error on direction cosine-X



edcosy

Float_t

Error on direction cosine-Y



edcosz

Float_t

Error on direction cosine-Z

The velocity of the track is measured by comparing the corrected times to the travel distance. Timing is based position is determined from time diff. of readout at 2 ends, spatial based position is determined from strip locations in opposite view



Sue Kasahara & Phil Symes