Upstream Background Tagger (UBT) detector. More...

#include <UpstreamTagger.h>

Inheritance diagram for UpstreamTagger:

[legend]

Collaboration diagram for UpstreamTagger:

[legend]

Public Member Functions
	UpstreamTagger (const char *Name, Bool_t Active)

	UpstreamTagger ()

Bool_t	ProcessHits (FairVolume *v=0) override

void	SetZposition (Double_t z)

void	SetBoxDimensions (Double_t x, Double_t y, Double_t z)

void	ConstructGeometry () override

Public Member Functions inherited from SHiP::Detector< UpstreamTaggerPoint >
	Detector ()=default

	Detector (const char *Name, Bool_t Active, Int_t detID)

	Detector (const char *Name, Bool_t Active)

	~Detector () override=default

UpstreamTaggerPoint *	AddHit (Args &&... args)

void	ConstructGeometry () override=0

void	Initialize () override

void	Reset () override

void	EndOfEvent () override

void	Register () override

TClonesArray *	GetCollection (Int_t iColl) const override

void	UpdatePointTrackIndices (const std::map< Int_t, Int_t > &indexMap) override
	Update track indices in point collection after track filtering.

void	SetSpecialPhysicsCuts () override

void	FinishPrimary () override

void	FinishRun () override

void	BeginPrimary () override

void	PostTrack () override

void	PreTrack () override

void	BeginEvent () override

void	CopyClones (TClonesArray cl1, TClonesArray cl2, Int_t offset) override

Public Member Functions inherited from ISTLPointContainer
virtual void	UpdatePointTrackIndices (const std::map< Int_t, Int_t > &indexMap)=0
	Update track indices in point collection after track filtering.

virtual	~ISTLPointContainer ()=default

Public Attributes
Double_t	module [11][3]

Double_t	det_zPos

Double_t	xbox_fulldet = 4.4 * m
	z-position of detector (set via SetZposition)

Double_t	ybox_fulldet = 6.4 * m
	X dimension (default: 4.4 m)

Double_t	zbox_fulldet
	Y dimension (default: 6.4 m)

Private Member Functions
	UpstreamTagger (const UpstreamTagger &)=delete

UpstreamTagger &	operator= (const UpstreamTagger &)=delete

Private Attributes
TGeoVolume *	UpstreamTagger_fulldet
	Z dimension/thickness (default: 16 cm)

TGeoVolume *	scoringPlaneUBText

Additional Inherited Members
Protected Attributes inherited from SHiP::Detector< UpstreamTaggerPoint >
Int_t	fEventID

Int_t	fTrackID
	event index

Int_t	fVolumeID
	track index

TLorentzVector	fPos
	volume id

TLorentzVector	fMom
	position at entrance

Double_t	fTime
	momentum at entrance

Double_t	fLength
	time

Double_t	fELoss
	length

std::vector< UpstreamTaggerPoint > *	fDetPoints
	energy loss

TGeoVolume *	fDetector

Detailed Description

Upstream Background Tagger (UBT) detector.

The UBT is a simplified scoring plane detector implemented as a vacuum box. It serves as a background tagging device upstream of the decay volume.

Historical Note: The UBT was previously implemented as a detailed RPC (Resistive Plate Chamber) with multiple material layers (Glass, PMMA, Freon SF6, FR4, Aluminium, strips). It was simplified to a single vacuum box scoring plane to avoid geometry overlaps and reduce simulation complexity while maintaining its physics purpose. See commits 178787588 and related for the simplification history.

Current Implementation:

Simple vacuum box with configurable dimensions
Default dimensions: 4.4m (X) × 6.4m (Y) × 16cm (Z)
Z position and box dimensions are set from geometry_config.py
Configured via SetZposition() and SetBoxDimensions()

Definition at line 44 of file UpstreamTagger.h.

Constructor & Destructor Documentation

◆ UpstreamTagger() [1/3]

UpstreamTagger::UpstreamTagger	(	const char *	Name,
		Bool_t	Active
	)

Name : Detector Name Active: kTRUE for active detectors (ProcessHits() will be called) kFALSE for inactive detectors

Definition at line 53 of file UpstreamTagger.cxx.

    : Detector(name, active, kUpstreamTagger),
      det_zPos(0),
      UpstreamTagger_fulldet(0),
      scoringPlaneUBText(0) {}

◆ UpstreamTagger() [2/3]

UpstreamTagger::UpstreamTagger ( )

default constructor

Definition at line 47 of file UpstreamTagger.cxx.

    : Detector("UpstreamTagger", kTRUE, kUpstreamTagger),
      det_zPos(0),
      UpstreamTagger_fulldet(0),
      scoringPlaneUBText(0) {}

◆ UpstreamTagger() [3/3]

UpstreamTagger::UpstreamTagger ( const UpstreamTagger & )

privatedelete

container for data points

Member Function Documentation

◆ ConstructGeometry()

void UpstreamTagger::ConstructGeometry ( )

overridevirtual

Create the detector geometry

Implements SHiP::Detector< UpstreamTaggerPoint >.

