The toolkit demo have been tested in python 3.6 in Ubuntu. We recommend to create an environment using Anaconda:
conda create -n facescape python=3.6 -y
conda activate facescape
Install required packages
pip install -r requirements.txt
conda install jupyter -y # for running in local jupyter
conda install nb_conda_kernels -y # enable notebook kernels
Then you can view demos locally by starting jupter notebook:
jupyter notebook
Run the following script to download sample data:
cd samples/ && ./download_sample.sh
The links below use an external jupyter renderer, because github often fails to render jupyter notebook online.
- bilinear_model-basic - use facescape bilinear model to generate 3D mesh models.
- bilinear_model-fit - fit the bilinear model to 2D/3D landmarks.
- multi-view-project - Project 3D models to multi-view images.
- landmark - extract landmarks using predefined vertex index.
- facial_mask - extract facial region from the full head TU-models.
- render - render TU-models to color images and depth map.
- alignment - align all the multi-view models.
- symmetry - get the correspondence of the vertices on TU-models from left side to right side.
- rig - rig 20 expressions to 52 expressions.