Skip to content

pone-software/apollo

Repository files navigation

Contributors Forks Stargazers Issues MIT License LinkedIn


Logo

Apollo

P-One's Neural Network based trigger algorithm
Explore the docs »

Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgments

About The Project

Product Name Screen Shot

Like the greek god Apollo, this repository is all about predicting things. The Pacific Ocean Neutrino Experimen (P-ONE) is a neutrino detector to be built in the Pacific Ocean. High event rates and limited bandwidth require a preselection of "interesting", in our case extragalactic high-energy neutrino, events. This has to be done in real time as the data stream does not stop. This repository contains neural network models that classify whether the current timeframe contains something interesting or not based on simulated events of different detector structures.

(back to top)

Built With

  • Python
  • PyTorch

(back to top)

Getting Started

This section tells you how to set up the package and be able to run with it.

Prerequisites

This package is built and updated using Poetry. Please install it and make yourself familiar if you never heard of it.

Installation

To install the virtual environment of the package call the following console command

foo@bar:apollo/$ poetry install

(back to top)

Usage

To use it, either call the commands of the Makefile. To list them call make help. If you want to have a granular check, you can run

foo@bar:apollo/$ poetry shell

To open a virtual environment.

(back to top)

Roadmap

V0.0.1

  • Create DataLoader
  • Create NoisedDataLoader
  • Create Notebook showing Data Loaders
  • Cleaning up Examples Folder

v1.0.0

  • Set up ML Workflow
  • Create first simple model
  • Create runnable ML Algorithm
  • Make package installable and add prerequisites and installation in template

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

(back to top)

Contributing

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

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

How to branch

  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

(back to top)

License

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

(back to top)

Contact

Janik Prottung - @janikprottung - [email protected]

Project Link: https://github.com/pone-software/apollo

(back to top)

Acknowledgments

(back to top)

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages