Skip to content

gjgjh/PTZ-Calib

Repository files navigation

PTZ-Calib

PTZ-Calib is a robust two-stage PTZ camera calibration method, that efficiently and accurately estimates camera parameters for arbitrary viewpoints. Our method includes an offline and an online stage. In the offline stage, we first uniformly select a set of reference images that sufficiently overlap to encompass a complete 360◦ view. We then utilize the novel PTZ-IBA (PTZ Incremental Bundle Adjustment) algorithm to automatically calibrate the cameras within a local coordinate system. Additionally, for practical application, we can further optimize camera parameters and align them with the geographic coordinate system using extra global reference 3D information. In the online stage, we formulate the calibration of any new viewpoints as a relocalization problem.

Pipeline of the two-stage PTZ-Calib method

Build

The program is compiled in an Ubuntu 20.04 environment with g++ 9.4.0. You can use the following scripts to install dependencies and compile the program separately.

# Install dependencies
bash install_deps.sh install_all_deps

# Build program
bash build.sh

Dataset download

You can download both Synthetic and WorldCup14 Dataset from this link. Note that we only use a subset of the original WorldCup14 Dataset in our experiment. The urban scene dataset used in the paper is temporarily unavailable due to data security and other concerns.

Run PTZ-BA (offline-stage)

We provide run_ptzba_synthetic.sh and run_ptzba_worldcup14.sh for batch running PTZ-BA on two datasets. You can check the scripts for more details.

Run PTZ-Reloc (online-stage)

We provide run_reloc_synthetic.sh and run_reloc_worldcup14.sh for batch running PTZ-Reloc on two datasets. You can check the scripts for more details.

Citation

If you use any of this code, please cite our paper. This paper was accepted by ICRA 2025.

@inproceedings{guo2025ptzcalib,
  author       = {Guo, Jinhui and Fan, Lubin and Wu, Bojian and Gu, Jiaqi and Cao, Shen and Ye, Jieping},
  title        = {PTZ-Calib: Robust Pan-Tilt-Zoom Camera Calibration},
  booktitle    = {2025 IEEE International Conference on Robotics and Automation (ICRA)},
  year         = {2025},
  pages        = {1907-1913},
  doi          = {10.1109/ICRA55743.2025.11128129}
}

About

[ICRA 2025] PTZ-Calib: Robust Pan-Tilt-Zoom Camera Calibration

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published