smpl2bvh - GitLite

KO | EN

gitlite — search

#llm #go #golang #deep-learning #docker #macos #java #cli #kubernetes #awesome-list #vue #security #pytorch #mcp

smpl2bvh

(★ 227)

This repository contains an example script to convert from a SMPL model to a bvh file.

File Explorer

Download Latest Version (.zip)

- aistpp.gif
- aistpp2.gif
- bvh.py
- quat.py
.gitignore
LICENSE
README.md
smpl2bvh.py

# Installation Guide

1. Get the code

git clone https://github.com/KosukeFukazawa/smpl2bvh

Downloads the entire project code from GitHub to your computer.

cd smpl2bvh

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

Python 3 Python is required to use pip.

pip install smplx[all]

Installs the package published on PyPI directly — no need to clone the source.

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# smpl2bvh
This repository contains an example script to convert from a SMPL model to a bvh file.

<img src="gif/aistpp.gif" align="center"> <br>
The left side of the figure shows the SMPL grand truth and the right side shows the bvh data.
If you want to convert [AMASS](https://amass.is.tue.mpg.de/) to bvh, please refer to [my another repo](https://github.com/KosukeFukazawa/CharacterAnimationTools#13-load-animation-from-amass).

## Notification
This code is MIT licensed, but SMPL requires a separate license.  
Please see [SMPL official website](https://smpl.is.tue.mpg.de/).

## Requirements
You need to download SMPL models in `./data/smpl/smpl/`.  
You need to download [smplx](https://github.com/vchoutas/smplx) too.  
To install from PyPi simply run:
```
    pip install smplx[all]
```

## How to use?
After downloads all requirements, you can use smpl2bvh like this:
```python
    python smpl2bvh.py --gender MALE --poses ${PATH_TO_Y0UR_INPUT} --fps 60 --output ${PATH_TO_SAVE} --mirror
```

`poses` is an `.npz` file or `.pkl` file.  
`.npz` file must contain `rotations` and `trans` as keys.  
`rotations` value is an np.array consisting of [fnum, 24, 3] and `trans` value is the root transition consisting of [fnum, 3]
(fnum means frame number).

`.pkl` file must contain `smpl_poses` and `smpl_scaling` and `smpl_trans` as keys.  
`smpl_poses` value is an np.array consisting of [fnum, 72] and `smpl_scaling` value is the scaling parameter. `smpl_trans` value is the root transition consisting of [fnum, 3].  
The format of `pkl` file is the same as [AIST++](https://google.github.io/aistplusplus_dataset/) dataset.  
If you check `--mirror` as an argument, the mirrored motion is also saved.  
After processing, you can find bvh file as `--output`.  
For more information, please refer to `smpl2bvh.py`.

## Reference
`bvh.py` and `quat.py` are based on [Motion Matching](https://github.com/orangeduck/Motion-Matching).