rosamllib 0.5.1

A library for reading and processing medical imaging files like DICOM, RTDOSE, RTSTRUCT, etc.

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
• Documentation
• Contributing
• License
• Contacts

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:

1. Fork the repository.
2. Create a new feature branch.
3. Implement your changes and write tests.
4. 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 [e-mail]