TupleToolMCTruth

[apiucci]

Add an example of the TupleToolMCTruth in the TupleTools lesson?

[ibab]

Usually, regular TupleTools only work with DecayTreeTuple and MCTupleTools work with MCDecayTreeTuple.
TupleToolMCTruth, when plugged into a DecayTreeTuple, will look for an associated MC particle for each candidate found by the DecayTreeTuple.
It allows you to plug MCTupleTools into it, thus providing you with a way to treat the DecayTreeTuple like an MCDecayTreeTuple.
This should be part of one of the lessons!

[alexpearce]

In case anyone wants to open a PR for this: use TupleToolMCTruth like this:

mc_truth = dtt.addTupleTool('TupleToolMCTruth')
mc_truth.ToolList = [
    'MCTupleToolPrompt'
]

Where dtt is a DecayTreeTuple instance, and MCTupleToolPrompt is a tuple tool that uses the MC truth particles.

You could also attached the tool to a branch as well, just replacing dtt with dtt.<branch_name>, e.g. dtt.D0.

We should find out exactly what the tool does when a MC association can't be found.