LArPandoraInput class. More...

#include "LArPandoraInput.h"

Classes
class	Settings
	Settings class. More...

Static Public Member Functions
static void	CreatePandoraHits2D (const Settings &settings, const LArDriftVolumeMap &driftVolumeMap, const HitVector &hitVector, IdToHitMap &idToHitMap)
	Create the Pandora 2D hits from the ART hits. More...

static void	CreatePandoraLArTPCs (const Settings &settings, const LArDriftVolumeList &driftVolumeList)
	Create pandora LArTPCs to represent the different drift volumes in use. More...

static void	CreatePandoraDetectorGaps (const Settings &settings, const LArDriftVolumeList &driftVolumeList, const LArDetectorGapList &listOfGaps)
	Create pandora line gaps to cover dead regions between TPCs in a global drift volume approach. More...

static void	CreatePandoraReadoutGaps (const Settings &settings, const LArDriftVolumeMap &driftVolumeMap)
	Create pandora line gaps to cover any (continuous regions of) bad channels. More...

static void	CreatePandoraMCParticles (const Settings &settings, const MCTruthToMCParticles &truthToParticles, const MCParticlesToMCTruth &particlesToTruth, const RawMCParticleVector &generatorMCParticleVector)
	Create the Pandora MC particles from the MC particles. More...

static void	FindPrimaryParticles (const RawMCParticleVector &mcParticleVector, std::map< const simb::MCParticle, bool > &primaryMCParticleMap)
	Find all primary MCParticles in a given vector of MCParticles. More...

static bool	IsPrimaryMCParticle (const art::Ptr< simb::MCParticle > &mcParticle, std::map< const simb::MCParticle, bool > &primaryMCParticleMap)
	Check whether an MCParticle can be found in a given map. More...

static void	CreatePandoraMCLinks2D (const Settings &settings, const HitMap &hitMap, const HitsToTrackIDEs &hitToParticleMap)
	Create links between the 2D hits and Pandora MC particles. More...

Static Private Member Functions
static void	GetTrueStartAndEndPoints (const Settings &settings, const art::Ptr< simb::MCParticle > &particle, int &startT, int &endT)
	Loop over MC trajectory points and identify start and end points within the detector. More...

static void	GetTrueStartAndEndPoints (const unsigned int cstat, const unsigned int tpc, const art::Ptr< simb::MCParticle > &particle, int &startT, int &endT)
	Loop over MC trajectory points and identify start and end points within a given cryostat and TPC. More...

static float	GetTrueX0 (const art::Ptr< simb::MCParticle > &particle, const int nT)
	Use detector and time services to get a true X offset for a given trajectory point. More...

static double	GetMips (const Settings &settings, const double hit_Charge, const geo::View_t hit_View)
	Convert charge in ADCs to approximate MIPs. More...

Detailed Description

LArPandoraInput class.

Definition at line 22 of file LArPandoraInput.h.

Member Function Documentation

void lar_pandora::LArPandoraInput::CreatePandoraDetectorGaps	(	const Settings &	settings,
		const LArDriftVolumeList &	driftVolumeList,
		const LArDetectorGapList &	listOfGaps
	)

static

Create pandora line gaps to cover dead regions between TPCs in a global drift volume approach.

Parameters

settings	the settings
driftVolumeList	the drift volume list
listOfGaps	the list of gaps

Definition at line 213 of file LArPandoraInput.cxx.

References lar_pandora::LArPandoraInput::Settings::m_pPrimaryPandora, and max.

Referenced by lar_pandora::LArPandora::beginJob().

 {
     mf::LogDebug("LArPandora") << " *** LArPandoraInput::CreatePandoraDetectorGaps(...) *** " << std::endl;
 
     if (!settings.m_pPrimaryPandora)
         throw cet::exception("LArPandora") << "CreatePandoraDetectorGaps - primary Pandora instance does not exist ";
 
     const pandora::Pandora *pPandora(settings.m_pPrimaryPandora);
 
     for (const LArDetectorGap &gap : listOfGaps)
     {
         PandoraApi::Geometry::LineGap::Parameters parameters;
 
         try
         {
             parameters.m_lineGapType = pandora::TPC_DRIFT_GAP;
             parameters.m_lineStartX = gap.GetX1();
             parameters.m_lineEndX = gap.GetX2();
             parameters.m_lineStartZ = -std::numeric_limits<float>::max();
             parameters.m_lineEndZ = std::numeric_limits<float>::max();
         }
         catch (const pandora::StatusCodeException &)
         {
             mf::LogWarning("LArPandora") << "CreatePandoraDetectorGaps - invalid line gap parameter provided, all assigned values must be finite, line gap omitted " << std::endl;
             continue;
         }
 
         try
         {
             PANDORA_THROW_RESULT_IF(pandora::STATUS_CODE_SUCCESS, !=, PandoraApi::Geometry::LineGap::Create(*pPandora, parameters));
         }
         catch (const pandora::StatusCodeException &)
         {
             mf::LogWarning("LArPandora") << "CreatePandoraDetectorGaps - unable to create line gap, insufficient or invalid information supplied " << std::endl;
             continue;
         }
     }
 }

void lar_pandora::LArPandoraInput::CreatePandoraHits2D	(	const Settings &	settings,
		const LArDriftVolumeMap &	driftVolumeMap,
		const HitVector &	hitVector,
		IdToHitMap &	idToHitMap
	)

static

Create the Pandora 2D hits from the ART hits.

Parameters

settings	the settings
driftVolumeMap	the mapping from volume id to drift volume
hits	the input list of ART hits for this event
idToHitMap	to receive the mapping from Pandora hit ID to ART hit

