rosamllib is a Python package for reading, manipulating, and visualizing DICOM files, particularly focusing on radiotherapy-related DICOM formats like RTSTRUCT and RTDOSE. The library simplifies the process of extracting useful information from DICOM files, overlaying contours on medical images, and resampling dose grids for dose distribution visualization.
Features
- DICOM Image Handling: Supports reading, resampling, and visualization of DICOM images.
- RTSTRUCT Handling: Extracts contours, generates masks for structures, and overlays them on medical images.
- RTDOSE Handling: Resamples dose grids to match CT image grids and visualizes dose distribution.
- Simple and Intuitive API: Easy-to-use API for manipulating DICOM datasets, working with medical images, and visualizing structures and dose distributions.
Table of Contents
Installation
To install rosamllib, you can use pip:
pip install rosamllib
Alternatively, you can clone this repository and install it manually:
git clone https://gitlab.com/ucla_rosaml/shared/rosamllib
cd rosamllib
pip install .
Documentation
Detailed documentation is available in the form of Jupyter notebooks within the repository. These provide step-by-step examples and usage guides for the core functionality of rosamllib:
- Rosamllib Basic Tutorial
- Reading DICOM Images
- Reading RTSTRUCT Files
- Reading RTDOSE Files
- Working with Registrations
Contributing
We welcome contributions to improve rosamllib! If you encounter bugs or have feature requests, feel free to open an issue or submit a pull request.If you would like to contribute:
- Fork the repository.
- Create a new feature branch.
- Implement your changes and write tests.
- Submit a pull request with a detailed explanation.
License
This project is licensed under the LGPL 3.0 License. See the LICENSE file for details.
Contacts
If you have any questions or suggestions, please contact me at YasinAAbdulkadir@gmail.com
Metadata
Release files for rosamllib 0.6.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| rosamllib-0.6.3-py3-none-any.whl | Python 3 | none | any | Details |
Release files / rosamllib-0.6.3-py3-none-any.whl
| Download URL | rosamllib-0.6.3-py3-none-any.whl |
|---|---|
| Size | 262.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4fccb79765dbda2c9b26ec9652e0ff3ba92d7197068188d834a07e7984cbe231
|
|
BLAKE2b-256 checksum How to use checksums |
99c25af0aab32b1f0e473689fb53583e64e371bdb928ba363090b670937ee3b3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.0.1 CPython/3.11.9
|