ossimProjection Class Reference

#include <ossimProjection.h>

Inheritance diagram for ossimProjection:

Public Member Functions
	ossimProjection ()
virtual	~ossimProjection ()
virtual ossimObject *	dup () const =0
virtual ossimGpt	origin () const =0
virtual ossimDpt	forward (const ossimGpt &wp) const
virtual ossimGpt	inverse (const ossimDpt &pp) const
virtual void	worldToLineSample (const ossimGpt &worldPoint, ossimDpt &lineSampPt) const =0
virtual void	lineSampleToWorld (const ossimDpt &lineSampPt, ossimGpt &worldPt) const =0
virtual void	lineSampleHeightToWorld (const ossimDpt &lineSampPt, const double &heightAboveEllipsoid, ossimGpt &worldPt) const =0
virtual void	getRoundTripError (const ossimDpt &imagePoint, ossimDpt &errorResult) const
virtual void	getRoundTripError (const ossimGpt &groundPoint, ossimDpt &errorResult) const
virtual std::ostream &	print (std::ostream &out) const
	Outputs theErrorStatus as an ossimErrorCode and an ossimString. More...
virtual void	getGroundClipPoints (ossimGeoPolygon &gpts) const
virtual bool	saveState (ossimKeywordlist &kwl, const char *prefix=0) const
virtual bool	loadState (const ossimKeywordlist &kwl, const char *prefix=0)
virtual bool	isEqualTo (const ossimObject &obj, ossimCompareType compareType=OSSIM_COMPARE_FULL) const
virtual bool	operator== (const ossimProjection &projection) const =0
virtual bool	operator!= (const ossimProjection &projection) const
virtual ossimDpt	getMetersPerPixel () const =0
virtual bool	isAffectedByElevation () const =0
	Pure virtual method to query if projection is affected by elevation. More...
Public Member Functions inherited from ossimObject
	ossimObject ()
virtual	~ossimObject ()
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 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
Public Member Functions inherited from ossimErrorStatusInterface
	ossimErrorStatusInterface ()
virtual	~ossimErrorStatusInterface ()
virtual ossimErrorCode	getErrorStatus () const
virtual ossimString	getErrorStatusString () const
virtual void	setErrorStatus (ossimErrorCode error_status) const
virtual void	setErrorStatus () const
virtual void	clearErrorStatus () const
bool	hasError () const

Additional Inherited Members
Protected Member Functions inherited from ossimReferenced
virtual	~ossimReferenced ()
Protected Attributes inherited from ossimErrorStatusInterface
ossimErrorCode	theErrorStatus

Detailed Description

Definition at line 25 of file ossimProjection.h.

Constructor & Destructor Documentation

ossimProjection()

ossimProjection::ossimProjection

(

)

Constructors, Destructor:

Definition at line 36 of file ossimProjection.cpp.

{
}

~ossimProjection()

virtual ossimProjection::~ossimProjection ( )

inlinevirtual

Definition at line 32 of file ossimProjection.h.

{}

Member Function Documentation

dup()

virtual ossimObject* ossimProjection::dup ( ) const

pure virtual

Reimplemented from ossimObject.

Implemented in ossimRpcModel, ossimRpcProjection, ossimFcsiModel, ossimAffineProjection, ossimRS1SarModel, ossimWarpProjection, ossimCoarseGridModel, ossimSarModel, ossimSonomaSensor, ossimplugins::ossimRadarSat2RPCModel, ossimRsmModel, ossimplugins::ossimRadarSat2Model, ossimplugins::ossimAlosPalsarModel, ossimplugins::ossimFormosatModel, ossimplugins::ossimPleiadesModel, ossimplugins::ossimSpot6Model, ossimplugins::ossimTerraSarModel, ossimAdjMapModel, ossimplugins::ossimRadarSatModel, ossimSpot5Model, ossimplugins::ossimEnvisatAsarModel, ossimplugins::ossimErsSarModel, ossimNitfRsmModel, ossimplugins::ossimTileMapModel, ossimLandSatModel, ossimAlbersProjection, ossimSpaceObliqueMercatorProjection, ossimQuickbirdRpcModel, ossimLambertConformalConicProjection, ossimIpodSensor, ossimSkyBoxLearSensor, ossimNitfMapModel, ossimNitfRpcModel, ossimPolynomProjection, ossimEquDistCylProjection, ossimObliqueMercatorProjection, ossimBilinearProjection, ossimLlxyProjection, ossimAzimEquDistProjection, ossimMercatorProjection, ossimSinusoidalProjection, ossimTransCylEquAreaProjection, ossimMillerProjection, ossimMollweidProjection, ossimOrthoGraphicProjection, ossimTransMercatorProjection, ossimApplanixEcefModel, ossimPolarStereoProjection, ossimUtmProjection, ossimBonneProjection, ossimCassiniProjection, ossimCylEquAreaProjection, ossimEckert6Projection, ossimPolyconicProjection, ossimEckert4Projection, ossimQuadProjection, ossimStereographicProjection, ossimVanDerGrintenProjection, ossimGnomonicProjection, ossimAlphaSensorHRI, ossimAlphaSensorHSI, ossimAlphaSensor, ossimNewZealandMapGridProjection, ossimPpjFrameSensor, ossimSpectraboticsRedEdgeModel, ossimApplanixUtmModel, ossimCadrgProjection, ossimUpsProjection, ossimGoogleProjection, and ossimBngProjection.