Definition at line 41 of file LArPandoraInput.cxx.

Referenced by lar_pandora::LArPandora::CreatePandoraInput().

 {
     mf::LogDebug("LArPandora") << " *** LArPandoraInput::CreatePandoraHits2D(...) *** " << std::endl;
 
     if (!settings.m_pPrimaryPandora)
         throw cet::exception("LArPandora") << "CreatePandoraHits2D - primary Pandora instance does not exist ";
 
     const pandora::Pandora *pPandora(settings.m_pPrimaryPandora);
 
     art::ServiceHandle<geo::Geometry> theGeometry;
     auto const* theDetector = lar::providerFrom<detinfo::DetectorPropertiesService>();
 
     // Loop over ART hits
     int hitCounter(0);
 
     lar_content::LArCaloHitFactory caloHitFactory;
 
     for (HitVector::const_iterator iter = hitVector.begin(), iterEnd = hitVector.end(); iter != iterEnd; ++iter)
     {
         const art::Ptr<recob::Hit> hit = *iter;
         const geo::WireID hit_WireID(hit->WireID());
 
         // Get basic hit properties (view, time, charge)
         const geo::View_t hit_View(hit->View());
         const double hit_Charge(hit->Integral());
         const double hit_Time(hit->PeakTime());
         const double hit_TimeStart(hit->PeakTimeMinusRMS());
         const double hit_TimeEnd(hit->PeakTimePlusRMS());
 
         // Get hit X coordinate and, if using a single global drift volume, remove any out-of-time hits here
         const double xpos_cm(theDetector->ConvertTicksToX(hit_Time, hit_WireID.Plane, hit_WireID.TPC, hit_WireID.Cryostat));
         const double dxpos_cm(std::fabs(theDetector->ConvertTicksToX(hit_TimeEnd, hit_WireID.Plane, hit_WireID.TPC, hit_WireID.Cryostat) -
             theDetector->ConvertTicksToX(hit_TimeStart, hit_WireID.Plane, hit_WireID.TPC, hit_WireID.Cryostat)));
 
         // Get hit Y and Z coordinates, based on central position of wire
         double xyz[3];
         theGeometry->Cryostat(hit_WireID.Cryostat).TPC(hit_WireID.TPC).Plane(hit_WireID.Plane).Wire(hit_WireID.Wire).GetCenter(xyz);
         const double y0_cm(xyz[1]);
         const double z0_cm(xyz[2]);
 
         // Get other hit properties here
         const double wire_pitch_cm(theGeometry->WirePitch(hit_View)); // cm
         const double mips(LArPandoraInput::GetMips(settings, hit_Charge, hit_View));
 
         // Create Pandora CaloHit
         lar_content::LArCaloHitParameters caloHitParameters;
 
         try
         {
             caloHitParameters.m_expectedDirection = pandora::CartesianVector(0., 0., 1.);
             caloHitParameters.m_cellNormalVector = pandora::CartesianVector(0., 0., 1.);
             caloHitParameters.m_cellSize0 = settings.m_dx_cm;
             caloHitParameters.m_cellSize1 = (settings.m_useHitWidths ? dxpos_cm : settings.m_dx_cm);
             caloHitParameters.m_cellThickness = wire_pitch_cm;
             caloHitParameters.m_cellGeometry = pandora::RECTANGULAR;
             caloHitParameters.m_time = 0.;
             caloHitParameters.m_nCellRadiationLengths = settings.m_dx_cm / settings.m_rad_cm;
             caloHitParameters.m_nCellInteractionLengths = settings.m_dx_cm / settings.m_int_cm;
             caloHitParameters.m_isDigital = false;
             caloHitParameters.m_hitRegion = pandora::SINGLE_REGION;
             caloHitParameters.m_layer = 0;
             caloHitParameters.m_isInOuterSamplingLayer = false;
             caloHitParameters.m_inputEnergy = hit_Charge;
             caloHitParameters.m_mipEquivalentEnergy = mips;
             caloHitParameters.m_electromagneticEnergy = mips * settings.m_mips_to_gev;
             caloHitParameters.m_hadronicEnergy = mips * settings.m_mips_to_gev;
             caloHitParameters.m_pParentAddress = (void*)((intptr_t)(++hitCounter));
             caloHitParameters.m_larTPCVolumeId = LArPandoraGeometry::GetVolumeID(driftVolumeMap, hit_WireID.Cryostat, hit_WireID.TPC);
 
             const geo::View_t pandora_View(LArPandoraGeometry::GetGlobalView(hit_WireID.Cryostat, hit_WireID.TPC, hit_View));
 
             if (pandora_View == geo::kW)
             {
                 caloHitParameters.m_hitType = pandora::TPC_VIEW_W;
                 const double wpos_cm(pPandora->GetPlugins()->GetLArTransformationPlugin()->YZtoW(y0_cm, z0_cm));
                 caloHitParameters.m_positionVector = pandora::CartesianVector(xpos_cm, 0., wpos_cm);
             }
             else if(pandora_View == geo::kU)
             {
                 caloHitParameters.m_hitType = pandora::TPC_VIEW_U;
                 const double upos_cm(pPandora->GetPlugins()->GetLArTransformationPlugin()->YZtoU(y0_cm, z0_cm));
                 caloHitParameters.m_positionVector = pandora::CartesianVector(xpos_cm, 0., upos_cm);
             }
             else if(pandora_View == geo::kV)
             {
                 caloHitParameters.m_hitType = pandora::TPC_VIEW_V;
                 const double vpos_cm(pPandora->GetPlugins()->GetLArTransformationPlugin()->YZtoV(y0_cm, z0_cm));
                 caloHitParameters.m_positionVector = pandora::CartesianVector(xpos_cm, 0., vpos_cm);
             }
             else
             {
                 throw cet::exception("LArPandora") << "CreatePandoraHits2D - this wire view not recognised (View=" << hit_View << ") ";
             }
         }
         catch (const pandora::StatusCodeException &)
         {
             mf::LogWarning("LArPandora") << "CreatePandoraHits2D - invalid calo hit parameter provided, all assigned values must be finite, calo hit omitted " << std::endl;
             continue;
         }
 
         // Store the hit address
         if (hitCounter >= settings.m_uidOffset)
             throw cet::exception("LArPandora") << "CreatePandoraHits2D - detected an excessive number of hits (" << hitCounter << ") ";
 
         idToHitMap[hitCounter] = hit;
 
         // Create the Pandora hit
         try
         {
             PANDORA_THROW_RESULT_IF(pandora::STATUS_CODE_SUCCESS, !=, PandoraApi::CaloHit::Create(*pPandora, caloHitParameters, caloHitFactory));
         }
         catch (const pandora::StatusCodeException &)
         {
             mf::LogWarning("LArPandora") << "CreatePandoraHits2D - unable to create calo hit, insufficient or invalid information supplied " << std::endl;
             continue;
         }
     }
 }

