FIND_DECAY and FIND_MCDECAY functor

Create two functor named FIND_DECAY and FIND_MC_DECAY that implements respectively the algorithms DecayFinder (new, see !3091 (merged)) and MCDecayFinder.

To be used in composition with other functors to get information about particles belonging to the decay chain.

FIND_DECAY (FIND_MC_DECAY) is MAP of _FIND_DECAY (_FIND_MC_DECAY), functor accepting const LHCb::Particle* (const LHCb::MCParticle*) or const LHCb::Particle& (const LHCb::MCParticle&) and returning a const LHCb::Particle* (const LHCb::MCParticle*).

TODO:

• Fix test;
• Adapt the functor to support MCParticles.

Perhaps related to issue: #356

Example in the DV MR DaVinci!781 (merged)

cc: @amathad

Phys/FunctorCore/include/Functors/Decay.h

@@ -29,12 +29,12 @@ namespace Functors::Decay {
     void bind( TopLevelInfo& top_level ) { m_find_decay.emplace( m_tool_name, top_level.algorithm() ); }
 
     auto prepare( EventContext const&, TopLevelInfo const& ) const {
-      // assert( m_find_decay.has_value() );
+      assert( m_find_decay.has_value() );
       if ( !m_find_decay->get() ) m_find_decay->retrieve().ignore();
-      return [dd = m_decay_desc, tool = m_find_decay->get()]( const auto& in ) {
+      return [dd = m_decay_desc, tool = m_find_decay->get()]( auto mask, const auto& in ) {
         LHCb::Particle::ConstVector out;
-        auto                        res = tool->findDecay( dd, in, out );
-        return res.isSuccess() ? Functors::Optional{out} : std::nullopt;
+        mask = mask && tool->findDecay( dd, in, out ).isSuccess();
+        return mask ? Functors::Optional{out} : std::nullopt;
       };
     }