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 theSection
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
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
Built Distributions
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | fc961defbfbfb3f11360954fb3ec51373eaff25b154fa31d6b31decca6937780 |
|
MD5 | 2962bf5306a2cb63f8dc2c4520791993 |
|
BLAKE2b-256 | 695e074df9658ae5be1bea5c98292b545c50875cf0490da402b6a7136acb0a7c |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5177a659cea695c392ec233c6ed075c073a9ea73fe591d0331cf47562274162d |
|
MD5 | 0501916921645247d9a9719bfcd7d08b |
|
BLAKE2b-256 | ad79ba15c8f88fba156046f35f7f89c7ab4a956e23f46d7b8de05dcfd7eca242 |
File details
Details for the file MorphIO-3.3.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
.
File metadata
- Download URL: MorphIO-3.3.2-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 1.8 MB
- Tags: CPython 3.9, manylinux: glibc 2.17+ 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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7c53fd176f31a4a42e15bfcb0afc95dac4d6ef2ac93ae4b0b4c8d166d148589c |
|
MD5 | dc70dc00807cd292d91c97edc010c93a |
|
BLAKE2b-256 | 3ff631ee4216341cce13cc36f9068cfceba2bb004e677c8eaa42fe6c64641869 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0ef813b29223327d88917193de42f2f330261de415649c8cded9dc7109c02f32 |
|
MD5 | 773b5f9ffac5194fe3e06ddc0f6d2c2e |
|
BLAKE2b-256 | cc6f297e312d2863615e46de027500a908669a29003f3db8411625f83071e5e0 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 03c3d169f890dad467903d4e0cb37414e69f81a7eb7abae6f6e54e115b452db9 |
|
MD5 | 8bdaafc46e39455090c93e3964807731 |
|
BLAKE2b-256 | 3ccf3acf85ae115b8a31825e45a4a4c76f090114ca76bd8136169e9ab8587cfe |
File details
Details for the file MorphIO-3.3.2-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
.
File metadata
- Download URL: MorphIO-3.3.2-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 1.8 MB
- Tags: CPython 3.8, manylinux: glibc 2.17+ 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
Algorithm | Hash digest | |
---|---|---|
SHA256 | db901b1d9cf2b58a49f66a221d15764d22b9439fb03185aa1b8ba15d8987068e |
|
MD5 | 51782630e3856c26aeb56bf7d7c8df22 |
|
BLAKE2b-256 | 5a5fd9f4f90140507dc33232c0fa9f933d9d8b7853a991a848a098ed07df94f6 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 167bb34547e2110cdbef382579e90f292f844c0862d32fa45a3070898452295e |
|
MD5 | 5d837db66edaba60914d57ed70d9274f |
|
BLAKE2b-256 | 00d472b9cce0f67001e667b393e8e75614a90ad5fd25afa550adb2a1469ae26f |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | b9594c9ffbf255e24929623a168c8fc2f59ce9087119974e04bc87b9957fb661 |
|
MD5 | f5c4a55f49521a5bae063e246acf6c85 |
|
BLAKE2b-256 | f3db1edfb8a823208ea6de4c52f049378349e97fdaeba49b2c4ec0e635fdd7f4 |
File details
Details for the file MorphIO-3.3.2-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
.
File metadata
- Download URL: MorphIO-3.3.2-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 1.8 MB
- Tags: CPython 3.7m, manylinux: glibc 2.17+ 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
Algorithm | Hash digest | |
---|---|---|
SHA256 | fccf7cb5c258b2a3073a05b17e7790dea9a912774310e3411704f8d5b06a42d1 |
|
MD5 | a24aa816873aea77ef4d7a1e78cf538a |
|
BLAKE2b-256 | cea2e16795780c0d757459d17aafe155fec9fd2cb11f1c0d25efb0d63095b8e1 |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 83eb1728b579a3e8ffa22f389dd416a0f036395a0f091800bb2656df1b4c7c14 |
|
MD5 | c4057b921490b00c2eef11e237d6a050 |
|
BLAKE2b-256 | e74255693b49a662fb92c888b9f592f056e852bfa9c72855a289e11d01b2f2af |