void lar_pandora::LArPandoraInput::CreatePandoraLArTPCs	(	const Settings &	settings,
		const LArDriftVolumeList &	driftVolumeList
	)

static

Create pandora LArTPCs to represent the different drift volumes in use.

Parameters

settings	the settings
driftVolumeList	the drift volume list

Definition at line 162 of file LArPandoraInput.cxx.

References lar_pandora::LArPandoraInput::Settings::m_pPrimaryPandora.

Referenced by lar_pandora::LArPandora::beginJob().

 {
     mf::LogDebug("LArPandora") << " *** LArPandoraInput::CreatePandoraLArTPCs(...) *** " << std::endl;
 
     if (!settings.m_pPrimaryPandora)
         throw cet::exception("LArPandora") << "CreatePandoraDetectorGaps - primary Pandora instance does not exist ";
 
     const pandora::Pandora *pPandora(settings.m_pPrimaryPandora);
 
     for (const LArDriftVolume &driftVolume : driftVolumeList)
     {
         PandoraApi::Geometry::LArTPC::Parameters parameters;
 
         try
         {
             parameters.m_larTPCVolumeId = driftVolume.GetVolumeID();
             parameters.m_centerX = driftVolume.GetCenterX();
             parameters.m_centerY = driftVolume.GetCenterY();
             parameters.m_centerZ = driftVolume.GetCenterZ();
             parameters.m_widthX = driftVolume.GetWidthX();
             parameters.m_widthY = driftVolume.GetWidthY();
             parameters.m_widthZ = driftVolume.GetWidthZ();
             parameters.m_wirePitchU = driftVolume.GetWirePitchU();
             parameters.m_wirePitchV = driftVolume.GetWirePitchV();
             parameters.m_wirePitchW = driftVolume.GetWirePitchW();
             parameters.m_wireAngleU = driftVolume.GetWireAngleU();
             parameters.m_wireAngleV = driftVolume.GetWireAngleV();
             parameters.m_wireAngleW = driftVolume.GetWireAngleW();
             parameters.m_sigmaUVW = driftVolume.GetSigmaUVZ();
             parameters.m_isDriftInPositiveX = driftVolume.IsPositiveDrift();
         }
         catch (const pandora::StatusCodeException &)
         {
             mf::LogWarning("LArPandora") << "CreatePandoraLArTPCs - invalid tpc parameter provided, all assigned values must be finite, tpc omitted " << std::endl;
             continue;
         }
 
         try
         {
             PANDORA_THROW_RESULT_IF(pandora::STATUS_CODE_SUCCESS, !=, PandoraApi::Geometry::LArTPC::Create(*pPandora, parameters));
         }
         catch (const pandora::StatusCodeException &)
         {
             mf::LogWarning("LArPandora") << "CreatePandoraLArTPCs - unable to create tpc, insufficient or invalid information supplied " << std::endl;
             continue;
         }
     }
 }

void lar_pandora::LArPandoraInput::CreatePandoraMCLinks2D	(	const Settings &	settings,
		const HitMap &	hitMap,
		const HitsToTrackIDEs &	hitToParticleMap
	)

static

Create links between the 2D hits and Pandora MC particles.

Parameters

settings	the settings
hitMap	mapping from Pandora hit addresses to ART hits
hitToParticleMap	mapping from each ART hit to its underlying G4 track ID

Definition at line 620 of file LArPandoraInput.cxx.

References lar_pandora::LArPandoraInput::Settings::m_pPrimaryPandora.

