Skip to content

SinanGncgl/Background-Estimation-NormalizingFlows

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


Logo

MLBender

Background Estimation with Neural Autoregressive Flows

A research project that uses Normalizing Flows to perform Background Estimation Task. (This project was carried out for GSoC-2021 (Google Summer of Code) with ML4SCI (Machine Learning for Science), Click Here for more details.).
Explore the docs »

· Report Bug · Request Feature

Table of Contents

About The Project

Logo

Data-driven background estimation is crucial for many scientific searches, including searches for new phenomena in experimental datasets. Neural autoregressive flows (NAF) is a deep generative model that can be used for general transformations and is therefore attractive for this application. The MLBENDER project focuses on studying how to develop such transformations that can be learned and applied to a region of interest. In this project the main aim is implementing a Neural Autoregressive Flow (NAF) model to estimate the background distribution and apply it to a representative physics analysis searching for a resonance excess over a smooth background.

Built With

Getting Started

  • All project related informations can be found in main.ipynb file.

Prerequisites

It is recommended to use conda or venv environments if you're going to run this on your local PC.

Installation

Main packages are as follows:

  • PyTorch 1.9
  • Python 3.6 or higher
  • Pandas
  • Seaborn
  • numpy
  • sklearn

Dataset

  • Dataset can be found at: LHC Dataset.
  • You can work with the other datasets if you like, the normalizing flow models are suitable to work with any other datasets.

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Sinan Gençoğlu - @SinanGncgl - [email protected]

Project Link: https://github.com/SinanGncgl/Background-Estimation-NormalizingFlows

Special Thanks

About

Background Distribution Estimation using Normalizing Flows.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published