Skip to main content

A neuron morphology IO library

Project description

license Build Status documentation status

MorphIO

Documentation

MorphIO documentation is built and hosted on readthedocs <http://morphio.readthedocs.org/>.

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 GNU Lesser General Public License version 3. Refer to COPYING.LESSER and COPYING for details.

Copyright (c) 2013-2021 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.2.0.tar.gz (3.8 MB view details)

Uploaded Source

Built Distributions

MorphIO-3.2.0-cp38-cp38-manylinux2014_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.8

MorphIO-3.2.0-cp38-cp38-macosx_10_13_x86_64.whl (1.9 MB view details)

Uploaded CPython 3.8 macOS 10.13+ x86-64

MorphIO-3.2.0-cp37-cp37m-manylinux2014_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.7m

MorphIO-3.2.0-cp37-cp37m-macosx_10_13_x86_64.whl (1.9 MB view details)

Uploaded CPython 3.7m macOS 10.13+ x86-64

MorphIO-3.2.0-cp36-cp36m-manylinux2014_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.6m

MorphIO-3.2.0-cp36-cp36m-macosx_10_13_x86_64.whl (1.9 MB view details)

Uploaded CPython 3.6m macOS 10.13+ x86-64

File details

Details for the file MorphIO-3.2.0.tar.gz.

File metadata

  • Download URL: MorphIO-3.2.0.tar.gz
  • Upload date:
  • Size: 3.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.9.5

File hashes

Hashes for MorphIO-3.2.0.tar.gz
Algorithm Hash digest
SHA256 e3f667cb9ca0c5f11062acf90b27addf010bc73aa28eb4cc3fc2f6be04ca7076
MD5 b90748369b868ac6fa3c1ac5e70ee77c
BLAKE2b-256 c00762af71769f040cef680e022c6ccc61cc4805787d132f6c5de1fee4bed58e

See more details on using hashes here.

File details

Details for the file MorphIO-3.2.0-cp38-cp38-manylinux2014_x86_64.whl.

File metadata

  • Download URL: MorphIO-3.2.0-cp38-cp38-manylinux2014_x86_64.whl
  • Upload date:
  • Size: 1.8 MB
  • Tags: CPython 3.8
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.9.5

File hashes

Hashes for MorphIO-3.2.0-cp38-cp38-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 8d9811b9279aadcc0d56976199fb69ded6c1bcaefcb7330348a34cdf41f84e4e
MD5 ee6f87360be3c0e66449b9bf28b7a6fd
BLAKE2b-256 7df5f9aa51f64828a44b3f1500b6e3e7365e35257642da533c8b3b4d084e48f1

See more details on using hashes here.

File details

Details for the file MorphIO-3.2.0-cp38-cp38-macosx_10_13_x86_64.whl.

File metadata

  • Download URL: MorphIO-3.2.0-cp38-cp38-macosx_10_13_x86_64.whl
  • Upload date:
  • Size: 1.9 MB
  • Tags: CPython 3.8, macOS 10.13+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.9.5

File hashes

Hashes for MorphIO-3.2.0-cp38-cp38-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 090cd06ce079d4d857d4cc5b93954827bec8f75e55978bd69a879a95ceb45a37
MD5 76ce4ae484e66f7d42d875f39711aca7
BLAKE2b-256 2dcc30c25e4ea948ea9d549b3d8b98738509c86896803bfb8715de4a331f1f6e

See more details on using hashes here.

File details

Details for the file MorphIO-3.2.0-cp37-cp37m-manylinux2014_x86_64.whl.

File metadata

  • Download URL: MorphIO-3.2.0-cp37-cp37m-manylinux2014_x86_64.whl
  • Upload date:
  • Size: 1.8 MB
  • Tags: CPython 3.7m
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.9.5

File hashes

Hashes for MorphIO-3.2.0-cp37-cp37m-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 852f58fa7c22fd0379bd29f1b765823d8898ad6532fb74a5fe3413ab19a58c7e
MD5 bc181aed1923d2716b50512a3e12443d
BLAKE2b-256 2b33c32fa6e957af0a7eccdcc3a884ae839107e85cc9a421b2b29b0799395416

See more details on using hashes here.

File details

Details for the file MorphIO-3.2.0-cp37-cp37m-macosx_10_13_x86_64.whl.

File metadata

  • Download URL: MorphIO-3.2.0-cp37-cp37m-macosx_10_13_x86_64.whl
  • Upload date:
  • Size: 1.9 MB
  • Tags: CPython 3.7m, macOS 10.13+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.9.5

File hashes

Hashes for MorphIO-3.2.0-cp37-cp37m-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 619a1f807230916d1dacde3850b7e3862a46cd30df49b1a009f03999e8e1555b
MD5 961549fdddff10712e9d28b213d203fb
BLAKE2b-256 d1e4e140e51b6dd4a1df33f14dd0f2bfad052193cbb5cef857dfc791fd9154b1

See more details on using hashes here.

File details

Details for the file MorphIO-3.2.0-cp36-cp36m-manylinux2014_x86_64.whl.

File metadata

  • Download URL: MorphIO-3.2.0-cp36-cp36m-manylinux2014_x86_64.whl
  • Upload date:
  • Size: 1.8 MB
  • Tags: CPython 3.6m
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.9.5

File hashes

Hashes for MorphIO-3.2.0-cp36-cp36m-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 c3226d43a556c6ffda9204ddd4ad7171cb192ba3d35e7f6a721fbfe6b622083c
MD5 7cf9ac62ac8f5ddbeac1aaf0bb6be926
BLAKE2b-256 668b1488a229d87ab88a0cf9f95ba7515a827c6c050b87eb66f4a2942529bb05

See more details on using hashes here.

File details

Details for the file MorphIO-3.2.0-cp36-cp36m-macosx_10_13_x86_64.whl.

File metadata

  • Download URL: MorphIO-3.2.0-cp36-cp36m-macosx_10_13_x86_64.whl
  • Upload date:
  • Size: 1.9 MB
  • Tags: CPython 3.6m, macOS 10.13+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.5.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.9.5

File hashes

Hashes for MorphIO-3.2.0-cp36-cp36m-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 132fe5f1301a5dea6be11434956b0670103c6933a5910192a758d56e7aa77403
MD5 2298393d17204305a82e7b68c78a727d
BLAKE2b-256 e679ddbfcb7f101c39621fbb9e814d93d29ec42b3d6a46dd5cdf2d618f3d1218

See more details on using hashes here.

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