hand-reconstruction

The official project repository for the BMVC 2019 paper
Single Image 3D Hand Reconstruction with Mesh Convolutions
by Dominik Kulon, Haoyang Wang, Riza Alp Güler, Michael Bronstein, Stefanos Zafeiriou

Introduction

Monocular 3D reconstruction of deformable objects, such as human body parts, has been typically approached by predicting parameters of heavyweight linear models. In this paper, we demonstrate an alternative solution that is based on the idea of encoding images into a latent non-linear representation of meshes. The prior on 3D hand shapes is learned by training an autoencoder with intrinsic graph convolutions performed in the spectral domain. The pre-trained decoder acts as a non-linear statistical deformable model. The latent parameters that reconstruct the shape and articulated pose of hands in the image are predicted using an image encoder.

Data

The data can be downloaded from the link below:
Hand Reconstruction Data

To access the data, please, contact me using the email address provided in the paper.

The data directory should be placed in the root of the project structure.

./data/datasets/hand-panoptic - Training data for the image-to-mesh system.
./data/datasets/mesh-samples - Data for pretraining the mesh autoencoder.
./data/models/i2m - The image-to-mesh network.
./data/models/spectral-ae - Spectral autoencoder.
./data/template - Hand template and mesh convolutions operators.

Requirements

Python 3.6.7
Tensorflow 1.14.0
NumPy
SciPy

Visualization:
Matplotlib
OpenCV

Optional:
For generating convolution and sampling operators: COMA
For visualizing the latent space as shown in the screenshot below: traits, mayavi

Running the code

Testing:

./evaluation/spectral_ae.ipynb - Example of running the trained spectral autoencoder and visualizing the output.
./evaluation/i2m.ipynb - Example of running the trained image-to-mesh system and visualizing the output.

Training:

./training/spectral/method/train_spectral_ae.py - Code for training the spectral autoencoder.
./training/i2m/method/train_i2m_spectral_densenet.py - Code for training the image to mesh system.

License

If you use the code, please, make sure you are familiar with the LICENSE and cite our paper.

Single Image 3D Hand Reconstruction with Mesh Convolutions

@inproceedings{dkulon2019rec,
author = {Dominik Kulon and
Haoyang Wang and
Riza Alp G{\"{u}}ler and
Michael M. Bronstein and
Stefanos Zafeiriou},
title = {Single Image 3D Hand Reconstruction with Mesh Convolutions},
booktitle = {Proceedings of the British Machine Vision Conference ({BMVC})},
year = {2019}
}

The training images come from the CMU Panoptic Dataset, training meshes are derivatives of MANO, and the mesh autoencoder architecture is based on COMA.

peterzs / hand-reconstruction Goto Github PK