{"id":19454145,"url":"https://github.com/ultralytics/petsys","last_synced_at":"2025-04-25T04:31:08.598Z","repository":{"id":103258318,"uuid":"133869433","full_name":"ultralytics/petsys","owner":"ultralytics","description":"LYSO-SiPM gamma scatter analysis from data collected by Ultralytics at PETSYS labs in Lisbon, Portugal, 2017.","archived":false,"fork":false,"pushed_at":"2025-03-28T00:59:08.000Z","size":2762,"stargazers_count":6,"open_issues_count":2,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-28T01:46:19.638Z","etag":null,"topics":["analysis","lyso","matlab","resolution","sipm","timing","ultralytics"],"latest_commit_sha":null,"homepage":"https://ultralytics.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ultralytics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"glenn-jocher","patreon":"ultralytics","open_collective":"ultralytics"}},"created_at":"2018-05-17T21:18:21.000Z","updated_at":"2025-03-28T00:59:10.000Z","dependencies_parsed_at":null,"dependency_job_id":"4bf4bd8f-f0dc-4b46-b95f-acc9b7148ddd","html_url":"https://github.com/ultralytics/petsys","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ultralytics%2Fpetsys","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ultralytics%2Fpetsys/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ultralytics%2Fpetsys/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ultralytics%2Fpetsys/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ultralytics","download_url":"https://codeload.github.com/ultralytics/petsys/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250754663,"owners_count":21481851,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["analysis","lyso","matlab","resolution","sipm","timing","ultralytics"],"created_at":"2024-11-10T17:08:09.238Z","updated_at":"2025-04-25T04:31:03.584Z","avatar_url":"https://github.com/ultralytics.png","language":"Python","funding_links":["https://github.com/sponsors/glenn-jocher","https://patreon.com/ultralytics","https://opencollective.com/ultralytics"],"categories":[],"sub_categories":[],"readme":"\u003cbr\u003e\n\u003ca href=\"https://www.ultralytics.com/\" target=\"_blank\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/ultralytics/assets/main/logo/Ultralytics_Logotype_Original.svg\" width=\"320\" alt=\"Ultralytics logo\"\u003e\u003c/a\u003e\n\n# 🚀 Introduction\n\nWelcome 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!\n\n[![Ultralytics Actions](https://github.com/ultralytics/petsys/actions/workflows/format.yml/badge.svg)](https://github.com/ultralytics/petsys/actions/workflows/format.yml)\n\n## 📜 Description\n\nIn 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](https://github.com/ultralytics/petsys) 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.\n\n## 📦 Requirements\n\nBefore you dive into the world of scintillation and photo-detection, you'll need to arm yourself with a few tools. Ensure you have [MATLAB](https://www.mathworks.com/products/matlab.html) 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:\n\n- Clone our common functions repository using the command:\n\n```bash\n$ git clone https://github.com/ultralytics/functions-matlab\n```\n\n- Integrate the repository into your MATLAB environment:\n\n```matlab\n\u003e\u003e addpath(genpath('/functions-matlab'))\n```\n\nEnsure the following MATLAB toolboxes are also installed:\n\n- `Statistics and Machine Learning Toolbox`\n- `Signal Processing Toolbox`\n\nLet's gear up for some high-fidelity analysis!\n\n## 🏃‍♀️ Running the Code\n\nStarting the analysis is as straightforward as a MATLAB command. Simply type the following into your MATLAB console and watch the magic happen:\n\n```matlab\n\u003e\u003e testSingles  % This script kicks off the analysis on the gamma scatter dataset\n```\n\nEnjoy the graphical outputs and insights generated by the script—like this stunning visualization:\n\n\u003cimg src=\"https://github.com/ultralytics/petsys/blob/main/results.png\"\u003e\n\n## 📑 Citation\n\nIf 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:\n\n[![DOI](https://zenodo.org/badge/133869433.svg)](https://zenodo.org/badge/latestdoi/133869433)\n\n## 🤝 Contribute\n\nWe 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](https://docs.ultralytics.com/help/contributing/) to get started. Also, we'd love to hear about your experience with Ultralytics products. Please consider filling out our [Survey](https://www.ultralytics.com/survey?utm_source=github\u0026utm_medium=social\u0026utm_campaign=Survey). A huge 🙏 and thank you to all of our contributors!\n\n\u003c!-- Ultralytics contributors --\u003e\n\n\u003ca href=\"https://github.com/ultralytics/yolov5/graphs/contributors\"\u003e\n\u003cimg width=\"100%\" src=\"https://github.com/ultralytics/assets/raw/main/im/image-contributors.png\" alt=\"Ultralytics open-source contributors\"\u003e\u003c/a\u003e\n\n## ©️ License\n\nUltralytics is excited to offer two different licensing options to meet your needs:\n\n- **AGPL-3.0 License**: Perfect for students and hobbyists, this [OSI-approved](https://opensource.org/license) open-source license encourages collaborative learning and knowledge sharing. Please refer to the [LICENSE](https://github.com/ultralytics/ultralytics/blob/main/LICENSE) file for detailed terms.\n- **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](https://www.ultralytics.com/license).\n\n## 📬 Contact Us\n\nFor 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)!\n\n\u003cbr\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/ultralytics\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-github.png\" width=\"3%\" alt=\"Ultralytics GitHub\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://www.linkedin.com/company/ultralytics/\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-linkedin.png\" width=\"3%\" alt=\"Ultralytics LinkedIn\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://twitter.com/ultralytics\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-twitter.png\" width=\"3%\" alt=\"Ultralytics Twitter\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://youtube.com/ultralytics\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-youtube.png\" width=\"3%\" alt=\"Ultralytics YouTube\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://www.tiktok.com/@ultralytics\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-tiktok.png\" width=\"3%\" alt=\"Ultralytics TikTok\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://ultralytics.com/bilibili\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-bilibili.png\" width=\"3%\" alt=\"Ultralytics BiliBili\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-transparent.png\" width=\"3%\" alt=\"space\"\u003e\n  \u003ca href=\"https://discord.com/invite/ultralytics\"\u003e\u003cimg src=\"https://github.com/ultralytics/assets/raw/main/social/logo-social-discord.png\" width=\"3%\" alt=\"Ultralytics Discord\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fultralytics%2Fpetsys","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fultralytics%2Fpetsys","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fultralytics%2Fpetsys/lists"}