Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ultralytics/wave
WAveform Vector Exploitation (WAVE): Machine Learning for particle physics detectors.
https://github.com/ultralytics/wave
deep-neural-networks machine-learning physics-analysis scintillation sipm time-of-flight
Last synced: 7 days ago
JSON representation
WAveform Vector Exploitation (WAVE): Machine Learning for particle physics detectors.
- Host: GitHub
- URL: https://github.com/ultralytics/wave
- Owner: ultralytics
- License: agpl-3.0
- Created: 2018-05-08T19:20:29.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2024-08-26T13:49:34.000Z (3 months ago)
- Last Synced: 2024-08-26T15:44:30.844Z (3 months ago)
- Topics: deep-neural-networks, machine-learning, physics-analysis, scintillation, sipm, time-of-flight
- Language: Python
- Homepage: https://ultralytics.com
- Size: 949 KB
- Stars: 14
- Watchers: 5
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🌊 Introduction
Welcome to the [Ultralytics WAVE repository](https://github.com/ultralytics/wave) – the cutting-edge solution for the machine learning driven analysis and interpretation of waveform data in particle physics! 🎉
Here, we introduce **WA**veform **V**ector **E**xploitation (WAVE), a novel approach that uses Deep Learning to readout and reconstruct signals from particle physics detectors. This repository contains our open-source codebase and aims to foster collaboration and innovation in this exciting intersection of ML and physics.
[](https://github.com/ultralytics/wave/actions/workflows/format.yml) 
## 🚀 Project Objectives
The primary goal of this project is to develop and share Machine Learning techniques that can be applied to full-waveform time-of-flight detectors. These advanced methods are designed to enhance signal processing and interpretation, thereby pushing the boundaries of what's possible in particle physics research.
## 🌟 Key Features
- Implementation of WAVE using PyTorch and TensorFlow.
- Codebase designed for ease of use and adaptability.
- Support for running WAVE on Google Cloud Platform (GCP).
- Sample images illustrating waveform analysis.
# 🔧 Requirements
Before you dive into waveform vector exploitation with our WAVE code, make sure your machine is set up with the following:
- Python 3.7 or later, plus these packages installed with `pip3 install -U -r requirements.txt`:
- `numpy`
- `scipy`
- `torch` (version 0.4.0 or later)
- `tensorflow` (version 1.8.0 or later)
- `plotly` (optional, for visualization)
# 🏃 Run Instructions
You can run the WAVE models using the following scripts:
- To use our PyTorch implementation, run `wave_pytorch.py`.
- For TensorFlow users, you can run `wave_tf.py`.
- If you're looking to deploy on Google Cloud Platform, explore `gcp/wave_pytorch_gcp.py`.
Explore the beauty of waveform signals and training process visualization with the images below:
 
# 📜 Citation
If you use this code in your research or wish to refer to the WAVE methodology, please cite the following paper:
- Jocher, G., Nishimura, K., Koblanski, J. and Li, V. (2018). WAVE: Machine Learning for Full-Waveform Time-Of-Flight Detectors. Available at: [Arxiv.org](https://arxiv.org/abs/1811.05875).
# 🤝 Contribute
We value each contribution and invite you to participate in developing this pioneering ML approach for physics! Whether you're sharpening bugs, proposing new features, or enriching our documentation, find out how to contribute through our [Contributing Guide](https://docs.ultralytics.com/help/contributing/). Also, let us know your thoughts by completing our [Survey](https://www.ultralytics.com/survey?utm_source=github&utm_medium=social&utm_campaign=Survey). A massive thank you 🙏 to everyone involved!
# 📄 License
Ultralytics is pleased to offer dual licensing options to accommodate a wide range of uses:
- **AGPL-3.0 License**: Our default [open-source license](https://github.com/ultralytics/ultralytics/blob/main/LICENSE), which is OSI-approved and encourages open collaboration and knowledge sharing, is perfect for students, educators, and enthusiasts.
- **Enterprise License**: For commercial applications that require a more flexible licensing arrangement, our enterprise license allows integration of Ultralytics software into proprietary products and services. Reach out through [Ultralytics Licensing](https://www.ultralytics.com/license) for more details.
# 📬 Contact Us
For bug reports, feature requests, and contributions, head to [GitHub Issues](https://github.com/ultralytics/velocity/issues). For questions and discussions about this project and other Ultralytics endeavors, join us on [Discord](https://discord.com/invite/ultralytics)!
