Where to get trekker?

Note

Citation information

If you use trekker in your study, please cite our work. Click here for more information.

Stand-alone executables

You can download precompiled stand-alone executables from here for:

  • Linux: Tested on Debian (versions 9 and 10) and Red Hat Enterprise Linux 6.

  • Windows: Tested on Windows 10.

  • Mac OS: A stand-alone executable does not exist.

Source code

Step 1. Download the source code from github, using:
git clone https://github.com/dmritrekker/trekker
Step 2. Modify the first few lines in the build script (make sure to have cmake-3.15 or newer):

  • For Linux -> build_Linux.sh

  • For Windows -> build_Windows.bat

Step 3. Run the build script. This will build Trekker:

  • For Linux -> <TrekkerFolder>/build/Linux/install

  • For Windows -> <TrekkerFolder>/build/Windows/install

Under the <TrekkerFolder>/install folder, the following will be generated:

  1. trekker executable under /bin

  2. Static and shared libraries under /lib with library header under /include

  3. If specified, a python built distribution (.whl) under /python/dist

Python package

A python package can be built from source. You can also download a built distributions (.whl) from here.

To install the python package use:

pip install Trekker-<VERSION>.whl

Test your installation

You can use the demo scripts in here for testing your installation.

Extensions

  • Matlab: Trekker formatted .vtk files can be read in Matlab using the following function, extensions/matlab/readTrekkerOutput.m.

  • LONI pipeline: A LONI pipeline module and workflow examples for Trekker can be found under: extensions/LONI_Pipeline/.

  • trekker_mergeTracksWithPrefix: This tool can be used to merge Trekker formatted (.vtk) tractograms inside a folder that start with given filename prefix.

  • trekker_addColor: This tool can be used to add direction coded color information for each segment in a Trekker formatted (.vtk) tractogram.