Referenced by lar_pandora::LArPandora::CreatePandoraInput().

 {
     mf::LogDebug("LArPandora") << " *** LArPandoraInput::CreatePandoraMCLinks(...) *** " << std::endl;
 
     if (!settings.m_pPrimaryPandora)
         throw cet::exception("LArPandora") << "CreatePandoraMCLinks2D - primary Pandora instance does not exist ";
 
     const pandora::Pandora *pPandora(settings.m_pPrimaryPandora);
 
     for (IdToHitMap::const_iterator iterI = idToHitMap.begin(), iterEndI = idToHitMap.end(); iterI != iterEndI ; ++iterI)
     {
         const int hitID(iterI->first);
         const art::Ptr<recob::Hit> hit(iterI->second);
       //  const geo::WireID hit_WireID(hit->WireID());
 
         // Get list of associated MC particles
         HitsToTrackIDEs::const_iterator iterJ = hitToParticleMap.find(hit);
 
         if (hitToParticleMap.end() == iterJ)
             continue;
 
         const TrackIDEVector &trackCollection = iterJ->second;
 
         if (trackCollection.size() == 0)
             throw cet::exception("LArPandora") << "CreatePandoraMCLinks2D - found a hit without any associated MC truth information ";
 
         // Create links between hits and MC particles
         for (unsigned int k = 0; k < trackCollection.size(); ++k)
         {
             const sim::TrackIDE trackIDE(trackCollection.at(k));
             const int trackID(std::abs(trackIDE.trackID)); // TODO: Find out why std::abs is needed
             const float energyFrac(trackIDE.energyFrac);
 
             try
             {
                 PANDORA_THROW_RESULT_IF(pandora::STATUS_CODE_SUCCESS, !=, PandoraApi::SetCaloHitToMCParticleRelationship(*pPandora,
                     (void*)((intptr_t)hitID), (void*)((intptr_t)trackID), energyFrac));
             }
             catch (const pandora::StatusCodeException &)
             {
                 mf::LogWarning("LArPandora") << "CreatePandoraMCLinks2D - unable to create calo hit to mc particle relationship, invalid information supplied " << std::endl;
                 continue;
             }
         }
     }
 }

void lar_pandora::LArPandoraInput::CreatePandoraMCParticles	(	const Settings &	settings,
		const MCTruthToMCParticles &	truthToParticles,
		const MCParticlesToMCTruth &	particlesToTruth,
		const RawMCParticleVector &	generatorMCParticleVector
	)

static

Create the Pandora MC particles from the MC particles.

Parameters

settings	the settings
truthToParticles	mapping from MC truth to MC particles
particlesToTruth	mapping from MC particles to MC truth

Definition at line 374 of file LArPandoraInput.cxx.

Referenced by lar_pandora::LArPandora::CreatePandoraInput().

 {
     mf::LogDebug("LArPandora") << " *** LArPandoraInput::CreatePandoraMCParticles(...) *** " << std::endl;
     art::ServiceHandle<cheat::ParticleInventoryService> particleInventoryService;
 
     if (!settings.m_pPrimaryPandora)
         throw cet::exception("LArPandora") << "CreatePandoraMCParticles - primary Pandora instance does not exist ";
 
     const pandora::Pandora *pPandora(settings.m_pPrimaryPandora);
 
     // Make indexed list of MC particles
     MCParticleMap particleMap;
 
     for (MCParticlesToMCTruth::const_iterator iter = particleToTruthMap.begin(), iterEnd = particleToTruthMap.end(); iter != iterEnd; ++iter)
     {
         const art::Ptr<simb::MCParticle> particle = iter->first;
         particleMap[particle->TrackId()] = particle;
     }
 
     // Loop over MC truth objects
     int neutrinoCounter(0);
 
     lar_content::LArMCParticleFactory mcParticleFactory;
 
     for (MCTruthToMCParticles::const_iterator iter1 = truthToParticleMap.begin(), iterEnd1 = truthToParticleMap.end(); iter1 != iterEnd1; ++iter1)
     {
         const art::Ptr<simb::MCTruth> truth = iter1->first;
 
         if (truth->NeutrinoSet())
         {
             const simb::MCNeutrino neutrino(truth->GetNeutrino());
             ++neutrinoCounter;
 
             if (neutrinoCounter >= settings.m_uidOffset)
                 throw cet::exception("LArPandora") << "CreatePandoraMCParticles - detected an excessive number of mc neutrinos (" << neutrinoCounter << ")";
 
             const int neutrinoID(neutrinoCounter + 9 * settings.m_uidOffset);
 
             // Create Pandora 3D MC Particle
             lar_content::LArMCParticleParameters mcParticleParameters;
 
             try
             {
                 mcParticleParameters.m_nuanceCode = neutrino.InteractionType();
                 mcParticleParameters.m_energy = neutrino.Nu().E();
                 mcParticleParameters.m_momentum = pandora::CartesianVector(neutrino.Nu().Px(), neutrino.Nu().Py(), neutrino.Nu().Pz());
                 mcParticleParameters.m_vertex = pandora::CartesianVector(neutrino.Nu().Vx(), neutrino.Nu().Vy(), neutrino.Nu().Vz());
                 mcParticleParameters.m_endpoint = pandora::CartesianVector(neutrino.Nu().Vx(), neutrino.Nu().Vy(), neutrino.Nu().Vz());
                 mcParticleParameters.m_particleId = neutrino.Nu().PdgCode();
                 mcParticleParameters.m_mcParticleType = pandora::MC_3D;
                 mcParticleParameters.m_pParentAddress = (void*)((intptr_t)neutrinoID);
             }
             catch (const pandora::StatusCodeException &)
             {
                 mf::LogWarning("LArPandora") << "CreatePandoraMCParticles - invalid mc neutrino parameter provided, all assigned values must be finite, mc neutrino omitted " << std::endl;
                 continue;
             }
 
             try
             {
                 PANDORA_THROW_RESULT_IF(pandora::STATUS_CODE_SUCCESS, !=, PandoraApi::MCParticle::Create(*pPandora, mcParticleParameters, mcParticleFactory));
             }
             catch (const pandora::StatusCodeException &)
             {
                 mf::LogWarning("LArPandora") << "CreatePandoraMCParticles - unable to create mc neutrino, insufficient or invalid information supplied " << std::endl;
                 continue;
             }
 
             // Loop over associated particles
             const MCParticleVector &particleVector = iter1->second;
 
             for (MCParticleVector::const_iterator iter2 = particleVector.begin(), iterEnd2 = particleVector.end(); iter2 != iterEnd2; ++iter2)
             {
                 const art::Ptr<simb::MCParticle> particle = *iter2;
                 const int trackID(particle->TrackId());
 
                 // Mother/Daughter Links
                 if (particle->Mother() == 0)
                 {
                     try
                     {
                         PANDORA_THROW_RESULT_IF(pandora::STATUS_CODE_SUCCESS, !=, PandoraApi::SetMCParentDaughterRelationship(*pPandora,
                             (void*)((intptr_t)neutrinoID), (void*)((intptr_t)trackID)));
                     }
                     catch (const pandora::StatusCodeException &)
                     {
                         mf::LogWarning("LArPandora") << "CreatePandoraMCParticles - unable to create mc particle relationship, invalid information supplied " << std::endl;
                         continue;
                     }
                 }
             }
         }
     }
 
     mf::LogDebug("LArPandora") << "   Number of Pandora neutrinos: " << neutrinoCounter << std::endl;
 
     // Loop over G4 particles
     int particleCounter(0);
 
     // Find Primary Generator Particles
     std::map<const simb::MCParticle, bool> primaryGeneratorMCParticleMap;
     LArPandoraInput::FindPrimaryParticles(generatorMCParticleVector, primaryGeneratorMCParticleMap);
 
     for (MCParticleMap::const_iterator iterI = particleMap.begin(), iterEndI = particleMap.end(); iterI != iterEndI; ++iterI)
     {
         const art::Ptr<simb::MCParticle> particle = iterI->second;
 
         if (particle->TrackId() != iterI->first)
             throw cet::exception("LArPandora") << "CreatePandoraMCParticles - mc truth information appears to be scrambled in this event";
 
         if (particle->TrackId() >= settings.m_uidOffset)
             throw cet::exception("LArPandora") << "CreatePandoraMCParticles - detected an excessive number of MC particles (" << particle->TrackId() << ")";
 
         ++particleCounter;
 
         // Find start and end trajectory points
         int firstT(-1), lastT(-1);
         LArPandoraInput::GetTrueStartAndEndPoints(settings, particle, firstT, lastT);
 
         if (firstT < 0 && lastT < 0)
         {
             firstT = 0; lastT = 0;
         }
 
         // Lookup position and kinematics at start and end points
         const float vtxX(particle->Vx(firstT));
         const float vtxY(particle->Vy(firstT));
         const float vtxZ(particle->Vz(firstT));
 
         const float endX(particle->Vx(lastT));
         const float endY(particle->Vy(lastT));
         const float endZ(particle->Vz(lastT));
 
         const float pX(particle->Px(firstT));
         const float pY(particle->Py(firstT));
         const float pZ(particle->Pz(firstT));
         const float E(particle->E(firstT));
 
         // Find the source of the mc particle
         int nuanceCode(0);
         const int trackID(particle->TrackId());
         const simb::Origin_t origin(particleInventoryService->TrackIdToMCTruth(trackID).Origin());
 
         if (LArPandoraInput::IsPrimaryMCParticle(particle, primaryGeneratorMCParticleMap))
         {
             nuanceCode = 2001;
         }
         else if (simb::kCosmicRay == origin)
         {
             nuanceCode = 3000;
         }
         else if (simb::kSingleParticle == origin)
         {
             nuanceCode = 2000;
         }
 
         // Create 3D Pandora MC Particle
         lar_content::LArMCParticleParameters mcParticleParameters;
 
         try
         {
             mcParticleParameters.m_nuanceCode = nuanceCode;
             mcParticleParameters.m_energy = E;
             mcParticleParameters.m_particleId = particle->PdgCode();
             mcParticleParameters.m_momentum = pandora::CartesianVector(pX, pY, pZ);
             mcParticleParameters.m_vertex = pandora::CartesianVector(vtxX, vtxY, vtxZ);
             mcParticleParameters.m_endpoint = pandora::CartesianVector(endX, endY, endZ);
             mcParticleParameters.m_mcParticleType = pandora::MC_3D;
             mcParticleParameters.m_pParentAddress = (void*)((intptr_t)particle->TrackId());
         }
         catch (const pandora::StatusCodeException &)
         {
             mf::LogWarning("LArPandora") << "CreatePandoraMCParticles - invalid mc particle parameter provided, all assigned values must be finite, mc particle omitted " << std::endl;
             continue;
         }
 
         try
         {
             PANDORA_THROW_RESULT_IF(pandora::STATUS_CODE_SUCCESS, !=, PandoraApi::MCParticle::Create(*pPandora, mcParticleParameters, mcParticleFactory));
         }
         catch (const pandora::StatusCodeException &)
         {
             mf::LogWarning("LArPandora") << "CreatePandoraMCParticles - unable to create mc particle, insufficient or invalid information supplied " << std::endl;
             continue;
         }
 
         // Create Mother/Daughter Links between 3D MC Particles
         const int id_mother(particle->Mother());
         MCParticleMap::const_iterator iterJ = particleMap.find(id_mother);
 
         if (iterJ != particleMap.end())
         {
             try
             {
                 PANDORA_THROW_RESULT_IF(pandora::STATUS_CODE_SUCCESS, !=, PandoraApi::SetMCParentDaughterRelationship(*pPandora,
                     (void*)((intptr_t)id_mother), (void*)((intptr_t)particle->TrackId())));
             }
             catch (const pandora::StatusCodeException &)
             {
                 mf::LogWarning("LArPandora") << "CreatePandoraMCParticles - Unable to create mc particle relationship, invalid information supplied " << std::endl;
                 continue;
             }
         }
     }
 
     mf::LogDebug("LArPandora") << "Number of mc particles: " << particleCounter << std::endl;
 }

