Skip to main content

A neuron morphology IO library

Project description

|license| |build| |docs|

MorphIO

Documentation

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

  • latest snapshot <http://morphio.readthedocs.org/en/latest/>_
  • latest release <http://morphio.readthedocs.org/en/stable/>_

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:

.. code-block:: bash

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

and then:

.. code-block:: bash

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 <https://github.com/BlueBrain/morphio/blob/master/CONTRIBUTING.md>_ 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

.. |license| image:: https://img.shields.io/pypi/l/morphio :target: https://github.com/BlueBrain/morphio/blob/master/COPYING.LESSER

.. |build| image:: https://travis-ci.com/BlueBrain/MorphIO.svg?token=KRP9rHiV52PC6mX3ACXp&branch=master :target: https://travis-ci.com/BlueBrain/MorphIO :alt: Build Status

.. |docs| image:: https://readthedocs.org/projects/morphio/badge/?version=latest :target: https://morphio.readthedocs.io/ :alt: documentation status

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

Uploaded Source

Built Distributions

MorphIO-3.3.2-cp39-cp39-win_amd64.whl (527.6 kB view details)

Uploaded CPython 3.9 Windows x86-64

MorphIO-3.3.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.8 MB view details)

Uploaded CPython 3.9 manylinux: glibc 2.17+ x86-64

MorphIO-3.3.2-cp39-cp39-macosx_10_13_x86_64.whl (2.0 MB view details)

Uploaded CPython 3.9 macOS 10.13+ x86-64

MorphIO-3.3.2-cp38-cp38-win_amd64.whl (527.6 kB view details)

Uploaded CPython 3.8 Windows x86-64

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

Uploaded CPython 3.8 manylinux: glibc 2.17+ x86-64

MorphIO-3.3.2-cp38-cp38-macosx_10_13_x86_64.whl (2.0 MB view details)

Uploaded CPython 3.8 macOS 10.13+ x86-64

MorphIO-3.3.2-cp37-cp37m-win_amd64.whl (526.6 kB view details)

Uploaded CPython 3.7m Windows x86-64

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

Uploaded CPython 3.7m manylinux: glibc 2.17+ x86-64

MorphIO-3.3.2-cp37-cp37m-macosx_10_13_x86_64.whl (2.0 MB view details)

Uploaded CPython 3.7m macOS 10.13+ x86-64

File details

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

File metadata

  • Download URL: MorphIO-3.3.2.tar.gz
  • Upload date:
  • Size: 3.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.5.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for MorphIO-3.3.2.tar.gz
Algorithm Hash digest
SHA256 fc961defbfbfb3f11360954fb3ec51373eaff25b154fa31d6b31decca6937780
MD5 2962bf5306a2cb63f8dc2c4520791993
BLAKE2b-256 695e074df9658ae5be1bea5c98292b545c50875cf0490da402b6a7136acb0a7c

See more details on using hashes here.

File details

Details for the file MorphIO-3.3.2-cp39-cp39-win_amd64.whl.

File metadata

  • Download URL: MorphIO-3.3.2-cp39-cp39-win_amd64.whl
  • Upload date:
  • Size: 527.6 kB
  • Tags: CPython 3.9, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.5.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for MorphIO-3.3.2-cp39-cp39-win_amd64.whl
Algorithm Hash digest
SHA256 5177a659cea695c392ec233c6ed075c073a9ea73fe591d0331cf47562274162d
MD5 0501916921645247d9a9719bfcd7d08b
BLAKE2b-256 ad79ba15c8f88fba156046f35f7f89c7ab4a956e23f46d7b8de05dcfd7eca242

See more details on using hashes here.

File details

Details for the file MorphIO-3.3.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for MorphIO-3.3.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 7c53fd176f31a4a42e15bfcb0afc95dac4d6ef2ac93ae4b0b4c8d166d148589c
MD5 dc70dc00807cd292d91c97edc010c93a
BLAKE2b-256 3ff631ee4216341cce13cc36f9068cfceba2bb004e677c8eaa42fe6c64641869

See more details on using hashes here.

File details

Details for the file MorphIO-3.3.2-cp39-cp39-macosx_10_13_x86_64.whl.

