meshparty


Namemeshparty JSON
Version 2.0.3 PyPI version JSON
download
home_pageNone
Summarya service to work with meshes
upload_time2025-07-10 18:36:17
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI
coveralls test coverage
            .. image:: https://readthedocs.org/projects/meshparty/badge/?version=latest
    :target: https://meshparty.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status
.. image:: https://travis-ci.com/sdorkenw/MeshParty.svg?branch=master
    :target: https://travis-ci.com/sdorkenw/MeshParty
.. image:: https://codecov.io/gh/sdorkenw/MeshParty/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/sdorkenw/MeshParty
.. image:: https://zenodo.org/badge/148393516.svg
   :target: https://zenodo.org/badge/latestdoi/148393516
   
MeshParty
#########
A package to work with meshes, designed around use cases for analyzing neuronal morphology.

documentation https://meshparty.readthedocs.io/
 
############

From pypi:
::

    pip install meshparty

Note: Version 2.0.0 or higher requires Python 3.10 or higher and offers reduced features for mesh analysis and visualization.
Projects like pyvista are now easier and more powerful for work that was previously done in MeshParty.
This package is still intended to be used for the Skeleton and MeshWork classes, but with reduced support for mesh analysis.


To install the git version do:

:: 

    git clone https://github.com/sdorkenw/MeshParty.git
    cd MeshParty
    pip install . --upgrade


to make optional features of ray tracing and interaction with the PyChunkedGraph work properly you need to install the optional dependencies

::

    conda install pyembree
    pip install caveclient
    


Usage example
#################

::

    from meshparty import trimesh_io

    meshmeta = trimesh_io.MeshMeta()
    mesh = meshmeta.mesh(path_to_mesh) # mesh gets cached

    local_vertices = mesh.get_local_view(n_points, pc_align=True, method="kdtree")


Downloading meshes
##################

Meshes can be downloaded in parallel using 

::

    trimesh_io.download_meshes(seg_ids, target_dir, cv_path)


where `cv_path` points to the cloudvolume bucket. For downloading proofread meshes one needs to 
specify the `mesh_endpoint` of the chunkedgraph server:

::

    trimesh_io.download_meshes(seg_ids, target_dir, cv_path, mesh_endpoint="https://...")



Extracting mesh information
###########################

The mesh needs to be `watertight` In order to compute reliable information. To
test whether a mesh is watertight, run

::

    mesh.is_watertight



