Skip to content

Commit c10de67

Browse files
pderrengerglenn-jocherUltralyticsAssistant
authored
Ultralytics Refactor https://ultralytics.com/actions (#42)
Signed-off-by: Glenn Jocher <glenn.jocher@ultralytics.com> Co-authored-by: Glenn Jocher <glenn.jocher@ultralytics.com> Co-authored-by: UltralyticsAssistant <web@ultralytics.com>
1 parent 8ba8abd commit c10de67

File tree

1 file changed

+34
-29
lines changed

1 file changed

+34
-29
lines changed

README.md

Lines changed: 34 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -2,70 +2,75 @@
22

33
# 🌊 Introduction
44

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). 🎉
66

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.
88

9-
[![Ultralytics Actions](https://github.com/ultralytics/wave/actions/workflows/format.yml/badge.svg)](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+
[![Ultralytics Actions](https://github.com/ultralytics/wave/actions/workflows/format.yml/badge.svg)](https://github.com/ultralytics/wave/actions/workflows/format.yml)
10+
[![Ultralytics Discord](https://img.shields.io/discord/1089800235347353640?logo=discord&logoColor=white&label=Discord&color=blue)](https://discord.com/invite/ultralytics)
11+
[![Ultralytics Forums](https://img.shields.io/discourse/users?server=https%3A%2F%2Fcommunity.ultralytics.com&logo=discourse&label=Forums&color=blue)](https://community.ultralytics.com/)
12+
[![Ultralytics Reddit](https://img.shields.io/reddit/subreddit-subscribers/ultralytics?style=flat&logo=reddit&logoColor=white&label=Reddit&color=blue)](https://reddit.com/r/ultralytics)
1013

1114
## 🚀 Project Objectives
1215

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.
1417

1518
## 🌟 Key Features
1619

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.
2124

2225
## 🔧 Requirements
2326

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:
2528

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)
3236

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.
3438

3539
## 🏃 Run Instructions
3640

37-
You can run the WAVE models using the following scripts:
41+
Execute the WAVE models using the provided scripts:
3842

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/).
4246

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:
4448

45-
![Waveform Signals](https://github.com/ultralytics/wave/blob/main/data/waveforms.png) ![Training Visualization](https://github.com/ultralytics/wave/blob/main/data/wave.png)
49+
![Waveform Signals](https://raw.githubusercontent.com/ultralytics/wave/main/data/waveforms.png)
50+
![Training Visualization](https://raw.githubusercontent.com/ultralytics/wave/main/data/wave.png)
4651

4752
## 📜 Citation
4853

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:
5055

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).
5257

5358
## 🤝 Contribute
5459

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!
5661

5762
[![Ultralytics open-source contributors](https://raw.githubusercontent.com/ultralytics/assets/main/im/image-contributors.png)](https://github.com/ultralytics/ultralytics/graphs/contributors)
5863

5964
## 📄 License
6065

61-
Ultralytics offers two licensing options to accommodate diverse use cases:
66+
Ultralytics provides two licensing options to suit different needs:
6267

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.
6570

6671
## 📬 Contact Us
6772

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)!
6974

7075
<br>
7176
<div align="center">

0 commit comments

Comments
 (0)