https://github.com/chris10m/eventego3d
EventEgo3D: 3D Human Motion Capture from Egocentric Event Streams [CVPR'24]
Science Score: 23.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
✓codemeta.json file
Found codemeta.json file -
○.zenodo.json file
-
○DOI references
-
✓Academic publication links
Links to: arxiv.org -
○Academic email domains
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (10.4%) to scientific vocabulary
Keywords
Repository
EventEgo3D: 3D Human Motion Capture from Egocentric Event Streams [CVPR'24]
Basic Info
- Host: GitHub
- Owner: Chris10M
- License: other
- Language: Python
- Default Branch: master
- Homepage: https://4dqv.mpi-inf.mpg.de/EventEgo3D
- Size: 21.1 MB
Statistics
- Stars: 10
- Watchers: 2
- Forks: 2
- Open Issues: 0
- Releases: 0
Topics
Metadata Files
README.md
🚀 EventEgo3D++ (IJCV) is now released!
Our latest version offers improved performance for in-the-wild egocentric event streams, complete with SMPL body annotations and synchronised multi-view RGB images. 🔗 Check out the project page for more details and downloads.
EventEgo3D: 3D Human Motion Capture from Egocentric Event Streams [CVPR'24]
Official PyTorch implementation
Abstract
Monocular egocentric 3D human motion capture is a challenging and actively researched problem. Existing methods use synchronously operating visual sensors (e.g. RGB cameras) and often fail under low lighting and fast motions, which can be restricting in many applications involving head-mounted devices. In response to the existing limitations, this paper 1) introduces a new problem, i.e. 3D human motion capture from an egocentric monocular event camera with a fisheye lens, and 2) proposes the first approach to it called EventEgo3D (EE3D). Event streams have high temporal resolution and provide reliable cues for 3D human motion capture under high-speed human motions and rapidly changing illumination. The proposed EE3D framework is specifically tailored for learning with event streams in the LNES representation, enabling high 3D reconstruction accuracy. We also design a prototype of a mobile head-mounted device with an event camera and record a real dataset with event observations and the ground-truth 3D human poses (in addition to the synthetic dataset). Our EE3D demonstrates robustness and superior 3D accuracy compared to existing solutions across various challenging experiments while supporting real-time 3D pose update rates of 140Hz.
Advantages of Event Based Vision
High Speed Motion | Low Light Performance
:-------------------------:|:-------------------------:|
|
|
|
EventEgo3D
Usage
- EventEgo3D: 3D Human Motion Capture from Egocentric Event Streams [CVPR'24]
- Official PyTorch implementation
- Abstract
- Advantages of Event Based Vision
- EventEgo3D
- Usage
- Installation
- Datasets
- Training
- Evaluation
- Citation
- License
- Acknowledgements
Installation
Clone the repository
bash
git clone https://github.com/Chris10M/EventEgo3D.git
cd EventEgo3D
Dependencies
Create a conda enviroment from the file
bash
conda env create -f EventEgo3D.yml
Next, install ocam_python using pip
bash
pip3 install git+https://github.com/Chris10M/ocam_python.git
Pretrained Model
The pretrained model best_model_state_dict.pth can be found here. Please place the model in the following folder structure.
bash
EventEgo3D
|
└── saved_models
|
└── best_model_state_dict.pth
Datasets
The datasets can obtained by executing the files in dataset_scripts. For detailed information, refer here.
Training
For training, ensure EE3D-S, EE3D-R and EE3D[BG-AUG] are present.
The batch size and checkpoint path can be specified with the following environment variables, BATCH_SIZE and CHECKPOINT_PATH.
bash
python train.py
Evaluation
EE3D-S
For evaluation, ensure EE3D-S Test is present. Please run,
bash
python evaluate_ee3d_s.py
The provided pretrained checkpoint gives us an accuracy of,
| Arch | HeadMPJPE | NeckMPJPE | RightshoulderMPJPE | RightelbowMPJPE | RightwristMPJPE | LeftshoulderMPJPE | LeftelbowMPJPE | LeftwristMPJPE | RighthipMPJPE | RightkneeMPJPE | RightankleMPJPE | RightfootMPJPE | LefthipMPJPE | LeftkneeMPJPE | LeftankleMPJPE | LeftfootMPJPE | MPJPE | HeadPAMPJPE | NeckPAMPJPE | RightshoulderPAMPJPE | RightelbowPAMPJPE | RightwristPAMPJPE | LeftshoulderPAMPJPE | LeftelbowPAMPJPE | LeftwristPAMPJPE | RighthipPAMPJPE | RightkneePAMPJPE | RightanklePAMPJPE | RightfootPAMPJPE | LefthipPAMPJPE | LeftkneePAMPJPE | LeftanklePAMPJPE | LeftfootPAMPJPE | PAMPJPE | |---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---| | EgoHPE | 29.020 | 44.788 | 51.028 | 98.415 | 144.434 | 53.148 | 103.996 | 141.923 | 91.309 | 146.183 | 210.144 | 224.728 | 87.292 | 141.563 | 210.710 | 219.027 | 124.857 | 50.010 | 47.727 | 50.475 | 86.859 | 131.602 | 53.526 | 90.658 | 127.851 | 74.953 | 98.317 | 116.803 | 129.032 | 75.543 | 96.434 | 119.562 | 132.058 | 92.588 |
EE3D-R
For evaluation, ensure EE3D-R is present. Please run,
bash
python evaluate_ee3d_r.py
The provided pretrained checkpoint gives us an accuracy of,
| Arch | walkMPJPE | crouchMPJPE | pushupMPJPE | boxingMPJPE | kickMPJPE | danceMPJPE | inter. with envMPJPE | crawlMPJPE | sportsMPJPE | jumpMPJPE | MPJPE | walkPAMPJPE | crouchPAMPJPE | pushupPAMPJPE | boxingPAMPJPE | kickPAMPJPE | dancePAMPJPE | inter. with envPAMPJPE | crawlPAMPJPE | sportsPAMPJPE | jumpPAMPJPE | PAMPJPE | |---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---| | EgoHPE | 70.881 | 163.840 | 97.886 | 136.571 | 103.724 | 88.877 | 103.191 | 109.714 | 101.020 | 97.320 | 107.302 | 52.113 | 99.483 | 75.530 | 104.667 | 86.055 | 71.968 | 70.859 | 77.949 | 77.827 | 80.179 | 79.663 |
Citation
If you find this code useful for your research, please cite our paper:
@inproceedings{Millerdurai_EventEgo3D_2024,
title={EventEgo3D: 3D Human Motion Capture from Egocentric Event Streams},
author={Christen Millerdurai and Hiroyasu Akada and Jian Wang and Diogo Luvizon and Christian Theobalt and Vladislav Golyanik},
booktitle = {Computer Vision and Pattern Recognition (CVPR)},
year={2024}
}
License
EventEgo3D is under CC-BY-NC 4.0 license. The license also applies to the pre-trained models.
Acknowledgements
The code is partially adapted from here.
Owner
- Name: Christen Millerdurai
- Login: Chris10M
- Kind: user
- Repositories: 25
- Profile: https://github.com/Chris10M
PhD & Researcher @ AV DFKI-Kaiserslautern.
GitHub Events
Total
- Issues event: 2
- Watch event: 6
Last Year
- Issues event: 2
- Watch event: 6