Since trimesh_io.Mesh() inherits from trimesh.Trimesh all trimesh functionality 
is available to mesh, e.g.:
::

    mesh.volume
    mesh.area
    mesh.center_mass


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "meshparty",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": null,
    "author": null,
    "author_email": "Sven Dorkenwald <svenmd@princeton.edu>, Forrest Collman <forrestc@alleninstitute.org>, Casey Schneider-Mizell <caseys@alleninstitute.org>",
    "download_url": "https://files.pythonhosted.org/packages/4a/e7/a1c0cd607a0ea91a46ced552f7d7dd2a0b53fbd237db52505b51e9f2c91d/meshparty-2.0.3.tar.gz",
    "platform": null,
    "description": ".. image:: https://readthedocs.org/projects/meshparty/badge/?version=latest\n    :target: https://meshparty.readthedocs.io/en/latest/?badge=latest\n    :alt: Documentation Status\n.. image:: https://travis-ci.com/sdorkenw/MeshParty.svg?branch=master\n    :target: https://travis-ci.com/sdorkenw/MeshParty\n.. image:: https://codecov.io/gh/sdorkenw/MeshParty/branch/master/graph/badge.svg\n   :target: https://codecov.io/gh/sdorkenw/MeshParty\n.. image:: https://zenodo.org/badge/148393516.svg\n   :target: https://zenodo.org/badge/latestdoi/148393516\n   \nMeshParty\n#########\nA package to work with meshes, designed around use cases for analyzing neuronal morphology.\n\ndocumentation https://meshparty.readthedocs.io/\n \n############\n\nFrom pypi:\n::\n\n    pip install meshparty\n\nNote: Version 2.0.0 or higher requires Python 3.10 or higher and offers reduced features for mesh analysis and visualization.\nProjects like pyvista are now easier and more powerful for work that was previously done in MeshParty.\nThis package is still intended to be used for the Skeleton and MeshWork classes, but with reduced support for mesh analysis.\n\n\nTo install the git version do:\n\n:: \n\n    git clone https://github.com/sdorkenw/MeshParty.git\n    cd MeshParty\n    pip install . --upgrade\n\n\nto make optional features of ray tracing and interaction with the PyChunkedGraph work properly you need to install the optional dependencies\n\n::\n\n    conda install pyembree\n    pip install caveclient\n    \n\n\nUsage example\n#################\n\n::\n\n    from meshparty import trimesh_io\n\n    meshmeta = trimesh_io.MeshMeta()\n    mesh = meshmeta.mesh(path_to_mesh) # mesh gets cached\n\n    local_vertices = mesh.get_local_view(n_points, pc_align=True, method=\"kdtree\")\n\n\nDownloading meshes\n##################\n\nMeshes can be downloaded in parallel using \n\n::\n\n    trimesh_io.download_meshes(seg_ids, target_dir, cv_path)\n\n\nwhere `cv_path` points to the cloudvolume bucket. For downloading proofread meshes one needs to \nspecify the `mesh_endpoint` of the chunkedgraph server:\n\n::\n\n    trimesh_io.download_meshes(seg_ids, target_dir, cv_path, mesh_endpoint=\"https://...\")\n\n\n\nExtracting mesh information\n###########################\n\nThe mesh needs to be `watertight` In order to compute reliable information. To\ntest whether a mesh is watertight, run\n\n::\n\n    mesh.is_watertight\n\n\n\nSince trimesh_io.Mesh() inherits from trimesh.Trimesh all trimesh functionality \nis available to mesh, e.g.:\n::\n\n    mesh.volume\n    mesh.area\n    mesh.center_mass\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "a service to work with meshes",
    "version": "2.0.3",
    "project_urls": {
        "Bug Tracker": "https://github.com/CAVEconnectome/MeshParty/issues",
        "Homepage": "https://github.com/CAVEconnectome/MeshParty"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "62684934ed0b1ff7df5ece74fc362f3fad4a2fb039a57eb0585d7dbec9d2511b",
                "md5": "4c42c141b2ba5424255f8a45649e4d8e",
                "sha256": "a5340774323e81ef5378a7cb62b1019896fd98018487deede014730b5529dad5"
            },
            "downloads": -1,
            "filename": "meshparty-2.0.3-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "4c42c141b2ba5424255f8a45649e4d8e",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 104101,
            "upload_time": "2025-07-10T18:36:10",
            "upload_time_iso_8601": "2025-07-10T18:36:10.472237Z",
            "url": "https://files.pythonhosted.org/packages/62/68/4934ed0b1ff7df5ece74fc362f3fad4a2fb039a57eb0585d7dbec9d2511b/meshparty-2.0.3-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "4ae7a1c0cd607a0ea91a46ced552f7d7dd2a0b53fbd237db52505b51e9f2c91d",
                "md5": "8ead4b9a0cb7eb169dc15d6fed3d2f14",
                "sha256": "03bf4f6f6c953afadf7e5daec3cc0b01d929d77aed83a4d2a50797b2475413e5"
            },
            "downloads": -1,
            "filename": "meshparty-2.0.3.tar.gz",
            "has_sig": false,
            "md5_digest": "8ead4b9a0cb7eb169dc15d6fed3d2f14",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 83147395,
            "upload_time": "2025-07-10T18:36:17",
            "upload_time_iso_8601": "2025-07-10T18:36:17.361748Z",
            "url": "https://files.pythonhosted.org/packages/4a/e7/a1c0cd607a0ea91a46ced552f7d7dd2a0b53fbd237db52505b51e9f2c91d/meshparty-2.0.3.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-10 18:36:17",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "CAVEconnectome",
    "github_project": "MeshParty",
    "travis_ci": true,
    "coveralls": true,
    "github_actions": true,
    "test_requirements": [
        {
            "name": "pytest",
            "specs": []
        },
        {
            "name": "pytest-cov",
            "specs": []
        },
        {
            "name": "pytest-runner",
            "specs": []
        },
        {
            "name": "pytest-xdist",
            "specs": []
        },
        {
            "name": "pytest-mock",
            "specs": []
        },
        {
            "name": "matplotlib",
            "specs": []
        }
    ],
    "lcname": "meshparty"
}
        
Elapsed time: 0.52134s