#include <ossimLensDistortion.h>

Inheritance diagram for ossimLensDistortion:

Public Member Functions
	ossimLensDistortion (const ossimDpt &callibratedCenter=ossimDpt(0, 0))

void	setCenter (const ossimDpt &center)

const ossimDpt &	getCenter () const

virtual void	forward (const ossimDpt &input, ossimDpt &output) const

virtual void	inverse (const ossimDpt &input, ossimDpt &output)

virtual void	distort (const ossimDpt &input, ossimDpt &output) const

virtual void	undistort (const ossimDpt &input, ossimDpt &output) const =0

virtual bool	saveState (ossimKeywordlist &kwl, const char *prefix=0) const

virtual bool	loadState (const ossimKeywordlist &kwl, const char *prefix=0)

Public Member Functions inherited from ossim2dTo2dTransform
virtual void	forward (ossimDpt &modify_this) const

virtual void	inverse (const ossimDpt &input, ossimDpt &output) const

virtual void	inverse (ossimDpt &modify_this) const

virtual const ossim2dTo2dTransform &	operator= (const ossim2dTo2dTransform &rhs)

virtual ossimDpt	getOrigin () const

virtual std::ostream &	print (std::ostream &out) const
	Generic print method. More...

void	setConvergenceThreshold (const double &new_threshold)

void	setMaxIterations (int new_max_iters)

void	setDxDy (const ossimDpt &dxdy)

Public Member Functions inherited from ossimObject
	ossimObject ()

virtual	~ossimObject ()

virtual ossimObject *	dup () const

virtual ossimString	getShortName () const

virtual ossimString	getLongName () const

virtual ossimString	getDescription () const

virtual ossimString	getClassName () const

virtual RTTItypeid	getType () const

virtual bool	canCastTo (ossimObject *obj) const

virtual bool	canCastTo (const RTTItypeid &id) const

virtual bool	canCastTo (const ossimString &parentClassName) const

virtual bool	isEqualTo (const ossimObject &obj, ossimCompareType compareType=OSSIM_COMPARE_FULL) const

virtual void	accept (ossimVisitor &visitor)

Public Member Functions inherited from ossimReferenced
	ossimReferenced ()

	ossimReferenced (const ossimReferenced &)

ossimReferenced &	operator= (const ossimReferenced &)

void	ref () const
	increment the reference count by one, indicating that this object has another pointer which is referencing it. More...

void	unref () const
	decrement the reference count by one, indicating that a pointer to this object is referencing it. More...

void	unref_nodelete () const
	decrement the reference count by one, indicating that a pointer to this object is referencing it. More...

int	referenceCount () const

Protected Attributes
ossimDpt	theCenter

Protected Attributes inherited from ossim2dTo2dTransform
double	theConvergenceThreshold

int	theMaxIterations

ossimDpt	theDxDy

Additional Inherited Members
Protected Member Functions inherited from ossim2dTo2dTransform
	ossim2dTo2dTransform ()

virtual	~ossim2dTo2dTransform ()

Protected Member Functions inherited from ossimReferenced
virtual	~ossimReferenced ()

Detailed Description

Definition at line 17 of file ossimLensDistortion.h.

Constructor & Destructor Documentation

◆ ossimLensDistortion()

ossimLensDistortion::ossimLensDistortion ( const ossimDpt & callibratedCenter = ossimDpt(0,0) )

inline

Definition at line 20 of file ossimLensDistortion.h.

       :theCenter(callibratedCenter)
    {
    }

Member Function Documentation

◆ distort()

void ossimLensDistortion::distort	(	const ossimDpt &	input,
		ossimDpt &	output
	)		const

virtual

Definition at line 57 of file ossimLensDistortion.cpp.

References DBL_EPSILON, ossim2dTo2dTransform::theConvergenceThreshold, ossim2dTo2dTransform::theMaxIterations, ossimDpt::u, undistort(), ossimDpt::v, ossimDpt::x, and ossimDpt::y.

Referenced by ossimSmacCallibrationSystem::test(), ossimApplanixUtmModel::worldToLineSample(), ossimSpectraboticsRedEdgeModel::worldToLineSample(), and ossimApplanixEcefModel::worldToLineSample().

 {
    int iters = 0;
    
    //***
    // Begin with guess. Forward transform is defined as trasforming left to
    // right. We are therefore solving for left:
    //***
    ossimDpt left (input);
    ossimDpt left_dx;
    ossimDpt left_dy;
    ossimDpt right;
    ossimDpt right_dx;
    ossimDpt right_dy;
    ossimDpt dr_dx;
    ossimDpt dr_dy;
    ossimDpt r_diff;
    ossimDpt l_diff;
    double inverse_norm;
    
    //***
    // Begin iterations:
    //***
    do
    {
       //***
       // establish perturbed image points about the guessed point:
       //***
       left_dx.x = left.x + 1.0;
       left_dx.y = left.y;
       left_dy.x = left.x;
       left_dy.y = left.y + 1.0;
       
       //***
       // Compute numerical partials at current guessed point:
       //***
       undistort(left,    right);
       undistort(left_dx, right_dx);
       undistort(left_dy, right_dy);
       
       dr_dx.x = (right_dx.x - right.x); //e
       dr_dx.y = (right_dx.y - right.y); //g
       dr_dy.x = (right_dy.x - right.x); //f
       dr_dy.y = (right_dy.y - right.y); //h
       
       //***
       // Test for convergence:
       //***
       r_diff = input - right;
       
       //***
       // Compute linearized estimate of image point given gp delta:
       //***
       inverse_norm = dr_dy.u*dr_dx.v - dr_dx.u*dr_dy.v; // fg-eh
       if (std::fabs(inverse_norm) > DBL_EPSILON)
       {
          l_diff.u = (-dr_dy.v*r_diff.u + dr_dy.u*r_diff.v)/inverse_norm;
          l_diff.v = ( dr_dx.v*r_diff.u - dr_dx.u*r_diff.v)/inverse_norm;
          left += l_diff;
       }
       else
       {
          l_diff.u = 0;
          l_diff.v = 0;
       }
       
       iters++;
       
    } while (((fabs(l_diff.u) > theConvergenceThreshold) ||
              (fabs(l_diff.v) > theConvergenceThreshold)) &&
             (iters < theMaxIterations));
    output = left;
 }

