Skip to main content
https://img.shields.io/pypi/v/fslpy.svg https://anaconda.org/conda-forge/fslpy/badges/version.svg https://zenodo.org/badge/DOI/10.5281/zenodo.1470750.svg https://git.fmrib.ox.ac.uk/fsl/fslpy/badges/master/coverage.svg

The fslpy project is a FSL programming library written in Python. It is used by FSLeyes.

fslpy is tested against Python versions 3.5, 3.6 and 3.7.

Installation

Install fslpy and its core dependencies via pip:

pip install fslpy

fslpy is also available on conda-forge:

conda install -c conda-forge fslpy

Dependencies

All of the core dependencies of fslpy are listed in the requirements.txt file.

Some extra dependencies are listed in requirements-extra.txt which provide addditional functionality:

  • wxPython: The fsl.utils.idle module has functionality to schedule functions on the wx idle loop.

  • indexed_gzip: The fsl.data.image.Image class can use indexed_gzip to keep large compressed images on disk instead of decompressing and loading them into memory..

  • trimesh/rtree: The fsl.data.mesh.TriangleMesh class has some methods which use trimesh to perform geometric queries on the mesh.

  • Pillow: The fsl.data.bitmap.Bitmap class uses Pillow to load image files.

If you are using Linux, you need to install wxPython first, as binaries are not available on PyPI. Install wxPython like so, changing the URL for your specific platform:

pip install -f https://extras.wxpython.org/wxPython4/extras/linux/gtk2/ubuntu-16.04/ wxpython

Once wxPython has been installed, you can type the following to install the rest of the extra dependencies:

pip install fslpy[extras]

Dependencies for testing and documentation are listed in the requirements-dev.txt file.

Non-Python dependencies

The fsl.data.dicom module requires the presence of Chris Rorden’s dcm2niix program.

The rtree library assumes that libspatialindex is installed on your system.

The fsl.transform.x5 module uses h5py, which requires libhdf5.

Documentation

fslpy is documented using sphinx. You can build the API documentation by running:

pip install -r requirements-dev.txt
python setup.py doc

The HTML documentation will be generated and saved in the doc/html/ directory.

Tests

Run the test suite via:

pip install -r requirements-dev.txt
python setup.py test

A test report will be generated at report.html, and a code coverage report will be generated in htmlcov/.

Contributing

If you are interested in contributing to fslpy, check out the contributing guide.

Credits

The fsl.data.dicom module is little more than a thin wrapper around Chris Rorden’s dcm2niix program.

The example.mgz file, used for testing, originates from the nibabel test data set.

Download files

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

Source Distribution

fslpy-3.2.2.tar.gz (4.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fslpy-03.2.2-py2.py3-none-any.whl (263.7 kB view details)

Uploaded Python 2Python 3

File details

Details for the file fslpy-3.2.2.tar.gz.

File metadata

  • Download URL: fslpy-3.2.2.tar.gz
  • Upload date:
  • Size: 4.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.3.1 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.7.8

File hashes

Hashes for fslpy-3.2.2.tar.gz
Algorithm Hash digest
SHA256 d70c04dcb3eb59b9cdc089fd5fdafa6f30fc81e65ef843ae6103cb17a6b07b51
MD5 561169e4509c66480f24a1f7eda714c0
BLAKE2b-256 b772bb1be0d1fcddca068f4ef7788a227980d90ce1cda99e6c969b12181b91f8

See more details on using hashes here.

File details

Details for the file fslpy-03.2.2-py2.py3-none-any.whl.

File metadata

  • Download URL: fslpy-03.2.2-py2.py3-none-any.whl
  • Upload date:
  • Size: 263.7 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.3.1 requests-toolbelt/0.9.1 tqdm/4.47.0 CPython/3.7.8

File hashes

Hashes for fslpy-03.2.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 d92f22360d6a3e27d073efe16aac4ccdb0b2b7b645ee6c94467c2aa4e80b7f2c
MD5 00b0db2a94a7e0a77d8bbc584d780ff8
BLAKE2b-256 cbf513835dcb65684de33cd154bb88aaf3758be9d6affc5ca88d4324ad4a76dc

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

3.2.2

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