Skip to main content

A neuron morphology IO library

Project description

doc/source/logo/BBP-MorphIO.jpg

license documentation status

MorphIO

Documentation

MorphIO documentation is built and hosted on readthedocs.

Introduction

MorphIO is a library for reading and writing neuron morphology files. It supports the following formats:

  • SWC

  • ASC (aka. neurolucida)

  • H5 v1

  • H5 v2 is not supported anymore, see H5v2

It provides 3 C++ classes that are the starting point of every morphology analysis:

  • Soma: contains the information related to the soma.

  • Section: a section is the succession of points between two bifurcations. To the bare minimum the Section object will contain the section type, the position and diameter of each point.

  • Morphology: the morphology object contains general information about the loaded cell but also provides accessors to the different sections.

One important concept is that MorphIO is split into a read-only part and a read/write one.

H5v2

Starting at version 2.6.0, the file format h5v2 is no longer supported. If you have morphologies in this format, you can convert them to h5v1 with:

pip install "morphio<2.6" "morph-tool==2.3.0"

and then:

# single file, OUTPUT must end with `.h5`
morph-tool convert file INPUTFILE OUTPUT
# bulk conversion
morph-tool convert folder -ext h5 INPUTDIR OUTPUTDIR

Contributing

If you want to improve the project or you see any issue, every contribution is welcome. Please check the contribution guidelines for more information.

Acknowledgements

The development of this software was supported by funding to the Blue Brain Project, a research center of the École polytechnique fédérale de Lausanne (EPFL), from the Swiss government’s ETH Board of the Swiss Federal Institutes of Technology.

This research was supported by the EBRAINS research infrastructure, funded from the European Union’s Horizon 2020 Framework Programme for Research and Innovation under the Specific Grant Agreement No. 945539 (Human Brain Project SGA3).

License

MorphIO is licensed under the terms of the Apache License 2.0. See LICENSE.txt for further details.

Copyright (c) 2013-2024 Blue Brain Project/EPFL

Project details


Download files

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

Source Distribution

morphio-3.3.10.tar.gz (626.6 kB view hashes)

Uploaded Source

Built Distributions

morphio-3.3.10-cp313-cp313-win_amd64.whl (596.4 kB view hashes)

Uploaded CPython 3.13 Windows x86-64

morphio-3.3.10-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.13 manylinux: glibc 2.27+ x86-64 manylinux: glibc 2.28+ x86-64

morphio-3.3.10-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.13 manylinux: glibc 2.17+ x86-64

morphio-3.3.10-cp313-cp313-macosx_11_0_arm64.whl (1.7 MB view hashes)

Uploaded CPython 3.13 macOS 11.0+ ARM64

morphio-3.3.10-cp313-cp313-macosx_10_13_x86_64.whl (2.1 MB view hashes)

Uploaded CPython 3.13 macOS 10.13+ x86-64

morphio-3.3.10-cp312-cp312-win_amd64.whl (596.4 kB view hashes)

Uploaded CPython 3.12 Windows x86-64

morphio-3.3.10-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.27+ x86-64 manylinux: glibc 2.28+ x86-64

morphio-3.3.10-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.12 manylinux: glibc 2.17+ x86-64

morphio-3.3.10-cp312-cp312-macosx_11_0_arm64.whl (1.7 MB view hashes)

Uploaded CPython 3.12 macOS 11.0+ ARM64

morphio-3.3.10-cp312-cp312-macosx_10_13_x86_64.whl (2.1 MB view hashes)

Uploaded CPython 3.12 macOS 10.13+ x86-64

morphio-3.3.10-cp311-cp311-win_amd64.whl (595.3 kB view hashes)

Uploaded CPython 3.11 Windows x86-64

morphio-3.3.10-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.27+ x86-64 manylinux: glibc 2.28+ x86-64

morphio-3.3.10-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.11 manylinux: glibc 2.17+ x86-64

morphio-3.3.10-cp311-cp311-macosx_11_0_arm64.whl (1.7 MB view hashes)

Uploaded CPython 3.11 macOS 11.0+ ARM64

morphio-3.3.10-cp311-cp311-macosx_10_9_x86_64.whl (2.1 MB view hashes)

Uploaded CPython 3.11 macOS 10.9+ x86-64

morphio-3.3.10-cp310-cp310-win_amd64.whl (594.6 kB view hashes)

Uploaded CPython 3.10 Windows x86-64

morphio-3.3.10-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.27+ x86-64 manylinux: glibc 2.28+ x86-64

morphio-3.3.10-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.10 manylinux: glibc 2.17+ x86-64

morphio-3.3.10-cp310-cp310-macosx_11_0_arm64.whl (1.7 MB view hashes)

Uploaded CPython 3.10 macOS 11.0+ ARM64

morphio-3.3.10-cp310-cp310-macosx_10_9_x86_64.whl (2.1 MB view hashes)

Uploaded CPython 3.10 macOS 10.9+ x86-64

morphio-3.3.10-cp39-cp39-win_amd64.whl (594.7 kB view hashes)

Uploaded CPython 3.9 Windows x86-64

morphio-3.3.10-cp39-cp39-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.27+ x86-64 manylinux: glibc 2.28+ x86-64

morphio-3.3.10-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.9 manylinux: glibc 2.17+ x86-64

morphio-3.3.10-cp39-cp39-macosx_11_0_arm64.whl (1.7 MB view hashes)

Uploaded CPython 3.9 macOS 11.0+ ARM64

morphio-3.3.10-cp39-cp39-macosx_10_9_x86_64.whl (2.1 MB view hashes)

Uploaded CPython 3.9 macOS 10.9+ x86-64

morphio-3.3.10-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.4 MB view hashes)

Uploaded CPython 3.8 manylinux: glibc 2.17+ x86-64

Supported by

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