radiuma-suv 0.0.0__tar.gz

radiuma_suv-0.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025  CPSC210-2025S
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

radiuma_suv-0.0.0/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025  CPSC210-2025S
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

radiuma_suv-0.0.0/PKG-INFO

@@ -0,0 +1,520 @@
+Metadata-Version: 2.4
+Name: radiuma-suv
+Version: 0.0.0
+Summary: Python library for PET DICOM to SUVbw conversion
+Author: Mohammad Salmanpour
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
+Classifier: Topic :: Scientific/Engineering :: Image Processing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: LICENSE.txt
+Requires-Dist: numpy
+Requires-Dist: pydicom
+Requires-Dist: SimpleITK
+Dynamic: license-file
+
+# Radiuma_SUV: PET to SUVbw Conversion – Python Script and Library
+
+![Python](https://img.shields.io/badge/Python-3.10%2B-blue)
+![Status](https://img.shields.io/badge/status-development-orange)
+
+**Radiuma_SUV** is the proposed library name for the PET-to-SUVbw conversion engine in `Radiuma_SUV.ipynb`. The code converts PET pixels to **body-weight-normalized standardized uptake values (SUVbw)** using DICOM acquisition and radiopharmaceutical metadata. It supports conventional single-frame PET, Enhanced multi-frame PET, NumPy arrays with matching DICOM metadata, and folders containing one or several PET series. In-memory results are floating-point arrays; DICOM results are newly written, calibrated derived images.
+
+**Publication note:** The notebook itself does not create a package named `radiuma_suv`. This README assumes the conversion functions have been placed in an installable `radiuma_suv` Python package exposing `Radiuma_SUV`, `Radiuma_SUV_from_input`, and `RadiumaSUVLoader`. `pip install radiuma-suv` applies only after that package has actually been published under the distribution name `radiuma-suv`.
+
+**Scientific caution:** `parameter_estimation="ON"` can fill missing metadata with notebook-configured values, including patient weight, radionuclide activity, timing, and other acquisition details. Those values must not be assumed correct for another patient. Prefer `"OFF"` with complete verified source DICOM metadata. No clinical validation is established by the notebook.
+
+## 🔍 Table of Contents
+
+- [🎥 YouTube Tutorials](#-youtube-tutorials)
+- [🧩 IBSI Standardization](#-ibsi-standardization)
+- [✨ Key Features](#-key-features)
+- [📚 Library Usage](#-library-usage)
+  - [📂 Single File Processing](#-single-file-processing)
+  - [🧠 In-Memory Array Processing](#-in-memory-array-processing)
+  - [⚡ Parallel Batch Processing](#-parallel-batch-processing)
+  - [🤖 Deep Features Extraction](#-deep-features-extraction)
+  - [🔧 Advanced Configuration](#-advanced-configuration)
+- [📥 Installation](#-installation)
+- [📂 Data Structure Requirements](#-data-structure-requirements)
+- [📋 Radiuma_SUV Parameters Reference](#-radiuma_suv-parameters-reference)
+- [📊 Parameter Compatibility](#-parameter-compatibility)
+- [📚 API Reference](#-api-reference)
+- [📊 Output Structure](#-output-structure)
+- [📁 Supported File Formats](#-supported-file-formats)
+- [🎯 Library Examples](#-library-examples)
+- [⚡ Performance Tips](#-performance-tips)
+- [💻 Integration of Radiuma_SUV to GUI](#-integration-of-radiuma_suv-to-gui)
+- [❓ Troubleshooting](#-troubleshooting)
+- [🕒 Version History](#-version-history)
+- [📬 Contact](#-contact)
+- [👥 Authors](#-authors)
+- [📚 Citation](#-citation)
+- [🙏 Acknowledgment](#-acknowledgment)
+- [📜 License](#-license)
+
+## 🎥 YouTube Tutorials
+
+No Radiuma_SUV-specific tutorial channel or videos are documented in `Radiuma_SUV.ipynb`. Add verified links here when available. The heading is retained to match the PySERA README section structure.
+
+
+## 🧩 IBSI Standardization
+
+The Radiuma_SUV performs PET intensity conversion based on IBSI radiomics feature extraction. 
+
+## ✨ Key Features
+
+- **PET-to-SUVbw conversion** using PET image pixels and matching DICOM metadata.
+- **Conventional PET DICOM**: single-frame PET images and conventional PET slice series.
+- **Enhanced PET DICOM**: multi-frame images with functional group metadata.
+- **NumPy arrays**: convert in memory using a corresponding DICOM metadata dictionary.
+- **Hierarchical PET directories**: recursively identify PET DICOM groups and process independent series separately.
+- **Type-preserving API**: NumPy input returns a NumPy array; DICOM input creates derived DICOM outputs.
+- **Optional metadata completion**: `parameter_estimation="ON"` fills selected missing values using notebook settings.
+- **Derived DICOM output**: new DICOM identifiers, calibrated signed 16-bit pixels, and output validation against computed SUVbw values.
+- **Source protection**: output paths are checked to avoid overwriting original DICOM files.
+- **Object-oriented convenience wrapper**: `RadiumaSUVLoader`.
+
+These are implementation capabilities, not independent quantitative or clinical validation claims.
+
+### 📦 Library Installation via pip
+
+After publishing the intended package under the distribution name `radiuma-suv`:
+
+```bash
+python -m pip install radiuma-suv
+```
+
+For local development in the directory containing `pyproject.toml`:
+
+```bash
+python -m pip install -e .
+```
+
+## 📚 Library Usage
+
+### 📂 Single File Processing
+
+```python
+from radiuma_suv import Radiuma_SUV_from_input
+
+output_path, metadata = Radiuma_SUV_from_input(
+    image_input="pet_scan.dcm",
+    parameter_estimation="OFF",
+    output_path="pet_suvbw.dcm",
+)
+print(output_path)
+```
+
+Supported single-file DICOM inputs are conventional single-frame PET or Enhanced multi-frame PET. Non-Enhanced multi-frame PET files are explicitly rejected.
+
+### 🧠 In-Memory Array Processing
+
+```python
+import json
+import numpy as np
+from radiuma_suv import Radiuma_SUV
+
+pet_pixels = np.load("pet_pixels.npy")
+with open("pet_dicom_metadata.json", "r", encoding="utf-8") as file:
+    metadata = json.load(file)
+
+suv_array, output_metadata = Radiuma_SUV(
+    input_array=pet_pixels,
+    input_metadata=metadata,
+    parameter_estimation="OFF",
+)
+np.save("pet_suvbw.npy", suv_array)
+print(suv_array.shape)
+```
+
+The JSON must be the actual metadata corresponding to the PET image, not an arbitrary placeholder. In-memory output is floating-point SUVbw without DICOM pixel quantization.
+
+The convenience input API accepts the same representation:
+
+```python
+from radiuma_suv import Radiuma_SUV_from_input
+suv, meta = Radiuma_SUV_from_input(
+    image_input=pet_pixels,
+    metadata_json=metadata,
+    parameter_estimation="OFF",
+)
+```
+NumPy input cannot specify `output_path`; saving a `.npy` file is the caller's responsibility.
+ 
+`parameter_estimation` controls metadata replacement:
+
+| Option | Behavior |
+|---|---|
+| `"OFF"` | Does not fill missing parameters from the configured notebook defaults. |
+| `"ON"` | Inserts eligible missing or invalid DICOM fields using configured values. |
+
+The notebook has configurable values for patient weight, age, height, sex; administered dose, half-life and radiopharmaceutical timing; acquisition and series times; PET units; SUV type; decay correction; rescale slope and intercept; image geometry; and other fields. These settings are **not additional keyword arguments** of `Radiuma_SUV_from_input`.
+
+The source implements unit conversion paths involving `BQML`, `GML`, `CM2ML`, and `CNTS`. Successful processing depends on the necessary metadata and calibration factors. The `BQML` converter handles `DecayCorrection` values `ADMIN`, `START`, and `NONE` with different reference-time logic. The source also includes body-composition helper functions used for certain `GML` SUV normalization variants.
+
+**Never reuse the notebook's example patient or dose values for a different person.** Review any derived output in the original DICOM context.
+
+## 📥 Installation
+
+Dependencies imported by the notebook are `numpy`, `pydicom`, and `SimpleITK`; other referenced Python modules are standard-library modules. In the original notebook the installation line is `%pip install numpy pydicom SimpleITK`; for a published library, declare these in `pyproject.toml` instead.
+
+### 🌐 GitHub Installation
+
+https://git.talkfluent.ir/admin/Radiuma-SUV/src/branch/main
+
+```bash
+git clone https://github.com/YOUR_USERNAME/radiuma_suv.git
+cd radiuma_suv
+python -m pip install -e .
+```
+
+### macOS/Linux Installation
+
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install --upgrade pip
+python -m pip install -e .
+```
+
+### Windows Setup
+
+In PowerShell inside the project directory:
+
+```powershell
+python -m venv .venv
+.venv\Scripts\Activate.ps1
+python -m pip install --upgrade pip
+python -m pip install -e .
+```
+
+### 💻 Python Script - Command Line Interface (CLI)
+
+The notebook contains an example `if __name__ == "__main__":` block but **does not implement an argument-parsing CLI or a `radiuma_suv` terminal command**. Create a short Python script when you want command-line execution:
+
+```python
+# convert_pet.py
+from radiuma_suv import Radiuma_SUV_from_input
+path, headers = Radiuma_SUV_from_input("pet_scan.dcm", parameter_estimation="OFF")
+print(path)
+```
+
+```bash
+python convert_pet.py
+```
+
+### 📦 Library Installation via pip
+
+```bash
+python -m pip install radiuma-suv
+```
+
+This will install the intended project **only after it is actually published** under that name on PyPI.
+
+## 📂 Data Structure Requirements
+
+The notebook processes PET DICOM input **without masks**. Examples of appropriate layouts:
+
+**Single PET image:**
+
+```text
+PET/
+└── scan.dcm
+```
+
+**Conventional PET image series:**
+
+```text
+PET_Series/
+├── slice_001.dcm
+├── slice_002.dcm
+└── slice_003.dcm
+```
+
+**Hierarchical directory:**
+
+```text
+Patients/
+├── patient_001/
+│   └── PET/
+│       ├── slice_001.dcm
+│       └── slice_002.dcm
+└── patient_002/
+    └── PET/
+        └── enhanced_pet.dcm
+```
+
+The source searches directories recursively, reads DICOM headers, selects `Modality=PT`, and groups series by their `SeriesInstanceUID` and folder. A DICOM series spanning different source folders is rejected by the writer. The corresponding output folders preserve relative structure with `_processed` naming.
+
+**Output must not be inside the source directory.** Existing destinations are not overwritten. Non-DICOM files may be skipped during directory discovery, but `.nii`, `.nii.gz`, `.nrrd`, and `.nhdr` are not valid Radiuma_SUV PET inputs. For NumPy, pass an in-memory `ndarray` and DICOM metadata; a `.npy` *path* is not accepted by `Radiuma_SUV_from_input`.
+
+## 📋 Radiuma_SUV Parameters Reference
+
+### Public function parameters
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `input_array` | `numpy.ndarray` | Required | PET array passed to `Radiuma_SUV`. |
+| `input_metadata` | `dict` | Required | Corresponding PET DICOM metadata dictionary. |
+| `image_input` | `numpy.ndarray`, string, path-like | Required | NumPy array, PET DICOM file, or PET DICOM directory. |
+| `metadata_json` | `dict` or `None` | `None` | Matching metadata for NumPy input; optional for DICOM input. |
+| `parameter_estimation` | `str` | `"OFF"` | `"ON"` or `"OFF"` only. |
+| `output_path` | string / path-like / `None` | `None` | Destination for DICOM outputs; not valid with NumPy input. |
+| `pet_metadata` | `dict` or `None` | `None` | `RadiumaSUVLoader` metadata for a NumPy input. |
+
+### Selected configured DICOM fields
+
+These are **example literal settings present in the notebook**, not a universal dataset or recommended patient parameters.
+
+| Metadata field | Notebook setting | Meaning |
+|---|---|---|
+| `PatientWeight` | `"75.5"` | Patient weight, kg |
+| `PatientAge` | `"045Y"` | Age in DICOM AS format |
+| `PatientSize` | `"1.75"` | Height, m |
+| `PatientSex` | `"M"` | DICOM sex code |
+| `RadionuclideTotalDose` | `"370000000"` | Radionuclide activity; representation-specific unit handling must be verified |
+| `RadionuclideHalfLife` | `"6586.2"` | Half-life, s |
+| `RadiopharmaceuticalStartDateTime` | `"20261010093015"` | Radiopharmaceutical administration start |
+| `ActualFrameDuration` | `"180000"` | Frame duration, ms |
+| `FrameReferenceTime` | `"90000"` | Frame reference time, ms |
+| `AcquisitionDate` | `"20261010"` | DICOM DA |
+| `AcquisitionTime` | `"100000"` | DICOM TM |
+| `Units` | `"BQML"` | PET units |
+| `SUVType` | `"BW"` | SUV normalization type |
+| `DecayCorrection` | `"START"` | Decay reference |
+| `RescaleSlope` | `"1.0"` | Pixel calibration slope |
+| `RescaleIntercept` | `"0.0"` | Pixel calibration intercept |
+| `Rows`, `Columns` | `256`, `256` | Example image size |
+| `PixelSpacing` | `[4.0, 4.0]` | Row/column spacing, mm |
+| `SliceThickness` | `"3.0"` | Slice thickness, mm |
+| `ImagePositionPatient` | `[0.0, 0.0, 0.0]` | Image coordinates, mm |
+| `ImageOrientationPatient` | `[1, 0, 0, 0, 1, 0]` | Orientation cosines |
+
+The source defines many additional correction, geometry, timing, and vendor-related fields. Consult the notebook's **User Controlled Parameters** section for the complete set. These values should not be inferred or substituted without acquisition-specific evidence.
+
+## 📊 Parameter Compatibility
+
+| Feature / argument | NumPy + metadata | Single PET DICOM | DICOM directory |
+|---|---:|---:|---:|
+| `parameter_estimation` | ✓ | ✓ | ✓ |
+| `metadata_json` / `input_metadata` | Required | No | No |
+| `output_path` | Not allowed | ✓ | ✓ |
+| Floating-point array return | ✓ | No | No |
+| Derived DICOM output | No | ✓ | ✓ |
+| Independent series grouping | No | No | ✓ |
+| `mask_input` | No | No | No |
+| `num_workers` | No | No | No |
+| Deep-learning model selection | No | No | No |
+
+## 📚 API Reference
+
+### `Radiuma_SUV(input_array, input_metadata, parameter_estimation="OFF")`
+
+Converts an in-memory PET NumPy array to SUVbw. Returns `(suv_array, output_metadata)`.
+
+### `Radiuma_SUV(input_array, input_metadata, parameter_estimation="ON")` 
+
+Converts an in-memory PET NumPy array to SUVbw, it replace missed parameters in input image DICOM header with default vlues defined in code. Returns `(suv_array, output_metadata)`.
+
+### `Radiuma_SUV_from_input(image_input, metadata_json=None, parameter_estimation="OFF", output_path=None)`
+
+Detects input representation and returns a matching result: a NumPy array or a new DICOM output file/folder path, plus corresponding metadata. DICOM source objects are not deliberately overwritten.
+
+### `Radiuma_SUV_from_input(image_input, metadata_json=None, parameter_estimation="ON", output_path=None)`
+Detects input representation and returns a matching result: a new DICOM output file/folder path, it replace missed parameters in input image DICOM header with default vlues defined in code. DICOM source objects are not deliberately overwritten.
+
+```python
+from radiuma_suv import RadiumaSUVLoader
+converter = RadiumaSUVLoader(parameter_estimation="OFF", output_path="pet_output.dcm")
+output, metadata = converter.convert("pet_input.dcm")
+```
+
+The source also defines `main(input_array, input_metadata, parameter_estimation="OFF")` as an in-memory alias. Its availability as a package-level import depends on your `__init__.py` exports.
+
+## 📊 Output Structure
+
+| Input | First return value | Second return value |
+|---|---|---|
+| NumPy array | Floating-point SUVbw NumPy array | Metadata dictionary |
+| Single PET DICOM file | New DICOM file path | Output header dictionary |
+| PET DICOM folder, one series | Output directory path | List of header dictionaries |
+| Folder, multiple series | Output root directory path | Nested header lists |
+
+**DICOM representation:** The source encodes SUVbw into calibrated **signed 16-bit pixels**. For conventional PET, the output `RescaleSlope` is needed to recover actual SUVbw. For Enhanced PET, use its real-world value mapping. The writer checks the saved file's pixel shape and reconstruction against calculated values within quantization tolerance. This is not an independent reference SUV validation.
+
+
+## 🔢 Feature Extraction Modes
+
+The source does not implement feature extraction. Its relevant modes are input/conversion paths:
+
+1. Conventional PET intensity rescaling and unit conversion to SUVbw.
+2. Enhanced PET per-frame mapping and SUVbw conversion.
+3. In-memory floating-point NumPy return.
+4. Calibrated derived DICOM output.
+
+The implementation includes unit conversion helpers for `BQML`, `GML`, `CM2ML`, and `CNTS`, plus body-composition normalization helpers used in certain transformations. Supported paths require valid metadata; they are not guaranteed for every scanner-specific DICOM object.
+
+## 📁 Supported File Formats
+
+| Format | Supported | Notes |
+|---|---|---|
+| Conventional PET DICOM `.dcm` | Yes | Single frame |
+| Enhanced PET DICOM `.dcm` | Yes | Multi-frame Enhanced PET SOP class |
+| Extensionless DICOM in a folder | Detected if readable | Must identify as PET (`Modality=PT`) |
+| PET DICOM directory | Yes | Recursive series grouping |
+| In-memory NumPy `ndarray` | Yes | Must provide matching DICOM metadata |
+| `.npy` path | No | Load with `np.load()` and pass array |
+
+## 🎯 Library Examples
+
+### Example 1: Single DICOM
+
+```python
+from radiuma_suv import Radiuma_SUV_from_input
+result, meta = Radiuma_SUV_from_input("pet.dcm", parameter_estimation="OFF")
+print(result)
+```
+
+### Example 2: Multiple PET folders
+
+```python
+from radiuma_suv import Radiuma_SUV_from_input
+out, headers = Radiuma_SUV_from_input(
+    "PET_Input", parameter_estimation="OFF", output_path="SUV_Output"
+)
+```
+
+### Example 3: NumPy data
+
+```python
+import numpy as np
+from radiuma_suv import Radiuma_SUV
+pixels = np.load("pet_pixels.npy")
+# Load the genuine DICOM metadata for the same scan.
+suv, meta = Radiuma_SUV(pixels, matching_pet_dicom_metadata, "OFF")
+```
+
+The `matching_pet_dicom_metadata` variable must be defined using actual DICOM metadata before executing this example.
+
+## ⚡ Performance Tips
+
+1. Use the folder interface when processing multiple PET DICOM series.
+2. Keep output outside the input directory and ensure the output path does not exist.
+3. Avoid making unnecessary copies of large arrays when working with NumPy.
+4. Do not assume parallel acceleration: no multiprocessing API is implemented.
+5. Use real acquisition-specific metadata for correct dose and decay calculations.
+6. Validate numerical values after conversion and DICOM quantization.
+7. The notebook contains no benchmarking results, so no speed claims are made here.
+
+
+```python
+from radiuma_suv import Radiuma_SUV_from_input
+
+def process_selected_pet(source, destination):
+    return Radiuma_SUV_from_input(
+        image_input=source,
+        output_path=destination,
+        parameter_estimation="OFF",
+    )
+```
+
+
+## ❓ Troubleshooting
+
+| Message / problem | Recommended check |
+|---|---|
+| `ModuleNotFoundError: No module named 'radiuma_suv'` | Confirm the package was created, installed, and imported from the active Python environment. |
+| `NumPy PET input requires associated DICOM metadata_json` | Pass matching DICOM metadata with the NumPy array. |
+| `parameter_estimation must be "ON" or "OFF"` | Use the exact supported values. |
+| `Input must be PET DICOM (Modality=PT)` | Confirm the file really contains PET DICOM. |
+| `Non-Enhanced multi-frame PET is unsupported` | Input format is outside the implemented multi-frame path. |
+| `No PET DICOM series found` | Verify DICOM readability, modality, and folder contents. |
+| `Output directory must not be nested within input folder` | Choose an independent output directory. |
+| `Refusing to overwrite existing output` | Choose another destination. |
+| Missing activity, weight, half-life, or timing | Review source metadata; do not blindly apply configured defaults. |
+| Unexpected SUVbw values | Recheck units, calibration, corrected dose, decay time, and actual acquisition data. |
+
+### Get Help
+
+  - **Examples**: Run `python examples/basic_usage.py`
+
+## 🕒 Version History
+
+The uploaded notebook does not state a release history or published Radiuma_SUV version. Suggested initial entry **after an actual package release**:
+
+```text
+v0.0.0 — proposed first Radiuma_SUV library release
+- Conventional PET DICOM to SUVbw
+- Enhanced multi-frame PET to SUVbw
+- NumPy input and metadata output
+- Recursive DICOM series processing
+```
+
+## 📬 Contact
+
+Radiuma_SUV is available **free of charge**.
+For access, questions, or feedback:
+
+**Dr. Mohammad R. Salmanpour (Team Lead)**  
+📧[msalman@bccrc.ca](mailto:msalman@bccrc.ca) | [m.salmanpoor66@gmail.com](mailto:m.salmanpoor66@gmail.com), [m.salmanpour@ubc.ca](mailto:m.salmanpour@ubc.ca)
+
+---
+## 🛠️ Maintenance
+
+For technical support and maintenance inquiries, please contact:
+
+**Dr. Mohammad R. Salmanpour (Team Lead)**  
+ msalman@bccrc.ca – m.salmanpoor66@gmail.com – m.salmanpour@ubc.ca
+
+**Ramin Afrah**  
+## 👥 Authors
+
+- **Dr. Mohammad R. Salmanpour (Team Lead, Fund Provider, Evaluator, Medical Imaging Expert, Backend Development, Code Refactoring, Debugging, Library Management, IBSI Standardization, and Activation of the PySERA Library, and GUI Development in 3D Slicer)** – [msalman@bccrc.ca](mailto:msalman@bccrc.ca), [m.salmanpoor66@gmail.com](mailto:m.salmanpoor66@gmail.com), [m.salmanpour@ubc.ca](mailto:m.salmanpour@ubc.ca)
+- **Ramin Afrah (Development, Code Refactoring, Debugging, and Library Management)** 
+- **Yasaman Salehi (Testing)** 
+- **Sonya Falahati (Tesing)** 
+- **Dr. Mehrdad Oveisi (Evaluator, Software Engineer, and Advisor)** 
+- **Dr. Arman Rahmim (Fund Provider, Medical Imaging Expert, Evaluator, and Advisor)** 
+
+## 📚 Citation
+
+
+```bibtex
+@misc{salmanpour2026Radiua_SUVpython,
+      title={Radiuma_SUV: Open-Source Standardized Python Library for PET-to-SUVbw conversion}, 
+      author={Mohammad R. Salmanpour and Ramin Afrah and Mehrdad Oveisi and Arman Rahmim},
+      year={2026},
+      eprint={2511.15963},
+      archivePrefix={arXiv},
+      primaryClass={physics.med-ph},
+      url={https://arxiv.org/abs/2511.15963}, 
+}
+```
+
+## 📜 License
+
+This open-source software is released under the **MIT License**, which grants permission to use, modify, and distribute it for any purpose, including research or commercial use, without requiring modified versions to be shared as open source. See the [LICENSE](LICENSE) file for details.
+
+## Support
+
+
+- **Issues**: [GitHub Issues](https://github.com/radiuma-com/Radiuma_SUV/issues)
+- **Documentation**: This README and the included guides
+- **Examples**: See `examples/basic_usage.py`
+
+
+## Acknowledgment
+
+- [🔬 **Qu**antitative **R**adiomolecular **I**maging and **T**herapy (Qurit) Lab, University of British Columbia, Vancouver, BC, Canada](https://www.qurit.ca)  
+- [🏥 BC Cancer Research Institute, Department of Basic and Translational Research, Vancouver, BC, Canada](https://www.bccrc.ca/)  
+- [💻 **Vir**tual **Collab**oration (VirCollab) Group, Vancouver, BC, Canada](https://vircollab.com/#/) 
+- [🏭 **Tec**hnological **Vi**rtual **Co**llaboration **Corp**oration (TECVICO Corp.), Vancouver, BC, Canada](https://www.tecvico.com)  
+We gratefully acknowledge funding from the💰 Natural Sciences and Engineering Research Council of Canada (**NSERC**) Idea to Innovation [**I2I**] Grant **GR034192**.
+---
+
+*Radiuma_SUV: PET-to-SUVbw conversion for NumPy arrays and DICOM images.*