{"id":28502070,"url":"https://github.com/kostrykin/libcarna-python","last_synced_at":"2025-07-05T02:31:05.900Z","repository":{"id":62560917,"uuid":"375100454","full_name":"kostrykin/LibCarna-Python","owner":"kostrykin","description":"Real-time 3D visualization for biomedical data and beyond in Python","archived":false,"fork":false,"pushed_at":"2025-05-17T10:22:59.000Z","size":20393,"stargazers_count":12,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-07T08:43:12.937Z","etag":null,"topics":["3d","3d-visualization","data-visualization","digitally-reconstructed-radiograph","direct-volume-rendering","jupyter","maximum-intensity-projections","opengl","python","scientific-visualization"],"latest_commit_sha":null,"homepage":"https://libcarna.readthedocs.io","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kostrykin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-06-08T18:00:31.000Z","updated_at":"2025-05-20T21:33:35.000Z","dependencies_parsed_at":"2023-12-12T11:43:35.337Z","dependency_job_id":"b6ed7e36-83d3-4ae2-acc3-782a5ceaf106","html_url":"https://github.com/kostrykin/LibCarna-Python","commit_stats":{"total_commits":21,"total_committers":1,"mean_commits":21.0,"dds":0.0,"last_synced_commit":"c7836cad216d439b7dc6504becd963d91d6b3a7f"},"previous_names":["kostrykin/libcarna-python","kostrykin/carnapy"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/kostrykin/LibCarna-Python","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kostrykin%2FLibCarna-Python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kostrykin%2FLibCarna-Python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kostrykin%2FLibCarna-Python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kostrykin%2FLibCarna-Python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kostrykin","download_url":"https://codeload.github.com/kostrykin/LibCarna-Python/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kostrykin%2FLibCarna-Python/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263671741,"owners_count":23494023,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d","3d-visualization","data-visualization","digitally-reconstructed-radiograph","direct-volume-rendering","jupyter","maximum-intensity-projections","opengl","python","scientific-visualization"],"created_at":"2025-06-08T16:08:58.137Z","updated_at":"2025-07-05T02:31:05.895Z","avatar_url":"https://github.com/kostrykin.png","language":"C++","readme":"LibCarna-Python\n===============\n\nThe aim of this package is to provide real-time 3D visualization in Python for specifically, but not limited to, biomedical data. The library is based on [LibCarna](https://github.com/kostrykin/LibCarna).\n\nSee [libcarna.readthedocs.io](https://libcarna.readthedocs.io) for examples and documentation.\n\n[![Build and Test](https://github.com/kostrykin/LibCarna-Python/actions/workflows/build_all.yml/badge.svg)](https://github.com/kostrykin/LibCarna-Python/actions/workflows/build_all.yml)\n[![Anaconda-Server Badge](https://img.shields.io/badge/Install%20with-conda-%2387c305)](https://anaconda.org/bioconda/libcarna-python)\n[![Anaconda-Server Badge](https://img.shields.io/conda/v/bioconda/libcarna-python.svg?label=Version)](https://anaconda.org/bioconda/libcarna-python)\n[![Anaconda-Server Badge](https://img.shields.io/conda/pn/bioconda/libcarna-python.svg?label=Platforms)](https://anaconda.org/bioconda/libcarna-python)\n\n---\n\n\u003ca href=\"https://libcarna.readthedocs.io/en/latest/examples/cells.html\"\u003e\u003cimg src=\"https://figshare.com/ndownloader/files/54620162\" height=\"350px\"\u003e\u003c/a\u003e\u0026nbsp;\u003ca href=\"https://libcarna.readthedocs.io/en/latest/examples/cthead.html\"\u003e\u003cimg src=\"https://figshare.com/ndownloader/files/54620159\" height=\"350px\"\u003e\u003c/a\u003e\n\n---\n## Contents\n\n* [Limitations](#1-limitations)\n* [Dependencies](#2-dependencies)\n* [Installation](#3-installation)\n* [Build instructions](#4-build-instructions)\n \n---\n## 1. Limitations\n\n* Only 8bit and 16bit volume data are supported at the moment.\n* Only a subset of rendering stages is exposed to Python yet.\n* Build process is currently limited to Linux-based systems.\n\n---\n## 2. Dependencies\n\nGeneral dependencies are listed in *environment.yml*. Further dependencies for testing are listed in\n*test/requirements.txt*, and those for the documentation in *docs/requirements.txt*.\n\n---\n## 3. Installation\n\nThe easiest way to install and use the library is to use one of the binary [Conda](https://www.anaconda.com/docs/getting-started/miniconda) packages:\n\n```bash\nconda install bioconda::libcarna-python\n```\n\nIf you encounter an error that looks like below,\n\n\u003e Failed expression: pimpl-\u003eeglDpy != EGL_NO_DISPLAY\n\nthen you must install the EGL implementation suitable for your rendering hardware (e.g., `sudo apt install libegl1`\ninstalls a meta package that automatically chooses the right implementation, or `libegl-mesa0` for software rendering).\n\n---\n## 4. Build instructions\n\nThere is a build script for Ubuntu Linux which builds a wheel file:\n```bash\nLIBCARNA_PYTHON_BUILD_DOCS=1 LIBCARNA_PYTHON_BUILD_TESTS=1 ./linux_build.bash\n```\nAdaption to other distributions should be self-explanatory.\n\nAfter building the wheel file, it can be installed using:\n```bash\npip install --force-reinstall build/dist/libcarna_python-*.whl\n```\n\nTo build against a development version of [LibCarna](https://github.com/kostrykin/LibCarna), install it locally via\n```bash\nLIBCARNA_SRC_PREFIX=\"../LibCarna\" ./install_libcarna_dev.bash\n```\nwhere you make `LIBCARNA_SRC_PREFIX` point to the source directory.\n\nThis will create a local directory `.libcarna-dev`. The build process will give precedence to LibCarna from this directory over other versions. Simply remove `.libcarna-dev` to stop building agaisnt the development version of LibCarna.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkostrykin%2Flibcarna-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkostrykin%2Flibcarna-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkostrykin%2Flibcarna-python/lists"}