Referenced by ossimMapViewController::changeOwner(), ossimEpsgProjectionDatabase::findProjection(), ossimGpkgWriter::getNewOutputProjection(), ossimTilingRect::initializeBase(), ossimChipProcTool::newIdentityProjection(), ossimImageGeometry::operator=(), ossimMapViewController::ossimMapViewController(), and ossimIgen::setView().

forward()

ossimDpt ossimProjection::forward ( const ossimGpt &  wp ) const

inlinevirtual

METHODS: forward(), reverse() OBSOLETE – provided for existing GUI code only. Bogus return value.

Reimplemented in ossimAlbersProjection, ossimLambertConformalConicProjection, ossimMapProjection, ossimSpaceObliqueMercatorProjection, ossimEquDistCylProjection, ossimObliqueMercatorProjection, ossimAzimEquDistProjection, ossimLlxyProjection, ossimOrthoGraphicProjection, ossimSinusoidalProjection, ossimMercatorProjection, ossimPolyconicProjection, ossimStereographicProjection, ossimTransCylEquAreaProjection, ossimCylEquAreaProjection, ossimMillerProjection, ossimMollweidProjection, ossimVanDerGrintenProjection, ossimEckert4Projection, ossimGnomonicProjection, ossimPolarStereoProjection, ossimTransMercatorProjection, ossimUtmProjection, ossimEckert6Projection, ossimBonneProjection, ossimCassiniProjection, ossimNewZealandMapGridProjection, ossimUpsProjection, ossimCadrgProjection, ossimBngProjection, and ossimGoogleProjection.

Definition at line 129 of file ossimProjection.h.

References worldToLineSample().

Referenced by ossimRpcProjection::buildNormalEquation(), ossimSensorModel::buildNormalEquation(), ossimRpcProjection::getForwardDeriv(), ossimSensorModel::getForwardDeriv(), ossimRpcProjection::getResidue(), ossimSensorModel::getResidue(), and ossimImageGeometry::getTiePoint().

{
   ossimDpt p;
   worldToLineSample(wp, p);
   return p;
}

getGroundClipPoints()

void ossimProjection::getGroundClipPoints ( ossimGeoPolygon &  gpts ) const

virtual

Reimplemented in ossimOrthoGraphicProjection.

Definition at line 195 of file ossimProjection.cpp.

Referenced by ossimImageViewProjectionTransform::getImageToViewBounds().

{
}

getMetersPerPixel()

virtual ossimDpt ossimProjection::getMetersPerPixel ( ) const

pure virtual

ACCESS METHODS:

Implemented in ossimMapProjection, ossimRpcProjection, ossimAdjMapModel, ossimAffineProjection, ossimWarpProjection, ossimSensorModel, ossimBilinearProjection, ossimQuadProjection, and ossimPolynomProjection.

Referenced by ossimImageViewProjectionTransform::getInputMetersPerPixel(), ossimAffineProjection::getMetersPerPixel(), ossimWarpProjection::getMetersPerPixel(), ossimImageGeometry::getMetersPerPixel(), ossimImageViewProjectionTransform::getOutputMetersPerPixel(), ossimImageGeometry::getTiePoint(), ossimTiledElevationDatabase::isCompatible(), and main().

getRoundTripError() [1/2]

