TransferSystematics

Transfer systematics from one sample to another, or from one channel/region to another.

This is useful in cases where individual samples or regions have low MC statistics and a larger region with similar kinematics is avialable to estimate the systematics from. What is transferred is the relative normalization and/or shape.

Usage:

+TransferSystematics {
  +HWWRun2GGF {
    +ZtautauMerging {
      <mode = "channel">
      # wildcarding is allowed everywhere
      # you can also mix values and lists of values
      <source = "SR_*Mll1_PtSubLeadincl*_x">
      <select.Channels={"SR_*Mll1_PtSubLead2*_e","SR_*Mll1_PtSubLead2*_m","SR_*Mll1_PtSubLead2*_x"}>
      <select.Samples = {"Zjets*"}>
      <select.Systematics = "theo_ztautau_*">
      }
    +ww_0j_merging_all {
      <mode = "channel">
      <select.Samples = {"qqWW0jet"}>
      # it is typically useful to define merged regions to evaluate the systematics on
      # these merged regions can be present when the model is built, and can be removed from the model before building the workspace using EditModel
      <source = "SR_All">
      <select.Channels={"SR_bin*"}>
      <select.Systematics ={"theo_ww_CKKW","theo_ww_QSF" }>
    }
    +zttandvgamma_0j_merging_from_all {
      <mode = "channel">
      <source = "SR_All">
      <select.Samples = {"Zjets0jet","Vgamma0jet"}>
      <select.Channels={"SR_bin*"}>
      <select.Systematics ={"ATLAS_JER*","ATLAS_JES*","ATLAS_MET*","MUONS_SAGITTA*", "MUONS_SCALE", "MUONS_MS", "MUONS_ID", "ATLAS_EG_SCALE_AF2","ATLAS_EG_SCALE_ALL","EG_RESOLUTION_ALL","PRW_DATASF"}>
    }
    # you can instruct the action to create a table of all the transfers actually made in the end like this
    <writeTable="transfer.tex">
  }
}

The edits will be made in-place on the model.