Skip to main content

Viewing and rendering of sequences of 3D data.

Project description

Code style: black Tests

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:

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)

git clone git@github.com:eth-ait/aitviewer.git
cd aitviewer
pip install -e .

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 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):

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 add you!

Citation

If you use this software, please cite it as below.

@software{Kaufmann_Vechev_aitviewer_2022,
  author = {Kaufmann, Manuel and Vechev, Velko and Mylonopoulos, Dario},
  doi = {10.5281/zenodo.1234},
  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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aitviewer-1.9.0.tar.gz (196.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aitviewer-1.9.0-py3-none-any.whl (238.0 kB view details)

Uploaded Python 3

File details

Details for the file aitviewer-1.9.0.tar.gz.

File metadata

  • Download URL: aitviewer-1.9.0.tar.gz
  • Upload date:
  • Size: 196.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.7.11

File hashes

Hashes for aitviewer-1.9.0.tar.gz
Algorithm Hash digest
SHA256 1926ca1a5dc19773ba8dde935264c60c530efa0b1684e8e6dfc55b0e5611c5ca
MD5 1fabc30bf453642ac3f6aaa40cfadcc8
BLAKE2b-256 50d110929698903f5feef965c65d59bb0efa3f6a63f1fffaae497dbfe9cff74a

See more details on using hashes here.

File details

Details for the file aitviewer-1.9.0-py3-none-any.whl.

File metadata

  • Download URL: aitviewer-1.9.0-py3-none-any.whl
  • Upload date:
  • Size: 238.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.7.11

File hashes

Hashes for aitviewer-1.9.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bf8b2794f6dcd9396a140196734afff2214d16aff47324a696f8e1a1e50c3f5f
MD5 f2141f7bf7a036c6b14535e13053cc63
BLAKE2b-256 c0b1b033bedc32ffc70ad16a26baa34676e443a224dba3189bca204213a57f7c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page