void ossimProjection::getRoundTripError ( const ossimDpt &  imagePoint, ossimDpt &  errorResult  ) const

virtual

Definition at line 171 of file ossimProjection.cpp.

Referenced by ossimBilinearProjection::initializeBilinear().

{
   ossimGpt world;
   ossimDpt testPt;
   
   lineSampleToWorld(imagePoint, world);
   worldToLineSample(world, testPt);

   errorResult = imagePoint - testPt;
}

getRoundTripError() [2/2]

void ossimProjection::getRoundTripError ( const ossimGpt &  groundPoint, ossimDpt &  errorResult  ) const

virtual

Definition at line 183 of file ossimProjection.cpp.

{
   ossimDpt tempPt;
   ossimGpt tempGround;

   worldToLineSample(groundPoint, tempPt);
   lineSampleToWorld(tempPt, tempGround);
   
   errorResult = ossimDpt(groundPoint) - ossimDpt(tempGround);
}

inverse()

ossimGpt ossimProjection::inverse ( const ossimDpt &  pp ) const

inlinevirtual

Reimplemented in ossimMapProjection, ossimAlbersProjection, ossimSpaceObliqueMercatorProjection, ossimLambertConformalConicProjection, ossimEquDistCylProjection, ossimObliqueMercatorProjection, ossimLlxyProjection, ossimAzimEquDistProjection, ossimOrthoGraphicProjection, ossimCylEquAreaProjection, ossimSinusoidalProjection, ossimEckert4Projection, ossimMercatorProjection, ossimPolyconicProjection, ossimStereographicProjection, ossimTransCylEquAreaProjection, ossimMillerProjection, ossimMollweidProjection, ossimVanDerGrintenProjection, ossimBonneProjection, ossimCassiniProjection, ossimGnomonicProjection, ossimPolarStereoProjection, ossimTransMercatorProjection, ossimUtmProjection, ossimEckert6Projection, ossimNewZealandMapGridProjection, ossimUpsProjection, ossimGoogleProjection, ossimCadrgProjection, and ossimBngProjection.

Definition at line 140 of file ossimProjection.h.

References lineSampleToWorld().

Referenced by ossimRpcProjection::buildNormalEquation(), ossimSensorModel::buildNormalEquation(), ossimGeoPdfReader::computeBoundingRect(), ossimRpcProjection::getInverseDeriv(), ossimSensorModel::getInverseDeriv(), ossimRpcProjection::getResidue(), ossimSensorModel::getResidue(), and ossimImageGeometry::getTiePoint().

{
   ossimGpt g;
   lineSampleToWorld(pp, g);
   return g;
}

isAffectedByElevation()

virtual bool ossimProjection::isAffectedByElevation ( ) const

pure virtual

Pure virtual method to query if projection is affected by elevation.

Returns

true if affected, false if not.

Implemented in ossimMapProjection, ossimSensorModel, ossimRpcProjection, ossimWarpProjection, ossimCoarseGridModel, ossimAffineProjection, ossimPolynomProjection, ossimBilinearProjection, and ossimQuadProjection.

Referenced by ossimWarpProjection::isAffectedByElevation(), ossimImageGeometry::isAffectedByElevation(), and ossimImageGeometry::upIsUpAngle().

isEqualTo()

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

inlinevirtual

Reimplemented from ossimObject.

Reimplemented in ossimMapProjection.

Definition at line 93 of file ossimProjection.h.

References ossimObject::isEqualTo().

Referenced by ossimMapProjection::isEqualTo(), ossimImageGeometry::isEqualTo(), and ossimImageViewProjectionTransform::viewToImage().

   {
      return ossimObject::isEqualTo(obj, compareType);
   }

lineSampleHeightToWorld()

virtual void ossimProjection::lineSampleHeightToWorld ( const ossimDpt &  lineSampPt, const double &  heightAboveEllipsoid, ossimGpt &  worldPt  ) const

pure virtual

METHOD: lineSampleHeightToWorld This is the pure virtual that projects the image point to the given elevation above ellipsoid, thereby bypassing reference to a DEM. Useful for projections that are sensitive to elevation (such as sensor models).

