DataFormats/python/RecoBTag_dataformats.py

0001 '''
0002     Created on Jun 26, 2013
0003     @author:  Mantas Stankevicius
0004     @contact: mantas.stankevicius@cern.ch
0005     http://cmsdoxy.web.cern.ch/cmsdoxy/dataformats/
0006
0007     @responsible:
0008
0009 '''
0010
0011 json = {
0012   "full": {
0013     "title": "RecoBTag collections (in RECO and AOD)",
0014     "data": [
0015      {
0016       "instance": "combinedMVABJetTags",
0017       "container": "*",
0018       "desc": "No documentation"
0019      },
0020      {
0021       "instance": "softMuonTagInfos",
0022       "container": "reco::SoftLeptonTagInfo ",
0023       "desc": "soft muon dedicated TagInfo, containing informations used to b-tag jets due to the presence of a soft muon in the jet"
0024      },
0025      {
0026       "instance": "softMuonBJetTags",
0027       "container": "reco::JetTag ",
0028       "desc": "results of b-tagging a jet using the SoftMuonTagInfo and the default soft muon tagger, which uses a neural network to combine most muon properties to improve rejection of non-b jets"
0029      },
0030      {
0031       "instance": "softMuonByIP3dBJetTags",
0032       "container": "*",
0033       "desc": "No documentation"
0034      },
0035      {
0036       "instance": "softMuonByPtBJetTags",
0037       "container": "*",
0038       "desc": "No documentation"
0039      },
0040      {
0041       "instance": "trackCountingHighEffBJetTags",
0042       "container": "reco::JetTag",
0043       "desc": "Result of track counting algorithm (requiring two tracks to have a significance above the discriminator). To be used for high efficiency selection (B eff > 50%, mistag rate > 1% )"
0044      },
0045      {
0046       "instance": "impactParameterTagInfos",
0047       "container": "reco::TrackIPTagInfo",
0048       "desc": "contains information used for btagging about track properties such as impact parameters, decay len, probability to originate from th primary vertex. Uses ak4JetTracksAssociatorAtVertex collection as input."
0049      },
0050      {
0051       "instance": "jetProbabilityBJetTags",
0052       "container": "reco::JetTag ",
0053       "desc": "result of jetProbability algorithm (based on TrackIPTagInfo)."
0054      },
0055      {
0056       "instance": "trackCountingHighPurBJetTags",
0057       "container": "reco::JetTag",
0058       "desc": "Result of track counting algorithm (requiring three tracks to have a significance above the discriminator). To be used for high purity selection (B eff < 50%, mistag rate < 1% )"
0059      },
0060      {
0061       "instance": "secondaryVertexTagInfos",
0062       "container": "reco::SecondaryVertexTagInfo ",
0063       "desc": "contains the reconstructed displaced secondary vertices in a jet and associated information, uses impactParameterTagInfos as input"
0064      },
0065      {
0066       "instance": "jetBProbabilityBJetTags",
0067       "container": "reco::JetTag ",
0068       "desc": "result of jetProbability algorithm in the `jetBProbability` variant."
0069      },
0070      {
0071       "instance": "simpleSecondaryVertexBJetTags",
0072       "container": "reco::JetTag ",
0073       "desc": "Uses the flight distance (i.e. distance between a reconstructed secondary vertex and the primary vertex in a jet) as b-tagging discriminator. Can be configured to return the value or significance in 2d and 3d, optionally corrected for the boost at the SV - works up to a maximum secondary vertex finding efficiency of ~70% in b-jets"
0074      },
0075      {
0076       "instance": "ghostTrackVertexTagInfos",
0077       "container": "*",
0078       "desc": "No documentation"
0079      },
0080      {
0081       "instance": "simpleSecondaryVertexHighPurBJetTags",
0082       "container": "reco::JetTag ",
0083       "desc": "Uses the flight distance (i.e. distance between a reconstructed secondary vertex and the primary vertex in a jet) as b-tagging discriminator. Secondary vertex is reconstructed with three or more tracks."
0084      },
0085      {
0086       "instance": "simpleSecondaryVertexHighEffBJetTags",
0087       "container": "reco::JetTag ",
0088       "desc": "Uses the flight distance (i.e. distance between a reconstructed secondary vertex and the primary vertex in a jet) as b-tagging discriminator. Secondary vertex is reconstructed with two or more tracks. Can be configured to return the value or significance in 2d and 3d, optionally corrected for the boost at the SV - works up to a maximum secondary vertex finding efficiency of ~70% in b-jets"
0089      },
0090      {
0091       "instance": "combinedSecondaryVertexMVABJetTags",
0092       "container": "reco::JetTag ",
0093       "desc": "uses the PhysicsTools/MVAComputer framework to compute a discriminator from the impactParameterTagInfos and secondaryVertexTagInfos with an uptodate calibration from the the CMS conditions database, using a neural network instead of a likelihood ratio in case an actual secondary vertex was reconstructed"
0094      },
0095      {
0096       "instance": "combinedSecondaryVertexBJetTags",
0097       "container": "reco::JetTag ",
0098       "desc": "Result of application of a likelihood estimator to the tagging variables for the three possible algorithm outcomes (tracks only, pseudo vertex from at least two tracks or successful secondary vertex fit), obtained from impactParameterTagInfos and secondaryVertexTagInfos"
0099      },
0100      {
0101       "instance": "btagSoftElectrons",
0102       "container": "reco::Electron ",
0103       "desc": "Electron candidates identified by the dedicated btagging SoftElectronProducer, starting from reco::Tracks"
0104      },
0105      {
0106       "instance": "ghostTrackBJetTags",
0107       "container": "*",
0108       "desc": "No documentation"
0109      },
0110      {
0111       "instance": "softPFElectrons",
0112       "container": "*",
0113       "desc": "No documentation"
0114      },
0115      {
0116       "instance": "softElectronCands",
0117       "container": "*",
0118       "desc": "No documentation"
0119      },
0120      {
0121       "instance": "softElectronBJetTags",
0122       "container": "reco::JetTag ",
0123       "desc": "results of b-tagging a jet using the SoftElectronTagInfo and the default soft electron tagger, which uses a neural network to combine most electron properties to improve rejection of non-b jets"
0124      },
0125      {
0126       "instance": "softElectronTagInfos",
0127       "container": "reco::SoftLeptonTagInfo ",
0128       "desc": "soft electron dedicated TagInfo, containing informations used to b-tag jets due to the presence of a soft electron in the jet"
0129      },
0130      {
0131       "instance": "softElectronByPtBJetTags",
0132       "container": "*",
0133       "desc": "No documentation"
0134      },
0135      {
0136       "instance": "softElectronByIP3dBJetTags",
0137       "container": "*",
0138       "desc": "No documentation"
0139      }
0140     ]
0141   },
0142   "aod": {
0143     "title": "RecoBTag collections (in AOD only)",
0144     "data": [
0145      {
0146       "instance": "softElectronByIP3dBJetTags",
0147       "container": "*",
0148       "desc": "No documentation"
0149      },
0150      {
0151       "instance": "softElectronBJetTags",
0152       "container": "*",
0153       "desc": "No documentation"
0154      },
0155      {
0156       "instance": "softMuonBJetTags",
0157       "container": "*",
0158       "desc": "No documentation"
0159      },
0160      {
0161       "instance": "softElectronByPtBJetTags",
0162       "container": "*",
0163       "desc": "No documentation"
0164      },
0165      {
0166       "instance": "softMuonByPtBJetTags",
0167       "container": "*",
0168       "desc": "No documentation"
0169      },
0170      {
0171       "instance": "softMuonByIP3dBJetTags",
0172       "container": "*",
0173       "desc": "No documentation"
0174      },
0175      {
0176       "instance": "combinedMVABJetTags",
0177       "container": "*",
0178       "desc": "No documentation"
0179      },
0180      {
0181       "instance": "trackCountingHighPurBJetTags",
0182       "container": "*",
0183       "desc": "No documentation"
0184      },
0185      {
0186       "instance": "trackCountingHighEffBJetTags",
0187       "container": "*",
0188       "desc": "No documentation"
0189      },
0190      {
0191       "instance": "jetBProbabilityBJetTags",
0192       "container": "*",
0193       "desc": "No documentation"
0194      },
0195      {
0196       "instance": "jetProbabilityBJetTags",
0197       "container": "*",
0198       "desc": "No documentation"
0199      },
0200      {
0201       "instance": "simpleSecondaryVertexHighEffBJetTags",
0202       "container": "*",
0203       "desc": "No documentation"
0204      },
0205      {
0206       "instance": "simpleSecondaryVertexBJetTags",
0207       "container": "*",
0208       "desc": "No documentation"
0209      },
0210      {
0211       "instance": "combinedSecondaryVertexBJetTags",
0212       "container": "*",
0213       "desc": "No documentation"
0214      },
0215      {
0216       "instance": "simpleSecondaryVertexHighPurBJetTags",
0217       "container": "*",
0218       "desc": "No documentation"
0219      },
0220      {
0221       "instance": "ghostTrackBJetTags",
0222       "container": "*",
0223       "desc": "No documentation"
0224      },
0225      {
0226       "instance": "combinedSecondaryVertexMVABJetTags",
0227       "container": "*",
0228       "desc": "No documentation"
0229      }
0230     ]
0231   },
0232   "reco": {
0233     "title": "RecoBTag collections (in RECO only)",
0234     "data": [
0235      {
0236       "instance": "combinedMVABJetTags",
0237       "container": "*",
0238       "desc": "No documentation"
0239      },
0240      {
0241       "instance": "softMuonTagInfos",
0242       "container": "reco::SoftLeptonTagInfo ",
0243       "desc": "soft muon dedicated TagInfo, containing informations used to b-tag jets due to the presence of a soft muon in the jet"
0244      },
0245      {
0246       "instance": "softMuonBJetTags",
0247       "container": "reco::JetTag ",
0248       "desc": "results of b-tagging a jet using the SoftMuonTagInfo and the default soft muon tagger, which uses a neural network to combine most muon properties to improve rejection of non-b jets"
0249      },
0250      {
0251       "instance": "softMuonByIP3dBJetTags",
0252       "container": "*",
0253       "desc": "No documentation"
0254      },
0255      {
0256       "instance": "softMuonByPtBJetTags",
0257       "container": "*",
0258       "desc": "No documentation"
0259      },
0260      {
0261       "instance": "trackCountingHighEffBJetTags",
0262       "container": "reco::JetTag",
0263       "desc": "Result of track counting algorithm (requiring two tracks to have a significance above the discriminator). To be used for high efficiency selection (B eff > 50%, mistag rate > 1% )"
0264      },
0265      {
0266       "instance": "impactParameterTagInfos",
0267       "container": "reco::TrackIPTagInfo",
0268       "desc": "contains information used for btagging about track properties such as impact parameters, decay len, probability to originate from th primary vertex. Uses ak4JetTracksAssociatorAtVertex collection as input."
0269      },
0270      {
0271       "instance": "jetProbabilityBJetTags",
0272       "container": "reco::JetTag ",
0273       "desc": "result of jetProbability algorithm (based on TrackIPTagInfo)."
0274      },
0275      {
0276       "instance": "trackCountingHighPurBJetTags",
0277       "container": "reco::JetTag",
0278       "desc": "Result of track counting algorithm (requiring three tracks to have a significance above the discriminator). To be used for high purity selection (B eff < 50%, mistag rate < 1% )"
0279      },
0280      {
0281       "instance": "secondaryVertexTagInfos",
0282       "container": "reco::SecondaryVertexTagInfo ",
0283       "desc": "contains the reconstructed displaced secondary vertices in a jet and associated information, uses impactParameterTagInfos as input"
0284      },
0285      {
0286       "instance": "jetBProbabilityBJetTags",
0287       "container": "reco::JetTag ",
0288       "desc": "result of jetProbability algorithm in the `jetBProbability` variant."
0289      },
0290      {
0291       "instance": "simpleSecondaryVertexBJetTags",
0292       "container": "reco::JetTag ",
0293       "desc": "Uses the flight distance (i.e. distance between a reconstructed secondary vertex and the primary vertex in a jet) as b-tagging discriminator. Can be configured to return the value or significance in 2d and 3d, optionally corrected for the boost at the SV - works up to a maximum secondary vertex finding efficiency of ~70% in b-jets"
0294      },
0295      {
0296       "instance": "ghostTrackVertexTagInfos",
0297       "container": "*",
0298       "desc": "No documentation"
0299      },
0300      {
0301       "instance": "simpleSecondaryVertexHighPurBJetTags",
0302       "container": "reco::JetTag ",
0303       "desc": "Uses the flight distance (i.e. distance between a reconstructed secondary vertex and the primary vertex in a jet) as b-tagging discriminator. Secondary vertex is reconstructed with three or more tracks."
0304      },
0305      {
0306       "instance": "simpleSecondaryVertexHighEffBJetTags",
0307       "container": "reco::JetTag ",
0308       "desc": "Uses the flight distance (i.e. distance between a reconstructed secondary vertex and the primary vertex in a jet) as b-tagging discriminator. Secondary vertex is reconstructed with two or more tracks. Can be configured to return the value or significance in 2d and 3d, optionally corrected for the boost at the SV - works up to a maximum secondary vertex finding efficiency of ~70% in b-jets"
0309      },
0310      {
0311       "instance": "combinedSecondaryVertexMVABJetTags",
0312       "container": "reco::JetTag ",
0313       "desc": "uses the PhysicsTools/MVAComputer framework to compute a discriminator from the impactParameterTagInfos and secondaryVertexTagInfos with an uptodate calibration from the the CMS conditions database, using a neural network instead of a likelihood ratio in case an actual secondary vertex was reconstructed"
0314      },
0315      {
0316       "instance": "combinedSecondaryVertexBJetTags",
0317       "container": "reco::JetTag ",
0318       "desc": "Result of application of a likelihood estimator to the tagging variables for the three possible algorithm outcomes (tracks only, pseudo vertex from at least two tracks or successful secondary vertex fit), obtained from impactParameterTagInfos and secondaryVertexTagInfos"
0319      },
0320      {
0321       "instance": "btagSoftElectrons",
0322       "container": "reco::Electron ",
0323       "desc": "Electron candidates identified by the dedicated btagging SoftElectronProducer, starting from reco::Tracks"
0324      },
0325      {
0326       "instance": "ghostTrackBJetTags",
0327       "container": "*",
0328       "desc": "No documentation"
0329      },
0330      {
0331       "instance": "softPFElectrons",
0332       "container": "*",
0333       "desc": "No documentation"
0334      },
0335      {
0336       "instance": "softElectronCands",
0337       "container": "*",
0338       "desc": "No documentation"
0339      },
0340      {
0341       "instance": "softElectronBJetTags",
0342       "container": "reco::JetTag ",
0343       "desc": "results of b-tagging a jet using the SoftElectronTagInfo and the default soft electron tagger, which uses a neural network to combine most electron properties to improve rejection of non-b jets"
0344      },
0345      {
0346       "instance": "softElectronTagInfos",
0347       "container": "reco::SoftLeptonTagInfo ",
0348       "desc": "soft electron dedicated TagInfo, containing informations used to b-tag jets due to the presence of a soft electron in the jet"
0349      },
0350      {
0351       "instance": "softElectronByPtBJetTags",
0352       "container": "*",
0353       "desc": "No documentation"
0354      },
0355      {
0356       "instance": "softElectronByIP3dBJetTags",
0357       "container": "*",
0358       "desc": "No documentation"
0359      }
0360     ]
0361   }
0362 }