[PWGHF,PWGJE] Unify and extend MC flags in candidate tables (3-prong, D*+)

[vkucera]

Add support for flagging all needed decay channels.

Background:

• MC-based corrections require knowledge about other decay channels than the ones expected in the candidate reconstruction and selection.
• Decay reconstruction flags used in the skim creator and decay matching flags used in the candidate creators are conceptually different. The former flags tag all decay hypotheses that satisfy selection conditions, the latter flags tag the actual decay channels.

Concept considerations:

• Separate decay reconstruction flags and decay matching flags.
• Enumerate all decay channels that need to be flagged for a given candidate table.
• All MC matching is be done in the candidate creators.
• Flags of main channels are stored in the existing columns: FlagMcMatchRec, FlagMcMatchGen.
• Flags of resonant channels are stored in the existing columns: FlagMcDecayChanRec, FlagMcDecayChanGen. (To be renamed.)
• Flags are stored as signed enumerator values (type int8_t), not as bitmaps.
  • 0 indicates no match.
  • Sign indicates particle/antiparticle.

Caveat:

• Invalidation of flags in existing derived data.

TODO: Extend to other species.

[github-actions]

O2 linter results: ❌ 81 errors, ⚠️ 0 warnings, 🔕 5 disabled

[fgrosa]

Hi @vkucera, see a few suggestions from my side below

[fgrosa]

Hi @vkucera thanks a lot! I still have a few comments (mainly for the beauty part). Once completed, I would also like to ask you to update the creators and tasks for the already existing tagging (e.g. for the D* the name of the flags changed with respect to the current version

O2Physics/PWGHF/TableProducer/candidateCreatorDstar.cxx

Lines 640 to 645 in f8f8fbc

	if (indexRecDstar > -1) {
	flagDstar = signDstar * (BIT(aod::hf_cand_dstar::DecayType::DstarToD0Pi));
	}
	if (indexRecD0 > -1) {
	flagD0 = signD0 * (BIT(aod::hf_cand_dstar::DecayType::D0ToPiK));
	}

). Thanks!

[fgrosa]

Hi @vkucera many thanks! It looks all good to me, except for one case (I hope I didn't miss anything else)

[alibuild]

Auto-approving on behalf of @vkucera.