void lar_pandora::LArPandoraInput::CreatePandoraReadoutGaps	(	const Settings &	settings,
		const LArDriftVolumeMap &	driftVolumeMap
	)

static

Create pandora line gaps to cover any (continuous regions of) bad channels.

Parameters

settings	the settings
driftVolumeMap	the mapping from volume id to drift volume

Definition at line 254 of file LArPandoraInput.cxx.

References geo::GeometryCore::Cryostat(), f, geo::WireGeo::GetCenter(), lar_pandora::LArPandoraGeometry::GetGlobalView(), lar_pandora::LArPandoraGeometry::GetVolumeID(), geo::kU, geo::kV, geo::kW, lar_pandora::LArPandoraInput::Settings::m_pPrimaryPandora, max, min, geo::GeometryCore::Ncryostats(), geo::GeometryCore::NTPC(), geo::GeometryCore::Nwires(), geo::TPCGeo::Plane(), geo::GeometryCore::PlaneWireToChannel(), geo::CryostatGeo::TPC(), geo::GeometryCore::TPC(), geo::PlaneGeo::Wire(), and geo::GeometryCore::WirePitch().

Referenced by lar_pandora::LArPandora::CreatePandoraInput().

 {
     mf::LogDebug("LArPandora") << " *** LArPandoraInput::CreatePandoraReadoutGaps(...) *** " << std::endl;
 
     if (!settings.m_pPrimaryPandora)
         throw cet::exception("LArPandora") << "CreatePandoraReadoutGaps - primary Pandora instance does not exist ";
 
     const pandora::Pandora *pPandora(settings.m_pPrimaryPandora);
 
     art::ServiceHandle<geo::Geometry> theGeometry;
     const lariov::ChannelStatusProvider &channelStatus(art::ServiceHandle<lariov::ChannelStatusService>()->GetProvider());
 
     for (unsigned int icstat = 0; icstat < theGeometry->Ncryostats(); ++icstat)
     {
         for (unsigned int itpc = 0; itpc < theGeometry->NTPC(icstat); ++itpc)
         {
             const geo::TPCGeo &TPC(theGeometry->TPC(itpc));
 
             for (unsigned int iplane = 0; iplane < TPC.Nplanes(); ++iplane)
             {
                 const geo::PlaneGeo &plane(TPC.Plane(iplane));
                 const float halfWirePitch(0.5f * theGeometry->WirePitch(plane.View()));
                 const unsigned int nWires(theGeometry->Nwires(geo::PlaneID(icstat, itpc, plane.View())));
 
                 int firstBadWire(-1), lastBadWire(-1);
 
                 for (unsigned int iwire = 0; iwire < nWires; ++iwire)
                 {
                     const raw::ChannelID_t channel(theGeometry->PlaneWireToChannel(plane.View(), iwire, itpc, icstat));
                     const bool isBadChannel(channelStatus.IsBad(channel));
                     const bool isLastWire(nWires == (iwire + 1));
 
                     if (isBadChannel && (firstBadWire < 0))
                         firstBadWire = iwire;
 
                     if (isBadChannel || isLastWire)
                         lastBadWire = iwire;
 
                     if (isBadChannel && !isLastWire)
                         continue;
 
                     if ((firstBadWire < 0) || (lastBadWire < 0))
                         continue;
 
                     double firstXYZ[3], lastXYZ[3];
                     theGeometry->Cryostat(icstat).TPC(itpc).Plane(iplane).Wire(firstBadWire).GetCenter(firstXYZ);
                     theGeometry->Cryostat(icstat).TPC(itpc).Plane(iplane).Wire(lastBadWire).GetCenter(lastXYZ);
 
                     firstBadWire = -1; lastBadWire = -1;
 
                     PandoraApi::Geometry::LineGap::Parameters parameters;
 
                     try
                     {
                         parameters.m_lineStartX = -std::numeric_limits<float>::max();
                         parameters.m_lineEndX = std::numeric_limits<float>::max();
 
                         const unsigned int volumeId(LArPandoraGeometry::GetVolumeID(driftVolumeMap, icstat, itpc));
                         LArDriftVolumeMap::const_iterator volumeIter(driftVolumeMap.find(volumeId));
 
                         if (driftVolumeMap.end() != volumeIter)
                         {
                             parameters.m_lineStartX = volumeIter->second.GetCenterX() - 0.5f * volumeIter->second.GetWidthX();
                             parameters.m_lineEndX = volumeIter->second.GetCenterX() + 0.5f * volumeIter->second.GetWidthX();
                         }
 
                         const geo::View_t iview = (geo::View_t)iplane;
                         const geo::View_t pandoraView(LArPandoraGeometry::GetGlobalView(icstat, itpc, iview));
 
                         if (pandoraView == geo::kW)
                         {
                             const float firstW(firstXYZ[2]);
                             const float lastW(lastXYZ[2]);
 
                             parameters.m_lineGapType = pandora::TPC_WIRE_GAP_VIEW_W;
                             parameters.m_lineStartZ = std::min(firstW, lastW) - halfWirePitch;
                             parameters.m_lineEndZ = std::max(firstW, lastW) + halfWirePitch;
                         }
                         else if (pandoraView == geo::kU)
                         {
                             const float firstU(pPandora->GetPlugins()->GetLArTransformationPlugin()->YZtoU(firstXYZ[1], firstXYZ[2]));
                             const float lastU(pPandora->GetPlugins()->GetLArTransformationPlugin()->YZtoU(lastXYZ[1], lastXYZ[2]));
 
                             parameters.m_lineGapType = pandora::TPC_WIRE_GAP_VIEW_U;
                             parameters.m_lineStartZ = std::min(firstU, lastU) - halfWirePitch;
                             parameters.m_lineEndZ = std::max(firstU, lastU) + halfWirePitch;
                         }
                         else if (pandoraView == geo::kV)
                         {
                             const float firstV(pPandora->GetPlugins()->GetLArTransformationPlugin()->YZtoV(firstXYZ[1], firstXYZ[2]));
                             const float lastV(pPandora->GetPlugins()->GetLArTransformationPlugin()->YZtoV(lastXYZ[1], lastXYZ[2]));
 
                             parameters.m_lineGapType = pandora::TPC_WIRE_GAP_VIEW_V;
                             parameters.m_lineStartZ = std::min(firstV, lastV) - halfWirePitch;
                             parameters.m_lineEndZ = std::max(firstV, lastV) + halfWirePitch;
                         }
                     }
                     catch (const pandora::StatusCodeException &)
                     {
                         mf::LogWarning("LArPandora") << "CreatePandoraReadoutGaps - invalid line gap parameter provided, all assigned values must be finite, line gap omitted " << std::endl;
                         continue;
                     }
 
                     try
                     {
                         PANDORA_THROW_RESULT_IF(pandora::STATUS_CODE_SUCCESS, !=, PandoraApi::Geometry::LineGap::Create(*pPandora, parameters));
                     }
                     catch (const pandora::StatusCodeException &)
                     {
                         mf::LogWarning("LArPandora") << "CreatePandoraReadoutGaps - unable to create line gap, insufficient or invalid information supplied " << std::endl;
                         continue;
                     }
                 }
             }
         }
     }
 }

