aitviewer

A set of tools to visualize and interact with sequences of 3D data.

https://github.com/eth-ait/aitviewer

Science Score: 57.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 4 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Academic email domains
  • Institutional organization owner
    Organization eth-ait has institutional domain (ait.ethz.ch)
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (15.7%) to scientific vocabulary

Keywords

3d-data-visualization 3d-graphics computervision meshes rendering sequences smpl
Last synced: 6 months ago · JSON representation

Repository

A set of tools to visualize and interact with sequences of 3D data.

Basic Info
  • Host: GitHub
  • Owner: eth-ait
  • License: mit
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 73 MB
Statistics
  • Stars: 634
  • Watchers: 13
  • Forks: 58
  • Open Issues: 17
  • Releases: 17
Topics
3d-data-visualization 3d-graphics computervision meshes rendering sequences smpl
Created over 3 years ago · Last pushed over 1 year ago
Metadata Files
Readme License Citation

README.md

Code style: black Tests DOI

aitviewer

A set of tools to visualize and interact with sequences of 3D data with cross-platform support on Windows, Linux, and macOS. See the official page at https://eth-ait.github.io/aitviewer for all the details.

Installation

Basic Installation: commandline pip install aitviewer Note that this does not install the GPU-version of PyTorch automatically. If your environment already contains it, you should be good to go, otherwise install it manually.

Or install locally (if you need to extend or modify code) commandline git clone git@github.com:eth-ait/aitviewer.git cd aitviewer pip install -e .

On macOS with Apple Silicon it is recommended to use PyQt6. Please check this issue for installation instructions.

For more advanced installation and for installing SMPL body models, please refer to the documentation .

Features

  • Native Python interface, easy to use and hack.
  • Load SMPL[-H/-X] / MANO / FLAME / STAR / SUPR sequences and display them in an interactive viewer.
  • Headless mode for server rendering of videos/images.
  • Remote mode for non-blocking integration of visualization code.
  • Render 3D data on top of images via weak-perspective or OpenCV camera models.
  • Animatable camera paths.
  • Edit SMPL sequences and poses manually.
  • Prebuilt renderable primitives (cylinders, spheres, point clouds, etc).
  • Built-in extensible GUI (based on Dear ImGui).
  • Export screenshots, videos and turntable views (as mp4/gif)
  • High-Performance ModernGL-based rendering pipeline (running at 100fps+ on most laptops).

aitviewer SMPL Editing

Quickstart

Display an SMPL T-pose (Requires SMPL models): ```py from aitviewer.renderables.smpl import SMPLSequence from aitviewer.viewer import Viewer

if name == 'main': v = Viewer() v.scene.add(SMPLSequence.t_pose()) v.run() ```

Projects using the aitviewer

A sampling of projects using the aitviewer. Let us know if you want to be added to this list! - Fan et al., HOLD: Category-agnostic 3D Reconstruction of Interacting Hands and Objects from Video, CVPR 2024 - Braun et al., Physically Plausible Full-Body Hand-Object Interaction Synthesis, 3DV 2024 - Zhang and Christen et al., ArtiGrasp: Physically Plausible Synthesis of Bi-Manual Dexterous Grasping and Articulation, 3DV 2024 - Kaufmann et al., EMDB: The Electromagnetic Database of Global 3D Human Pose and Shape in the Wild, ICCV 2023 - Shen and Guo et al., X-Avatar: Expressive Human Avatars, CVPR 2023 - Sun et al., TRACE: 5D Temporal Regression of Avatars with Dynamic Cameras in 3D Environments, CVPR 2023 - Fan et al., ARCTIC: A Dataset for Dexterous Bimanual Hand-Object Manipulation, CVPR 2023 - Dong and Guo et al., PINA: Learning a Personalized Implicit Neural Avatar from a Single RGB-D Video Sequence, CVPR 2022 - Dong et al., Shape-aware Multi-Person Pose Estimation from Multi-view Images, ICCV 2021 - Kaufmann et al., EM-POSE: 3D Human Pose Estimation from Sparse Electromagnetic Trackers, ICCV 2021 - Vechev et al., Computational Design of Kinesthetic Garments, Eurographics 2021 - Guo et al., Human Performance Capture from Monocular Video in the Wild, 3DV 2021

