Skip to main content

FSL Python library

Project description

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.10, 3.11, 3.12, and 3.13.

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 pyproject.toml file.

Some optional dependencies (labelled extra in pyproject.toml) 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 remaining optional dependencies:

pip install "fslpy[extra]"

Dependencies for testing and documentation are also listed in pyproject.toml, and are respectively labelled as test and doc.

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

API documentation for fslpy is hosted at https://open.win.ox.ac.uk/pages/fsl/fslpy/.

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

pip install ".[doc]"
sphinx-build doc html

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

Tests

Run the test suite via:

pip install ".[test]"
pytest

Some tests will only pass if the test environment meets certain criteria - refer to the tool.pytest.init_options section of [pyproject.toml](pyproject.toml) for a list of [pytest marks](https://docs.pytest.org/en/7.1.x/example/markers.html) which can be selectively enabled or disabled.

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.

Project details


Release history Release notifications | RSS feed

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.23.0.tar.gz (4.8 MB view details)

Uploaded Source

Built Distribution

fslpy-3.23.0-py3-none-any.whl (4.8 MB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: fslpy-3.23.0.tar.gz
  • Upload date:
  • Size: 4.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.18

File hashes

Hashes for fslpy-3.23.0.tar.gz
Algorithm Hash digest
SHA256 94aa05e84382c2c27c67318233cc34b9d843d36f79d48b88557c19eddbd26eef
MD5 a900905353e838d93a227995766e9897
BLAKE2b-256 51b3f54176e9873e4aee9029b9a7e26e0da77d604166cfb0c589fea6c79f9488

See more details on using hashes here.

File details

Details for the file fslpy-3.23.0-py3-none-any.whl.

File metadata

  • Download URL: fslpy-3.23.0-py3-none-any.whl
  • Upload date:
  • Size: 4.8 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.18

File hashes

Hashes for fslpy-3.23.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2fd9c548357240ee76a2801c041bf5444af8871a641a0cb05dadcb75417eb3ad
MD5 34b7034ea97229eb9a6a232e25fe6f3c
BLAKE2b-256 3603bc6d81c93c1bf3d838861ace99015f1d1843132ae3c186f8cb8b868297e0

See more details on using hashes here.

Supported by

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