|
2 | 2 |
|
3 | 3 | # 🌊 Introduction
|
4 | 4 |
|
5 |
| -Welcome to the [Ultralytics WAVE repository](https://github.com/ultralytics/wave) – the cutting-edge solution for the [machine learning](https://www.ultralytics.com/glossary/machine-learning-ml) driven analysis and interpretation of waveform data in [particle physics](https://en.wikipedia.org/wiki/Particle_physics)! 🎉 |
| 5 | +Welcome to the [Ultralytics WAVE repository](https://github.com/ultralytics/wave)! This repository hosts the cutting-edge solution for the [machine learning](https://www.ultralytics.com/glossary/machine-learning-ml)-driven analysis and interpretation of waveform data, particularly tailored for applications in [particle physics](https://en.wikipedia.org/wiki/Particle_physics). 🎉 |
6 | 6 |
|
7 |
| -Here, we introduce **WA**veform **V**ector **E**xploitation (WAVE), a novel approach that uses [Deep Learning](https://www.ultralytics.com/glossary/deep-learning-dl) 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. |
| 7 | +Here, we introduce **WA**veform **V**ector **E**xploitation (WAVE), a novel approach leveraging [Deep Learning](https://www.ultralytics.com/glossary/deep-learning-dl) to readout and reconstruct signals from particle physics detectors. This open-source codebase aims to foster collaboration and innovation at the exciting intersection of ML and physics. |
8 | 8 |
|
9 |
| -[](https://github.com/ultralytics/wave/actions/workflows/format.yml) <a href="https://discord.com/invite/ultralytics"><img alt="Discord" src="https://img.shields.io/discord/1089800235347353640?logo=discord&logoColor=white&label=Discord&color=blue"></a> <a href="https://community.ultralytics.com/"><img alt="Ultralytics Forums" src="https://img.shields.io/discourse/users?server=https%3A%2F%2Fcommunity.ultralytics.com&logo=discourse&label=Forums&color=blue"></a> <a href="https://reddit.com/r/ultralytics"><img alt="Ultralytics Reddit" src="https://img.shields.io/reddit/subreddit-subscribers/ultralytics?style=flat&logo=reddit&logoColor=white&label=Reddit&color=blue"></a> |
| 9 | +[](https://github.com/ultralytics/wave/actions/workflows/format.yml) |
| 10 | +[](https://discord.com/invite/ultralytics) |
| 11 | +[](https://community.ultralytics.com/) |
| 12 | +[](https://reddit.com/r/ultralytics) |
10 | 13 |
|
11 | 14 | ## 🚀 Project Objectives
|
12 | 15 |
|
13 |
| -The primary goal of this project is to develop and share [Machine Learning](https://www.ultralytics.com/glossary/machine-learning-ml) 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. |
| 16 | +The primary goal of this project is to develop and share advanced [Machine Learning](https://www.ultralytics.com/glossary/machine-learning-ml) techniques applicable to full-waveform time-of-flight detectors. These methods are designed to enhance signal processing and interpretation, pushing the boundaries of particle physics research. |
14 | 17 |
|
15 | 18 | ## 🌟 Key Features
|
16 | 19 |
|
17 |
| -- Implementation of WAVE using [PyTorch](https://pytorch.org/) and [TensorFlow](https://www.tensorflow.org/). |
18 |
| -- Codebase designed for ease of use and adaptability. |
19 |
| -- Support for running WAVE on [Google Cloud Platform (GCP)](https://cloud.google.com/). |
20 |
| -- Sample images illustrating waveform analysis. |
| 20 | +- **Framework Flexibility**: Implementation of WAVE using both [PyTorch](https://pytorch.org/) and [TensorFlow](https://www.tensorflow.org/). |
| 21 | +- **User-Friendly Codebase**: Designed for ease of use and adaptability to various research needs. |
| 22 | +- **Cloud Integration**: Support for running WAVE experiments on [Google Cloud Platform (GCP)](https://cloud.google.com/). |
| 23 | +- **Visualization Examples**: Sample images illustrating waveform analysis and training progress. |
21 | 24 |
|
22 | 25 | ## 🔧 Requirements
|
23 | 26 |
|
24 |
| -Before you dive into waveform vector exploitation with our WAVE code, make sure your machine is set up with the following: |
| 27 | +Before diving into waveform vector exploitation with WAVE, ensure your environment meets the following prerequisites: |
25 | 28 |
|
26 |
| -- [Python](https://www.python.org/) 3.7 or later, plus these packages installed with `pip3 install -U -r requirements.txt`: |
27 |
| - - [`numpy`](https://numpy.org/) |
28 |
| - - [`scipy`](https://scipy.org/) |
29 |
| - - [`torch`](https://pytorch.org/) (version 0.4.0 or later) |
30 |
| - - [`tensorflow`](https://www.tensorflow.org/) (version 1.8.0 or later) |
31 |
| - - [`plotly`](https://plotly.com/) (optional, for visualization) |
| 29 | +- [Python](https://www.python.org/) 3.7 or later. |
| 30 | +- Essential Python packages installed via `pip3 install -U -r requirements.txt`: |
| 31 | + - `numpy` |
| 32 | + - `scipy` |
| 33 | + - `torch` (version 0.4.0 or later) |
| 34 | + - `tensorflow` (version 1.8.0 or later) |
| 35 | + - `plotly` (optional, for enhanced visualization) |
32 | 36 |
|
33 |
| -You can easily install the required packages using [pip](https://pip.pypa.io/en/stable/). |
| 37 | +You can easily install these packages using [pip](https://pip.pypa.io/en/stable/), the Python package installer. |
34 | 38 |
|
35 | 39 | ## 🏃 Run Instructions
|
36 | 40 |
|
37 |
| -You can run the WAVE models using the following scripts: |
| 41 | +Execute the WAVE models using the provided scripts: |
38 | 42 |
|
39 |
| -- To use our [PyTorch](https://pytorch.org/) implementation, run `wave_pytorch.py`. |
40 |
| -- For [TensorFlow](https://www.tensorflow.org/) users, you can run `wave_tf.py`. |
41 |
| -- If you're looking to deploy on [Google Cloud Platform](https://cloud.google.com/), explore `gcp/wave_pytorch_gcp.py`. |
| 43 | +- **PyTorch Implementation**: Run `wave_pytorch.py` for the [PyTorch](https://pytorch.org/)-based model. |
| 44 | +- **TensorFlow Implementation**: Use `wave_tf.py` if you prefer [TensorFlow](https://www.tensorflow.org/). |
| 45 | +- **Google Cloud Deployment**: Explore `gcp/wave_pytorch_gcp.py` for running on [Google Cloud Platform](https://cloud.google.com/). |
42 | 46 |
|
43 |
| -Explore the beauty of waveform signals and the training process visualization with the images below: |
| 47 | +Visualize the intricacies of waveform signals and the training process with these example images: |
44 | 48 |
|
45 |
| -  |
| 49 | + |
| 50 | + |
46 | 51 |
|
47 | 52 | ## 📜 Citation
|
48 | 53 |
|
49 |
| -If you use this code in your research or wish to refer to the WAVE methodology, please cite the following paper: |
| 54 | +If you utilize this code or the WAVE methodology in your research, please cite the original paper: |
50 | 55 |
|
51 |
| -- 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). |
| 56 | +- Jocher, G., Nishimura, K., Koblanski, J. and Li, V. (2018). WAVE: Machine Learning for Full-Waveform Time-Of-Flight Detectors. _arXiv preprint arXiv:1811.05875_. Available at: [https://arxiv.org/abs/1811.05875](https://arxiv.org/abs/1811.05875). |
52 | 57 |
|
53 | 58 | ## 🤝 Contribute
|
54 | 59 |
|
55 |
| -We value each contribution and invite you to participate in developing this pioneering ML approach for physics! Whether you're fixing bugs, proposing new features, or enriching our documentation, find out how to contribute through our [Contributing Guide](https://docs.ultralytics.com/help/contributing/). We also encourage you to share 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! |
| 60 | +We highly value community contributions and invite you to participate in advancing this pioneering ML approach for physics! Whether it's fixing bugs, proposing new features, or improving documentation, your input is welcome. Learn how to contribute by reading our [Contributing Guide](https://docs.ultralytics.com/help/contributing/). We also encourage you to share your feedback through our [Survey](https://www.ultralytics.com/survey?utm_source=github&utm_medium=social&utm_campaign=Survey). A huge thank you 🙏 to all our contributors! |
56 | 61 |
|
57 | 62 | [](https://github.com/ultralytics/ultralytics/graphs/contributors)
|
58 | 63 |
|
59 | 64 | ## 📄 License
|
60 | 65 |
|
61 |
| -Ultralytics offers two licensing options to accommodate diverse use cases: |
| 66 | +Ultralytics provides two licensing options to suit different needs: |
62 | 67 |
|
63 |
| -- **AGPL-3.0 License**: Ideal for students and enthusiasts, this [OSI-approved](https://opensource.org/license) [open-source license](https://github.com/ultralytics/ultralytics/blob/main/LICENSE) promotes open collaboration and knowledge sharing. See the [LICENSE](https://github.com/ultralytics/wave/blob/main/LICENSE) file for more details. |
64 |
| -- **Enterprise License**: Designed for commercial use, this license permits seamless integration of Ultralytics software and AI models into commercial products and services. For more information, please visit [Ultralytics Licensing](https://www.ultralytics.com/license). |
| 68 | +- **AGPL-3.0 License**: This [OSI-approved](https://opensource.org/license) [open-source license](https://github.com/ultralytics/wave/blob/main/LICENSE) is ideal for students and researchers, promoting open collaboration and knowledge sharing. See the [LICENSE](https://github.com/ultralytics/wave/blob/main/LICENSE) file for details. |
| 69 | +- **Enterprise License**: Designed for commercial applications, this license allows for the integration of Ultralytics software and AI models into commercial products and services. Visit [Ultralytics Licensing](https://www.ultralytics.com/license) for more information. |
65 | 70 |
|
66 | 71 | ## 📬 Contact Us
|
67 | 72 |
|
68 |
| -For bug reports, feature requests, and contributions, please visit [GitHub Issues](https://github.com/ultralytics/wave/issues). For broader questions and discussions about this project and other Ultralytics initiatives, join our vibrant community on [Discord](https://discord.com/invite/ultralytics)! |
| 73 | +For bug reports, feature requests, and contributions, please use [GitHub Issues](https://github.com/ultralytics/wave/issues). For broader questions and discussions about the WAVE project or other Ultralytics initiatives, join our vibrant community on [Discord](https://discord.com/invite/ultralytics)! |
69 | 74 |
|
70 | 75 | <br>
|
71 | 76 | <div align="center">
|
|
0 commit comments