Please note that PaCER is a research tool NOT intended for clinical use.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
Copyright (C) 2016-2017 Andreas Husch, Centre Hospitalier de Luxembourg, National Department of Neurosurgery and University of Luxembourg, Luxembourg Centre for Systems Biomedicine.
The PaCER Toolbox is a MATLAB implementation of a robust method to fully automatically reconstruct deep brain stimulation trajectories from post operative CT imaging data. PaCER is able to fully preserving electrode bending (e.g. caused by brainshift). Further is able to detect individual contacts on high-resolution data. The PaCER toolbox is provided with means to easily visualize electrodes as well as imaging data within the MATLAB environment.
The requirements to use PaCER are:
- MATLAB, including the Image Processing Toolbox
- post-operative CT image in nifti file format.
A CT slice-thickness <= 1 mm is recommended, however, PaCER will work on lower resolution data too by falling back to a less sophisticated contact detection method (yielding lower accuracy). Nifti input files are supported in compressed form (.nii.gz) as well as non-compressed (.nii).
The easiest way to learn about PaCER is to run the example files. We recommend to add the PaCER directory and all its subdirectories to your MATLAB path first. This can be archived by running the file SETUP_PACER.m in MATLAB (once). The examples include a call to SETUP_PACER.
The following examples require only a post op CT dataset - they should work out of the box for most CT scan protocols as long as the slice thickness is not toooo bad :-) Easy conversion from DICOM to NIFTI is possible dcm2nii which is included in MRIcron. Advanced example demonstrating further use-cases (e.g. visualisation of segmentations and atlas data, simple volume of tissue activated model etc.) can be found in the examples/advanced/ directory. However these examples require appropriate co-registered image modalities (e.g. atlases, segmentation). We are in the process to provide a full example dataset in the future.
- EXAMPLE_1.m - Basic PaCER call and electrode plot. Start here!
- EXAMPLE_1_1.m - Continues EXAMPLE_1 by adding an MPR view of the CT image and demonstrating some plot customisations
The PaCER algorithm is described in:
A. Husch, M. V. Petersen, P. Gemmar, J. Goncalves, F. Hertel: PaCER – A fully automated method for electrode trajectory and contact reconstruction in deep brain stimulation, NeuroImage: Clinical, Volume 17, 2018, Pages 80-89, Available online 6 October 2017, ISSN 2213-1582, https://doi.org/10.1016/j.nicl.2017.10.004., [Open access fulltext].
For people interested in even more technical details, the preprocessing pipeline is described in more details here:
A. Husch, P. Gemmar, J. Lohscheller, F. Bernard, F. Hertel: Assessment of Electrode Displacement and Deformation with Respect to Pre-Operative Planning in Deep Brain Stimulation. Bildverarbeitung für die Medizin 2015, Springer Berlin Heidelberg, 2015.[ORBilu repository with fulltext request form]
An example of using PaCER within an automatic image-registration pipeline for DBS assessment is described in:
A. Husch, M. V. Petersen, P. Gemmar, J. Goncalves, N. Sunde, F. Hertel: Post-operative deep brain stimulation assessment: Automatic data integration and report generation, Brain Stimulation, Available online 1 February 2018. [Open access fulltext]
ARTENOLIS (Automated Reproducibility and Testing Environment for Licensed Software) is a general-purpose and flexible infrastructure software application that implements continuous integration for open-source software with licensed dependencies. You may cite ARTENOLIS as:
L. Heirendt, S. Arreckx, C. Trefois, Y. Jarosz, M. Vyas, V. P. Satagopam, R. Schneider, I. Thiele, R. M. T. Fleming: ARTENOLIS: Automated Reproducibility and Testing Environment for Licensed Software, abs/1712.05236, 2017.
Please acknowledge the respective papers when using the algorithm in your work.
Feel free to open an issue at https://github.com/adhusch/PaCER or drop a note to mail (at) andreashusch.de
If you need help our have trouble processing local data you are invited to open a GitHub issue. Any feedback to further improve the performance on varing datasets is very welcome.
PaCER is packaged with some free external software libraries for convenience. Please see the “toolboxes” folder and the respective LICENSE files for details. We feel grateful to the authors of this toolboxes and scripts:
- Tools for NIfTI and ANALYZE image by Jimmy Shen
- RGB triple of color name, version 2 by Kristjan Jonasson
- GUI Layout Toolbox by David Sampson and Ben Tordoff
- in_polyhedron by Jaroslaw Tuszynski
- Cylinder Between 2 Points by Per Sundqvist
- MPR View by Florian Bernard
This work was made possible by an Aide à la Formation Recherche (AFR) grant to Andreas Husch from the Luxembourg National Research Fund (FNR).
The Responsible and Reproducible Research (R3) of the LCSB BioCore is acknowledged for providing the ARTENOLIS infrastructure and technical expertise to ensure high quality of the present software.