ShowerRecoTools::ShowerExampleTool Class Reference

Inheritance diagram for ShowerRecoTools::ShowerExampleTool:

Public Member Functions
	ShowerExampleTool (const fhicl::ParameterSet &pset)
int	CalculateElement (const art::Ptr< recob::PFParticle > &pfparticle, art::Event &Event, reco::shower::ShowerElementHolder &ShowerEleHolder) override
Public Member Functions inherited from ShowerRecoTools::IShowerTool
	IShowerTool (const fhicl::ParameterSet &pset)
virtual	~IShowerTool () noexcept=default
int	RunShowerTool (const art::Ptr< recob::PFParticle > &pfparticle, art::Event &Event, reco::shower::ShowerElementHolder &ShowerEleHolder, std::string evd_display_name_append="")
void	SetPtr (art::ProducesCollector *collector)
void	InitaliseProducerPtr (reco::shower::ShowerProducedPtrsHolder &uniqueproducerPtrs)

Private Member Functions
void	InitialiseProducers () override
int	AddAssociations (const art::Ptr< recob::PFParticle > &pfpPtr, art::Event &Event, reco::shower::ShowerElementHolder &ShowerEleHolder) override

Private Attributes
art::InputTag	fPFParticleLabel
int	fVerbose

Additional Inherited Members
Protected Member Functions inherited from ShowerRecoTools::IShowerTool
const shower::LArPandoraShowerAlg &	GetLArPandoraShowerAlg () const
template<class T >
art::Ptr< T >	GetProducedElementPtr (std::string Name, reco::shower::ShowerElementHolder &ShowerEleHolder, int iter=-1)
template<class T >
void	InitialiseProduct (std::string Name, std::string InstanceName="")
template<class T , class A , class B >
void	AddSingle (A &a, B &b, std::string Name)
int	GetVectorPtrSize (std::string Name)
void	PrintPtrs ()
void	PrintPtr (std::string Name)

Detailed Description

Definition at line 18 of file ShowerExampleTool_tool.cc.

Constructor & Destructor Documentation

ShowerRecoTools::ShowerExampleTool::ShowerExampleTool

(

const fhicl::ParameterSet &

pset

)

Definition at line 42 of file ShowerExampleTool_tool.cc.

    : //Setup the algs and others here
    IShowerTool(pset.get<fhicl::ParameterSet>("BaseTools"))
    , fPFParticleLabel(pset.get<art::InputTag>("PFParticleLabel"))
    , fVerbose(pset.get<int>("Verbose"))
  {}

Member Function Documentation

int ShowerRecoTools::ShowerExampleTool::AddAssociations ( const art::Ptr< recob::PFParticle > &  pfpPtr, art::Event &  Event, reco::shower::ShowerElementHolder &  ShowerEleHolder  )

overrideprivatevirtual

Reimplemented from ShowerRecoTools::IShowerTool.

Definition at line 137 of file ShowerExampleTool_tool.cc.

  {
    //Here you add elements to associations defined. You can get the art::Ptrs by  GetProducedElementPtr<T>. Then you can add single like a usally association using AddSingle<assn<T>. Assn below.

    //First check the element has been set
    if (!ShowerEleHolder.CheckElement("myvertex")) {
      if (fVerbose) mf::LogError("ShowerExampleTooAddAssn") << "vertex not set." << std::endl;
      return 1;
    }

    //Then you can get the size of the vector which the unique ptr hold so that you can do associations. If you are comfortable in the fact that your element will always be made when a shower is made you don't need to to do this you can just get the art ptr as:      const art::Ptr<recob::Vertex> vertexptr = GetProducedElementPtr<recob::Vertex>("myvertex", ShowerEleHolder);. Note doing this when you allow partial showers to be set can screw up the assocation for the partial shower.
    int ptrsize = GetVectorPtrSize("myvertex");

    const art::Ptr<recob::Vertex> vertexptr =
      GetProducedElementPtr<recob::Vertex>("myvertex", ShowerEleHolder, ptrsize);
    const art::Ptr<recob::Shower> showerptr =
      GetProducedElementPtr<recob::Shower>("shower", ShowerEleHolder);
    AddSingle<art::Assns<recob::Shower, recob::Vertex>>(showerptr, vertexptr, "myvertexassan");

    return 0;
  }

int ShowerRecoTools::ShowerExampleTool::CalculateElement ( const art::Ptr< recob::PFParticle > &  pfparticle, art::Event &  Event, reco::shower::ShowerElementHolder &  ShowerEleHolder  )

overridevirtual

Implements ShowerRecoTools::IShowerTool.

