Metadata-Version: 2.1
Name: fsleyes
Version: 0.28.1
Summary: FSLeyes, the FSL image viewer
Home-page: https://git.fmrib.ox.ac.uk/fsl/fsleyes/fsleyes
Author: Paul McCarthy
Author-email: pauldmccarthy@gmail.com
License: Apache License Version 2.0
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Dist: setuptools
Requires-Dist: six (==1.*)
Requires-Dist: numpy (>=1.14)
Requires-Dist: matplotlib (>=1.5.1)
Requires-Dist: nibabel (>=2.3.*)
Requires-Dist: Jinja2 (==2.*)
Requires-Dist: Pillow (>=3.2.0)
Requires-Dist: PyOpenGL (>=3.1.0)
Requires-Dist: PyOpenGL-accelerate (>=3.1.0)
Requires-Dist: pyparsing (==2.*)
Requires-Dist: scipy (>=0.18)
Requires-Dist: wxPython (>=3.0.2.0)
Requires-Dist: fslpy (>=2.*)
Requires-Dist: fsleyes-props (>=1.6.2)
Requires-Dist: fsleyes-widgets (>=0.6)
Provides-Extra: extras
Requires-Dist: indexed-gzip (>=0.7.0) ; extra == 'extras'
Requires-Dist: xnat (>=0.3.3) ; extra == 'extras'
Requires-Dist: wxnatpy (>=0.3.0) ; extra == 'extras'
Requires-Dist: trimesh (>=2.22.28) ; extra == 'extras'
Requires-Dist: rtree (==0.8.3) ; extra == 'extras'
Requires-Dist: pyzmq (>=17.0) ; extra == 'extras'
Requires-Dist: tornado (>=5.0) ; extra == 'extras'
Requires-Dist: ipykernel (>=4.8) ; extra == 'extras'
Requires-Dist: ipython (>=5) ; extra == 'extras'
Requires-Dist: jupyter-client (>=5.2) ; extra == 'extras'
Requires-Dist: notebook (>=5.5) ; extra == 'extras'

FSLeyes
=======

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

.. image:: https://anaconda.org/conda-forge/fsleyes/badges/version.svg
   :target: https://anaconda.org/conda-forge/fsleyes

.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.1470761.svg
   :target: https://doi.org/10.5281/zenodo.1470761

.. image:: https://git.fmrib.ox.ac.uk/fsl/fsleyes/fsleyes/badges/master/coverage.svg
   :target: https://git.fmrib.ox.ac.uk/fsl/fsleyes/fsleyes/commits/master/


`FSLeyes <https://git.fmrib.ox.ac.uk/fsl/fsleyes/fsleyes>`_ is the `FSL
<http://fsl.fmrib.ox.ac.uk/fsl/fslwiki>`_ image viewer.


Installation
------------


These instructions pertain to manual installation of FSLeyes into a Python
environment. Standalone versions of FSLeyes can be downloaded from
https://fsl.fmrib.ox.ac.uk/fsl/fslwiki/FSLeyes.



FSLeyes is a `wxPython <https://www.wxpython.org>`_ application.  If you are
on Linux, you will need to install wxPython first - head to
https://extras.wxpython.org/wxPython4/extras/linux/ and find the directory
that matches your OS. Then run this command (change the URL accordingly)::

    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
<requirements.txt>`_.


Some extra dependencies, which provide additional functionality, are listed in
`requirements-extras.txt <requirements-extras.txt>`_ and
`requirements-notebook.txt <requirements-notebook.txt>`_.


Dependencies for running tests and building the documentation are listed
in `requirements-dev.txt <requirements-dev.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 <http://www.sphinx-doc.org/>`_::

    pip install -r requirements-dev.txt
    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 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

The GLSL parser is based on code by Nicolas P . Rougier, available at
https://github.com/rougier/glsl-parser, and released under the BSD license.

DICOM to NIFTI conversion is performed with Chris Rorden's dcm2niix
(https://github.com/rordenlab/dcm2niix).

