Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add equidistant distortion model #160

Merged
merged 1 commit into from
Nov 12, 2021

Conversation

mintar
Copy link
Contributor

@mintar mintar commented Nov 12, 2021

This is a forward-port from ROS1 noetic:

ros/common_msgs#109

This PR brings the ROS2 list of supported distortion models back into sync with ROS Noetic and is required to forward-port support for this model in vision_opencv:

ros-perception/vision_opencv#358


Background info

The model is based on the following publication:

J. Kannala and S. Brandt (2006). A Generic Camera Model and Calibration Method for Conventional, Wide-Angle, and Fish-Eye Lenses, IEEE Transactions on Pattern Analysis and Machine Intelligence, vol. 28, no. 8, pp. 1335-1340

There are many different names for this distortion model:

All of these are just different names for the same model.

This is a forward-port from ROS1 noetic:

ros/common_msgs#109

The model is based on the following publication:

J. Kannala and S. Brandt (2006). A Generic Camera Model and Calibration
Method for Conventional, Wide-Angle, and Fish-Eye Lenses, IEEE
Transactions on Pattern Analysis and Machine Intelligence, vol. 28, no.
8, pp. 1335-1340

There are many different names for this distortion model:

* Kannala and Brandt call it "Generic Camera Model". Sometimes they also
  call it "equidistance projection model".
* Kalibr calls it "equidistant": https://github.com/ethz-asl/kalibr/wiki/supported-models
* Camodocal calls it "kannala-brandt": https://github.com/hengli/camodocal
* OpenCV calls it "fisheye": https://stackoverflow.com/a/34309644/3036576

All of these are just different names for the same model.

Signed-off-by: Martin Günther <martin.guenther@dfki.de>
Copy link
Contributor

@clalancette clalancette left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me!

@clalancette
Copy link
Contributor

CI:

  • Linux Build Status
  • Linux-aarch64 Build Status
  • macOS Build Status
  • Windows Build Status

@clalancette clalancette merged commit f22c436 into ros2:master Nov 12, 2021
@mintar mintar deleted the add_equidistant_distortion branch November 22, 2021 10:42
@mintar
Copy link
Contributor Author

mintar commented Nov 22, 2021

Thanks for merging this so quickly, @clalancette ! What about #161?

@clalancette
Copy link
Contributor

@Mergifyio backport foxy galactic

mergify bot pushed a commit that referenced this pull request Nov 30, 2021
This is a forward-port from ROS1 noetic:

ros/common_msgs#109

The model is based on the following publication:

J. Kannala and S. Brandt (2006). A Generic Camera Model and Calibration
Method for Conventional, Wide-Angle, and Fish-Eye Lenses, IEEE
Transactions on Pattern Analysis and Machine Intelligence, vol. 28, no.
8, pp. 1335-1340

There are many different names for this distortion model:

* Kannala and Brandt call it "Generic Camera Model". Sometimes they also
  call it "equidistance projection model".
* Kalibr calls it "equidistant": https://github.com/ethz-asl/kalibr/wiki/supported-models
* Camodocal calls it "kannala-brandt": https://github.com/hengli/camodocal
* OpenCV calls it "fisheye": https://stackoverflow.com/a/34309644/3036576

All of these are just different names for the same model.

Signed-off-by: Martin Günther <martin.guenther@dfki.de>
(cherry picked from commit f22c436)
mergify bot pushed a commit that referenced this pull request Nov 30, 2021
This is a forward-port from ROS1 noetic:

ros/common_msgs#109

The model is based on the following publication:

J. Kannala and S. Brandt (2006). A Generic Camera Model and Calibration
Method for Conventional, Wide-Angle, and Fish-Eye Lenses, IEEE
Transactions on Pattern Analysis and Machine Intelligence, vol. 28, no.
8, pp. 1335-1340

There are many different names for this distortion model:

* Kannala and Brandt call it "Generic Camera Model". Sometimes they also
  call it "equidistance projection model".
* Kalibr calls it "equidistant": https://github.com/ethz-asl/kalibr/wiki/supported-models
* Camodocal calls it "kannala-brandt": https://github.com/hengli/camodocal
* OpenCV calls it "fisheye": https://stackoverflow.com/a/34309644/3036576

All of these are just different names for the same model.

Signed-off-by: Martin Günther <martin.guenther@dfki.de>
(cherry picked from commit f22c436)
@mergify
Copy link

mergify bot commented Nov 30, 2021

backport foxy galactic

✅ Backports have been created

jacobperron pushed a commit that referenced this pull request Dec 2, 2021
This is a forward-port from ROS1 noetic:

ros/common_msgs#109

The model is based on the following publication:

J. Kannala and S. Brandt (2006). A Generic Camera Model and Calibration
Method for Conventional, Wide-Angle, and Fish-Eye Lenses, IEEE
Transactions on Pattern Analysis and Machine Intelligence, vol. 28, no.
8, pp. 1335-1340

There are many different names for this distortion model:

* Kannala and Brandt call it "Generic Camera Model". Sometimes they also
  call it "equidistance projection model".
* Kalibr calls it "equidistant": https://github.com/ethz-asl/kalibr/wiki/supported-models
* Camodocal calls it "kannala-brandt": https://github.com/hengli/camodocal
* OpenCV calls it "fisheye": https://stackoverflow.com/a/34309644/3036576

All of these are just different names for the same model.

Signed-off-by: Martin Günther <martin.guenther@dfki.de>
(cherry picked from commit f22c436)

Co-authored-by: Martin Günther <martin.guenther@dfki.de>
clalancette pushed a commit that referenced this pull request Dec 6, 2021
This is a forward-port from ROS1 noetic:

ros/common_msgs#109

The model is based on the following publication:

J. Kannala and S. Brandt (2006). A Generic Camera Model and Calibration
Method for Conventional, Wide-Angle, and Fish-Eye Lenses, IEEE
Transactions on Pattern Analysis and Machine Intelligence, vol. 28, no.
8, pp. 1335-1340

There are many different names for this distortion model:

* Kannala and Brandt call it "Generic Camera Model". Sometimes they also
  call it "equidistance projection model".
* Kalibr calls it "equidistant": https://github.com/ethz-asl/kalibr/wiki/supported-models
* Camodocal calls it "kannala-brandt": https://github.com/hengli/camodocal
* OpenCV calls it "fisheye": https://stackoverflow.com/a/34309644/3036576

All of these are just different names for the same model.

Signed-off-by: Martin Günther <martin.guenther@dfki.de>
(cherry picked from commit f22c436)

Co-authored-by: Martin Günther <martin.guenther@dfki.de>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants