/humman_toolbox

Toolbox for HuMMan Dataset

Primary LanguagePythonOtherNOASSERTION

Toolbox for HuMMan Dataset

Please visit our Homepage for more details.

Updates

  • [2024-07-27] HuMMan-Recon: Release of depth maps for the Reconstruction Subset
  • [2023-04-25] HuMMan-Recon: Release of manually annotated masks for color images in the test split
  • [2023-02-27] HuMMan-Recon: Downloads are organized by modalities, links have been updated
  • [2023-01-23] HuMMan-Recon: Release of textured meshes for the Reconstruction Subset, and a toolbox
  • [2023-01-23] HuMMan-Recon: Minor fixes on the mask data, download links have been updated
  • [2023-01-11] Release of HuMMan v1.0: Reconstruction Subset (HuMMan-Recon)
  • [2022-10-27] We presented HuMMan as an oral paper at ECCV'22 (Tel Aviv, Israel)
  • [2022-08] Release of HuMMan v0.1 (no longer available, please use v1.0)

Datasets

  • HuMMan-Recon: HuMMan v1.0: Reconstruction Subset (HuMMan-Recon)
  • HuMMan-Point: HuMMan v1.0: 3D Vision Subset (HuMMan-Point, Coming Soon!)
  • HuMMan-MoGen: HuMMan v1.0: Motion Generation Subset (HuMMan-MoGen, Coming Soon!)

Installation

To use our visulization tools, relevant python packages need to be installed.

conda create -n humman python=3.9 -y
conda activate humman
pip install torch==1.12.1 opencv-python==4.10.0.84 smplx==0.1.28 chumpy==0.70 trimesh==4.4.3 tqdm==4.66.4 open3d numpy==1.26.4

Citation

Please cite our work if you find our dataset and tools useful.

@inproceedings{cai2022humman,
  title={{HuMMan}: Multi-modal 4d human dataset for versatile sensing and modeling},
  author={Cai, Zhongang and Ren, Daxuan and Zeng, Ailing and Lin, Zhengyu and Yu, Tao and Wang, Wenjia and Fan, 
          Xiangyu and Gao, Yang and Yu, Yifan and Pan, Liang and Hong, Fangzhou and Zhang, Mingyuan and
          Loy, Chen Change and Yang, Lei and Liu, Ziwei},
  booktitle={17th European Conference on Computer Vision, Tel Aviv, Israel, October 23--27, 2022, 
             Proceedings, Part VII},
  pages={557--577},
  year={2022},
  organization={Springer}
}