/trajectoryGuideModules

Primary LanguagePythonMIT LicenseMIT

Contributors Forks Stargazers Issues MIT License
DOI


Logo

trajectoryGuide

An open-source software for neurosurgical trajectory planning, visualization, and postoperative assessment
Explore the docs »

Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Contributing
  5. License
  6. Contact
  7. Acknowledgements

About The Project

trajectoryGuide

trajectoryGuide provides the capability to plan surgical trajectories within 3D Slicer, an open-source medical imaging software. trajectoryGuide contains modules that span the three phases of neurosurgical trajectory planning.

The main goal of image guidance in neurosurgery is to accurately project magnetic resonance imaging (MRI) and/or computed tomography (CT) data into the operative field for defining anatomical landmarks, pathological structures and margins of tumors. To achieve this, "neuronavigation" software solutions have been developed to provide precise spatial information to neurosurgeons. Safe and accurate navigation of brain anatomy is of great importance when attempting to avoid important structures such as arteries and nerves.

  Neuronavigation software provides orientation information to the surgeon during all three phases of surgery: 1) pre-operative trajectory planning, 2) the intraoperative stereotactic procedure, and 3) post-operative visualization. Trajectory planning is performed prior to surgery using preoperative MRI data. On the day of surgery, the plans are transferred to stereotactic space using a frame or frame-less system. In both instances, a set of radiopaque fiducials are detected, providing the transformation matrix from anatomical space to stereotactic space. During the surgical procedure, the plans are updated according to intraoperative data collected (i.e. microelectrode recordings, electrode stimulation etc.). After the surgery, post-operative MRI or CT imaging confirms the actual position of the trajectory(ies).

Built With

  • Python version: 3.9
  • 3D Slicer version: 4.11

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

3D Slicer

Install 3D Slicer Version 4.11.0 (or later) by downloading it from the 3D Slicer website.

Template space directory

Download the template space files from this GitHub release. Unzip the folder and move it into the trajectoryGuide folder at the location resources/ext_libs/space.

Installation

Please follow the instructions on the documentation site.

Usage

  1. Pre-operative

    • automatic stereotactic frame detection (supported frames: Leksell, BRW)

    • co-registration of MRI scans with 3D volumetric stealth MRI

      drawing

    • trajectory planning providing coordinates in anatomical and frame space (including arc, ring angles)

  2. Intra-operative

    • update final electrode position based on intra-operative testing
    • display microelectrode recordings (MER) within the patients MRI space

  3. Post-operative

    • co-registration of post-op imaging (CT or MRI)
    • visualization of implanted electrodes (planned, intra-op update, and post-op location)
    • visualize stimulation settings as volume of tissues activated fields
    • view data within a template space (default is MNI space)

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Greydon Gilmore - @GilmoreGreydon - greydon.gilmore@gmail.com

Project Link: https://github.com/greydongilmore/trajectoryGuideModules

Acknowledgements