IMUPoser
IMUPoser copied to clipboard
Code for IMUPoser: Full-Body Pose Estimation using IMUs in Phones, Watches, and Earbuds
IMUPoser: Full-Body Pose Estimation using IMUs in Phones, Watches, and Earbuds
Click to watch the video!
Research code for IMUPoser (CHI 2023)
Reference
Vimal Mollyn, Riku Arakawa, Mayank Goel, Chris Harrison, and Karan Ahuja. 2023. IMUPoser: Full-Body Pose Estimation using IMUs in Phones, Watches, and Earbuds. In Proceedings of the 2023 CHI Conference on Human Factors in Computing Systems (CHI '23). Association for Computing Machinery, New York, NY, USA, Article 529, 1–12.
BibTeX Reference:
@inproceedings{10.1145/3544548.3581392,
author = {Mollyn, Vimal and Arakawa, Riku and Goel, Mayank and Harrison, Chris and Ahuja, Karan},
title = {IMUPoser: Full-Body Pose Estimation Using IMUs in Phones, Watches, and Earbuds},
year = {2023},
isbn = {9781450394215},
publisher = {Association for Computing Machinery},
address = {New York, NY, USA},
url = {https://doi.org/10.1145/3544548.3581392},
doi = {10.1145/3544548.3581392},
booktitle = {Proceedings of the 2023 CHI Conference on Human Factors in Computing Systems},
articleno = {529},
numpages = {12},
keywords = {sensors, inertial measurement units, mobile devices, Motion capture},
location = {Hamburg, Germany},
series = {CHI '23}
}
1. Clone (or Fork!) this repository
git clone https://github.com/FIGLAB/IMUPoser.git
2. Create a virtual environment
We recommend using conda. Tested on Ubuntu 18.04
, with python 3.7
.
conda create -n "imuposer" python=3.7
conda activate imuposer
conda install pytorch==1.12.1 torchvision==0.13.1 torchaudio==0.12.1 cudatoolkit=10.2 -c pytorch
python -m pip install -r requirements.txt
python -m pip install -e src/
3. Download training data
data
└── raw
├── AMASS
│ ├── ACCAD
│ ├── BioMotionLab_NTroje
│ ├── BMLhandball
│ ├── BMLmovi
│ ├── CMU
│ ├── DanceDB
│ ├── DFaust_67
│ ├── EKUT
│ ├── Eyes_Japan_Dataset
│ ├── HUMAN4D
│ ├── HumanEva
│ ├── KIT
│ ├── MPI_HDM05
│ ├── MPI_Limits
│ ├── MPI_mosh
│ ├── SFU
│ ├── SSM_synced
│ ├── TCD_handMocap
│ ├── TotalCapture
│ └── Transitions_mocap
├── DIP_IMU
│ ├── s_01
│ ├── s_02
│ ├── s_03
│ ├── s_04
│ ├── s_05
│ ├── s_06
│ ├── s_07
│ ├── s_08
│ ├── s_09
│ └── s_10
└── README.md
4. Training Steps
- Start by preprocessing the AMASS and DIP-IMU datasets scripts/1. Preprocessing. Run all files in order.
- Train the model scripts/2. Train/run_combos.sh
Disclaimer
THE PROGRAM IS DISTRIBUTED IN THE HOPE THAT IT WILL BE USEFUL, BUT WITHOUT ANY WARRANTY. IT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW THE AUTHOR WILL BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Acknowledgments
Some of the modules in this repo were inspired by the amazing TransPose github repo.
License
The IMUPoser code can only be used for research i.e., non-commercial purposes. For a commercial license, please contact Vimal Mollyn, Karan Ahuja and Chris Harrison.
Contact
Feel free to contact Vimal Mollyn for any help, questions or general feedback!