#include <ossimQuickbirdRpcModel.h>

Inheritance diagram for ossimQuickbirdRpcModel:

Public Member Functions
	ossimQuickbirdRpcModel ()

	ossimQuickbirdRpcModel (const ossimQuickbirdRpcModel &rhs)

	ossimQuickbirdRpcModel (const ossimQbTileFilesHandler *handler)
	Initializes. More...

	~ossimQuickbirdRpcModel ()

virtual ossimObject *	dup () const
	dup() Returns pointer to a new instance, copy of this. More...

virtual bool	saveState (ossimKeywordlist &kwl, const char *prefix=0) const
	saveState Fulfills ossimObject base-class pure virtuals. More...

virtual bool	loadState (const ossimKeywordlist &kwl, const char *prefix=0)
	loadState Fulfills ossimObject base-class pure virtuals. More...

virtual bool	parseFile (const ossimFilename &file)
	Public method for parsing generic image file. More...

void	setSupportData (ossimQuickbirdMetaData *supportData)

ossimQuickbirdMetaData *	getSupportData ()

const ossimQuickbirdMetaData *	getSupportData () const

Public Member Functions inherited from ossimRpcModel
	ossimRpcModel ()
	default constructor More...

	ossimRpcModel (const ossimRpcModel &copy_this)
	copy construtor More...

void	setAttributes (ossim_float64 theSampleOffset, ossim_float64 theLineOffset, ossim_float64 theSampleScale, ossim_float64 theLineScale, ossim_float64 theLatOffset, ossim_float64 theLonOffset, ossim_float64 theHeightOffset, ossim_float64 theLatScale, ossim_float64 theLonScale, ossim_float64 theHeightScale, const std::vector< double > &xNumeratorCoeffs, const std::vector< double > &xDenominatorCoeffs, const std::vector< double > &yNumeratorCoeffs, const std::vector< double > &yDenominatorCoeffs, PolynomialType polyType=B, bool computeGsdFlag=true)

void	setMetersPerPixel (const ossimDpt &metersPerPixel)

void	setPositionError (const ossim_float64 &biasError, const ossim_float64 &randomError, bool initNominalPostionErrorFlag)
	Sets data member theBiasError, theRandError. More...

virtual void	worldToLineSample (const ossimGpt &world_point, ossimDpt &image_point) const
	worldToLineSample() Overrides base class implementation. More...

virtual std::ostream &	print (std::ostream &out) const
	print() Extends base-class implementation. More...

virtual void	lineSampleToWorld (const ossimDpt &image_point, ossimGpt &world_point) const

virtual void	lineSampleHeightToWorld (const ossimDpt &image_point, const double &heightEllipsoid, ossimGpt &worldPoint) const

virtual void	imagingRay (const ossimDpt &image_point, ossimEcefRay &image_ray) const
	imagingRay() Overrides base class pure virtual. More...

virtual void	updateModel ()

virtual void	initAdjustableParameters ()

virtual bool	useForward () const

virtual bool	setupOptimizer (const ossimString &init_file)
	uses file path to init model More...

virtual ossimDpt	getForwardDeriv (int parmIdx, const ossimGpt &gpos, double h)
	Compute partials of samp/line WRT ground point. More...

double	getBiasError () const
	Returns Error - Bias. More...

double	getRandError () const
	Returns Error - Random. More...

void	getRpcParameters (ossimRpcModel::rpcModelStruct &model) const
	Returns RPC parameter set in structure. More...

void	setImageOffset (const ossimDpt &offset_to_chip_ul)
	Allows setting an offset to a subimage while using the coefficients of a full-image model. More...

bool	toJSON (std::ostream &json) const
	Serializes RPC to JSON format. More...

bool	toRPB (std::ostream &out) const
	Serialize to WorldView-style .RPB file to the stream provided. More...

Public Member Functions inherited from ossimSensorModel
	ossimSensorModel ()

	ossimSensorModel (const ossimSensorModel &copy_this)

	ossimSensorModel (const ossimKeywordlist &geom_kwl)

const ossimSensorModel &	operator= (const ossimSensorModel &rhs)
	assignment operator More...

virtual ossimObject *	getBaseObject ()

virtual const ossimObject *	getBaseObject () const

virtual ossimGpt	origin () const

virtual ossimDpt	getMetersPerPixel () const

virtual const double &	getNominalPosError () const
	Returns the estimated Absolute horizontal position error (CE90) of the sensor model. More...

virtual const double &	getRelativePosError () const
	Returns the estimated RELATIVE horizontal position error (CE90) of the sensor model. More...

virtual void	setNominalPosError (const double &ce90)
	Assigns the absolute image position error uncertainty (abs CE90) More...

virtual void	setRelativePosError (const double &ce90)
	Assigns the relative image position error uncertainty (rel CE90) More...

void	setRefImgPt (const ossimDpt &pt)
	Sets the center line sampe of the image. More...

void	setRefGndPt (const ossimGpt &pt)
	Sets the center latitude, longitude, height of the image. More...

void	setImageRect (const ossimDrect &imageRect)

void	setGroundRect (const ossimGpt &ul, const ossimGpt &ur, const ossimGpt &lr, const ossimGpt &ll)

ossimDpt	imageSize () const

void	setImageSize (const ossimDpt &size)

virtual void	adjustableParametersChanged ()

