Skip to content

Latest commit

 

History

History
80 lines (61 loc) · 2.03 KB

installation-docker.md

File metadata and controls

80 lines (61 loc) · 2.03 KB
Raw

Getting started

Start by cloning the repo:

git clone git@github.com:YuliangXiu/ECON.git
cd ECON

Environment

  • GPU Memory > 12GB

start with docker compose

# you can change your container name by passing --name "parameter" 
docker compose run [--name myecon] econ

Docker container's shell

# activate the pre-build env
cd code
conda activate econ

# install libmesh & libvoxelize
cd lib/common/libmesh
python setup.py build_ext --inplace
cd ../libvoxelize
python setup.py build_ext --inplace

Register at ICON's website

Register Required:

  • SMPL: SMPL Model (Male, Female)
  • SMPL-X: SMPL-X Model, used for training
  • SMPLIFY: SMPL Model (Neutral)
  • PIXIE: PIXIE SMPL-X estimator

⚠️ Click Register now on all dependencies, then you can download them all with ONE account.

Downloading required models and extra data

cd ~/code
bash fetch_data.sh # requires username and password

🐋 todo

  • Image Environment Infos
    • Ubuntu 18
    • CUDA = 11.3
    • Python = 3.8
  • pre-built image with docker compose
  • docker run command, Dockerfile
  • verify on WSL (Windows)

Citation

👍 Please consider citing these awesome HPS approaches: PyMAF-X, PIXIE

@article{pymafx2022,
  title={PyMAF-X: Towards Well-aligned Full-body Model Regression from Monocular Images},
  author={Zhang, Hongwen and Tian, Yating and Zhang, Yuxiang and Li, Mengcheng and An, Liang and Sun, Zhenan and Liu, Yebin},
  journal={arXiv preprint arXiv:2207.06400},
  year={2022}
}


@inproceedings{PIXIE:2021,
  title={Collaborative Regression of Expressive Bodies using Moderation},
  author={Yao Feng and Vasileios Choutas and Timo Bolkart and Dimitrios Tzionas and Michael J. Black},
  booktitle={International Conference on 3D Vision (3DV)},
  year={2021}
}