Metadata-Version: 2.1
Name: omnifold
Version: 0.1.24
Summary: OmniFold, a library to perform unbinned and high-dimensional unfolding for HEP.
Home-page: https://github.com/ViniciusMikuni/omnifold
Author: Vinicius Mikuni
Author-email: vmikuni@lbl.gov
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: matplotlib
Requires-Dist: numpy
Requires-Dist: PyYAML
Requires-Dist: setuptools
Requires-Dist: tensorflow
Provides-Extra: parallel
Requires-Dist: horovod>=0.28.1; extra == "parallel"

# OmniFold: A Method to Simultaneously Unfold All Observables

This repository contains the implementation and examples of the OmniFold algorithm originally described in [Phys. Rev. Lett. 124 (2020) 182001](https://dx.doi.org/10.1103/PhysRevLett.124.182001), [1911.09107 [hep-ph]](https://arxiv.org/abs/1911.09107).  The code for the original paper can be found at [this repository](https://github.com/ericmetodiev/OmniFold), which includes a [binder demo](https://mybinder.org/v2/gh/ericmetodiev/OmniFold/master).  This repository was created to maintain the pip installable version of OmniFold with additional functionality compared to the original package:

# Installation

```bash
pip install omnifold
```

# Getting Started
Examples for tabular data and for Point Cloud-like inputs are provided in the notebooks OmniFold_example.ipynb and OmniFold_example_pc.ipynb, respectively.
To unfold your own data you can follow these steps:

## Creating a DataLoader to hold your data

```python
from omnifold import DataLoader

# Load your own dataset, possibly with weights.
mock_dataset = np.zeros((100,3,4))
mock_dataloader = DataLoader(
		  reco = mock_dataset,
		  gen = mock_dataset,
		  normalize=True)

```

The DataLoader class will automatically normalize the weights if ```normalize``` is true. To estimate the statistical uncertainty using the Bootstrap method, you can use the optional flag ```bootstrap = True```.

## Creating your own Keras model to be used for Unfolding

In the MultiFold class, we provide simple neural network models that you can use. For a Multilayer Perceptron you can load

```python
from omnifold import MLP
ndim = 3 #The number of features present in your dataset
reco_model = MLP(ndim)
gen_model = MLP(ndim)
```

to create the models to be used at both reconstruction and generator level trainings of OmniFold. In case your data is better described by a point cloud, we also provide the implementation of the [Point-Edge Transformer (PET)](https://arxiv.org/abs/2404.16091) model that can be used similarly to the MLP implementation:


```python
from omnifold import PET
ndim = 3 #The number of features present in your dataset
npart = 5 #Maximum number of particles present in the dataset

reco_model = PET(ndim,num_part = npart)
gen_model = PET(ndim,num_part = npart)
```

You can also provide your own custom keras.Model to be used by OmniFold

## Creating the MultiFold Object

Now that we have the dataset and models, we can create the MultiFold object that performs the unfolding and reweighting of new datasets

```python
omnifold = MultiFold(
    "Name_of_experiment",
    reco_model,
    gen_model,
    data, # a dataloader instance containing the measured data
    mc , # a dataloader instance containing the simulation
)

```