Definition at line 114 of file UpstreamTagger.cxx.

                                       {
  TGeoVolume* top = gGeoManager->GetTopVolume();
 
 
 
 
  ShipGeo::InitMedium("vacuum");
  TGeoMedium* Vacuum_box = gGeoManager->GetMedium("vacuum");
 
  // Adding UBT Extension
  if (!Vacuum_box) {
    Fatal("ConstructGeometry", "Medium 'vacuum' not found.");
  }
 
  UpstreamTagger_fulldet =
      gGeoManager->MakeBox("Upstream_Tagger", Vacuum_box, xbox_fulldet / 2.0,
                           ybox_fulldet / 2.0, zbox_fulldet / 2.0);
  UpstreamTagger_fulldet->SetLineColor(kGreen);
 
  top->AddNode(UpstreamTagger_fulldet, 1,
               new TGeoTranslation(0.0, 0.0, det_zPos));
  AddSensitiveVolume(UpstreamTagger_fulldet);
  cout << " Z Position (Upstream Tagger1) " << det_zPos << endl;
 
  return;
}

◆ operator=()

UpstreamTagger & UpstreamTagger::operator= ( const UpstreamTagger & )

privatedelete

◆ ProcessHits()

Bool_t UpstreamTagger::ProcessHits ( FairVolume * v = 0 )

override

this method is called for each step during simulation (see FairMCApplication::Stepping())

This method is called from the MC stepping

Definition at line 59 of file UpstreamTagger.cxx.

                                                  {
  // Set parameters at entrance of volume. Reset ELoss.
  if (gMC->IsTrackEntering()) {
    fELoss = 0.;
    fTime = gMC->TrackTime() * 1.0e09;
    fLength = gMC->TrackLength();
    gMC->TrackPosition(fPos);
    gMC->TrackMomentum(fMom);
  }
 
  // Sum energy loss for all steps in the active volume
  fELoss += gMC->Edep();
 
  // Create vetoPoint at exit of active volume
  if (gMC->IsTrackExiting() || gMC->IsTrackStop() ||
      gMC->IsTrackDisappeared()) {
    if (fELoss == 0.) {
      return kFALSE;
    }
 
    fTrackID = gMC->GetStack()->GetCurrentTrackNumber();
    fEventID = gMC->CurrentEvent();
    Int_t uniqueId;
    gMC->CurrentVolID(uniqueId);
    if (uniqueId > 1000000)  // Solid scintillator case
    {
      Int_t vcpy;
      gMC->CurrentVolOffID(1, vcpy);
      if (vcpy == 5) uniqueId += 4;  // Copy of half
    }
 
    TParticle* p = gMC->GetStack()->GetCurrentTrack();
    Int_t pdgCode = p->GetPdgCode();
    TLorentzVector Pos;
    gMC->TrackPosition(Pos);
    TLorentzVector Mom;
    gMC->TrackMomentum(Mom);
    Double_t xmean = (fPos.X() + Pos.X()) / 2.;
    Double_t ymean = (fPos.Y() + Pos.Y()) / 2.;
    Double_t zmean = (fPos.Z() + Pos.Z()) / 2.;
 
    AddHit(fEventID, fTrackID, uniqueId, TVector3(xmean, ymean, zmean),
           TVector3(fMom.Px(), fMom.Py(), fMom.Pz()), fTime, fLength, fELoss,
           pdgCode, TVector3(Pos.X(), Pos.Y(), Pos.Z()),
           TVector3(Mom.Px(), Mom.Py(), Mom.Pz()));
 
    // Increment number of veto det points in TParticle
    ShipStack* stack = dynamic_cast<ShipStack*>(gMC->GetStack());
    stack->AddPoint(kUpstreamTagger);
  }
 
  return kTRUE;
}

◆ SetBoxDimensions()

void UpstreamTagger::SetBoxDimensions	(	Double_t	x,
		Double_t	y,
		Double_t	z
	)

inline

Definition at line 62 of file UpstreamTagger.h.

                                                            {
    xbox_fulldet = x;
    ybox_fulldet = y;
    zbox_fulldet = z;
  }

◆ SetZposition()

void UpstreamTagger::SetZposition ( Double_t z )

inline

Sets detector position and sizes

Definition at line 61 of file UpstreamTagger.h.

61{ det_zPos = z; }

Member Data Documentation

◆ det_zPos

Double_t UpstreamTagger::det_zPos

Detector parameters.

Definition at line 76 of file UpstreamTagger.h.

◆ module

Double_t UpstreamTagger::module[11][3]

Definition at line 71 of file UpstreamTagger.h.

◆ scoringPlaneUBText

TGeoVolume* UpstreamTagger::scoringPlaneUBText

private

Definition at line 85 of file UpstreamTagger.h.

◆ UpstreamTagger_fulldet

TGeoVolume* UpstreamTagger::UpstreamTagger_fulldet

private

Z dimension/thickness (default: 16 cm)

Definition at line 84 of file UpstreamTagger.h.

◆ xbox_fulldet

Double_t UpstreamTagger::xbox_fulldet = 4.4 * m

z-position of detector (set via SetZposition)

Definition at line 78 of file UpstreamTagger.h.

◆ ybox_fulldet

Double_t UpstreamTagger::ybox_fulldet = 6.4 * m

X dimension (default: 4.4 m)

Definition at line 79 of file UpstreamTagger.h.

◆ zbox_fulldet

Double_t UpstreamTagger::zbox_fulldet

Initial value:

=

16.0 * cm

cm

Double_t cm

Definition: ShipBellField.cxx:24

Y dimension (default: 6.4 m)

Definition at line 80 of file UpstreamTagger.h.

The documentation for this class was generated from the following files:

UpstreamTagger/UpstreamTagger.h
UpstreamTagger/UpstreamTagger.cxx

Public Member Functions

Public Attributes

Private Member Functions

Private Attributes

Additional Inherited Members