Definition at line 60 of file ShowerExampleTool_tool.cc.

  {

    //In here calculate a shower or element (or multiple). It can be something used to create the recob::shower i.e. the direction. These have specific names so be careful to make these correctly. Alternative you can create something completely new e.g. recob::Vertex and add it the shower element holder

    //Now we are calculating the property of the shower like pfparticle. You have access to everything in the event. Maybe you want the vertex.

    auto const vtxHandle = Event.getValidHandle<std::vector<recob::Vertex>>(fPFParticleLabel);
    std::vector<art::Ptr<recob::Vertex>> vertices;
    art::fill_ptr_vector(vertices, vtxHandle);

    //Remember the module goes through the tools and if you want to (fcl param) it will loop over them twice. You can check to see if a element has been set with a specific name:
    bool shower_direction_set = ShowerEleHolder.CheckElement("ShowerDirection");

    TVector3 ShowerDirection = {-999, -999, -999};

    //Then you can go and get that element if you want to use it and fill it in for you.
    if (shower_direction_set) { ShowerEleHolder.GetElement("ShowerDirection", ShowerDirection); }

    //Do some crazy physics - Some legacy code in here for ease.
    art::Ptr<recob::Vertex> proposed_vertex = vertices[0];
    double xyz[3] = {-999, -999, -999};
    proposed_vertex->XYZ(xyz);

    if (ShowerDirection.X() < 0) {
      xyz[0] = -xyz[0];
      xyz[1] = -xyz[1];
      xyz[2] = -xyz[2];
    }
    recob::Vertex new_vertex = recob::Vertex(xyz);
    TVector3 recobshower_vertex = {xyz[0], xyz[1], xyz[2]};
    TVector3 recobshower_err = {xyz[0] * 0.1, xyz[1] * 0.1, xyz[2] * 0.1};
    //You can set elements of the recob::shower just choose the right name (you can acess them later). You can give the property an error anf this must be done the for standard recob::shower properties; The standard is to access the name via a fcl file.
    ShowerEleHolder.SetElement(recobshower_vertex, recobshower_err, "ShowerStartPosition");

    //You can also set the same element with a different name so that you can compare downstream two tools.
    //The standard is to actually define the name in fcl.
    ShowerEleHolder.SetElement(
      recobshower_vertex, recobshower_err, "ShowerExampleTool_ShowerStartPosition");

    //Or you can set one of the save elements
    ShowerEleHolder.SetElement(new_vertex, "myvertex");

    //Or a new unsave one.
    std::vector<double> xyz_vec = {xyz[0], xyz[1], xyz[2]};
    ShowerEleHolder.SetElement(xyz_vec, "xyz");

    //If you want to check if your element was actually made before the shower is made you can set a bool. If partial showers is turned off then the shower will not be made if this element is not filled. Properties i.e. elements with errors i.e. ShowerStartPosition  will not be checked. There is no way to store properties in the Event, only products are stored. You can make your own class which holds the error. The defualt is not to check the element. The recob::shower properties are checked however.
    ShowerEleHolder.SetElement(xyz_vec, "xyz", true);

    //You can see if an element will be checked before the shower is save with
    bool will_be_checked = ShowerEleHolder.CheckElementTag("xyz");

    if (will_be_checked) { std::cout << "Element checked at save time" << std::endl; }

    //You can also changed the tag.
    ShowerEleHolder.SetElementTag("xyz", false);

    //Note: Elements that are actually saved because you defined them in InitialiseProducers will be checked regardless. We don't want you saving nothign now.

    //You can also get the shower number that you are current one (the first shower number is 0).
    int showernum = ShowerEleHolder.GetShowerNumber();
    if (fVerbose > 1) std::cout << "You on are shower: " << showernum << std::endl;

    //You can also read out what ptr are set and what elements are set:.
    PrintPtrs();
    PrintPtr("myvertex");
    ShowerEleHolder.PrintElements();

    //Remember to add make a new fcl parmas list for your new tool. For examles see showertools.fcl. And remember to add it the the list in the module fcl params list.

    return 0;
  }

void ShowerRecoTools::ShowerExampleTool::InitialiseProducers ( )

overrideprivatevirtual

Reimplemented from ShowerRecoTools::IShowerTool.

Definition at line 50 of file ShowerExampleTool_tool.cc.

  {
    //Do you create something and you want to save it the event. Initialsie here. For every event with have a vector of showers so each one has a vertex. This is what we are saving. Make sure to use the name "myvertex" later down the line.
    InitialiseProduct<std::vector<recob::Vertex>>("myvertex");

    //We can also do associations
    InitialiseProduct<art::Assns<recob::Shower, recob::Vertex>>("myvertexassan");
  }

Member Data Documentation

art::InputTag ShowerRecoTools::ShowerExampleTool::fPFParticleLabel

private

Definition at line 38 of file ShowerExampleTool_tool.cc.

int ShowerRecoTools::ShowerExampleTool::fVerbose

private

Definition at line 39 of file ShowerExampleTool_tool.cc.

---

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

• ShowerExampleTool_tool.cc