flow 0.1.2

columnflow

Backend for vectorized, columnar HEP analyses with pure Python, law and order.

Quickstart

Modules, exported shell functions and environment variables might have a prefix CF or cf to express their connection to this project.

A couple test tasks are listed below. They might require a valid voms proxy for accessing input data.

# clone the project
git clone --recursive [e-mail]:uhh-cms/columnflow.git
cd columnflow

# source the setup and store decisions in .setups/dev.sh (arbitrary name)
source setup.sh dev

# index existing tasks once to enable auto-completion for "law run"
law index --verbose

# run your first task
law run cf.ReduceEvents \
    --version v1 \
    --dataset st_tchannel_t \
    --branch 0

# create a plot
law run cf.PlotVariables \
    --version v1 \
    --datasets st_tchannel_t \
    --producers example \
    --variables jet1_pt \
    --categories 1e \
    --branch 0

# create a (test) datacard (CMS-style)
law run cf.CreateDatacards \
    --version v1 \
    --producers example \
    --inference-model example \
    --workers 3

Projects using columnflow

• analysis playground: A testing playground for HEP analyses.

• hh2bbtautau: HH → bb𝜏𝜏 analysis with CMS.

• hh2bbww: HH → bbWW analysis with CMS.

• topmass: Top quark mass measurement with CMS.

• mttbar: Search for heavy resonances in ttbar events with CMS.

Development

• Source hosted at GitHub

• Report issues, questions, feature requests on GitHub Issues