Skip to content
Cortical neuroimaging visualization in Python
Python Other
  1. Python 99.2%
  2. Other 0.8%
Branch: master
Clone or download

PySurfer: Neuroimaging visualization in Python

PySurfer is a Python package for interacting with a cortical surface representations of neuroimaging data. It extends Mayavi's powerful visualization engine with a high-level interface for working with MRI and MEG data.

PySurfer offers both a command-line interface designed to broadly the Freesurfer Tksurfer program and a Python library for writing scripts to efficiently explore complex datasets and prepare publication-ready figures.

To goal of the project is to facilitate the production of figures that are both beautiful and scientifically informative.

Important Links


This packages uses setuptools. To install it for all users, run:

python build
sudo python install

If you do not have sudo privileges, you can install locally:

python install --home

For information about dependencies, please see the online documentation


Available under the Revised BSD (3-clause) license.


You can launch the test suite by running nosetests from the source folder.

Another way to test is to build the documentation, which will run the example scripts and automatically generate static image output. From the source directory:

cd doc/
make clean
make html

The resulting documentation will live at _build/html/index.html, which can be compared to the online docs.

Either method will work only if you have Freesurfer installed on your machine with a valid SUBJECTS_DIR folder.

You can’t perform that action at this time.