skip to navigation
skip to content

raredecay 1.3.0

A package for analysis of rare particle decays with machine-learning algorithms

[![Code Health](](
[![Build Status](](
[![PyPI version](](
[![Dependency Status](](

# raredecay #

This package consists of several tools for the event selection of particle decays, mostly built on machine learning techniques.
It contains:

- a **data-container** holding data, weights, labels and more and implemented root-to-python data conversion as well as plots and KFold-data splitting
- **reweighting** tools from the hep_ml-repository wrapped in a KFolding structure and with metrics to evaluate the reweighting quality
- **classifier optimization** tools for hyper-parameters as well as feature selection involving a backward-elimination
- an **output handler** which makes it easy to add text as well as figures into your code and automatically save them to a file
- ... and more

## HowTo examples ##

To get an idea of the package, have a look at the howto notebooks:
[HTML version]( or the
[IPython Notebooks](

## Minimal example ##
Want to test whether your reweighting did overfit? Use train_similar:

from import HEPDataStorage
from import train_similar

mc_data = HEPDataStorage(df, weights=*pd.Series weights*, target=0)
real_data = HEPDataStorage(df, weights=*pd.Series weights*, target=1)

score = train_similar(mc_data, real_data, old_mc_weights=1 *or whatever weights the mc had before*)

## Getting started right now ##

If you want it the easy, fast way, have a look at the
[Ready-to-use scripts](
All you need to do is to have a look at every "TODO" task and probably change them. Then you can run the script without the need of coding at all.

## Documentation and API ##

The API as well as the documentation:

## Setup and installation ##

The package, in its current state, requires root_numpy as well as rootpy (and therefore a ROOT installation with python-bindings) to be installed on your system. If that is not the case, some functions won't work and you should install it with the --no-dependencies flag and install the other requirements by hand.

First install the very newest version of REP
(the -U can be omitted, but is recommended to have the newest dependencies, on the other hand may crashes REPs reproducibility):
pip install -U
To install the newest version of hep_ml containing the loss-regularization:
pip install -U

Then, install the raredecay package (without ROOT-support) via

pip install raredecay

To make sure you can convert ROOT-NTuples, use

pip install raredecay[root] # *use raredecay\[root\] in a zsh-console*
As it is a young package still under developement, it may receive regular updates and improvements and it is probably a good idea to regularly download the newest package.


File Type Py Version Uploaded on Size
raredecay-1.3.0-py2-none-any.whl (md5) Python Wheel py2 2017-07-19 89KB
raredecay-1.3.0.tar.gz (md5) Source 2017-07-19 78KB