https://github.com/isarandi/poseviz
3D Human Pose Visualizer for Python
https://github.com/isarandi/poseviz
3d-human-pose 3d-viewer 3d-visualization mayavi pose-estimation python
Last synced: about 2 months ago
JSON representation
3D Human Pose Visualizer for Python
- Host: GitHub
- URL: https://github.com/isarandi/poseviz
- Owner: isarandi
- License: mit
- Created: 2021-10-18T18:28:08.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-12-12T15:07:45.000Z (5 months ago)
- Last Synced: 2025-03-29T14:06:58.974Z (about 2 months ago)
- Topics: 3d-human-pose, 3d-viewer, 3d-visualization, mayavi, pose-estimation, python
- Language: Python
- Homepage:
- Size: 501 KB
- Stars: 136
- Watchers: 5
- Forks: 16
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PoseViz – 3D Human Pose Visualizer
Multi-person, multi-camera 3D human pose visualization tool built using
[Mayavi](https://docs.enthought.com/mayavi/mayavi/). As used
in [MeTRAbs](https://github.com/isarandi/metrabs) visualizations.
**This repo does not contain pose estimation code, only the visualization part.**
## Gist of Usage
```python
import poseviz
import cameralib
camera = cameralib.Camera(...)
with poseviz.PoseViz(...) as viz:
for frame in frames:
bounding_boxes, poses3d = run_pose_estimation_model(frame)
viz.update(frame=frame, boxes=bounding_boxes, poses=poses3d, camera=camera)
```
See also [```demo.py```](demo.py).
The main feature of this tool is that the graphical event loop is hidden from the library user. We
want to write code in terms of the *prediction loop* of the human pose estimator, not from the point
of view of the visualizer tool.
Behind the scenes, this is achieved through forking a dedicated visualization process and passing
new scene information via multiprocessing queues.
## Installation
PoseViz is released as a conda package (experimental, tested only on Linux):
```bash
conda install poseviz -c isarandi
```
Alternatively, in case the above doesn't work, install Mayavi via conda (the Mayavi pip package has
compilation problems), clone this repo and install PoseViz via pip:
```bash
conda install mayavi -c conda-forge
pip install git+https://github.com/isarandi/poseviz.git
```
Then run [demo.py](demo.py) to test if installation was successful.