◆ forward()

virtual void ossimLensDistortion::forward	(	const ossimDpt &	input,
		ossimDpt &	output
	)		const

inlinevirtual

Implements ossim2dTo2dTransform.

Definition at line 29 of file ossimLensDistortion.h.

    {
       distort(input, output);
    }

◆ getCenter()

const ossimDpt& ossimLensDistortion::getCenter ( ) const

inline

Definition at line 28 of file ossimLensDistortion.h.

28 {return theCenter;}

ossimLensDistortion::theCenter

ossimDpt theCenter

Definition: ossimLensDistortion.h:49

◆ inverse()

virtual void ossimLensDistortion::inverse	(	const ossimDpt &	input,
		ossimDpt &	output
	)

inlinevirtual

Definition at line 34 of file ossimLensDistortion.h.

    {
       undistort(input, output);
    }

◆ loadState()

bool ossimLensDistortion::loadState	(	const ossimKeywordlist &	kwl,
		const char *	prefix = `0`
	)

virtual

Method to the load (recreate) the state of the object from a keyword list. Return true if ok or false on error.

Reimplemented from ossim2dTo2dTransform.

Reimplemented in ossimMeanRadialLensDistortion, and ossimTangentialRadialLensDistortion.

Definition at line 33 of file ossimLensDistortion.cpp.

References ossimKeywordlist::find(), ossim2dTo2dTransform::loadState(), ossimString::split(), theCenter, ossimString::trim(), ossimDpt::x, and ossimDpt::y.

Referenced by ossimTangentialRadialLensDistortion::loadState(), and ossimMeanRadialLensDistortion::loadState().

 {
    const char* center = kwl.find(prefix, "center");
    theCenter.x = 0.0;
    theCenter.y = 0.0;
    
    if(center)
    {
       std::vector<ossimString> splitString;
       ossimString tempString(center);
       tempString = tempString.trim();
       tempString.split(splitString, " ");
       if(splitString.size() == 2)
       {
          theCenter.x = splitString[0].toDouble();
          theCenter.y = splitString[1].toDouble();
       }
    }
 
    return ossim2dTo2dTransform::loadState(kwl, prefix);
 
 }

◆ saveState()

bool ossimLensDistortion::saveState	(	ossimKeywordlist &	kwl,
		const char *	prefix = `0`
	)		const

virtual

Method to save the state of the object to a keyword list. Return true if ok or false on error.

Reimplemented from ossim2dTo2dTransform.

Reimplemented in ossimMeanRadialLensDistortion, and ossimTangentialRadialLensDistortion.

Definition at line 20 of file ossimLensDistortion.cpp.

References ossimKeywordlist::add(), ossim2dTo2dTransform::saveState(), theCenter, ossimString::toString(), ossimDpt::x, and ossimDpt::y.

Referenced by ossimTangentialRadialLensDistortion::saveState(), and ossimMeanRadialLensDistortion::saveState().

 {
    ossim2dTo2dTransform::saveState(kwl, prefix);
    
    kwl.add(prefix,
            "center",
            ossimString::toString(theCenter.x) + " " + ossimString::toString(theCenter.y),
            true);
 
    return true;
 }

◆ setCenter()

void ossimLensDistortion::setCenter ( const ossimDpt & center )

inline

Definition at line 24 of file ossimLensDistortion.h.

    {
       theCenter = center;
    }

◆ undistort()

virtual void ossimLensDistortion::undistort	(	const ossimDpt &	input,
		ossimDpt &	output
	)		const

pure virtual

Implemented in ossimSmacCallibrationSystem, ossimMeanRadialLensDistortion, and ossimTangentialRadialLensDistortion.

Referenced by distort().

Member Data Documentation

◆ theCenter

ossimDpt ossimLensDistortion::theCenter

protected

Definition at line 49 of file ossimLensDistortion.h.

Referenced by loadState(), saveState(), ossimMeanRadialLensDistortion::undistort(), and ossimSmacCallibrationSystem::undistort().

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

Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ossimLensDistortion()

Member Function Documentation

◆ distort()

◆ forward()

◆ getCenter()

◆ inverse()

◆ loadState()

◆ saveState()

◆ setCenter()

◆ undistort()

Member Data Documentation

◆ theCenter