Skip to main content

A meta-pipeline tool for tractography based on Nipype.

Project description

========== TRAMPOLINO

.. image:: https://img.shields.io/pypi/v/trampolino.svg :target: https://pypi.python.org/pypi/trampolino

.. image:: https://img.shields.io/travis/matteomancini/trampolino.svg :target: https://travis-ci.org/matteomancini/trampolino

.. image:: https://readthedocs.org/projects/trampolino/badge/?version=latest :target: https://trampolino.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status

TRAMPOLINO (TRActography Meta-Pipeline cOmmand LINe tOol) is a command line interface tool for brain tractography. It leverages the Nipype Python package to offer an immediate way to reconstruct an orientation distribution function, use it to track the streamlines and eventually filter them, all using existing software toolboxes.

At the moment it is under active development and support mainly MRtrix but the plan is to include as many software alternatives as possible.

Features

  • Composable command line interfaces built using the Click Python package;
  • One-command generation of multiple results using different parameters (e.g. angular thresholds, tracking algorithm);
  • Ensemble tractography implementation;

Requirements

TRAMPOLINO requires the GraphViz_ visualization software and the MRtrix3_ tool.

Installing TRAMPOLINO

TRAMPOLINO can be easily installed using pip::

pip install trampolino

Running TRAMPOLINO

To try TRAMPOLINO, you can download some example data using this script::

get_example_data

It will download the Sherbrooke multi-shell dataset from DiPy_. Then you can run::

trampolino -n msmt_csd -r example_results recon -i sherbrooke_3shell/dwi.nii.gz -v sherbrooke_3shell/bvec.txt -b sherbrooke_3shell/bval.txt mrtrix_msmt_csd track --angle 30,45 --algorithm iFOD2,SD_Stream mrtrix_tckgen

And you have your first results!

Credits

This package was created with Cookiecutter_ and the audreyr/cookiecutter-pypackage_ project template.

.. _GraphViz: http://www.graphviz.org .. _MRtrix3: https://github.com/MRtrix3/mrtrix3 .. _DiPy: https://github.com/nipy/dipy .. _Cookiecutter: https://github.com/audreyr/cookiecutter .. _audreyr/cookiecutter-pypackage: https://github.com/audreyr/cookiecutter-pypackage

======= History

0.1.0 (2019-08-25)

  • First release on PyPI.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

trampolino-0.1.4.tar.gz (27.8 kB view details)

Uploaded Source

File details

Details for the file trampolino-0.1.4.tar.gz.

File metadata

  • Download URL: trampolino-0.1.4.tar.gz
  • Upload date:
  • Size: 27.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/3.7.3

File hashes

Hashes for trampolino-0.1.4.tar.gz
Algorithm Hash digest
SHA256 a970cc1e70c81fe1a408c2da4fb230e2b1e7b8858bd57bb954204ef8ff837d64
MD5 14f46125c74b9bfacd1f8bce6716f696
BLAKE2b-256 019012bf1e187de3519802a636cc406a41e956f1c68f20977dc0dc92b5fc88fc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page