void lar_pandora::LArPandoraInput::FindPrimaryParticles	(	const RawMCParticleVector &	mcParticleVector,
		std::map< const simb::MCParticle, bool > &	primaryMCParticleMap
	)

static

Find all primary MCParticles in a given vector of MCParticles.

Parameters

mcParticleVector	vector of all MCParticles to consider
primaryMCParticleMap	map containing primary MCParticles and bool indicating whether particle has been accounted for

Definition at line 585 of file LArPandoraInput.cxx.

Referenced by CreatePandoraMCParticles().

 {
     for (const simb::MCParticle &mcParticle : mcParticleVector)
     {
         if ("primary" == mcParticle.Process())
         {
             primaryMCParticleMap.emplace(std::make_pair(mcParticle, false));
         }
     }
 }

double lar_pandora::LArPandoraInput::GetMips	(	const Settings &	settings,
		const double	hit_Charge,
		const geo::View_t	hit_View
	)

staticprivate

Convert charge in ADCs to approximate MIPs.

Parameters

settings	the settings
hit_Charge	the input charge
hit_View	the input view number

Definition at line 748 of file LArPandoraInput.cxx.

References util::kGeVToElectrons, lar_pandora::LArPandoraInput::Settings::m_dEdX_mip, lar_pandora::LArPandoraInput::Settings::m_mips_if_negative, lar_pandora::LArPandoraInput::Settings::m_mips_max, lar_pandora::LArPandoraInput::Settings::m_recombination_factor, lar_pandora::LArPandoraInput::Settings::m_useBirksCorrection, and geo::GeometryCore::WirePitch().

Referenced by CreatePandoraHits2D().

 {
     art::ServiceHandle<geo::Geometry> theGeometry;
     auto const* theDetector = lar::providerFrom<detinfo::DetectorPropertiesService>();
 
     // TODO: Unite this procedure with other calorimetry procedures under development
     const double dQdX(hit_Charge / (theGeometry->WirePitch(hit_View))); // ADC/cm
     const double dQdX_e(dQdX / (theDetector->ElectronsToADC() * settings.m_recombination_factor)); // e/cm
     const double dEdX(settings.m_useBirksCorrection ? theDetector->BirksCorrection(dQdX_e) : dQdX_e * 1000. / util::kGeVToElectrons); // MeV/cm
     double mips(dEdX / settings.m_dEdX_mip);
 
     if (mips < 0.)
         mips = settings.m_mips_if_negative;
 
     if (mips > settings.m_mips_max)
         mips = settings.m_mips_max;
 
     return mips;
 }

void lar_pandora::LArPandoraInput::GetTrueStartAndEndPoints	(	const Settings &	settings,
		const art::Ptr< simb::MCParticle > &	particle,
		int &	startT,
		int &	endT
	)

staticprivate

Loop over MC trajectory points and identify start and end points within the detector.

Parameters

settings	the settings
particle	the true particle
startT	the first trajectory point in the detector
endT	the last trajectory point in the detector

Definition at line 669 of file LArPandoraInput.cxx.

References geo::GeometryCore::Ncryostats(), and geo::GeometryCore::NTPC().