virtual bool	insideImage (const ossimDpt &p) const

virtual bool	operator== (const ossimProjection &proj) const

const ossimString &	getImageID () const
	Access methods: More...

const ossimDrect &	getImageClipRect () const

virtual ossim_uint32	degreesOfFreedom () const

virtual bool	needsInitialState () const
	needsInitialState() More...

virtual double	optimizeFit (const ossimTieGptSet &tieSet, double *targetVariance=0)

virtual ossimGpt	getInverseDeriv (int parmIdx, const ossimDpt &ipos, double hdelta=1e-11)

virtual ossimSensorModel::CovMatStatus	getObsCovMat (const ossimDpt &ipos, NEWMAT::SymmetricMatrix &Cov, const ossim_float64 defPointingSigma=0.5) const
	Gives 2X2 covariance matrix of observations. More...

virtual bool	isAffectedByElevation () const
	Implementation of pure virtual ossimProjection::isAffectedByElevation method. More...

void	computeGsd ()
	This method computes the ground sample distance(gsd) and sets class attributes theGSD and theMeanGSD by doing a lineSampleHeightToWorld on four points and calculating the distance from them. More...

virtual bool	getImageGeometry (const ossimString &, const ossimString &, ossimKeywordlist &) const
	Extracts geometry info from a non-ossim key,value pair to an ossim keyword list. More...

Public Member Functions inherited from ossimProjection
	ossimProjection ()

virtual	~ossimProjection ()

virtual ossimDpt	forward (const ossimGpt &wp) const

virtual ossimGpt	inverse (const ossimDpt &pp) const

virtual void	getRoundTripError (const ossimDpt &imagePoint, ossimDpt &errorResult) const

virtual void	getRoundTripError (const ossimGpt &groundPoint, ossimDpt &errorResult) const

virtual void	getGroundClipPoints (ossimGeoPolygon &gpts) const

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

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

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

Public Member Functions inherited from ossimOptimizableProjection
	ossimOptimizableProjection ()

	ossimOptimizableProjection (const ossimOptimizableProjection &source)

virtual	~ossimOptimizableProjection ()

virtual ossimOptimizableProjection &	operator= (const ossimOptimizableProjection &source)

Public Member Functions inherited from ossimAdjustableParameterInterface
	ossimAdjustableParameterInterface ()

	ossimAdjustableParameterInterface (const ossimAdjustableParameterInterface &rhs)

virtual	~ossimAdjustableParameterInterface ()

void	newAdjustment (ossim_uint32 numberOfParameters=0)

void	setAdjustmentDescription (const ossimString &description)

ossimString	getAdjustmentDescription () const

ossimString	getAdjustmentDescription (ossim_uint32 adjustmentIdx) const
	Returns adjustmentDescription of specific adjustmentInfo. More...

void	setCurrentAdjustment (ossim_uint32 adjustmentIndex, bool notify=false)

bool	setCurrentAdjustment (const ossimString &description, bool notify=false)
	Sets the current adjustment to the adjustment with a matching description. More...

void	eraseAdjustment (bool notify)

void	eraseAdjustment (ossim_uint32 idx, bool notify)

void	resetAdjustableParameters (bool notify=false)

void	copyAdjustment (ossim_uint32 idx, bool notify)

void	copyAdjustment (bool notify=false)

void	keepAdjustment (ossim_uint32 idx, bool createCopy)

virtual void	keepAdjustment (bool createCopy=true)

const ossimAdjustableParameterInterface &	operator= (const ossimAdjustableParameterInterface &rhs)

void	removeAllAdjustments ()

ossim_uint32	getNumberOfAdjustableParameters () const

double	getAdjustableParameter (ossim_uint32 idx) const

virtual void	setAdjustableParameter (ossim_uint32 idx, double value, bool notify=false)

virtual void	setAdjustableParameter (ossim_uint32 idx, double value, double sigma, bool notify=false)

double	getParameterSigma (ossim_uint32 idx) const

void	setParameterSigma (ossim_uint32 idx, double value, bool notify=false)

ossimUnitType	getParameterUnit (ossim_uint32 idx) const

void	setParameterUnit (ossim_uint32 idx, ossimUnitType unit)

void	setParameterUnit (ossim_uint32 idx, const ossimString &unit)

void	setParameterCenter (ossim_uint32 idx, double center, bool notify=false)

double	getParameterCenter (ossim_uint32 idx) const

double	computeParameterOffset (ossim_uint32 idx) const

void	setParameterOffset (ossim_uint32 idx, ossim_float64 value, bool notify=false)

ossimString	getParameterDescription (ossim_uint32 idx) const

void	setParameterDescription (ossim_uint32 idx, const ossimString &descrption)

ossim_int32	findParameterIdxGivenDescription (ossim_uint32 adjustmentIdx, const ossimString &name) const

ossim_int32	findParameterIdxContainingDescription (ossim_uint32 adjustmentIdx, const ossimString &name) const

bool	isParameterLocked (ossim_uint32 idx) const

void	setParameterLockFlag (ossim_uint32 idxParam, bool flag)

bool	getParameterLockFlag (ossim_uint32 idx) const

void	lockAllParametersCurrentAdjustment ()

void	unlockAllParametersCurrentAdjustment ()

void	lockAllParameters (ossim_uint32 idxAdjustment)

void	unlockAllParameters (ossim_uint32 idxAdjustment)

