ldpk
Public Types | Public Member Functions | List of all members
ldpk::generic_anamorphic_distortion< VEC2, MAT2, N > Class Template Reference

A polynomial distortion model for anamorphic distortion without decntering. N is the degree of the polynomial, even. VEC2 is a float-valued, two-component vector type. The model has the following properties: More...

#include <ldpk_generic_anamorphic_distortion.h>

Inheritance diagram for ldpk::generic_anamorphic_distortion< VEC2, MAT2, N >:
Inheritance graph
[legend]
Collaboration diagram for ldpk::generic_anamorphic_distortion< VEC2, MAT2, N >:
Collaboration graph
[legend]

Public Types

typedef generic_distortion_base< VEC2, MAT2,(N+2)*(N+4)/4-2 > base_type
 
typedef VEC2 vec2_type
 

Public Member Functions

double get_coeff (int i) const
 Get coefficient as demanded by base class.
 
void set_coeff (int i, double q)
 Set coefficient as demanded by base class.
 
double cx (int i_phi, int i_r) const
 x-direction
 
void cx (int i_phi, int i_r, double c)
 
double cy (int i_phi, int i_r) const
 y-direction
 
void cy (int i_phi, int i_r, double c)
 
vec2_type operator() (const vec2_type &p_dn) const
 As usual, we define the distortion mapping in diagonally normalized coordinates, (hence the suffix _dn). The operator expects, that p_dn is already shifted so that the lens center is (0,0).
 
void derive (double *dg, int n_parameters, const vec2_type &p_dn) const
 Derivative wrt distortion coefficients. For performance reasons we calculate all derivatives simultaneously. g points to an array with (N / 2 + 1) * (N / 2 + 2) - 2 Elements. That is 4 for N=2, 10 for N=4, 18 for N=6.
 
std::ostream & out (std::ostream &cout) const
 The derived class implements a method for printing values inside 3DE4's matrix tool dialog. This functionality is currently not supported by tde4_ld_plugin.
 
- Public Member Functions inherited from ldpk::generic_distortion_base< VEC2, MAT2,(N+2)*(N+4)/4-2 >
int get_num_parameters () const
 Number of parameters, that is N.
 
void setup_map_inverse (int n_max_iter, int n_post_iter, double epsilon)
 Configure iterative procedure for map_inverse(). Call this, if you don't agree with the default values.
 
virtual void done ()
 After changing one or more coefficients of the model, call this (future use). The derived class may prepare some data structure for fast/precise evalutation..
 
int get_n_max_iter () const
 User-defined maximum number of iterations applied in map_inverse in order to fulfill the termination condition.
 
int get_n_post_iter () const
 User-defined number of additional iterations to be applied when the termination condition is fulfilled (which we call post-iterations).
 
vec2_type eval (const vec2_type &p) const
 Same as method instead of operator.
 
virtual mat2_type jacobi (const vec2_type &p_dn) const
 Jacobi-Matrix. The result is a matrix g_{ij} = d/dp_j f(p)_i, where f represents the undistort-function. We compute this by means of difference quotients. This requires four evaluations. For better performance, you can implement the analytic form in your derived distortion class.
 
virtual vec2_type map_inverse (const vec2_type &q) const
 Inverse mapping by solving the fixed point equation without providing initial values. Virtual, because the derived class might use some smart data structure for calculating an initial value.
 
vec2_type map_inverse (const vec2_type &q, const vec2_type &p_start) const
 For given q, we are looking for p so that f(p) = q. p_start is near to p.
 

Additional Inherited Members

- Protected Member Functions inherited from ldpk::generic_distortion_base< VEC2, MAT2,(N+2)*(N+4)/4-2 >
void check_range (int i) const
 A derived class may check if the index is valid.
 

Detailed Description

template<class VEC2, class MAT2, int N>
class ldpk::generic_anamorphic_distortion< VEC2, MAT2, N >

A polynomial distortion model for anamorphic distortion without decntering. N is the degree of the polynomial, even. VEC2 is a float-valued, two-component vector type. The model has the following properties:


The documentation for this class was generated from the following file: