# RapidPoseTriangulation

Fast triangulation of multiple persons from multiple camera views. \
A general overview can be found in the paper [RapidPoseTriangulation: Multi-view Multi-person Whole-body Human Pose Triangulation in a Millisecond](https://arxiv.org/pdf/2503.21692).

<div align="center">
    <img src="media/2d-k.jpg" alt="2D detections"" width="65%"/>
    <b>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</b>
    <img src="media/3d-p.jpg" alt="3D detections" width="30%"/>
    <br>
    <br>
    <img src="media/2d-p.jpg" alt="3D to 2D projection" width="95%"/>
</div>

<br>

## Build

- Clone this project:

    ```bash
    git clone https://gitlab.com/Percipiote/RapidPoseTriangulation.git
    cd RapidPoseTriangulation/
    ```

- Enable GPU-access for docker building:

  - Install _nvidia_ container tools: [Link](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html)

  - Run `sudo nano /etc/docker/daemon.json` and add:

    ```json
    {
      "runtimes": {
        "nvidia": {
          "args": [],
          "path": "nvidia-container-runtime"
        }
      },
      "default-runtime": "nvidia"
    }
    ```

  - Restart docker: `sudo systemctl restart docker`

- Build docker container:

  ```bash
  docker build --progress=plain -t rapidposetriangulation .
  ./run_container.sh
  ```

- Build triangulator:

  ```bash
  cd /RapidPoseTriangulation/
  uv sync --group dev
  uv run pytest tests/test_interface.py
  uv build
  ```

<br>

## Extras


<br>

## Citation

Please cite [RapidPoseTriangulation](https://arxiv.org/pdf/2503.21692) if you found it helpful for your research or business.

```bibtex
@article{
  rapidtriang,
  title={{RapidPoseTriangulation: Multi-view Multi-person Whole-body Human Pose Triangulation in a Millisecond}},
  author={Bermuth, Daniel and Poeppel, Alexander and Reif, Wolfgang},
  journal={arXiv preprint arXiv:2503.21692},
  year={2025}
}
```