Skip to content

Commit 552d34e

Browse files
authored
Revise README for clarity and updates
Updated README to reflect changes in project description, citation format, and demo section.
1 parent 7434f42 commit 552d34e

1 file changed

Lines changed: 23 additions & 15 deletions

File tree

README.md

Lines changed: 23 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
# FMPose3D: monocular 3D pose estimation via flow matching
22

33
![Version](https://img.shields.io/badge/python_version-3.10-purple)
4-
[![PyPI version](https://badge.fury.io/py/fmpose3d.svg)](https://badge.fury.io/py/fmpose3d)
4+
[![PyPI version](https://badge.fury.io/py/fmpose3d.svg?icon=si%3Apython)](https://badge.fury.io/py/fmpose3d)
55
[![License: LApache 2.0](https://img.shields.io/badge/License-Apache2.0-blue.svg)](https://www.gnu.org/licenses/apach2.0)
66

7-
This is the official implementation of the approach described in the paper:
7+
This is the official implementation of the approach described in the preprint:
88

9-
[**FMPose3D: monocular 3D Pose Estimation via Flow Matching**](xxx)
9+
[**FMPose3D: monocular 3D pose estimation via flow matching**](http://arxiv.org/abs/2602.05755)
1010
Ti Wang, Xiaohang Yu, Mackenzie Weygandt Mathis
1111

1212
<!-- <p align="center"><img src="./images/Frame 4.jpg" width="50%" alt="" /></p> -->
@@ -15,13 +15,13 @@ Ti Wang, Xiaohang Yu, Mackenzie Weygandt Mathis
1515

1616
## 🚀 TL;DR
1717

18-
FMPose3D replaces slow diffusion models for monocular 3D pose estimation with fast Flow Matching, generating multiple plausible 3D poses via an ODE in just a few steps, then aggregates them using a reprojection-based Bayesian module (RPEA) for accurate predictions, achieving state-of-the-art results on human and animal 3D pose benchmarks.
18+
FMPose3D creates a 3D pose from a single 2D image. It leverages fast Flow Matching, generating multiple plausible 3D poses via an ODE in just a few steps, then aggregates them using a reprojection-based Bayesian module (RPEA) for accurate predictions, achieving state-of-the-art results on human and animal 3D pose benchmarks.
1919

2020

2121

2222
## News!
2323

24-
- [X] Feb 2026: FMPose3D code and arXiv paper is released - check out the demos here or on our [project page](https://xiu-cs.github.io/FMPose3D/)
24+
- [X] Feb 2026: the FMPose3D code and our arXiv paper is released - check out the demos here or on our [project page](https://xiu-cs.github.io/FMPose3D/)
2525
- [ ] Planned: This method will be integrated into [DeepLabCut](https://www.mackenziemathislab.org/deeplabcut)
2626

2727
## Installation
@@ -32,17 +32,11 @@ Make sure you have Python 3.10+. You can set this up with:
3232
```bash
3333
conda create -n fmpose_3d python=3.10
3434
conda activate fmpose_3d
35-
```
36-
<!-- test version -->
37-
```bash
38-
git clone https://github.com/AdaptiveMotorControlLab/FMPose3D.git
39-
# TestPyPI (pre-release/testing build)
40-
pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ fmpose3d==0.0.7
41-
# Future Official PyPI release
42-
# pip install fmpose3d
35+
36+
pip install fmpose3d
4337
```
4438

45-
## Demo
39+
## Demos
4640

4741
### Testing on in-the-wild images (humans)
4842

@@ -98,10 +92,24 @@ To run inference on Human3.6M:
9892
sh ./scripts/FMPose3D_test.sh
9993
```
10094

101-
## Experiments Animals
95+
## Experiments on non-human animals
10296

10397
For animal training/testing and demo scripts, see [animals/README.md](animals/README.md).
10498

99+
## Citation
100+
101+
```
102+
@misc{wang2026fmpose3dmonocular3dpose,
103+
title={FMPose3D: monocular 3D pose estimation via flow matching},
104+
author={Ti Wang and Xiaohang Yu and Mackenzie Weygandt Mathis},
105+
year={2026},
106+
eprint={2602.05755},
107+
archivePrefix={arXiv},
108+
primaryClass={cs.CV},
109+
url={https://arxiv.org/abs/2602.05755},
110+
}
111+
```
112+
105113
## Acknowledgements
106114

107115
We thank the Swiss National Science Foundation (SNSF Project # 320030-227871) and the Kavli Foundation for providing financial support for this project.

0 commit comments

Comments
 (0)