Welcome to the official repository for the analysis of gamma scatter interactions on LYSO crystals, backed by Ultralytics' innovative approach to data-driven research in particle physics!
In our pursuit of advancing the realm of particle detection and imaging technology, we've gathered a unique dataset from PETSYS electronics in Lisbon, Portugal. The Ultralytics PETSYS repo is dedicated to the meticulous analysis of gamma scatter phenomenon on LYSO crystals paired with Silicon Photomultipliers (SiPMs). The data, collected in 2017, serves as a foundation for our algorithms that conduct energy calibration and evaluate the timing resolution of these intricate detection systems.
Before you dive into the world of scintillation and photo-detection, you'll need to arm yourself with a few tools. Ensure you have MATLAB version 2018a or higher at your disposal. Additionally, you'll need a set of MATLAB toolboxes geared toward statistical and signal processing. Here's how to get started:
- Clone our common functions repository using the command:
$ git clone https://github.com/ultralytics/functions-matlab- Integrate the repository into your MATLAB environment:
>> addpath(genpath('/functions-matlab'))Ensure the following MATLAB toolboxes are also installed:
Statistics and Machine Learning ToolboxSignal Processing Toolbox
Let's gear up for some high-fidelity analysis!
Starting the analysis is as straightforward as a MATLAB command. Simply type the following into your MATLAB console and watch the magic happen:
>> testSingles % This script kicks off the analysis on the gamma scatter datasetEnjoy the graphical outputs and insights generated by the script—like this stunning visualization:
If this dataset and our analysis tools facilitate your research or pique your interest in advanced gamma scatter analysis, please cite our work using the DOI provided below:
We welcome contributions from the community! Whether you're fixing bugs, adding new features, or improving documentation, your input is invaluable. Take a look at our Contributing Guide to get started. Also, we'd love to hear about your experience with Ultralytics products. Please consider filling out our Survey. A huge 🙏 and thank you to all of our contributors!
Ultralytics is excited to offer two different licensing options to meet your needs:
- AGPL-3.0 License: Perfect for students and hobbyists, this OSI-approved open-source license encourages collaborative learning and knowledge sharing. Please refer to the LICENSE file for detailed terms.
- Enterprise License: Ideal for commercial use, this license allows for the integration of Ultralytics software and AI models into commercial products without the open-source requirements of AGPL-3.0. For use cases that involve commercial applications, please contact us via Ultralytics Licensing.
For bug reports, feature requests, and contributions, head to GitHub Issues. For questions and discussions about this project and other Ultralytics endeavors, join us on Discord!
