# petsys
**Repository Path**: mirrors_ultralytics/petsys
## Basic Information
- **Project Name**: petsys
- **Description**: LYSO-SiPM gamma scatter analysis from data collected by Ultralytics at PETSYS labs in Lisbon, Portugal, 2017.
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-10-22
- **Last Updated**: 2026-05-17
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# ๐ Introduction
Welcome to the official Ultralytics repository dedicated to analyzing gamma scatter interactions on LutetiumโYttrium Oxyorthosilicate (LYSO) crystals. This project leverages Ultralytics' expertise in data-driven research to advance understanding in [particle physics](https://home.cern/science/physics) and imaging technology.
[](https://github.com/ultralytics/petsys/actions/workflows/format.yml)
[](https://discord.com/invite/ultralytics)
[](https://community.ultralytics.com/)
[](https://reddit.com/r/ultralytics)
## ๐ Description
Our goal is to push the boundaries of particle detection and imaging. This repository, [Ultralytics PETSYS](https://github.com/ultralytics/petsys), focuses on the detailed analysis of gamma scatter phenomena observed on LYSO crystals coupled with Silicon Photomultipliers (SiPMs). The dataset originates from PETSYS electronics in Lisbon, Portugal, collected in 2017. It forms the basis for our algorithms designed to perform energy calibration and assess the timing resolution of these sophisticated detection systems, crucial for applications like Positron Emission Tomography (PET).
## ๐ฆ Requirements
To explore the intricacies of scintillation and photo-detection with our tools, you'll need specific software and toolboxes. Ensure you have [MATLAB](https://www.mathworks.com/products/matlab.html) version 2018a or newer installed. Additionally, certain MATLAB toolboxes focused on statistical analysis and signal processing are required.
Get started by:
1. Cloning our common functions repository:
```bash
git clone https://github.com/ultralytics/functions-matlab
```
2. Adding the repository path to your MATLAB environment:
```matlab
addpath(genpath('/path/to/functions-matlab')) % Replace /path/to/ with the actual directory
```
3. Ensuring the following MATLAB toolboxes are installed:
- `Statistics and Machine Learning Toolbox`
- `Signal Processing Toolbox`
With these prerequisites met, you're ready for high-fidelity analysis!
## ๐โโ๏ธ Running the Code
Initiating the analysis is simple. Execute the following command in your MATLAB console:
```matlab
testSingles % This script starts the analysis of the gamma scatter dataset
```
The script will generate graphical outputs and insights, including visualizations like the one shown below:
## ๐ Citation
If you find this dataset or our analysis tools beneficial for your research, please acknowledge our work by citing the DOI provided:
[](https://zenodo.org/badge/latestdoi/133869433)
## ๐ค Contribute
Contributions from the community are highly encouraged! Whether it's fixing bugs, proposing new features, or enhancing documentation, your input helps us improve. Please see our [Contributing Guide](https://docs.ultralytics.com/help/contributing/) for details on how to get started. We'd also appreciate hearing about your experience using Ultralytics products through our [Survey](https://www.ultralytics.com/survey?utm_source=github&utm_medium=social&utm_campaign=Survey). A heartfelt ๐ thank you to all our contributors!
[](https://github.com/ultralytics/ultralytics/graphs/contributors)
## ยฉ๏ธ License
Ultralytics provides two licensing options to accommodate diverse needs:
- **AGPL-3.0 License**: An [OSI-approved](https://opensource.org/license/agpl-v3) open-source license ideal for students and enthusiasts keen on contributing to open projects. See the [LICENSE](https://github.com/ultralytics/ultralytics/blob/main/LICENSE) file for details.
- **Enterprise License**: Designed for commercial applications, this license permits the integration of Ultralytics software and AI models into commercial products and services without the open-source stipulations of AGPL-3.0. For commercial use inquiries, please contact us via [Ultralytics Licensing](https://www.ultralytics.com/license).
## ๐ฌ Contact Us
For bug reports, feature suggestions, and contributions, please visit [GitHub Issues](https://github.com/ultralytics/petsys/issues). For broader questions and discussions related to this project or other Ultralytics initiatives, join our active community on [Discord](https://discord.com/invite/ultralytics)!