Implemented in ossimRpcModel, ossimFcsiModel, ossimSensorModel, ossimplugins::ossimRadarSat2RPCModel, ossimRpcProjection, ossimCoarseGridModel, ossimLandSatModel, ossimSarModel, ossimplugins::ossimFormosatModel, ossimplugins::ossimTileMapModel, ossimSpot5Model, ossimplugins::ossimGeometricSarSensorModel, ossimSonomaSensor, ossimAdjMapModel, ossimRS1SarModel, ossimEquDistCylProjection, ossimAffineProjection, ossimWarpProjection, ossimNitfMapModel, ossimMapProjection, ossimNitfRpcModel, ossimBilinearProjection, ossimSkyBoxLearSensor, ossimRsmModel, ossimIpodSensor, ossimPolynomProjection, ossimQuadProjection, ossimApplanixEcefModel, ossimSpectraboticsRedEdgeModel, ossimPpjFrameSensor, ossimApplanixUtmModel, and ossimAlphaSensor.

Referenced by ossimImageGeometry::localToWorld().

lineSampleToWorld()

virtual void ossimProjection::lineSampleToWorld ( const ossimDpt &  lineSampPt, ossimGpt &  worldPt  ) const

pure virtual

METHOD: lineSampleToWorld() Performs the inverse projection from line, sample to ground (world):

Implemented in ossimplugins::ossimGeometricSarSensorModel, ossimRpcModel, ossimSensorModel, ossimCoarseGridModel, ossimRpcProjection, ossimSarModel, ossimplugins::ossimTileMapModel, ossimSonomaSensor, ossimAdjMapModel, ossimLlxyProjection, ossimAffineProjection, ossimWarpProjection, ossimMapProjection, ossimPolynomProjection, ossimBilinearProjection, ossimRsmModel, ossimQuadProjection, ossimApplanixEcefModel, ossimCadrgProjection, ossimPpjFrameSensor, ossimSpectraboticsRedEdgeModel, and ossimApplanixUtmModel.

Referenced by ossimIgenGenerator::addPadding(), ossimIgenGenerator::generateGeoTiledSpecList(), ossimIgenGenerator::generatePixelTiledSpecList(), inverse(), ossimSpot5Model::lineSampleHeightToWorld(), ossimImageGeometry::localToWorld(), and main().

loadState()

bool ossimProjection::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 ossimObject.

Reimplemented in ossimSensorModel, ossimMapProjection, ossimplugins::ossimGeometricSarSensorModel, ossimRpcModel, ossimFcsiModel, ossimAlbersProjection, ossimSonomaSensor, ossimLambertConformalConicProjection, ossimEquDistCylProjection, ossimplugins::ossimRadarSat2Model, ossimplugins::ossimTerraSarModel, ossimplugins::ossimRadarSat2RPCModel, ossimRpcProjection, ossimplugins::ossimAlosPalsarModel, ossimRsmModel, ossimplugins::ossimRadarSatModel, ossimLlxyProjection, ossimObliqueMercatorProjection, ossimplugins::ossimEnvisatAsarModel, ossimplugins::ossimErsSarModel, ossimLandSatModel, ossimMercatorProjection, ossimSkyBoxLearSensor, ossimAffineProjection, ossimIpodSensor, ossimWarpProjection, ossimAzimEquDistProjection, ossimTransCylEquAreaProjection, ossimH5GridModel, ossimTransMercatorProjection, ossimCoarseGridModel, ossimplugins::ossimFormosatModel, ossimplugins::ossimPleiadesModel, ossimplugins::ossimSpot6Model, ossimCylEquAreaProjection, ossimplugins::ossimTileMapModel, ossimEckert6Projection, ossimSinusoidalProjection, ossimSpot5Model, ossimEckert4Projection, ossimVanDerGrintenProjection, ossimBonneProjection, ossimMollweidProjection, ossimOrthoGraphicProjection, ossimRS1SarModel, ossimApplanixEcefModel, ossimCassiniProjection, ossimMillerProjection, ossimPolyconicProjection, ossimAdjMapModel, ossimGnomonicProjection, ossimStereographicProjection, ossimPolarStereoProjection, ossimNitfRpcModel, ossimUtmProjection, ossimNewZealandMapGridProjection, ossimSpectraboticsRedEdgeModel, ossimSarModel, ossimSpaceObliqueMercatorProjection, ossimBilinearProjection, ossimNitfMapModel, ossimNitfRsmModel, ossimPpjFrameSensor, ossimQuadProjection, ossimIkonosRpcModel, ossimApplanixUtmModel, ossimQuickbirdRpcModel, ossimCadrgProjection, ossimUpsProjection, ossimAlphaSensor, ossimPolynomProjection, ossimAlphaSensorHRI, ossimAlphaSensorHSI, ossimBngProjection, and ossimGoogleProjection.

Definition at line 57 of file ossimProjection.cpp.

Referenced by ossimHdf5ProjectionFactory::createProjection(), ossimSensorModelFactory::createProjection(), ossimGdalProjectionFactory::createProjection(), ossimMiscProjectionFactory::createProjection(), ossimplugins::ossimPluginProjectionFactory::createProjection(), ossimMapProjectionFactory::createProjection(), ossimEpsgProjectionFactory::createProjection(), ossimPolynomProjection::loadState(), ossimCadrgProjection::loadState(), ossimQuadProjection::loadState(), ossimBilinearProjection::loadState(), and ossimMapProjection::loadState().

{
   return true;
}

operator!=()

virtual bool ossimProjection::operator!= ( const ossimProjection &  projection ) const

inlinevirtual

Definition at line 103 of file ossimProjection.h.

{return !(*this == projection);}

operator==()

virtual bool ossimProjection::operator== ( const ossimProjection &  projection ) const

pure virtual

OPERATOR: == Compares this instance with arg projection.

Implemented in ossimSensorModel, ossimMapProjection, ossimLambertConformalConicProjection, ossimAlbersProjection, ossimRpcProjection, ossimAffineProjection, ossimWarpProjection, ossimLlxyProjection, ossimObliqueMercatorProjection, ossimMercatorProjection, ossimTransMercatorProjection, ossimUtmProjection, ossimTransCylEquAreaProjection, ossimSinusoidalProjection, ossimVanDerGrintenProjection, ossimBonneProjection, ossimMollweidProjection, ossimSpaceObliqueMercatorProjection, ossimBilinearProjection, ossimCadrgProjection, ossimQuadProjection, ossimUpsProjection, ossimPolynomProjection, and ossimGoogleProjection.

origin()

virtual ossimGpt ossimProjection::origin ( ) const

pure virtual

METHOD: origin() Returns projection's ground point origin. That is the GP corresponding to line=0, sample=0.

Implemented in ossimRpcProjection, ossimAffineProjection, ossimWarpProjection, ossimSensorModel, ossimPolynomProjection, ossimMapProjection, ossimBilinearProjection, and ossimQuadProjection.

Referenced by ossimImageViewProjectionTransform::getImageToViewBounds(), ossimGeoAnnotationEllipseObject::getWidthHeightInPixels(), ossimGdalOgrVectorAnnotation::loadLineString(), ossimGdalOgrVectorAnnotation::loadMultiLineString(), ossimGdalOgrVectorAnnotation::loadMultiPoint(), ossimGdalOgrVectorAnnotation::loadMultiPolygon(), ossimGdalOgrVectorAnnotation::loadPoint(), ossimGdalOgrVectorAnnotation::loadPolygon(), ossimWarpProjection::origin(), and ossimAffineProjection::origin().

print()

std::ostream & ossimProjection::print ( std::ostream &  out ) const

virtual

Outputs theErrorStatus as an ossimErrorCode and an ossimString.

Returns

std::ostream&

Note

Derived classes should only have to implement a virtual print, not an operator<< funtion as it's implemented here.

Reimplemented from ossimErrorStatusInterface.

Reimplemented in ossimMapProjection, ossimplugins::ossimGeometricSarSensorModel, ossimSensorModel, ossimLambertConformalConicProjection, ossimRpcModel, ossimFcsiModel, ossimplugins::ossimRadarSat2Model, ossimplugins::ossimTerraSarModel, ossimplugins::ossimRadarSat2RPCModel, ossimplugins::ossimEnvisatAsarModel, ossimLlxyProjection, ossimSarModel, ossimTransMercatorProjection, ossimRpcProjection, ossimLandSatModel, ossimRsmModel, ossimUtmProjection, ossimAffineProjection, ossimWarpProjection, ossimCoarseGridModel, ossimplugins::ossimFormosatModel, ossimplugins::ossimPleiadesModel, ossimplugins::ossimSpot6Model, ossimSpot5Model, ossimAdjMapModel, ossimBilinearProjection, ossimplugins::ossimTileMapModel, ossimNitfMapModel, and ossimPolynomProjection.

Definition at line 199 of file ossimProjection.cpp.

References ossimErrorStatusInterface::print().

Referenced by ossimBilinearProjection::print(), ossimAffineProjection::print(), ossimWarpProjection::print(), ossimSensorModel::print(), ossimMapProjection::print(), and ossimImageGeometry::print().

{
   return ossimErrorStatusInterface::print(out);
}

saveState()

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

virtual

METHODS: saveState, loadState Fulfills ossimObject base-class pure virtuals.

Reimplemented from ossimObject.

Reimplemented in ossimSensorModel, ossimMapProjection, ossimplugins::ossimGeometricSarSensorModel, ossimRpcModel, ossimFcsiModel, ossimSonomaSensor, ossimAlbersProjection, ossimLambertConformalConicProjection, ossimEquDistCylProjection, ossimRpcProjection, ossimplugins::ossimRadarSat2Model, ossimplugins::ossimTerraSarModel, ossimplugins::ossimRadarSat2RPCModel, ossimSkyBoxLearSensor, ossimplugins::ossimAlosPalsarModel, ossimLandSatModel, ossimLlxyProjection, ossimRsmModel, ossimplugins::ossimRadarSatModel, ossimIpodSensor, ossimObliqueMercatorProjection, ossimplugins::ossimEnvisatAsarModel, ossimAffineProjection, ossimWarpProjection, ossimplugins::ossimErsSarModel, ossimMercatorProjection, ossimplugins::ossimFormosatModel, ossimplugins::ossimPleiadesModel, ossimplugins::ossimSpot6Model, ossimAzimEquDistProjection, ossimCoarseGridModel, ossimTransCylEquAreaProjection, ossimplugins::ossimTileMapModel, ossimH5GridModel, ossimSpot5Model, ossimTransMercatorProjection, ossimSarModel, ossimAdjMapModel, ossimApplanixEcefModel, ossimCylEquAreaProjection, ossimRS1SarModel, ossimEckert6Projection, ossimSinusoidalProjection, ossimEckert4Projection, ossimVanDerGrintenProjection, ossimBonneProjection, ossimMollweidProjection, ossimOrthoGraphicProjection, ossimCassiniProjection, ossimMillerProjection, ossimPolyconicProjection, ossimGnomonicProjection, ossimStereographicProjection, ossimNitfRpcModel, ossimPolarStereoProjection, ossimSpectraboticsRedEdgeModel, ossimUtmProjection, ossimNewZealandMapGridProjection, ossimBilinearProjection, ossimPpjFrameSensor, ossimSpaceObliqueMercatorProjection, ossimNitfMapModel, ossimHdf5GridModel, ossimQuadProjection, ossimApplanixUtmModel, ossimQuickbirdRpcModel, ossimNitfRsmModel, ossimIkonosRpcModel, ossimAlphaSensor, ossimCadrgProjection, ossimAlphaSensorHRI, ossimAlphaSensorHSI, ossimPolynomProjection, ossimUpsProjection, ossimBngProjection, ossimGoogleProjection, and ossimEnviCgModel.

Definition at line 43 of file ossimProjection.cpp.

References ossimKeywordlist::add(), ossimKeywordNames::TYPE_KW, and TYPE_NAME.

Referenced by ossimMapProjection::assign(), ossimGdalProjectionFactory::createProjection(), ossimEpsgProjectionFactory::createProjection(), ossimCadrgProjection::saveState(), ossimQuadProjection::saveState(), ossimBilinearProjection::saveState(), ossimMapProjection::saveState(), ossimImageGeometry::saveState(), ossimRpcProjection::setupOptimizer(), and ossimRpcModel::setupOptimizer().

{
   kwl.add(prefix,
           ossimKeywordNames::TYPE_KW,
           TYPE_NAME(this),
           true);

   return true;
}

worldToLineSample()

void ossimProjection::worldToLineSample ( const ossimGpt &  worldPoint, ossimDpt &  lineSampPt  ) const

pure virtual

METHOD: worldToLineSample() Performs the forward projection from ground point to line, sample.

