/Osirix-ColorMRI

A RGB Image Composer Plugin For Osirix

Primary LanguageC++MIT LicenseMIT

ColorMRI Logo

Osirix Color MRI Plugin

An RGB Image Composer Plugin developed for Osirix image viewer application. The plugin lets users choose 2 or 3 image sets from the same locations of a patient and composes them into a single RGB Image Set.

Tricolor Composing

you can find much more detailed information from Dr. Nevit Dilmen’s documentation : Three color vision and Color MRI

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

In order to run this plugin, you must have at least OSX 10.6 and Osirix installed in your system.

Installing

  • Download “ColorMRI.osirixplugin.zip” the latest release from the Releases tab.
  • Double click on the extracted “ColorMRI.osirixplugin” file. Osirix will launch automatically and add the plugin to the application.

Rebuilding the project from the source code and install

  • Clone the repository by typing “git clone https://github.com/dreampowder/Osirix-ColorMRI
  • open terminal and navigate to the project path.
  • run “pod install” inside the project path. If you do not have cocoapods installed in your system, you can install it by typing “sudo gem install cocoapods” in the terminal window. ( you can also find further instuctions about installing cocoapods at https://guides.cocoapods.org/using/getting-started.html )
  • Open the project by typing “open Osirix\ ColorMRI.xcworkspace/” from the terminal or double click on the “Osirix ColorMRI.xcworkspace” file form the finder.
  • From the XCode, click on ‘Build’ from Product menu from the top to build.
  • Once the build process is completed, right click on the “ColorMRI.osirixplugin” and show in finder to open the file from finder.
  • double click on the file to launch Osirix and Install the plugin.

Minimum image requirements

  • In order to make a trichromatic color MRI you will need:
  • Three series with the same Field of view (FOV) and same resolution.
  • Recommended series are T1 for red channel, T2 for green channel and STIR or T2 Fat sat for blue channel.


Usage

Resulting images

  • Colors of resulting image depends on orginal series used in combination and the order:
  • If you follow the recommended series: T1 for red channel, T2 for green channel and STIR or T2 Fat sat for blue channel.
  • Then the colors of resulting image would be as follows
    • Fat: Yellow
    • Water: Cyan/Blue
    • Muscle: Dark red
    • Old blood: Red

Contributing

Please read [CONTRIBUTING.md](https://gist.github.com/PurpleBooth/b24679402957c63ec426) for details on our code of conduct, and the process for submitting pull requests to us.

Authors

  • Dr. Nevit Dilmen - Project Manager
  • Serdar Coskun - Developer

License

This project is licensed under the MIT License - see the [LICENSE] file for details

Example Outputs from the plugin


Sagittal cervical Color MRI


Axial Orbita Color MRI


Sagittal Lumbar Color MRI





Color MRA MIP, Arterial phase in red and late phase in blue.
How to Create Color MRA: step by step instructions. (View/Download PDF File)