Referenced by CreatePandoraMCParticles().

 {
     art::ServiceHandle<geo::Geometry> theGeometry;
     firstT = -1;  lastT  = -1;
 
     for (unsigned int icstat = 0; icstat < theGeometry->Ncryostats(); ++icstat)
     {
         for (unsigned int itpc = 0; itpc < theGeometry->NTPC(icstat); ++itpc)
         {
             int thisfirstT(-1), thislastT(-1);
             LArPandoraInput::GetTrueStartAndEndPoints(icstat, itpc, particle, thisfirstT, thislastT);
 
             if (thisfirstT < 0)
                 continue;
 
             if (firstT < 0 || thisfirstT < firstT)
                 firstT = thisfirstT;
 
             if (lastT < 0 || thislastT > lastT)
                 lastT = thislastT;
         }
     }
 }

void lar_pandora::LArPandoraInput::GetTrueStartAndEndPoints	(	const unsigned int	cstat,
		const unsigned int	tpc,
		const art::Ptr< simb::MCParticle > &	particle,
		int &	startT,
		int &	endT
	)

staticprivate

Loop over MC trajectory points and identify start and end points within a given cryostat and TPC.

Parameters

cstat	the cryostat
tpc	the TPC
particle	the true particle
startT	the first trajectory point in the detector
endT	the last trajectory point in the detector

Definition at line 695 of file LArPandoraInput.cxx.

References geo::CryostatID::Cryostat, geo::GeometryCore::FindTPCAtPosition(), geo::CryostatID::isValid, simb::MCParticle::NumberTrajectoryPoints(), geo::TPCID::TPC, simb::MCParticle::Vx(), simb::MCParticle::Vy(), and simb::MCParticle::Vz().

 {
     art::ServiceHandle<geo::Geometry> theGeometry;
 
     bool foundStartPosition(false);
     const int numTrajectoryPoints(static_cast<int>(particle->NumberTrajectoryPoints()));
 
     for (int nt = 0; nt < numTrajectoryPoints; ++nt)
     {
         const double pos[3] = {particle->Vx(nt), particle->Vy(nt), particle->Vz(nt)};
         geo::TPCID tpcID = theGeometry->FindTPCAtPosition(pos);
 
         if (!tpcID.isValid)
             continue;
 
         if (!(cstat == tpcID.Cryostat && tpc == tpcID.TPC))
             continue;
 
         endT = nt;
 
         if (!foundStartPosition)
         {
             startT = endT;
             foundStartPosition = true;
         }
     }
 }

float lar_pandora::LArPandoraInput::GetTrueX0	(	const art::Ptr< simb::MCParticle > &	particle,
		const int	nT
	)

staticprivate

Use detector and time services to get a true X offset for a given trajectory point.

Parameters

particle	the true particle
nT	the trajectory point

Definition at line 726 of file LArPandoraInput.cxx.

References geo::GeometryCore::Cryostat(), geo::kNegX, geo::GeometryCore::PositionToTPC(), simb::MCParticle::T(), geo::CryostatGeo::TPC(), simb::MCParticle::Vx(), simb::MCParticle::Vy(), and simb::MCParticle::Vz().

 {
     art::ServiceHandle<geo::Geometry> theGeometry;
     auto const* theTime = lar::providerFrom<detinfo::DetectorClocksService>();
     auto const* theDetector = lar::providerFrom<detinfo::DetectorPropertiesService>();
 
     unsigned int which_tpc(0);
     unsigned int which_cstat(0);
     double pos[3] = {particle->Vx(nt), particle->Vy(nt), particle->Vz(nt)};
     theGeometry->PositionToTPC(pos, which_tpc, which_cstat);
 
     const float vtxT(particle->T(nt));
     const float vtxTDC(theTime->TPCG4Time2Tick(vtxT));
     const float vtxTDC0(theDetector->TriggerOffset());
 
     const geo::TPCGeo &theTpc = theGeometry->Cryostat(which_cstat).TPC(which_tpc);
     const float driftDir((theTpc.DriftDirection() == geo::kNegX) ? +1.0 :-1.0);
     return (driftDir * (vtxTDC - vtxTDC0) * theDetector->GetXTicksCoefficient());
 }

bool lar_pandora::LArPandoraInput::IsPrimaryMCParticle	(	const art::Ptr< simb::MCParticle > &	mcParticle,
		std::map< const simb::MCParticle, bool > &	primaryMCParticleMap
	)

static

Check whether an MCParticle can be found in a given map.

Parameters

mcParticle	target MCParticle
primaryMCParticleMap	map containing primary MCParticles and bool indicating whether particle has been accounted for

Definition at line 598 of file LArPandoraInput.cxx.

References simb::MCParticle::Px(), simb::MCParticle::Py(), and simb::MCParticle::Pz().

Referenced by CreatePandoraMCParticles().

 {
     for (auto &mcParticleIter : primaryMCParticleMap)
     {
         if (!mcParticleIter.second)
         {
             const simb::MCParticle primaryMCParticle(mcParticleIter.first);
 
             if (std::fabs(primaryMCParticle.Px() - mcParticle->Px()) < std::numeric_limits<double>::epsilon() && 
                 std::fabs(primaryMCParticle.Py() - mcParticle->Py()) < std::numeric_limits<double>::epsilon() && 
                 std::fabs(primaryMCParticle.Pz() - mcParticle->Pz()) < std::numeric_limits<double>::epsilon())
             {
                 mcParticleIter.second = true;
                 return true;
             }
         }
     }
     return false;
 }

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

/cvmfs/larsoft.opensciencegrid.org/products/larpandora/v07_06_01/source/larpandora/LArPandoraInterface/LArPandoraInput.h
/cvmfs/larsoft.opensciencegrid.org/products/larpandora/v07_06_01/source/larpandora/LArPandoraInterface/LArPandoraInput.cxx

Classes

Static Public Member Functions

Static Private Member Functions

Detailed Description

Member Function Documentation