11. Skims#
The skim package is a collection of high-level analysis scripts that reduce the data set to a manageable size by applying a simple selection. The input to a skim are Belle II File Format files of processed data. The output are so-called (Advanced) user mDST files (udst) files. These files actually contain more information but fewer events.
Tip
Analysts are recommended to use skimmed udst files as input to their analysis. For an introductory lesson, take a look at Section 3.4.12.
Tip
If you would like to know which skims are available, please browse the Physics skims section of the documentation. If you would like to know which cuts are made by a particular skim, then consult the source code by clicking the [source] button on that skim in Physics skims, or by navigating to skim/scripts/skim/WGs/<your working group name>/ in the basf2 repository.
Changed in version release-06-00-00: The skim package was reorganised between releases 5 and 6. If you need your skim steering files to work with both release 5 and release 6, then please use the following type of try-except block:
try:
# release 6+ imports
from skim import BaseSkim, CombinedSkim
from skim.WGs.ewp import BtoXll
except (ImportError, ModuleNotFoundError):
# release 5 imports
from skimExpertFunctions import BaseSkim, CombinedSkim
from skim.ewp import BtoXll
- 11.1. Systematics skims
RandomResonanceSystematicsBhabhaSystematicsCombinedHadronicSystematicsCombinedLowMultiSystematicsDstarSystematicsEELLSystematicsFourLeptonFromHLTFlagSystematicsJpsiSystematicsKshortSystematicsLambdaSystematicsPhiGammaSystematicsRadEESystematicsRadMuMuSystematicsRadMuMuFromHLTFlagSystematicsTracking- 11.1.1. Using
SystematicsCombinedskims
- 11.2. Physics skims
- 11.2.1. B → charm skims
B0toD0Kpipi0_pi0B0toDD_Kpipi_KspiB0toDDs0starB0toDomegapi_Kpipi_pipipi0B0toDomegapi_Kspi_pipipi0B0toDpi_KpipiB0toDpi_KspiB0toDrho_KpipiB0toDrho_KspiB0toDs1DB0toDstarDB0toDstarPi_D0pi_KpiB0toDstarPi_D0pi_Kpipipi_Kpipi0B0toDstarRho_D0pi_KpiB0toDstarRho_D0pi_Kpipipi_Kpipi0B0toDstaretapi_D0pi_KpiB0toDstarpipi0_D0pi_KpiBptoD0etapi_KpiBptoD0pipi0_KpiBtoD0h_KpiBtoD0h_Kpipipi_Kpipi0BtoD0h_KshhBtoD0h_Kspi0BtoD0h_Kspipipi0BtoD0h_hhBtoD0pi_Kpiomega_pipipi0BtoD0rho_KpiBtoD0rho_Kpipipi_Kpipi0BtoDpipi_KpipiBtoDsDsst_Kpi_KKBtoDstarpipipi0_D0pi_KpiBtoDstpipi_D0pi_KpiantiB0toDpipi0_KpipiantiB0toDsDsst_Kpi0
- 11.2.2. B → charmless skims
- 11.2.3. Charm physics skims
DpToEtaHpDpToHpOmegaDpToHpPi0DpToPipEpEmDpToPipKpKmDpToPipMupMumDspToHpOmegaDstToD0Pi_D0ToGenericDstToD0Pi_D0ToHpHmHpJmDstToD0Pi_D0ToHpJmDstToD0Pi_D0ToHpJmEtaDstToD0Pi_D0ToHpJmKsDstToD0Pi_D0ToHpJmPi0DstToD0Pi_D0ToKsOmegaDstToD0Pi_D0ToNeutralsDstToD0Pi_D0ToRareDstToD0Pi_D0ToVGammaDstToDpPi0_DpToHpPi0EarlyData_DstToD0Pi_D0ToHpHmPi0EarlyData_DstToD0Pi_D0ToHpJmPi0LambdacToGenericLambdacToSHpJmLambdacTopHpJmXToD0_D0ToHpJmXToD0_D0ToNeutralsXToDp_DpToHpHmJpXToDp_DpToKsHpXic0ToLHpJmXicToXimPipPimXicpToLKsHpXicpTopHpJmcharm_skim_sigma()charm_skim_std_charged()
- 11.2.4. Dark sector skims
AA2uuuuALP3GammaBtoKplusLLPDarkShowerDielectronPlusMissingEnergyDielectronPlusVisibleDarkHiggsDimuonPlusMissingEnergyDimuonPlusVisibleDarkHiggsDimuonRecoilMassSquaredEGammaControlDarkElectronMuonPlusMissingEnergyGammaGammaControlKLMDarkInelasticDarkMatterInelasticDarkMatterWithDarkHiggsLFVZpVisibleRadBhabhaV0ControlSinglePhotonDark
- 11.2.5. Full event interpretation skims
- 11.2.6. Leptonic skims
- 11.2.7. Low multiplicity skims
- 11.2.8. Quarkonium skims
- 11.2.9. Radiative and electroweak penguins skims
- 11.2.10. Semileptonic skims
B0toDstarl_Kpi_Kpipi0_KpipipiBtoDl_and_ROE_e_or_mu_or_lowmultBtoDl_and_ROE_e_or_mu_or_lowmult.ApplyHLTHadronCutBtoDl_and_ROE_e_or_mu_or_lowmult.TestSampleProcessBtoDl_and_ROE_e_or_mu_or_lowmult.build_lists()BtoDl_and_ROE_e_or_mu_or_lowmult.load_standard_lists()BtoDl_and_ROE_e_or_mu_or_lowmult.validation_histograms()BtoDl_and_ROE_e_or_mu_or_lowmult.validation_sample
PRsemileptonicUntaggedSLUntagged
- 11.2.11. Time-dependent CP-violation (TDCPV) analysis skims
- 11.2.12. Tau-pair skims
- 11.2.1. B → charm skims
- 11.3. Standard skim lists
- 11.3.1. Charm lists
loadCharmlessD0_Kpipi0()loadD0_Kshh_loose()loadD0_Kspi0_loose()loadD0_Kspipipi0()loadD0_hh_loose()loadKForBtoHadrons()loadKSkimHighEff()loadPiForBtoHadrons()loadPiSkimHighEff()loadSkimHighEffD0_Kpi()loadSkimHighEffD0_Kpipipi()loadSkimHighEffDstarPlus_D0pi_Kpi()loadSkimHighEffDstarPlus_D0pi_Kpipipi()loadSlowPi()loadStdD0()loadStdD0_Kpi()loadStdD0_Kpipi0()loadStdD0_Kpipipi()loadStdD0_Kspipi()loadStdD0_eff20_Kpipi0()loadStdDplus()loadStdDplus_Kpipi()loadStdDplus_Kpipipi0()loadStdDplus_Kspi()loadStdDplus_Kspipi0()loadStdDstar0()loadStdDstar0_D0pi0_Kpi()loadStdDstar0_D0pi0_Kpipi0()loadStdDstar0_D0pi0_Kpipipi()loadStdDstar0_D0pi0_Kspipi()loadStdDstar0_D0pi0_all()loadStdDstarPlus()loadStdDstarPlus_D0pi_Kpi()loadStdDstarPlus_D0pi_Kpipi0()loadStdDstarPlus_D0pi_Kpipi0_eff20()loadStdDstarPlus_D0pi_Kpipipi()loadStdDstarPlus_D0pi_Kspipi()loadStdDstarPlus_D0pi_all()loadStdDstarPlus_Dpi0_Kpipi()
- 11.3.2. Dilepton lists
- 11.3.3. Light meson lists
loadA_1Plus()loadStdAllEta()loadStdAllEtaPrime()loadStdAllF_0()loadStdAllKstar0()loadStdAllKstarPlus()loadStdAllOmega()loadStdAllPhi()loadStdAllRho0()loadStdAllRhoPlus()loadStdLightMesons()loadStdLooseEta()loadStdLooseEtaPrime()loadStdLooseF_0()loadStdLooseKstar0()loadStdLooseKstarPlus()loadStdLooseOmega()loadStdLoosePhi()loadStdLooseRho0()loadStdLooseRhoPlus()loadStdPhotonCutEta()loadStdPi0ForBToHadrons()loadStdSkimHighEffEta()loadStdSkimHighEffEtaPrime()loadStdSkimHighEffF_0()loadStdSkimHighEffKstar0()loadStdSkimHighEffOmega()loadStdSkimHighEffPhi()loadStdSkimHighEffRho0()loadStdSkimHighEffTracks()loadStdWideOmega()
- 11.3.4. Charmless lists
- 11.3.1. Charm lists
- 11.4. Information for skim experts
- 11.4.1. Writing a skim
- 11.4.2. Building skim lists in a steering file
- 11.4.3. Running a skim
- 11.4.4. Skim registry
- 11.4.5. Testing skim performance
- 11.4.6. Core skim package API
BaseSkimBaseSkim.ApplyHLTHadronCutBaseSkim.MergeDataStructuresBaseSkim.NoisyModulesBaseSkim.SkimListsBaseSkim.TestFilesBaseSkim.TestSampleProcessBaseSkim.additional_setup()BaseSkim.analysisGlobaltagBaseSkim.apply_hlt_hadron_cut_if_required()BaseSkim.build_lists()BaseSkim.codeBaseSkim.flagBaseSkim.initialise_skim_flag()BaseSkim.load_standard_lists()BaseSkim.mcBaseSkim.output_udst()BaseSkim.pidGlobaltagBaseSkim.postskim_pathBaseSkim.produce_on_tau_samplesBaseSkim.produces_mdst_by_defaultBaseSkim.set_skim_logging()BaseSkim.skim_event_cuts()BaseSkim.update_skim_flag()BaseSkim.validation_histograms()BaseSkim.validation_sample
CombinedSkimCombinedSkim.TestFilesCombinedSkim.additional_setup()CombinedSkim.apply_hlt_hadron_cut_if_required()CombinedSkim.build_lists()CombinedSkim.flagCombinedSkim.flagsCombinedSkim.initialise_skim_flag()CombinedSkim.load_standard_lists()CombinedSkim.merge_data_structures()CombinedSkim.output_mdst_if_any_flag_passes()CombinedSkim.output_udst()CombinedSkim.produce_on_tau_samplesCombinedSkim.set_skim_logging()CombinedSkim.update_skim_flag()
- 11.4.7. Utility functions for skim experts
- 11.4.8.
b2skim-prod: Produce grid production requests - 11.4.9.
b2skim-stats-total: Produce summary statistics for skim package - 11.4.10.
lpns2yaml.py: Convert lists of LPNs to format expected byb2skim-prod