fsleyes 0.20.1

FSLeyes, the FSL image viewer

FSLeyes is the FSL image viewer.

Installation

FSLeyes is a wxPython application. As of January 2018, the latest version of wxPython is in pre-release, so it cannot be installed like any other Python package.

• macOS: pip install --pre wxpython

• Linux (change the URL for your specific platform): pip install --only-binary wxpython -f https://extras.wxpython.org/wxPython4/extras/linux/gtk2/ubuntu-16.04/ wxpython

Once wxPython has been installed, you can install FSLeyes like so:

pip install fsleyes

To install FSLeyes with all of the optional dependencies (for additional functionality):

pip install fsleyes[extras]

Dependencies

All of the core dependencies of FSLeyes are listed in requirements.txt.

Some extra dependencies, which provide additional functionality, are listed in requirements-extras.txt.

Being an OpenGL application, FSLeyes can only be used on computers with graphics hardware (or a software GL renderer) that supports one of the following versions:

• OpenGL 1.4, with the following extensions:

  • ARB_vertex_program

  • ARB_fragment_program

  • EXT_framebuffer_object

  • GL_ARB_texture_non_power_of_two

• OpenGL 2.1, with the following extensions:

  • EXT_framebuffer_object

  • ARB_instanced_arrays

  • ARB_draw_instanced

FSLeyes also requires the presence of GLUT, or FreeGLUT.

Documentation

The FSLeyes user and API documentation is written in ReStructuredText, and can be built using sphinx:

python setup.py userdoc
python setup.py apidoc

The documentation will be generated and saved in userdoc/html/ and apidoc/html/.

Credits

Some of the FSLeyes icons are derived from the Freeline icon set, by Enes Dal, available at https://www.iconfinder.com/Enesdal, and released under the Creative Commons (Attribution 3.0 Unported) license.

The file fsleyes.gl.trimesh module includes code from Michael Dawson-Haggerty’s trimesh project, which is released under the MIT license.

The volumetric spline interpolation routine uses code from:

Daniel Ruijters and Philippe Thévenaz, GPU Prefilter for Accurate Cubic B-Spline Interpolation, The Computer Journal, vol. 55, no. 1, pp. 15-20, January 2012. http://dannyruijters.nl/docs/cudaPrefilter3.pdf