void	resizeAdjustableParameterArray (ossim_uint32 numberOfParameters)

void	setAdjustment (const ossimAdjustmentInfo &adj, bool notify=false)

void	setAdjustment (ossim_uint32 idx, const ossimAdjustmentInfo &adj, bool notify=false)

void	addAdjustment (const ossimAdjustmentInfo &adj, bool notify)

void	getAdjustment (ossimAdjustmentInfo &adj) const

void	getAdjustment (ossim_uint32 idx, ossimAdjustmentInfo &adj) const

ossim_uint32	getNumberOfAdjustments () const

ossim_uint32	getCurrentAdjustmentIdx () const

void	setDirtyFlag (bool flag=true)

void	setAllDirtyFlag (bool flag=true)

bool	hasDirtyAdjustments () const

virtual void	saveCurrentAdjustmentOnly (ossimKeywordlist &kwl, const ossimString &prefix=ossimString(""))
	Saves the current active adjustment to the KWL file. More...

bool	saveAdjustments (ossimKeywordlist &kwl, const ossimString &prefix=ossimString("")) const
	Save all adjustments to the KWL file. More...

bool	loadAdjustments (const ossimKeywordlist &kwl, const ossimString &prefix=ossimString(""))

std::ostream &	print (std::ostream &out) const
	Dumps the currently active adjustment to ostream. More...

Protected Member Functions
bool	parseNitfFile (const ossimFilename &file)
	Parses a NITF image file for RPC info. Returns TRUE if successful. More...

bool	parseTiffFile (const ossimFilename &file)
	Parses a tagged TIFF image file for RPC info. Returns TRUE if successful. More...

bool	parseMetaData (const ossimFilename &file)
	Initializes the support data member with metadata file info. Returns TRUE if successful. More...

bool	parseRpcData (const ossimFilename &file)
	Given some base name for the image data, parses the associated RPC data file. More...

bool	parseTileData (const ossimFilename &file)
	Reads the TIL file for pertinent info. Returns TRUE if successful. More...

bool	findSupportFile (ossimFilename &file) const
	Given an initial filename with case-agnostic extension, this method searches first for an image-specific instance of that file (i.e., with _RC in the filename) before considering the mosaic-global support file (_RC removed). More...

void	finishConstruction ()
	Collects common code among all parsers. More...

Protected Member Functions inherited from ossimRpcModel
virtual	~ossimRpcModel ()
	virtual destructor More...

double	polynomial (const double &nlat, const double &nlon, const double &nhgt, const double *coeffs) const

double	dPoly_dLat (const double &nlat, const double &nlon, const double &nhgt, const double *coeffs) const

double	dPoly_dLon (const double &nlat, const double &nlon, const double &nhgt, const double *coeffs) const

double	dPoly_dHgt (const double &nlat, const double &nlon, const double &nhgt, const double *coeffs) const

Protected Member Functions inherited from ossimSensorModel
virtual	~ossimSensorModel ()

virtual ossimDpt	extrapolate (const ossimGpt &gp) const

virtual ossimGpt	extrapolate (const ossimDpt &ip, const double &height=ossim::nan()) const

void	buildNormalEquation (const ossimTieGptSet &tieSet, NEWMAT::SymmetricMatrix &A, NEWMAT::ColumnVector &residue, NEWMAT::ColumnVector &projResidue, double pstep_scale)

NEWMAT::ColumnVector	getResidue (const ossimTieGptSet &tieSet)

NEWMAT::ColumnVector	solveLeastSquares (NEWMAT::SymmetricMatrix &A, NEWMAT::ColumnVector &r) const

NEWMAT::Matrix	invert (const NEWMAT::Matrix &m) const
	stable invert stolen from ossimRpcSolver More...

Protected Member Functions inherited from ossimReferenced
virtual	~ossimReferenced ()

Protected Member Functions inherited from ossimAdjustableParameterInterface
bool	paramChanged (ossim_uint32 param_idx) const
	Returns true if specified parameter has been modified since last setAllChangeFlag(false) call. More...

void	setAllChangeFlags (bool areChanged)
	Sets all the change flags to the boolean indicated to indicate parameters are changed (TRUE) or not (FALSE). More...

void	initChangeFlags ()
	Initializes the change flags to TRUE. More...

Protected Attributes
ossimRefPtr< ossimQuickbirdMetaData >	theSupportData

Protected Attributes inherited from ossimRpcModel
PolynomialType	thePolyType

double	theLineScale

double	theSampScale

double	theLatScale

double	theLonScale

double	theHgtScale

double	theLineOffset

double	theSampOffset

double	theLatOffset

double	theLonOffset

double	theHgtOffset

double	theIntrackOffset

double	theCrtrackOffset

double	theIntrackScale

double	theCrtrackScale

double	theCosMapRot

double	theSinMapRot

double	theBiasError
	error More...

double	theRandError

double	theLineNumCoef [20]

double	theLineDenCoef [20]

double	theSampNumCoef [20]

double	theSampDenCoef [20]

Protected Attributes inherited from ossimSensorModel
ossimIpt	theImageSize

ossimDpt	theSubImageOffset

ossimString	theImageID

ossimString	theSensorID

ossimDpt	theGSD

ossim_float64	theMeanGSD

ossimGpt	theRefGndPt

ossimDpt	theRefImgPt

ossimPolygon	theBoundGndPolygon

ossimDrect	theImageClipRect

ossim_float64	theRelPosError

ossim_float64	theNominalPosError

ossimDpt	theParWRTx
	Partials for current point. More...

ossimDpt	theParWRTy

ossimDpt	theParWRTz

ossimDpt	theObs
	Observations & residuals for current point. More...

ossimDpt	theResid

ossimRefPtr< ossimProjection >	theSeedFunction
	Used as an initial guess for iterative solutions and a guess for points outside the support bounds. More...

bool	theExtrapolateImageFlag

bool	theExtrapolateGroundFlag

Protected Attributes inherited from ossimErrorStatusInterface
ossimErrorCode	theErrorStatus

Additional Inherited Members
Public Types inherited from ossimRpcModel
enum	PolynomialType { A ='A', B ='B' }

Public Types inherited from ossimSensorModel
enum	CovMatStatus { COV_INVALID = 0, COV_PARTIAL = 1, COV_FULL = 2 }

enum	DeriveMode { OBS_INIT =-99, EVALUATE =-98, P_WRT_X = -1, P_WRT_Y = -2, P_WRT_Z = -3 }

Static Public Member Functions inherited from ossimRpcModel
static void	writeGeomTemplate (ostream &os)
	STATIC METHOD: writeGeomTemplate(ostream) Writes a template of geom keywords processed by loadState and saveState to output stream. More...

Static Public Member Functions inherited from ossimSensorModel
static void	writeGeomTemplate (ostream &os)

Protected Types inherited from ossimRpcModel
enum	AdjustParamIndex { INTRACK_OFFSET = 0, CRTRACK_OFFSET, INTRACK_SCALE, CRTRACK_SCALE, MAP_ROTATION, NUM_ADJUSTABLE_PARAMS }

Detailed Description

CLASS: ossimQuickbirdRpcModel

Definition at line 33 of file ossimQuickbirdRpcModel.h.

Constructor & Destructor Documentation

◆ ossimQuickbirdRpcModel() [1/3]

ossimQuickbirdRpcModel::ossimQuickbirdRpcModel ( )

Definition at line 43 of file ossimQuickbirdRpcModel.cpp.

Referenced by dup().

    :ossimRpcModel(),
     theSupportData(new ossimQuickbirdMetaData())
 {
 }

◆ ossimQuickbirdRpcModel() [2/3]

ossimQuickbirdRpcModel::ossimQuickbirdRpcModel ( const ossimQuickbirdRpcModel & rhs )

Definition at line 52 of file ossimQuickbirdRpcModel.cpp.

    : ossimRpcModel(rhs),
      theSupportData(new ossimQuickbirdMetaData())
 {
 }

◆ ossimQuickbirdRpcModel() [3/3]

ossimQuickbirdRpcModel::ossimQuickbirdRpcModel ( const ossimQbTileFilesHandler * handler )

Initializes.

Constructor for multiple tile-files sharing common RPC model initializes given pointer to multi-tile-files handler.

Definition at line 62 of file ossimQuickbirdRpcModel.cpp.

References ossimErrorStatusInterface::clearErrorStatus(), finishConstruction(), ossimImageHandler::getFilename(), ossimTiledImageHandler::getImageRectangle(), ossimDpt::makeNan(), parseRpcData(), ossimErrorStatusInterface::setErrorStatus(), ossimSensorModel::theGSD, and ossimSensorModel::theImageClipRect.

 :  ossimRpcModel(),
    theSupportData(new ossimQuickbirdMetaData())
 {
    setErrorStatus();
    if (!handler)
       return;
 
    // Make the gsd nan so it gets computed.
    theGSD.makeNan();
 
    theImageClipRect = handler->getImageRectangle();
 
    ossimFilename imageFile = handler->getFilename();
    if (!parseRpcData(imageFile))
       return;
 
    finishConstruction();
    clearErrorStatus();
    return;
 }

◆ ~ossimQuickbirdRpcModel()

ossimQuickbirdRpcModel::~ossimQuickbirdRpcModel ( )

Definition at line 87 of file ossimQuickbirdRpcModel.cpp.

References theSupportData.

 {
    theSupportData = 0;
 }

Member Function Documentation

◆ dup()

ossimObject * ossimQuickbirdRpcModel::dup ( ) const

virtual

dup() Returns pointer to a new instance, copy of this.

Reimplemented from ossimRpcModel.

Definition at line 95 of file ossimQuickbirdRpcModel.cpp.

References ossimQuickbirdRpcModel().

 {
    return new ossimQuickbirdRpcModel(*this);
 }

◆ findSupportFile()

bool ossimQuickbirdRpcModel::findSupportFile ( ossimFilename & file ) const

protected

Given an initial filename with case-agnostic extension, this method searches first for an image-specific instance of that file (i.e., with _R*C* in the filename) before considering the mosaic-global support file (_R*C* removed).

If a file is found, the argument is modified to match the actual filename and TRUE is returned. Otherwise, argument filename is left unchanged and FALSE is returned.

Definition at line 489 of file ossimQuickbirdRpcModel.cpp.

References ossimString::downcase(), ossimFilename::exists(), ossimFilename::ext(), ossimString::replaceAllThatMatch(), ossimFilename::setExtension(), and ossimString::upcase().

Referenced by parseMetaData(), parseRpcData(), and parseTileData().

 {
    ossimFilename f (filename);
    ossimString extension = f.ext();
    if(f.exists())
    {
       filename = f;
       return true;
    }
    // Search for support file with same basename as image:
    extension.upcase();
    f.setExtension(extension);
    if(f.exists())
    {
       filename = f;
       return true;
    }
    extension.downcase();
    if(f.exists())
    {
       filename = f;
       return true;
    }
 
    // None found so far, search for mosaic-global support file:
    f = f.replaceAllThatMatch("_R[0-9]+C[0-9]+");
    if(f.exists())
    {
       filename = f;
       return true;
    }
   extension.upcase();
    f.setExtension(extension);
    if(f.exists())
    {
       filename = f;
       return true;
    }
 
 
    // Modify argument to match good filename:
    return false;
 }

◆ finishConstruction()

void ossimQuickbirdRpcModel::finishConstruction ( )

protected

Collects common code among all parsers.

Definition at line 413 of file ossimQuickbirdRpcModel.cpp.

References ossimSensorModel::computeGsd(), ossimDpt::hasNans(), ossimDrect::height(), ossimGpt::hgt, ossimGpt::lat, ossimIpt::line, ossimDpt::line, ossimRpcModel::lineSampleHeightToWorld(), ossimDrect::ll(), ossimGpt::lon, ossimDrect::lr(), ossimDrect::midPoint(), ossimNotify(), ossimNotifyLevel_WARN, ossimIpt::samp, ossimDpt::samp, ossimSensorModel::theBoundGndPolygon, ossimSensorModel::theGSD, ossimRpcModel::theHgtOffset, ossimSensorModel::theImageClipRect, ossimSensorModel::theImageSize, ossimRpcModel::theLatOffset, ossimRpcModel::theLonOffset, ossimSensorModel::theRefGndPt, ossimSensorModel::theRefImgPt, ossimDrect::ul(), ossimRpcModel::updateModel(), ossimDrect::ur(), ossimException::what(), ossimDrect::width(), ossimDpt::x, and ossimDpt::y.

Referenced by ossimQuickbirdRpcModel(), and parseTiffFile().

 {
    theImageSize.line = theImageClipRect.height();
    theImageSize.samp = theImageClipRect.width();
    theRefImgPt.line = theImageClipRect.midPoint().y;
    theRefImgPt.samp = theImageClipRect.midPoint().x;
    theRefGndPt.lat = theLatOffset;
    theRefGndPt.lon = theLonOffset;
    theRefGndPt.hgt = theHgtOffset;
 
    //---
    // NOTE:  We must call "updateModel()" to set parameter used by base
    // ossimRpcModel prior to calling lineSampleHeightToWorld or all
    // the world points will be same.
    //---
    updateModel();
 
    ossimGpt v0, v1, v2, v3;
    lineSampleHeightToWorld(theImageClipRect.ul(), theHgtOffset, v0);
    lineSampleHeightToWorld(theImageClipRect.ur(), theHgtOffset, v1);
    lineSampleHeightToWorld(theImageClipRect.lr(), theHgtOffset, v2);
    lineSampleHeightToWorld(theImageClipRect.ll(), theHgtOffset, v3);
 
    theBoundGndPolygon = ossimPolygon (ossimDpt(v0), ossimDpt(v1), ossimDpt(v2), ossimDpt(v3));
 
    // Set the ground reference point using the model.
    lineSampleHeightToWorld(theRefImgPt, theHgtOffset, theRefGndPt);
 
    if( theGSD.hasNans() )
    {
       try
       {
          // This will set theGSD and theMeanGSD. Method throws ossimException.
          computeGsd();
       }
       catch (const ossimException& e)
       {
          ossimNotify(ossimNotifyLevel_WARN)
             << "ossimQuickbirdRpcModel::finishConstruction -- caught exception:\n"
             << e.what() << std::endl;
       }
    }
 }

◆ getSupportData() [1/2]

ossimQuickbirdMetaData* ossimQuickbirdRpcModel::getSupportData ( )

inline

Definition at line 56 of file ossimQuickbirdRpcModel.h.

References ossimRefPtr< T >::get(), and theSupportData.

    {
       return theSupportData.get();
    }

◆ getSupportData() [2/2]

const ossimQuickbirdMetaData* ossimQuickbirdRpcModel::getSupportData ( ) const

inline

Definition at line 60 of file ossimQuickbirdRpcModel.h.

References ossimRefPtr< T >::get(), and theSupportData.

    {
       return theSupportData.get();
    }

◆ loadState()

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

virtual

loadState Fulfills ossimObject base-class pure virtuals.

Loads and saves geometry KWL files. Returns true if successful.

Reimplemented from ossimRpcModel.

Definition at line 470 of file ossimQuickbirdRpcModel.cpp.

References ossimQuickbirdMetaData::loadState(), ossimRpcModel::loadState(), theSupportData, and ossimRefPtr< T >::valid().

 {
    // sanity check only.  This shoulc always be true
    if(theSupportData.valid())
    {
       ossimString supportPrefix = ossimString(prefix) + "support_data.";
       theSupportData->loadState(kwl, supportPrefix);
    }
    return ossimRpcModel::loadState(kwl, prefix);
 }

◆ parseFile()

bool ossimQuickbirdRpcModel::parseFile ( const ossimFilename & file )

virtual

Public method for parsing generic image file.

Definition at line 103 of file ossimQuickbirdRpcModel.cpp.

References parseNitfFile(), and parseTiffFile().

Referenced by ossimQuickbirdTiffTileSource::getImageGeometry().

 {
    bool result = parseNitfFile(file);
    if ( !result )
    {
       result = parseTiffFile(file);
    }
    return result;
 }

◆ parseMetaData()

bool ossimQuickbirdRpcModel::parseMetaData ( const ossimFilename & file )

protected

Initializes the support data member with metadata file info. Returns TRUE if successful.

Definition at line 336 of file ossimQuickbirdRpcModel.cpp.

References findSupportFile(), ossimQuickbirdMetaData::getSatID(), ossimQuickbirdMetaData::open(), ossimNotify(), ossimNotifyLevel_WARN, ossimFilename::setExtension(), ossimSensorModel::theSensorID, theSupportData, and ossimRefPtr< T >::valid().

Referenced by parseNitfFile(), and parseTiffFile().

 {
 
    ossimFilename metadataFile (base_name);
    metadataFile.setExtension("IMD");
    if (!findSupportFile(metadataFile))
       return false;
 
    if ( !theSupportData.valid() )
       theSupportData = new ossimQuickbirdMetaData();
 
    if(!theSupportData->open(metadataFile))
    {
       theSupportData = 0; // ossimRefPtr
 #if 0 /* This should be wrapped in trace. drb */
       ossimNotify(ossimNotifyLevel_WARN)
          << "ossimQuickbirdRpcModel::parseMetaData WARNING:"
          << "\nCould not open IMD file.  Sensor ID unknown." << std::endl;
 #endif
       return false;
    }
 
    theSensorID = theSupportData->getSatID();
    return true;
 }

◆ parseNitfFile()

bool ossimQuickbirdRpcModel::parseNitfFile ( const ossimFilename & file )

protected

Parses a NITF image file for RPC info. Returns TRUE if successful.

Definition at line 116 of file ossimQuickbirdRpcModel.cpp.

References ossimNitfImageHeader::getImageRect(), ossimNitfFile::getNewImageHeader(), ossimNitfImageHeader::getTagData(), ossimDpt::line, ossim::nan(), ossimNitfFile::parseFile(), parseMetaData(), parseRpcData(), parseTileData(), ossimDpt::samp, ossimErrorStatusInterface::setErrorStatus(), ossimFilename::setExtension(), ossimSensorModel::theGSD, and ossimSensorModel::theImageClipRect.

Referenced by parseFile().

 {
    setErrorStatus();
 
    //---
    // ossimNitfFile::parseFile(...) checks the first eight byte so three calls
    // to parseFile are not necessary. drb - 21 Dec. 2016  
    //---
    ossimRefPtr<ossimNitfFile> nitfFilePtr = new ossimNitfFile;
    if( nitfFilePtr->parseFile( file ) == false )
    {
       return false;
    }
    
 #if 0   
    ossimFilename nitfFile = file;
    ossimRefPtr<ossimNitfFile> nitfFilePtr = new ossimNitfFile;
    if(!nitfFilePtr->parseFile(nitfFile))
    {
       nitfFile = nitfFile.setExtension("NTF");
       if(!nitfFilePtr->parseFile(nitfFile))
       {
          nitfFile = nitfFile.setExtension("ntf");
          if(!nitfFilePtr->parseFile(nitfFile))
             return false;
       }
    }
 #endif
    
    ossimRefPtr<ossimNitfImageHeader> ih = nitfFilePtr->getNewImageHeader(0);
    if (!ih)
       return false;
 
    theImageClipRect = ih->getImageRect();
  
    // Give preference to external RPC data file. Only consider external tiling data if RPC is 
    // provided externally, otherwise expect ICHIPB in NITF:
    bool useInternalRpcTags = true;
    if (parseRpcData(file))
    {
       useInternalRpcTags = false;
       if (!parseTileData(file))
          return false;
    }
 
    // Check for IMD (metadata) file:
    parseMetaData(file);
 
    // Get the gsd.
    theGSD.line = ossim::nan();
    theGSD.samp = ossim::nan();
    
    ossimRefPtr<ossimNitfRegisteredTag> tag;
    tag = ih->getTagData(PIAIMC_TAG);
    if (tag.valid())
    {
       ossimNitfPiaimcTag* p = PTR_CAST(ossimNitfPiaimcTag, tag.get());
       if (p)
       {
          theGSD.line = p->getMeanGsdInMeters();
          theGSD.samp = theGSD.line;
       }
    }
    if (ossim::isnan(theGSD.line))
    {
       tag = ih->getTagData(USE00A_TAG);
       if (tag.valid())
       {
          ossimNitfUse00aTag* p = PTR_CAST(ossimNitfUse00aTag, tag.get());
          if (p)
          {
             theGSD.line = p->getMeanGsdInMeters();
             theGSD.samp = theGSD.line;
          }
       }
    }
 
    // If external RPC data file was correctly parsed, then we can bypass this code block. Otherwise
    // need to parse internal NITF tags for RPC data:
    if (useInternalRpcTags)
    {
       // Get the the RPC tag:
       ossimNitfRpcBase* rpcTag = NULL;
       
       // Look for the RPC00B tag first.
       tag = ih->getTagData(RPC00B_TAG);
       if (tag.valid())
          rpcTag = PTR_CAST(ossimNitfRpcBase, tag.get());
       
       if (!tag.valid())
       {
          // Look for RPC00A tag.
          tag = ih->getTagData(RPC00A_TAG);
          if (tag.valid())
             rpcTag = PTR_CAST(ossimNitfRpcBase, tag.get());
       }
       
       if (!rpcTag)
          return false;
       
       // Set the polynomial type.
       if (rpcTag->getRegisterTagName() == "RPC00B")
          thePolyType = B;
       else
          thePolyType = A;
 
       // Parse coefficients:
       for (ossim_uint32 i=0; i<20; ++i)
       {
          theLineNumCoef[i] = rpcTag->getLineNumeratorCoeff(i).toFloat64();
          theLineDenCoef[i] = rpcTag->getLineDenominatorCoeff(i).toFloat64();
          theSampNumCoef[i] = rpcTag->getSampleNumeratorCoeff(i).toFloat64();
          theSampDenCoef[i] = rpcTag->getSampleDenominatorCoeff(i).toFloat64();
       }
 
       // Initialize other items in tags:
       theLineScale  = rpcTag->getLineScale().toFloat64();
       theSampScale  = rpcTag->getSampleScale().toFloat64();
       theLatScale   = rpcTag->getGeodeticLatScale().toFloat64();
       theLonScale   = rpcTag->getGeodeticLonScale().toFloat64();
       theHgtScale   = rpcTag->getGeodeticHeightScale().toFloat64();
       theLineOffset = rpcTag->getLineOffset().toFloat64();
       theSampOffset = rpcTag->getSampleOffset().toFloat64();
       theLatOffset  = rpcTag->getGeodeticLatOffset().toFloat64();
       theLonOffset  = rpcTag->getGeodeticLonOffset().toFloat64();
       theHgtOffset  = rpcTag->getGeodeticHeightOffset().toFloat64();
       theImageID    = ih->getImageId();
    }
 
    finishConstruction();
    clearErrorStatus();
    return true;
 }

◆ parseRpcData()

bool ossimQuickbirdRpcModel::parseRpcData ( const ossimFilename & base_name )

protected

Given some base name for the image data, parses the associated RPC data file.

Returns TRUE if successful

Definition at line 288 of file ossimQuickbirdRpcModel.cpp.

Referenced by ossimQuickbirdRpcModel(), parseNitfFile(), and parseTiffFile().

 {
    ossimFilename rpcFile (base_name);
 
    // There are two possibilities for RPC data files: either each image file has its own RPC data
    // file, or a single RPC file is provided for a multi-tile scene.
    rpcFile.setExtension("RPB");
    if (!findSupportFile(rpcFile))
    {
       rpcFile.setExtension("RPA");
       if (!findSupportFile(rpcFile))
          return false;
    }
 
    // An RPC file was located, open it:
    ossimQuickbirdRpcHeader hdr;
    if(!hdr.open(rpcFile))
       return false;
 
    if(hdr.isAPolynomial())
       thePolyType = A;
    else
       thePolyType = B;
 
    std::copy(hdr.theLineNumCoeff.begin(), hdr.theLineNumCoeff.end(), theLineNumCoef);
    std::copy(hdr.theLineDenCoeff.begin(), hdr.theLineDenCoeff.end(), theLineDenCoef);
    std::copy(hdr.theSampNumCoeff.begin(), hdr.theSampNumCoeff.end(), theSampNumCoef);
    std::copy(hdr.theSampDenCoeff.begin(), hdr.theSampDenCoeff.end(), theSampDenCoef);
 
    theLineScale  = hdr.theLineScale;
    theSampScale  = hdr.theSampScale;
    theLatScale   = hdr.theLatScale;
    theLonScale   = hdr.theLonScale;
    theHgtScale   = hdr.theHeightScale;
    theLineOffset = hdr.theLineOffset;
    theSampOffset = hdr.theSampOffset;
    theLatOffset  = hdr.theLatOffset;
    theLonOffset  = hdr.theLonOffset;
    theHgtOffset  = hdr.theHeightOffset;
    theImageID    = rpcFile.fileNoExtension();
 
    return true;
 }

◆ parseTiffFile()

bool ossimQuickbirdRpcModel::parseTiffFile ( const ossimFilename & file )

protected

Parses a tagged TIFF image file for RPC info. Returns TRUE if successful.

Definition at line 253 of file ossimQuickbirdRpcModel.cpp.

References ossimErrorStatusInterface::clearErrorStatus(), finishConstruction(), ossimImageHandler::getImageRectangle(), ossimDpt::makeNan(), ossimTiffTileSource::open(), parseMetaData(), parseRpcData(), parseTileData(), ossimErrorStatusInterface::setErrorStatus(), ossimSensorModel::theGSD, and ossimSensorModel::theImageClipRect.

Referenced by parseFile().

 {
    setErrorStatus();
 
    // Make the gsd nan so it gets computed.
    theGSD.makeNan();
 
    ossimFilename tiffFile = file;
    ossimRefPtr<ossimTiffTileSource> tiff = new ossimTiffTileSource();
    if (!tiff->open(file))
    {
       return false;
    }
 
    theImageClipRect = tiff->getImageRectangle();
 
    parseMetaData(file);
 
    // TIFF format expects the RPC and TILE info to be provided externally:
    if (!parseRpcData(file))
       return false;
 
    // If no TIL data present, assumes full image:
    if (!parseTileData(file))
       return false;
 
    finishConstruction();
    clearErrorStatus();
    return true;
 }

