3D Human Shape Models
C++ C Matlab Other
Switch branches/tags
Nothing to show
Clone or download
Leonid Pishchulin
Latest commit 52ddec5 Oct 29, 2016


HUMANSHAPE - 3D Human Shape Modeling, Fitting and Evaluation

This short documentation describes steps necessary to compile and run the 3D human body shape building, manipulation, fitting and evaluation presented in the paper:

Leonid Pishchulin, Stefanie Wuhrer, Thomas Helten, Christian Theobalt and Bernt Schiele
Building Statistical Shape Spaces for 3D Human Modeling In ArXiv, March 2015



This code was developed under Linux (Debian wheezy, 64 bit) and was tested only in this environment.

  1. Set MATLAB_HOME in following make files:

  2. Switch to the top level directory of the source code, issue make from the command line

Getting the models

  1. Download the models
    wget http://datasets.d2.mpi-inf.mpg.de/humanshape/caesar.zip
    wget http://datasets.d2.mpi-inf.mpg.de/humanshape/caesar-norm-wsx.zip
    wget http://datasets.d2.mpi-inf.mpg.de/humanshape/caesar-norm-nh.zip
  1. Unzip the models
    unzip caesar.zip && rm -f caesar.zip
    unzip caesar-norm-wsx.zip && rm -f caesar-norm-wsx.zip
    unzip caesar-norm-nh.zip && rm -f caesar-norm-nh.zip

Getting the fitted meshes

  1. Download the fitted meshes
    wget http://datasets.d2.mpi-inf.mpg.de/humanshape/caesar-fitted-meshes.zip
    wget http://datasets.d2.mpi-inf.mpg.de/humanshape/caesar-norm-wsx-fitted-meshes.zip
    wget http://datasets.d2.mpi-inf.mpg.de/humanshape/caesar-norm-nh-fitted-meshes.zip
  1. Unzip the fitted meshes
    unzip caesar-fitted-meshes.zip && rm -f caesar-fitted-meshes.zip
    unzip caesar-norm-wsx-fitted-meshes.zip && rm -f caesar-norm-wsx-fitted-meshes.zip
    unzip caesar-norm-nh-fitted-meshes.zip && rm -f caesar-norm-nh-fitted-meshes.zip


  1. Start matlab
  2. Edit file fitting/expParams.m
    1. point p.rootDir to the full path to the source code directory
    2. point p.modelInDir to the model directory, e.g. caesar/
  3. Run demo


Add evaluation code for

  1. Per-vertex mean fitting accuracy
  2. Total fitting accuracy
  3. Compactness, generalization and specificity

If you have any questions, send an email to leonid@mpi-inf.mpg.de with a topic "humanshape".