CatadioptricCamera

class CatadioptricCamera(k: float | None = None, projection: str = 'equiangular', maxangle: float | None = None, **kwargs)

Create catadioptric camera projection model

Parameters:

• k (float, optional) – scale factor

• projection (str, optional) – projection model: 'equiangular' [default], 'sine', 'equisolid' or 'stereographic'

• kwargs – arguments passed to CameraBase constructor

A catadioptric camera comprises a perspective camera pointed at a convex mirror, typically paraboloidal or conical.

The elevation angle range is from \(-\pi/2\) (below the mirror) to maxangle above the horizontal plane. The mapping from elevation angle \(\theta\) to image plane radius is given by:

Projection	\(r(\theta)\)
equiangular	\(r = k \theta\)
sine	\(r = k \sin \theta\)
equisolid	\(r = k \sin \frac{\theta}{2}\)
stereographic	\(r = k \tan \frac{\theta}{2}\)

Note

• If K is not specified it is computed such that the circular imaging region maximally fills the image plane.

• This camera model assumes central projection, that is, the focal point is at \(z=0\) and the image plane is at \(z=f\). The image is not inverted.

References:

• P. Corke, Robotics, Vision & Control for Python, Springer, 2023, Section 13.3.2.

Seealso:

CameraBase CentralCamera FishEyeCamera SphericalCamera

Methods

clf	Clear the virtual image plane (base method)
disp	Display image on virtual image plane (base method)
move	Move camera (base method)
plot	Plot 3D camera icon in world view (base method)
plot_line2	Plot 2D line on virtual image plane (base method)
plot_point	Plot points on virtual image plane (base method)
plot_wireframe	Plot 3D wireframe in virtual image plane (base method)
project_conic
project_line
project_point	Project 3D points to image plane
reset	Reset camera pose (base method)

Attributes

camtype	Set/get camera type (base method)
distortion	Set/Get distortion model (base method)
height	Get image plane height (base method)
imagesize	Set/get size of virtual image plane (base method)
k
name	Set/get camera name (base method)
noise	Set/Get projection noise (base method)
nu	Get image plane width (base method)
nv	Get image plane height (base method)
pose	Set/get camera pose (base method)
pp	Set/get principal point coordinate (base method)
projection
rfunc
rho	Get pixel dimensions (base method)
rhou	Get pixel width (base method)
rhov	Get pixel width (base method)
u0	Get principal point: horizontal coordinate (base method)
v0	Get principal point: vertical coordinate (base method)
width	Get image plane width (base method)