cgal-pybind


Namecgal-pybind JSON
Version 0.1.6 PyPI version JSON
download
home_pageNone
SummaryPython bindings for some CGAL classes
upload_time2024-09-26 07:25:00
maintainerNone
docs_urlNone
authorBlue Brain Project, EPFL
requires_python>=3.8
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            Overview:
=========

Some CGAL_ Python bindings built with pybind11_.
This includes some auxiliary functions, as well, as mentioned in the CGAL-free portion.

CGAL Methods:
=============

* Skeletonization/contraction
* Segmentation
* Discrete authalic parametrization of surface mesh

BBP Atlas tools (CGAL-free)
===========================

* Volume slicer (used to split the layer 2/3 of the AIBS mouse isocortex)
* Streamlines intersector (used for flat mapping of brain regions)
* Thickness estimator (used for placement hints computation)
* Utils: a 3D vector field interpolator (trilinear interpolation)

Installation
============

If one is on a Linux platform, one should be able to use the compiled Python wheels.
This is the recommended way.
Otherwise, use the developer instructions to try and install it that way.

.. code-block:: bash

    $ pip install cgal-pybind

Examples
========

Several examples are available in the rendered ipython notebook:
https://github.com/BlueBrain/cgal-pybind/blob/main/examples/Examples.ipynb

Tests
=====

.. code-block:: bash

    pip install tox
    tox

Requirements
============

* cmake > 3.0.9
* C++ compiler (with C++17 support)
* Boost
* CGAL header
* Eigen3

Unit tests requirement:
=======================

* trimesh Python package

Developer instructions
======================

It is assumed that the develop has installed the C++ requirements as noted above.

CGAL_ in header only format can be used, but it still will require dependencies.
These include things like *eigen3-devel*, *gmp-devel*, *mpfr-devel* on RedHat like Linux systems.
On modern Debian systems, *libcgal-dev* and *libeigen3-dev*  can be used instead of downloading the CGAL library.
More information can be found on the CGAL_ installation getting started https://doc.cgal.org/latest/Manual/usage.html

.. code-block:: bash

    # if CGAL header-only is used, if using system packages, skip the following two lines.
    git clone https://github.com/CGAL/cgal.git $TARGET_CGAL_DIRECTORY
    export CGAL_DIR=$TARGET_CGAL_DIRECTORY

    git clone https://github.com/BlueBrain/cgal-pybind
    cd cgal-pybind
    git submodule init
    git submodule update
    pip install .



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.

For license and authors, see LICENSE.txt and AUTHORS.txt respectively.

Copyright (c) 2022-2024 Blue Brain Project/EPFL

.. _CGAL: https://www.cgal.org/
.. _pybind11: https://pybind11.readthedocs.io

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "cgal-pybind",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": null,
    "author": "Blue Brain Project, EPFL",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/a1/10/dd772b4e6e81dedd9e93146841b63548d78c0eb42c40345459252d50ce5c/cgal_pybind-0.1.6.tar.gz",
    "platform": null,
    "description": "Overview:\n=========\n\nSome CGAL_ Python bindings built with pybind11_.\nThis includes some auxiliary functions, as well, as mentioned in the CGAL-free portion.\n\nCGAL Methods:\n=============\n\n* Skeletonization/contraction\n* Segmentation\n* Discrete authalic parametrization of surface mesh\n\nBBP Atlas tools (CGAL-free)\n===========================\n\n* Volume slicer (used to split the layer 2/3 of the AIBS mouse isocortex)\n* Streamlines intersector (used for flat mapping of brain regions)\n* Thickness estimator (used for placement hints computation)\n* Utils: a 3D vector field interpolator (trilinear interpolation)\n\nInstallation\n============\n\nIf one is on a Linux platform, one should be able to use the compiled Python wheels.\nThis is the recommended way.\nOtherwise, use the developer instructions to try and install it that way.\n\n.. code-block:: bash\n\n    $ pip install cgal-pybind\n\nExamples\n========\n\nSeveral examples are available in the rendered ipython notebook:\nhttps://github.com/BlueBrain/cgal-pybind/blob/main/examples/Examples.ipynb\n\nTests\n=====\n\n.. code-block:: bash\n\n    pip install tox\n    tox\n\nRequirements\n============\n\n* cmake > 3.0.9\n* C++ compiler (with C++17 support)\n* Boost\n* CGAL header\n* Eigen3\n\nUnit tests requirement:\n=======================\n\n* trimesh Python package\n\nDeveloper instructions\n======================\n\nIt is assumed that the develop has installed the C++ requirements as noted above.\n\nCGAL_ in header only format can be used, but it still will require dependencies.\nThese include things like *eigen3-devel*, *gmp-devel*, *mpfr-devel* on RedHat like Linux systems.\nOn modern Debian systems, *libcgal-dev* and *libeigen3-dev*  can be used instead of downloading the CGAL library.\nMore information can be found on the CGAL_ installation getting started https://doc.cgal.org/latest/Manual/usage.html\n\n.. code-block:: bash\n\n    # if CGAL header-only is used, if using system packages, skip the following two lines.\n    git clone https://github.com/CGAL/cgal.git $TARGET_CGAL_DIRECTORY\n    export CGAL_DIR=$TARGET_CGAL_DIRECTORY\n\n    git clone https://github.com/BlueBrain/cgal-pybind\n    cd cgal-pybind\n    git submodule init\n    git submodule update\n    pip install .\n\n\n\nAcknowledgements\n================\n\nThe development of this software was supported by funding to the Blue Brain Project, a research center of the \u00c9cole polytechnique f\u00e9d\u00e9rale de Lausanne (EPFL), from the Swiss government\u2019s ETH Board of the Swiss Federal Institutes of Technology.\n\nFor license and authors, see LICENSE.txt and AUTHORS.txt respectively.\n\nCopyright (c) 2022-2024 Blue Brain Project/EPFL\n\n.. _CGAL: https://www.cgal.org/\n.. _pybind11: https://pybind11.readthedocs.io\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Python bindings for some CGAL classes",
    "version": "0.1.6",
    "project_urls": {
        "Homepage": "https://github.com/BlueBrain/cgal-pybind",
        "Issues": "https://github.com/BlueBrain/cgal-pybind/issues",
        "Repository": "https://github.com/BlueBrain/cgal-pybind",
        "Tracker": "https://github.com/BlueBrain/cgal-pybind/issues"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "a820bd134874fde1018f0c5219f868b8950bcf6f3333bf0684a91cefca9d3ea7",
                "md5": "72e450ca06a30a67817a5536eac52aae",
                "sha256": "93a664f90dcdee82ae24453b85257be07db73abf29be8d94c696d18d00a8ca14"
            },
            "downloads": -1,
            "filename": "cgal_pybind-0.1.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "72e450ca06a30a67817a5536eac52aae",
            "packagetype": "bdist_wheel",
            "python_version": "cp310",
            "requires_python": ">=3.8",
            "size": 888413,
            "upload_time": "2024-09-26T07:24:50",
            "upload_time_iso_8601": "2024-09-26T07:24:50.754812Z",
            "url": "https://files.pythonhosted.org/packages/a8/20/bd134874fde1018f0c5219f868b8950bcf6f3333bf0684a91cefca9d3ea7/cgal_pybind-0.1.6-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "7ebc1a0673a00a400b2e675f054475d51f05c56f3443a14dbdaaaad1c33786d7",
                "md5": "4992d276081a8680b0d7307090073af0",
                "sha256": "05c43ca2a9c27a35c944ad33c882d32a69d0e1239eace4dbf3e484dc2add5e5c"
            },
            "downloads": -1,
            "filename": "cgal_pybind-0.1.6-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "4992d276081a8680b0d7307090073af0",
            "packagetype": "bdist_wheel",
            "python_version": "cp311",
            "requires_python": ">=3.8",
            "size": 890052,
            "upload_time": "2024-09-26T07:24:52",
            "upload_time_iso_8601": "2024-09-26T07:24:52.483312Z",
            "url": "https://files.pythonhosted.org/packages/7e/bc/1a0673a00a400b2e675f054475d51f05c56f3443a14dbdaaaad1c33786d7/cgal_pybind-0.1.6-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "c3f2146cd5699e1c74ee9afeb03a07ea9ca4ee6fa2fefc92ea8b9f0b08570298",
                "md5": "2bfc3a522bc43fc9e94cb0048ce06f01",
                "sha256": "d9b1e72daed5103d162cadbb591b04121c2beb5626e4fe253b0a3c0c7c3a4c1f"
            },
            "downloads": -1,
            "filename": "cgal_pybind-0.1.6-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "2bfc3a522bc43fc9e94cb0048ce06f01",
            "packagetype": "bdist_wheel",
            "python_version": "cp312",
            "requires_python": ">=3.8",
            "size": 888274,
            "upload_time": "2024-09-26T07:24:54",
            "upload_time_iso_8601": "2024-09-26T07:24:54.080698Z",
            "url": "https://files.pythonhosted.org/packages/c3/f2/146cd5699e1c74ee9afeb03a07ea9ca4ee6fa2fefc92ea8b9f0b08570298/cgal_pybind-0.1.6-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "520c0587806b1bb8fa455d8ec2bd3f094ec4f7052e07cc657b29a89626ce9fae",
                "md5": "ec3328ee2119981b9be07443b9e29e44",
                "sha256": "a5d8ee44c64109da1dd02816e8402a8cde4c2cf63b0dc4e6f40e0363e8eb8a51"
            },
            "downloads": -1,
            "filename": "cgal_pybind-0.1.6-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "ec3328ee2119981b9be07443b9e29e44",
            "packagetype": "bdist_wheel",
            "python_version": "cp313",
            "requires_python": ">=3.8",
            "size": 888449,
            "upload_time": "2024-09-26T07:24:55",
            "upload_time_iso_8601": "2024-09-26T07:24:55.597119Z",
            "url": "https://files.pythonhosted.org/packages/52/0c/0587806b1bb8fa455d8ec2bd3f094ec4f7052e07cc657b29a89626ce9fae/cgal_pybind-0.1.6-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "fb7075dcfa40f55e697a0f9c0bd45a13c9f629d5bbe9b0c48f35144364c91782",
                "md5": "54f097659a23bb29bb611daa332987a3",
                "sha256": "09906fabe32e9224bb0c82f308925a16cd5c8179777997a19266018e0d497fe6"
            },
            "downloads": -1,
            "filename": "cgal_pybind-0.1.6-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "54f097659a23bb29bb611daa332987a3",
            "packagetype": "bdist_wheel",
            "python_version": "cp38",
            "requires_python": ">=3.8",
            "size": 888297,
            "upload_time": "2024-09-26T07:24:57",
            "upload_time_iso_8601": "2024-09-26T07:24:57.229181Z",
            "url": "https://files.pythonhosted.org/packages/fb/70/75dcfa40f55e697a0f9c0bd45a13c9f629d5bbe9b0c48f35144364c91782/cgal_pybind-0.1.6-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "3443cc6bc002aaae4585cb478a2b2fd80b201826517cf2731e0fed7561480d57",
                "md5": "19323c74352009a9272b6d278bacde08",
                "sha256": "66b8208ce852dc4f5158daf92458f903a217a8d74108c8e62170a271205c2110"
            },
            "downloads": -1,
            "filename": "cgal_pybind-0.1.6-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "has_sig": false,
            "md5_digest": "19323c74352009a9272b6d278bacde08",
            "packagetype": "bdist_wheel",
            "python_version": "cp39",
            "requires_python": ">=3.8",
            "size": 889037,
            "upload_time": "2024-09-26T07:24:58",
            "upload_time_iso_8601": "2024-09-26T07:24:58.854753Z",
            "url": "https://files.pythonhosted.org/packages/34/43/cc6bc002aaae4585cb478a2b2fd80b201826517cf2731e0fed7561480d57/cgal_pybind-0.1.6-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "a110dd772b4e6e81dedd9e93146841b63548d78c0eb42c40345459252d50ce5c",
                "md5": "4eb6bf3bac4ac8b1821f282d14631262",
                "sha256": "528b122f4553d911a2284f9a32ab53de720cf9c8445716b55de49038e5d3f3ee"
            },
            "downloads": -1,
            "filename": "cgal_pybind-0.1.6.tar.gz",
            "has_sig": false,
            "md5_digest": "4eb6bf3bac4ac8b1821f282d14631262",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 1338237,
            "upload_time": "2024-09-26T07:25:00",
            "upload_time_iso_8601": "2024-09-26T07:25:00.184857Z",
            "url": "https://files.pythonhosted.org/packages/a1/10/dd772b4e6e81dedd9e93146841b63548d78c0eb42c40345459252d50ce5c/cgal_pybind-0.1.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-09-26 07:25:00",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "BlueBrain",
    "github_project": "cgal-pybind",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "tox": true,
    "lcname": "cgal-pybind"
}
        
Elapsed time: 0.54958s