◆ parseTileData()

bool ossimQuickbirdRpcModel::parseTileData ( const ossimFilename & file )

protected

Reads the TIL file for pertinent info. Returns TRUE if successful.

Definition at line 365 of file ossimQuickbirdRpcModel.cpp.

References ossimFilename::file(), findSupportFile(), ossimQuickbirdTile::getInfo(), ossimDpt::hasNans(), ossimQuickbirdTile::open(), ossimFilename::setExtension(), ossimRpcModel::setImageOffset(), ossimQuickbirdTileInfo::theUlXOffset, and ossimQuickbirdTileInfo::theUlYOffset.

Referenced by parseNitfFile(), and parseTiffFile().

 {
    ossimFilename tileFile (image_file);
    tileFile.setExtension("TIL");
 
    // The TIL file is optional. Consider the image to be the full image if not present:
    if (!findSupportFile(tileFile))
       return true;
 
    ossimQuickbirdTile tileHdr;
    if(!tileHdr.open(tileFile))
       return false;
 
    ossimQuickbirdTileInfo info;
    if(!tileHdr.getInfo(info, image_file.file()))
       return false;
 
 //   if((info.theUlXOffset != OSSIM_INT_NAN) && (info.theUlYOffset != OSSIM_INT_NAN) &&
 //      (info.theLrXOffset != OSSIM_INT_NAN) && (info.theLrYOffset != OSSIM_INT_NAN) &&
 //      (info.theLlXOffset != OSSIM_INT_NAN) && (info.theLlYOffset != OSSIM_INT_NAN) &&
 //      (info.theUrXOffset != OSSIM_INT_NAN) && (info.theUrYOffset != OSSIM_INT_NAN))
 //   {
 //      theImageClipRect = ossimIrect(ossimIpt(info.theUlXOffset, info.theUlYOffset),
 //                                    ossimIpt(info.theUrXOffset, info.theUrYOffset),
 //                                    ossimIpt(info.theLrXOffset, info.theLrYOffset),
 //                                    ossimIpt(info.theLlXOffset, info.theLlYOffset));
 //   }
 //   else if ((info.theUlXOffset != OSSIM_INT_NAN) && (info.theUlYOffset != OSSIM_INT_NAN) &&
 //      (theImageClipRect.width() != OSSIM_INT_NAN) && (theImageClipRect.height() != OSSIM_INT_NAN))
 //   {
 //      theImageClipRect = ossimIrect(info.theUlXOffset, info.theUlYOffset,
 //                                    info.theUlXOffset+theImageClipRect.width()-1,
 //                                    info.theUlYOffset+theImageClipRect.height()-1);
 //   }
 
    // Define the RPC model's 2D transform for chipped imagery. Note that the TIL file will only
    // define an offset, not a full affine.  Can only use the tile's UL corner:
    ossimDpt ul (info.theUlXOffset, info.theUlYOffset);
    if (!ul.hasNans())
       setImageOffset(ul);
       //theImageXform = new ossim2dTo2dShiftTransform(ul);
 
    return true;
 }

◆ saveState()

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

virtual

saveState Fulfills ossimObject base-class pure virtuals.

Loads and saves geometry KWL files. Returns true if successful.

Reimplemented from ossimRpcModel.

Definition at line 457 of file ossimQuickbirdRpcModel.cpp.

References ossimQuickbirdMetaData::saveState(), ossimRpcModel::saveState(), theSupportData, and ossimRefPtr< T >::valid().

 {
    // sanity check only.  This shoulc always be true
    if(theSupportData.valid())
    {
       ossimString supportPrefix = ossimString(prefix) + "support_data.";
       theSupportData->saveState(kwl, supportPrefix);
    }
 
    return ossimRpcModel::saveState(kwl, prefix);
 }

◆ setSupportData()

void ossimQuickbirdRpcModel::setSupportData ( ossimQuickbirdMetaData * supportData )

inline

Definition at line 52 of file ossimQuickbirdRpcModel.h.

References theSupportData.

    {
       theSupportData = supportData;
    }

Member Data Documentation

◆ theSupportData

ossimRefPtr<ossimQuickbirdMetaData> ossimQuickbirdRpcModel::theSupportData

protected

Definition at line 80 of file ossimQuickbirdRpcModel.h.

Referenced by getSupportData(), loadState(), parseMetaData(), saveState(), setSupportData(), and ~ossimQuickbirdRpcModel().

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

Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ossimQuickbirdRpcModel() [1/3]

◆ ossimQuickbirdRpcModel() [2/3]

◆ ossimQuickbirdRpcModel() [3/3]

◆ ~ossimQuickbirdRpcModel()

Member Function Documentation

◆ dup()

◆ findSupportFile()

◆ finishConstruction()

◆ getSupportData() [1/2]

◆ getSupportData() [2/2]

◆ loadState()

◆ parseFile()

◆ parseMetaData()

◆ parseNitfFile()

◆ parseRpcData()

◆ parseTiffFile()

◆ parseTileData()

◆ saveState()

◆ setSupportData()

Member Data Documentation

◆ theSupportData