MackensteinCAM

A camera-based system for automatic identification and localization of electrodes.

Developed by the Institute of Biomedical Engineering (IBT) of the Karlsruhe Institute of Technology (KIT). This tool is distributed under the MIT License (MIT).

Features:

• localizes multiple electrode positions at once
• accuracy 1±1 mm
• system of markers for robust identification using an error-correcting code

Includes all algorithms from the following paper: http://dx.doi.org/10.1515/bmt-2014-0018, which explains all processing steps and includes a validation.

The code requires

• the open source computer vision (OpenCV) library (version 2.4.6.0), which is distributed under a BSD license
• the Augmented Reality library from the University of Cordoba (ArUco) (version 2.0.10), which is distributed under a BSD licence

If you are interested in using MackensteinCAM and haven’t yet told us about it, please do so and send us an email: ws@evolunis.com. We are very happy to help you get started.

For static electrode positions, start with a single camera (e.g. that of your iPhone) and take two photos of the same scene. For dynamic electrode positions, get yourself two cameras with posts (e.g. two Canon EOS 600D). Then add a remote controller to acquire the scence from the two positions at the same time.

Install OpenCV (version 2.0.10)

• download from http://opencv.org/downloads.html

Install ArUco (version 2.0.10):

• download from https://sourceforge.net/projects/aruco/files/
• in the downloaded directory, run commands:

mkdir build cd build cmake .. note: if cmake throws an error saying that "Performing Test OpenMP_FLAG_DETECTED - Failed", your compilation will likely not run on multiple processors in parallel, but it will likely compile anyway.

• in the downloaded directory, run commands:

make sudo make install note: if make produces warnings requesting a "C++11 extension", assign "-std=c++11" to the CMAKE_CXX_FLAGS in CMakeCache.txt, such that:

//Flags used by the compiler during all build types.
CMAKE_CXX_FLAGS:STRING=-std=c++11

Download MackensteinCAM: git clone https://github.com/IBTKIT/MackensteinCAM

mkdir build cd build cmake .. make ./MackenteinCAM

note: If CMake could not find aruco library, please modify 5th line in CMakeLists.txt set(CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} "/usr/local/lib/cmake") to proper path to Findacuro.cmake file or you can run cmake like this:

./cmake -D CMAKE_MODULE_PATH="<path-to-folder-containing-Findacuro.cmake-file>"

Please see our wiki page https://github.com/IBTKIT/MackensteinCAM/wiki with instructions on how to run the tool for an example from the paper.

Are you using MackensteinCAM in research work? If so, please include explicit mention of our work in your related publications:

@article{MackensteinCAM2014,
  title={Automatic camera-based identification and 3-D reconstruction of electrode positions in electrocardiographic imaging},
  author={Schulze, Walther HW and Mackens, Patrick and Potyagaylo, Danila and Rhode, Kawal and T{\"u}l{\"u}men, Erol and Schimpf, Rainer and Papavassiliu, Theano and Borggrefe, Martin and D{\"o}ssel, Olaf},
  journal={Biomedical Engineering/Biomedizinische Technik},
  volume={59},
  number={6},
  pages={515--528},
  year={2014}
}