Implemented in ossimFcsiModel, ossimSensorModel, ossimRpcModel, ossimplugins::ossimRadarSat2RPCModel, ossimSarModel, ossimH5GridModel, ossimAdjMapModel, ossimplugins::ossimTileMapModel, ossimEquDistCylProjection, ossimRpcProjection, ossimLlxyProjection, ossimMapProjection, ossimAffineProjection, ossimWarpProjection, ossimNitfRpcModel, ossimPolynomProjection, ossimApplanixEcefModel, ossimBilinearProjection, ossimRsmModel, ossimPpjFrameSensor, ossimSpectraboticsRedEdgeModel, ossimApplanixUtmModel, ossimQuadProjection, ossimAlphaSensorHRI, ossimAlphaSensorHSI, and ossimCadrgProjection.

Definition at line 70 of file ossimProjection.cpp.

Referenced by ossimIgenGenerator::addPadding(), forward(), ossimIgenGenerator::generatePixelTiledSpecList(), ossimQuadProjection::worldToLineSample(), ossimBilinearProjection::worldToLineSample(), ossimH5GridModel::worldToLineSample(), ossimSensorModel::worldToLineSample(), and ossimImageGeometry::worldToLocal().

{
   if (traceExec())  ossimNotify(ossimNotifyLevel_DEBUG) << "DEBUG ossimProjection::worldToLineSample: entering..." << std::endl;

   static const double PIXEL_THRESHOLD    = 0.1; // acceptable pixel error
   static const int    MAX_NUM_ITERATIONS = 20;

   //***
   // First check if the world point is inside bounding rectangle:
   //***
   int iters = 0;
   double height = worldPoint.hgt;
   if ( ossim::isnan(height) )
   {
      height = 0.0;
   }

   //***
   // Utilize iterative scheme for arriving at image point. Begin with guess
   // at image center:
   //***
   ip.u = 0;
   ip.v = 0;
   
   ossimDpt ip_du;
   ossimDpt ip_dv;

   ossimGpt gp, gp_du, gp_dv;
   double dlat_du, dlat_dv, dlon_du, dlon_dv;
   double delta_lat, delta_lon, delta_u, delta_v;
   double inverse_norm;
   
   //***
   // Begin iterations:
   //***
   do
   {
      //***
      // establish perturbed image points about the guessed point:
      //***
      ip_du.u = ip.u + 1.0;
      ip_du.v = ip.v;
      ip_dv.u = ip.u;
      ip_dv.v = ip.v + 1.0;
      
      //***
      // Compute numerical partials at current guessed point:
      //***
      lineSampleHeightToWorld(ip,    height, gp);
      lineSampleHeightToWorld(ip_du, height, gp_du);
      lineSampleHeightToWorld(ip_dv, height, gp_dv);

      dlat_du = gp_du.lat - gp.lat; //e
      dlon_du = gp_du.lon - gp.lon; //g
      dlat_dv = gp_dv.lat - gp.lat; //f
      dlon_dv = gp_dv.lon - gp.lon; //h

      //***
      // Test for convergence:
      //***
      delta_lat = worldPoint.lat - gp.lat;
      delta_lon = worldPoint.lon - gp.lon;
      
      //***
      // Compute linearized estimate of image point given gp delta:
      //***
      inverse_norm = dlat_dv*dlon_du - dlat_du*dlon_dv; // fg-eh
      if (inverse_norm != 0)
      {
          delta_u = (-dlon_dv*delta_lat + dlat_dv*delta_lon)/inverse_norm;
          delta_v = ( dlon_du*delta_lat - dlat_du*delta_lon)/inverse_norm;
          ip.u += delta_u;
          ip.v += delta_v;
      }
      else
      {
         delta_u = 0;
         delta_v = 0;
      }

      iters++;
      
   } while (((fabs(delta_u) > PIXEL_THRESHOLD) ||
             (fabs(delta_v) > PIXEL_THRESHOLD)) &&
            (iters < MAX_NUM_ITERATIONS));

   //***
   // Note that this error mesage appears only if max count was reached while
   // iterating. A linear (no iteration) solution would finish with iters =
   // MAX_NUM_ITERATIONS + 1:
   //***
   if (iters == MAX_NUM_ITERATIONS)
   {
//       ossimNotify(ossimNotifyLevel_WARN) << "WARNING ossimProjection::worldToLineSample: Exceeded max number of iterations computing image \n"
//            << "point for ground point: " << worldPoint
//            << "\nCheck the geometry file for valid quantities." << endl;
   }
   
}

---

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

• ossimProjection.h
• ossimProjection.cpp