Skip to main content


Project description

columnflow logo
Build status Package version Documentation status Code coverge License

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


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
cd columnflow

# source the setup and store decisions in .setups/ (arbitrary name)
source 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.


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

flow-0.1.2.tar.gz (139.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page