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

Uploaded Source

Built Distributions

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

Uploaded CPython 3.8

MorphIO-3.3.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.3.0-cp37-cp37m-manylinux2014_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.7m

MorphIO-3.3.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.3.0-cp36-cp36m-manylinux2014_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.6m

MorphIO-3.3.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.3.0.tar.gz.

File metadata

  • Download URL: MorphIO-3.3.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.1 CPython/3.9.5

File hashes

Hashes for MorphIO-3.3.0.tar.gz
Algorithm Hash digest
SHA256 cf9ec72e10b7be415f8e299c560f913b32040ae5c68700f47bb9cad68ef08387
MD5 9c17dbc979c79a43445324843f1ae522
BLAKE2b-256 5e45d4ef02066faa8de682ab29bd12ef5ec9558ac10d53d3299115b7e568c382

See more details on using hashes here.

File details

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

File metadata

  • Download URL: MorphIO-3.3.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.1 CPython/3.9.5

File hashes

Hashes for MorphIO-3.3.0-cp38-cp38-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 7e6892fd2f5edaa05cf0cacfdb6ebedfd81ca6e02af1d5a191367c4ef7f5f51e
MD5 b0e2cc11d7dadb8e9a331cc51fa64f84
BLAKE2b-256 3ced8871978c8dbdce82fff0b60bc8c40a00cf8edfb99d19c3986d067570e043

See more details on using hashes here.

File details

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

File metadata

  • Download URL: MorphIO-3.3.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.1 CPython/3.9.5

File hashes

Hashes for MorphIO-3.3.0-cp38-cp38-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 883cabe4aaf57b5670feb7a4bcc8a88cf86c2ebe16cae651dfbb23d2c87c0e9a
MD5 d1a462bbe37b6ede9a4ac6a32ba35e90
BLAKE2b-256 c0755e279647ded7a1d4d0a59bd2f91be784924b8e3dbf3d0a800e2e2fa06928

See more details on using hashes here.

File details

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

File metadata

  • Download URL: MorphIO-3.3.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.1 CPython/3.9.5

File hashes

Hashes for MorphIO-3.3.0-cp37-cp37m-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 9703aa17de2292975cd22b9a482f3dff2bc7e08650333770f2d5be4c6d6e7a3a
MD5 e1e7b6fbca05f624eb63daf826a992c8
BLAKE2b-256 15550cac335fead281674c75e8a39ebae508fd66888dde9c6dcd642342cd4cc8

See more details on using hashes here.

File details

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

File metadata

  • Download URL: MorphIO-3.3.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.1 CPython/3.9.5

File hashes

Hashes for MorphIO-3.3.0-cp37-cp37m-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 6d35e210614e811ba1bbee15c5c048aeaac5dce22c4168da535b63c1fba233e7
MD5 761fe855169dcbcbbd20fe07ef5a0538
BLAKE2b-256 f97596839e0e148319fa215abe44fbbae8039094bd2de5d87a88e6533ef40fc2

See more details on using hashes here.

File details

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

File metadata

  • Download URL: MorphIO-3.3.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.1 CPython/3.9.5

File hashes

Hashes for MorphIO-3.3.0-cp36-cp36m-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 dac42667f5f91927e7934ad5734d650702dda5b4d108f467828ecb5517926e6d
MD5 862eba18498716600d3c1bece79afb8b
BLAKE2b-256 9697e7cd7a2bba030a3e1d2d98d3b9cd36ee9d27bf8212465213c55ad43e1a7b

See more details on using hashes here.

File details

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

File metadata

  • Download URL: MorphIO-3.3.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.1 CPython/3.9.5

File hashes

Hashes for MorphIO-3.3.0-cp36-cp36m-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 8da39db851ce442f6d18e60cef17284f665b62d43b1489a2605dce68d1b67d4a
MD5 de49948627ed6e80de1779acfc979de5
BLAKE2b-256 025d4f6ece3ead8b15d625ed5c08d980954a61cacdc9010798b0ae43c7c3a039

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