File metadata

  • Download URL: MorphIO-3.3.2-cp39-cp39-macosx_10_13_x86_64.whl
  • Upload date:
  • Size: 2.0 MB
  • Tags: CPython 3.9, macOS 10.13+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.5.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for MorphIO-3.3.2-cp39-cp39-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 0ef813b29223327d88917193de42f2f330261de415649c8cded9dc7109c02f32
MD5 773b5f9ffac5194fe3e06ddc0f6d2c2e
BLAKE2b-256 cc6f297e312d2863615e46de027500a908669a29003f3db8411625f83071e5e0

See more details on using hashes here.

File details

Details for the file MorphIO-3.3.2-cp38-cp38-win_amd64.whl.

File metadata

  • Download URL: MorphIO-3.3.2-cp38-cp38-win_amd64.whl
  • Upload date:
  • Size: 527.6 kB
  • Tags: CPython 3.8, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.5.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for MorphIO-3.3.2-cp38-cp38-win_amd64.whl
Algorithm Hash digest
SHA256 03c3d169f890dad467903d4e0cb37414e69f81a7eb7abae6f6e54e115b452db9
MD5 8bdaafc46e39455090c93e3964807731
BLAKE2b-256 3ccf3acf85ae115b8a31825e45a4a4c76f090114ca76bd8136169e9ab8587cfe

See more details on using hashes here.

File details

Details for the file MorphIO-3.3.2-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for MorphIO-3.3.2-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 db901b1d9cf2b58a49f66a221d15764d22b9439fb03185aa1b8ba15d8987068e
MD5 51782630e3856c26aeb56bf7d7c8df22
BLAKE2b-256 5a5fd9f4f90140507dc33232c0fa9f933d9d8b7853a991a848a098ed07df94f6

See more details on using hashes here.

File details

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

File metadata

  • Download URL: MorphIO-3.3.2-cp38-cp38-macosx_10_13_x86_64.whl
  • Upload date:
  • Size: 2.0 MB
  • Tags: CPython 3.8, macOS 10.13+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.5.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for MorphIO-3.3.2-cp38-cp38-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 167bb34547e2110cdbef382579e90f292f844c0862d32fa45a3070898452295e
MD5 5d837db66edaba60914d57ed70d9274f
BLAKE2b-256 00d472b9cce0f67001e667b393e8e75614a90ad5fd25afa550adb2a1469ae26f

See more details on using hashes here.

File details

Details for the file MorphIO-3.3.2-cp37-cp37m-win_amd64.whl.

File metadata

  • Download URL: MorphIO-3.3.2-cp37-cp37m-win_amd64.whl
  • Upload date:
  • Size: 526.6 kB
  • Tags: CPython 3.7m, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.5.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for MorphIO-3.3.2-cp37-cp37m-win_amd64.whl
Algorithm Hash digest
SHA256 b9594c9ffbf255e24929623a168c8fc2f59ce9087119974e04bc87b9957fb661
MD5 f5c4a55f49521a5bae063e246acf6c85
BLAKE2b-256 f3db1edfb8a823208ea6de4c52f049378349e97fdaeba49b2c4ec0e635fdd7f4

See more details on using hashes here.

File details

Details for the file MorphIO-3.3.2-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for MorphIO-3.3.2-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 fccf7cb5c258b2a3073a05b17e7790dea9a912774310e3411704f8d5b06a42d1
MD5 a24aa816873aea77ef4d7a1e78cf538a
BLAKE2b-256 cea2e16795780c0d757459d17aafe155fec9fd2cb11f1c0d25efb0d63095b8e1

See more details on using hashes here.

File details

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

File metadata

  • Download URL: MorphIO-3.3.2-cp37-cp37m-macosx_10_13_x86_64.whl
  • Upload date:
  • Size: 2.0 MB
  • Tags: CPython 3.7m, macOS 10.13+ x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.5.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for MorphIO-3.3.2-cp37-cp37m-macosx_10_13_x86_64.whl
Algorithm Hash digest
SHA256 83eb1728b579a3e8ffa22f389dd416a0f036395a0f091800bb2656df1b4c7c14
MD5 c4057b921490b00c2eef11e237d6a050
BLAKE2b-256 e74255693b49a662fb92c888b9f592f056e852bfa9c72855a289e11d01b2f2af

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