Citation

If you use this software, please cite it as below. commandline @software{Kaufmann_Vechev_aitviewer_2022, author = {Kaufmann, Manuel and Vechev, Velko and Mylonopoulos, Dario}, doi = {10.5281/zenodo.10013305}, month = {7}, title = {{aitviewer}}, url = {https://github.com/eth-ait/aitviewer}, year = {2022} }

Contact & Contributions

This software was developed by Manuel Kaufmann, Velko Vechev and Dario Mylonopoulos. For questions please create an issue. We welcome and encourage module and feature contributions from the community.

aitviewer Sample

Owner

  • Name: AIT
  • Login: eth-ait
  • Kind: organization
  • Location: Zurich

Advanced Interactive Technologies (AIT) group at ETH Zurich

GitHub Events

Total
  • Issues event: 15
  • Watch event: 102
  • Issue comment event: 29
  • Fork event: 11
Last Year
  • Issues event: 15
  • Watch event: 102
  • Issue comment event: 29
  • Fork event: 11

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 49
  • Total pull requests: 21
  • Average time to close issues: 16 days
  • Average time to close pull requests: 16 days
  • Total issue authors: 33
  • Total pull request authors: 7
  • Average comments per issue: 2.41
  • Average comments per pull request: 0.19
  • Merged pull requests: 19
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 9
  • Pull requests: 2
  • Average time to close issues: 17 days
  • Average time to close pull requests: 5 months
  • Issue authors: 6
  • Pull request authors: 2
  • Average comments per issue: 1.44
  • Average comments per pull request: 0.5
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • huzijun1996 (4)
  • MarilynKeller (4)
  • DaebangStn (3)
  • yhiroya2000 (2)
  • wwwpkol (2)
  • Okaerikoto (2)
  • Aricling (2)
  • kunkun0w0 (2)
  • Arthur151 (2)
  • richardrl (2)
  • MathPoem (1)
  • Shigurex (1)
  • DehTop (1)
  • marcilzakour (1)
  • smueksch (1)
Pull Request Authors
  • ramenguy99 (11)
  • MarilynKeller (3)
  • kaufManu (3)
  • christsa (2)
  • totomobile43 (2)
  • zc-alexfan (2)
  • sh1boot (1)
Top Labels
Issue Labels
question (3) bug (3) enhancement (2) documentation (1)
Pull Request Labels

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 2,294 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 1
  • Total versions: 18
  • Total maintainers: 2
pypi.org: aitviewer

Viewing and rendering of sequences of 3D data.

  • Versions: 18
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 2,294 Last month
Rankings
Stargazers count: 3.3%
Forks count: 7.1%
Downloads: 7.8%
Average: 10.0%
Dependent packages count: 10.1%
Dependent repos count: 21.6%
Maintainers (2)
Last synced: 6 months ago

Dependencies

setup.py pypi
  • PyQt5 >=5.15.4
  • imgui >=1.3.0
  • joblib *
  • moderngl >=5.6.4,<6.0
  • moderngl-window >=2.4.0
  • numpy >=1.18,<2
  • omegaconf >=2.1.1
  • opencv-contrib-python-headless >=4.5.1.48
  • roma >=1.2.3
  • rtree >=0.9.7
  • scipy >=1.5.2
  • smplx *
  • torch >=1.6.0
  • tqdm >=4.60.0
  • trimesh >=3.9.15,<4
.github/workflows/lint.yml actions
  • actions/checkout v2 composite
  • actions/setup-python v2 composite
  • isort/isort-action master composite
  • psf/black stable composite
.github/workflows/tests.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
pyproject.toml pypi