This class allows for direct localisation and indirect localisation using the RadarSat2 sensor model. More...

#include <ossimRadarSat2RPCModel.h>

Inheritance diagram for ossimplugins::ossimRadarSat2RPCModel:

Public Member Functions
	ossimRadarSat2RPCModel ()
	default constructor More...

	ossimRadarSat2RPCModel (const ossimRadarSat2RPCModel &rhs)
	copy constructor More...

	ossimRadarSat2RPCModel (const ossimFilename &RS2File)

virtual	~ossimRadarSat2RPCModel ()
	Destructor. More...

virtual ossimString	getClassName () const
	Method to return the class name. More...

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

bool	open (const ossimFilename &file)
	Method to parse an nitf file and initialize model. More...

virtual bool	saveState (ossimKeywordlist &kwl, const char *prefix=0) const
	Method to save object state to a keyword list. More...

virtual bool	loadState (const ossimKeywordlist &kwl, const char *prefix=0)
	Method to the load (recreate) the state of the object from a keyword list. More...

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

virtual void	worldToLineSample (const ossimGpt &world_point, ossimDpt &image_point) const
	worldToLineSample() Calls ossimRpcModel::worldToLineSample(), then applies (if needed) decimation. More...

virtual void	lineSampleHeightToWorld (const ossimDpt &image_point, const double &heightEllipsoid, ossimGpt &worldPoint) const
	lineSampleHeightToWorld() Backs out decimation of image_point (if needed) then calls: ossimRpcModel::lineSampleHeightToWorld This is a temp work around for decimation RPC NITFs. More...

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	lineSampleToWorld (const ossimDpt &image_point, ossimGpt &world_point) 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 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...

Private Member Functions
bool	InitSensorParams (const ossimKeywordlist &kwl, const char *prefix)

bool	initSensorParams (const ossimXmlDocument *xdoc, const ossimRadarSat2ProductDoc &rsDoc)

Private Attributes
ossim_float64	theDecimation
	Stored from header field "IMAG". More...

SensorParams *	_sensor

ossimFilename	theProductXmlFile

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 }

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 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

Detailed Description

This class allows for direct localisation and indirect localisation using the RadarSat2 sensor model.

Definition at line 45 of file ossimRadarSat2RPCModel.h.

Constructor & Destructor Documentation

◆ ossimRadarSat2RPCModel() [1/3]

ossimplugins::ossimRadarSat2RPCModel::ossimRadarSat2RPCModel ( )

default constructor

Definition at line 51 of file ossimRadarSat2RPCModel.cpp.

Referenced by dup().

    :
    ossimRpcModel(),
    theDecimation(1.0),
    theProductXmlFile(ossimFilename::NIL)
 {
 }

◆ ossimRadarSat2RPCModel() [2/3]

ossimplugins::ossimRadarSat2RPCModel::ossimRadarSat2RPCModel ( const ossimRadarSat2RPCModel & rhs )

copy constructor

Definition at line 59 of file ossimRadarSat2RPCModel.cpp.

    :
    ossimRpcModel(rhs),
    theDecimation(1.0),
    theProductXmlFile(rhs.theProductXmlFile)
 {
    
 }

◆ ossimRadarSat2RPCModel() [3/3]

ossimplugins::ossimRadarSat2RPCModel::ossimRadarSat2RPCModel ( const ossimFilename & RS2File )

Definition at line 76 of file ossimRadarSat2RPCModel.cpp.

References open(), ossimNotify(), and ossimNotifyLevel_DEBUG.

    :ossimRpcModel(), theDecimation(1.0)
 {
    
    // Open the XML file, and read the RPC values in.
    if (!open(RS2File))
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << "DEBUG ossimRadarSat2RPCModel::ossimRadarSat2RPCModel(RS2File): Unable to parse file " << RS2File
            << std::endl;
    }
 
 }

◆ ~ossimRadarSat2RPCModel()

ossimplugins::ossimRadarSat2RPCModel::~ossimRadarSat2RPCModel ( )

virtual

Destructor.

Definition at line 90 of file ossimRadarSat2RPCModel.cpp.

91 {

92 }

Member Function Documentation

◆ dup()

ossimObject * ossimplugins::ossimRadarSat2RPCModel::dup ( ) const

virtual

Returns pointer to a new instance, copy of this.

Reimplemented from ossimRpcModel.

Definition at line 101 of file ossimRadarSat2RPCModel.cpp.

References ossimRadarSat2RPCModel().

 {
    return new ossimRadarSat2RPCModel(*this);
 }

◆ getClassName()

ossimString ossimplugins::ossimRadarSat2RPCModel::getClassName ( ) const

virtual

Method to return the class name.

Returns: The name of this class.

Reimplemented from ossimObject.

Definition at line 94 of file ossimRadarSat2RPCModel.cpp.

Referenced by loadState().

 {
    return ossimString("ossimRadarSat2RPCModel");
 }

◆ InitSensorParams()

bool ossimplugins::ossimRadarSat2RPCModel::InitSensorParams	(	const ossimKeywordlist &	kwl,
		const char *	prefix
	)

private

Definition at line 433 of file ossimRadarSat2RPCModel.cpp.

 {
    
    // sensor frequencies
    const char* central_freq_str = kwl.find(prefix,"central_freq");
    double central_freq = 0.0;
    if (central_freq_str)
    {
       central_freq = ossimString::toDouble(central_freq_str);
    }
    const char* fr_str = kwl.find(prefix,"fr");
    double fr = 0.0;
    if (fr_str)
    {
       fr = ossimString::toDouble(fr_str);
    }
    const char* fa_str = kwl.find(prefix,"fa");
    double fa = 0.0;
    if (fa_str)
    {
       fa = ossimString::toDouble(fa_str);
    }
    
    //number of different looks
    const char* n_azilok_str = kwl.find(prefix,"n_azilok");
    double n_azilok = 0.0;
    if (n_azilok_str)
    {
       n_azilok = ossimString::toDouble(n_azilok_str);
    }
    const char* n_rnglok_str = kwl.find(prefix,"n_rnglok");
    double n_rnglok = 0.0;
    if (n_rnglok_str)
    {
       n_rnglok = ossimString::toDouble(n_rnglok_str);
    }
    
    //ellipsoid parameters
    const char* ellip_maj_str = kwl.find(prefix,"ellip_maj");
    double ellip_maj = 0.0;
    if (ellip_maj_str)
    {
       ellip_maj = ossimString::toDouble(ellip_maj_str) * 1000.0;// km -> m
    }
    const char* ellip_min_str = kwl.find(prefix,"ellip_min");
    double ellip_min = 0.0;
    if (ellip_min_str)
    {
       ellip_min = ossimString::toDouble(ellip_min_str) * 1000.0;// km -> m
    }
    
    if(_sensor != 0)
    {
       delete _sensor;
    }
    
    _sensor = new SensorParams();
    
    const char* lineTimeOrdering_str = kwl.find(prefix,"lineTimeOrdering");
    std::string lineTimeOrdering(lineTimeOrdering_str) ;
    const char* pixelTimeOrdering_str = kwl.find(prefix,"pixelTimeOrdering");
    std::string pixelTimeOrdering(pixelTimeOrdering_str) ;
    if (pixelTimeOrdering == "Increasing") _sensor->set_col_direction(1);
    else _sensor->set_col_direction(- 1);
    if (lineTimeOrdering == "Increasing") _sensor->set_lin_direction(1);
    else _sensor->set_lin_direction(- 1);
    
    const char* lookDirection_str = kwl.find(prefix,"lookDirection");
    std::string lookDirection(lookDirection_str) ;
    if ((lookDirection == "Right")||(lookDirection == "RIGHT")) _sensor->set_sightDirection(SensorParams::Right) ;
    else _sensor->set_sightDirection(SensorParams::Left) ;
    
    _sensor->set_sf(fr);
    const double CLUM        = 2.99792458e+8 ;
    double wave_length = CLUM / central_freq ;
    _sensor->set_rwl(wave_length);
    _sensor->set_nAzimuthLook(n_azilok);
    _sensor->set_nRangeLook(n_rnglok);
    
    // fa is the processing PRF
    _sensor->set_prf(fa * n_azilok);
    
    _sensor->set_semiMajorAxis(ellip_maj) ;
    _sensor->set_semiMinorAxis(ellip_min) ;
    
    return true;
 }

◆ initSensorParams()

bool ossimplugins::ossimRadarSat2RPCModel::initSensorParams	(	const ossimXmlDocument *	xdoc,
		const ossimRadarSat2ProductDoc &	rsDoc
	)

private

Definition at line 522 of file ossimRadarSat2RPCModel.cpp.

References _sensor, ossimplugins::ossimRadarSat2ProductDoc::initSensorParams(), ossimNotify(), and ossimNotifyLevel_DEBUG.

 {
    static const char MODULE[] = "ossimRadarSat2RPCModel::initSensorParams";
    
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)<< MODULE << " entered...\n";
    }
    
    if (_sensor )
    {
       delete _sensor;
    }
    _sensor =  new SensorParams();
    
    bool result = rsDoc.initSensorParams(xdoc, _sensor);
    
    if (!result)
    {
       delete _sensor;
       _sensor = 0;
    }
    
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << MODULE << " exit status = " << (result?"true":"false\n")
          << std::endl;
    }
    
    return result;
 }

◆ lineSampleHeightToWorld()

void ossimplugins::ossimRadarSat2RPCModel::lineSampleHeightToWorld	(	const ossimDpt &	image_point,
		const double &	heightEllipsoid,
		ossimGpt &	worldPoint
	)		const

virtual

lineSampleHeightToWorld() Backs out decimation of image_point (if needed) then calls: ossimRpcModel::lineSampleHeightToWorld This is a temp work around for decimation RPC NITFs.

Reimplemented from ossimRpcModel.

Definition at line 405 of file ossimRadarSat2RPCModel.cpp.

References ossimRpcModel::lineSampleHeightToWorld(), theDecimation, ossimDpt::x, and ossimDpt::y.

 {
    
    // Convert image point to full res (not decimated) point.
    ossimDpt pt;
    pt.x = image_point.x / theDecimation;
    pt.y = image_point.y / theDecimation;
    
    // Call base...
    ossimRpcModel::lineSampleHeightToWorld(pt, heightEllipsoid, worldPoint);
 }

◆ loadState()

bool ossimplugins::ossimRadarSat2RPCModel::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.

Returns: true if load OK, false on error

Reimplemented from ossimRpcModel.

Definition at line 590 of file ossimRadarSat2RPCModel.cpp.

References ossimPolygon::clear(), ossimKeywordlist::find(), getClassName(), ossimRpcModel::loadState(), open(), ossimNotify(), ossimNotifyLevel_DEBUG, ossimSensorModel::theBoundGndPolygon, theDecimation, theProductXmlFile, ossimString::toBool(), ossimString::toFloat64(), and ossimKeywordNames::TYPE_KW.

 {
    static const char MODULE[] = "ossimRadarSat2RPCModel::loadState";
    
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG) << MODULE << " entered...\n";
    }
    
    const char* lookup = 0;
    ossimString s;
    
    // Check the type first.
    lookup = kwl.find(prefix, ossimKeywordNames::TYPE_KW);
    if (lookup)
    {
       s = lookup;
       if (s != getClassName())
       {
          return false;
       }
    }
    
    // Get the product.xml file name.
    lookup = kwl.find(prefix, PRODUCT_XML_FILE_KW);
    if (lookup)
    {
       theProductXmlFile = lookup;
       
       // See if caller wants to load from xml vice keyword list.
       lookup = kwl.find(prefix, LOAD_FROM_PRODUCT_FILE_KW);
       if (lookup)
       {
          s = lookup;
          if ( s.toBool() )
          {
             // Loading from product.xml file.
             return open(theProductXmlFile);
          }
       }
    }
    
    
    // Call base.
    bool result = ossimRpcModel::loadState(kwl, prefix);
 
    // Lookup decimation.
    const char* value = kwl.find(prefix, "decimation");
    if (value)
    {
       theDecimation = ossimString(value).toFloat64();
       if (theDecimation <= 0.0)
       {
          // Do not allow negative or "0.0"(divide by zero).
          theDecimation = 1.0;
       }
    }
    
    
    //---
    // Temp:  This must be cleared or you end up with a bounding rect of all
    // zero's.
    //---
    theBoundGndPolygon.clear();
    
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << MODULE << " exit status = " << (result?"true":"false\n")
          << std::endl;
    }
    
    return result;
 }

◆ open()

bool ossimplugins::ossimRadarSat2RPCModel::open ( const ossimFilename & file )

Method to parse an nitf file and initialize model.

Parameters

entryIndex The entry to get model for. Note the nitf's can have multiple entries; each with a different projection.

Returns: true on success, false on error.

Definition at line 106 of file ossimRadarSat2RPCModel.cpp.

References ossimRpcModel::B, RPCModel::biasError, ossimFilename::dirCat(), ossimString::downcase(), ossimFilename::exists(), ossimFilename::expand(), ossimFilename::ext(), ossimplugins::ossimRadarSat2ProductDoc::getAcquisitionType(), ossimplugins::ossimRadarSat2ProductDoc::getBeamModeMnemonic(), ossimplugins::ossimRadarSat2ProductDoc::getImageId(), ossimplugins::ossimRadarSat2ProductDoc::getRpcData(), ossimplugins::ossimRadarSat2ProductDoc::getSatellite(), RPCModel::heightOffset, RPCModel::heightScale, ossimGpt::hgt, ossimplugins::ossimRadarSat2ProductDoc::initGsd(), ossimplugins::ossimRadarSat2ProductDoc::initImageSize(), ossimFilename::isFile(), ossimGpt::isLatNan(), ossimGpt::isLonNan(), ossimplugins::ossimRadarSat2ProductDoc::isRadarSat2(), ossimGpt::lat, RPCModel::latitudeOffset, RPCModel::latitudeScale, ossimIpt::line, ossimDpt::line, RPCModel::lineDenominatorCoefficients, RPCModel::lineNumeratorCoefficients, RPCModel::lineOffset, ossimRpcModel::lineSampleHeightToWorld(), ossimRpcModel::lineSampleToWorld(), RPCModel::lineScale, ossimDrect::ll(), ossimGpt::lon, RPCModel::longitudeOffset, RPCModel::longitudeScale, ossimDrect::lr(), ossimFilename::NIL, ossimXmlDocument::openFile(), ossimNotify(), ossimNotifyLevel_DEBUG, ossimFilename::path(), RPCModel::pixelDenominatorCoefficients, RPCModel::pixelNumeratorCoefficients, RPCModel::pixelOffset, RPCModel::pixelScale, RPCModel::randomError, ossimIpt::samp, ossimDpt::samp, ossimErrorStatusInterface::setErrorStatus(), ossimSensorModel::setGroundRect(), ossimRpcModel::theBiasError, ossimSensorModel::theBoundGndPolygon, theDecimation, ossimSensorModel::theGSD, ossimRpcModel::theHgtOffset, ossimRpcModel::theHgtScale, ossimSensorModel::theImageClipRect, ossimSensorModel::theImageID, ossimSensorModel::theImageSize, ossimRpcModel::theLatOffset, ossimRpcModel::theLatScale, ossimRpcModel::theLineDenCoef, ossimRpcModel::theLineNumCoef, ossimRpcModel::theLineOffset, ossimRpcModel::theLineScale, ossimRpcModel::theLonOffset, ossimRpcModel::theLonScale, ossimSensorModel::theMeanGSD, ossimSensorModel::theNominalPosError, ossimRpcModel::thePolyType, theProductXmlFile, ossimRpcModel::theRandError, ossimSensorModel::theRefGndPt, ossimSensorModel::theRefImgPt, ossimRpcModel::theSampDenCoef, ossimRpcModel::theSampNumCoef, ossimRpcModel::theSampOffset, ossimRpcModel::theSampScale, ossimSensorModel::theSensorID, ossimSensorModel::theSubImageOffset, ossimDrect::ul(), ossimRpcModel::updateModel(), ossimDrect::ur(), ossimIpt::x, ossimDpt::x, ossimIpt::y, and ossimDpt::y.

Referenced by loadState(), and ossimRadarSat2RPCModel().

 {
    static const char MODULE[] = "ossimRadarSat2RPCModel::open";
    
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)<< MODULE << " entered...\n";
    }
    
    bool result = false;
    
    // Get the xml file.
    ossimFilename xmlFile;
    
    if (file.ext().downcase() == "xml")
    {
       xmlFile = file;
    }
    else if (file.isFile())
    {
       xmlFile = file.expand().path().dirCat("product.xml");
    }
    
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << "product xml file: " << xmlFile << "\n";
    }
    
    if ( xmlFile.exists() )
    {
       //---
       // Instantiate the XML parser:
       //---
       ossimXmlDocument* xdoc = new ossimXmlDocument();
       if ( xdoc->openFile(xmlFile) )
       {
          ossimRadarSat2ProductDoc rsDoc;
          
          result = rsDoc.isRadarSat2(xdoc);
          
          if (result)
          {
             if (traceDebug())
             {
                ossimNotify(ossimNotifyLevel_DEBUG)
                   << "isRadarSat2...\n";
                ossimString s;
                if ( rsDoc.getBeamModeMnemonic(xdoc, s) )
                {
                   ossimNotify(ossimNotifyLevel_DEBUG)
                      << "beam_mode_mnemonic: " << s << "\n";
                }
                if ( rsDoc.getAcquisitionType(xdoc, s) )
                {
                   ossimNotify(ossimNotifyLevel_DEBUG)
                      << "acquisition_type: " << s << "\n";
                }
             }
             
             // Set the base class number of lines and samples
             result = rsDoc.initImageSize(xdoc, theImageSize);
             
             
             //---
             // Fetch Image Size:
             //---
 
             theImageSize.line = theImageSize.x;
             theImageSize.samp =theImageSize.y;
 
 
             //***
                  // Assign the bounding image space rectangle:
                  //***
 
                       if (result)
                    {
                       // Set the base class clip rect.
                       theImageClipRect = ossimDrect(
                          0, 0,
                          theImageSize.x-1, theImageSize.y-1);
                    }
 
             // Set the sub image offset. tmp hard coded (drb).
             theSubImageOffset.x = 0.0;
             theSubImageOffset.y = 0.0;
 
             // Set the image id.
             if (result)
             {
                result = rsDoc.getImageId(xdoc, theImageID);
             }
 
             // Set the sensor ID.
             if (result)
             {
                result = rsDoc.getSatellite(xdoc, theSensorID);
             }
 
             // Set the base class gsd:
             result = rsDoc.initGsd(xdoc, theGSD);
             if (result)
             {
                theMeanGSD = (theGSD.x + theGSD.y)/2.0;
             }
 
 
          }
 
          thePolyType = B;
 
 
          RPCModel model;
          model = rsDoc.getRpcData(xdoc);
 
 
          theBiasError  = model.biasError;
          theRandError  = model.randomError;
          theLineOffset = model.lineOffset;
          theSampOffset = model.pixelOffset;
          theLatOffset  = model.latitudeOffset;
          theLonOffset  = model.longitudeOffset;
          theHgtOffset  = model.heightOffset;
          theLineScale  = model.lineScale;
          theSampScale  = model.pixelScale;
          theLatScale   = model.latitudeScale;
          theLonScale   = model.longitudeScale;
          theHgtScale   = model.heightScale;
 
 
          if (traceDebug())
          {
             ossimNotify(ossimNotifyLevel_DEBUG)
                << "All parameters RPC : "
                << theBiasError << ", "
                << theRandError << ", "
                << theLineOffset << ", "
                << theSampOffset << ", "
                << theLatOffset << ", "
                << theLonOffset << ", "
                << theHgtOffset << ", "
                << theLineScale << ", "
                << theSampScale << ", "
                << theLatScale << ", "
                << theLonScale << ", "
                << theHgtScale << ", " << std::endl;
          }
 
          // Parse coefficients:
          ossim_uint32 i;
 
          for (i=0; i<20; ++i)
          {
 
             theLineNumCoef[i] = model.lineNumeratorCoefficients[i];
             theLineDenCoef[i] = model.lineDenominatorCoefficients[i];
             theSampNumCoef[i] = model.pixelNumeratorCoefficients[i];
             theSampDenCoef[i] = model.pixelDenominatorCoefficients[i];
          }
 
          // Assign other data members to default values:
          theNominalPosError = sqrt(theBiasError*theBiasError +
                                    theRandError*theRandError); // meters
 
 
 
 
       } // matches: if ( xdoc->openFile(xmlFile) )
 
       delete xdoc;
       xdoc = 0;
 
    } // matches: if ( xmlFile.exists() )
 
    if (result)
    {
       theProductXmlFile = xmlFile;
    }
    else
    {
       theProductXmlFile = ossimFilename::NIL;
    }
 
    if (result)
    {
       theProductXmlFile = xmlFile;
    }
    else
    {
       theProductXmlFile = ossimFilename::NIL;
    }
 
    if (result)
    {
       // Assign the ossimSensorModel::theBoundGndPolygon
       ossimGpt ul;
       ossimGpt ur;
       ossimGpt lr;
       ossimGpt ll;
       lineSampleToWorld(theImageClipRect.ul(), ul);
       lineSampleToWorld(theImageClipRect.ur(), ur);
       lineSampleToWorld(theImageClipRect.lr(), lr);
       lineSampleToWorld(theImageClipRect.ll(), ll);
       setGroundRect(ul, ur, lr, ll);  // ossimSensorModel method.
    }
 
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << MODULE << " exit status = " << (result?"true":"false\n")
          << std::endl;
    }
 
 
 
    //---
    // Get the decimation if any from the header "IMAG" field.
    //
    // Look for string like:
    // "/2" = 1/2
    // "/4  = 1/4
    // ...
    // "/16 = 1/16
    // If it is full resolution it should be "1.0"
    //---
 
    theDecimation = 1.0;
 
 
 
    //***
         // Assign other data members:
         //***
              thePolyType = B;                   // This may not be true for early RPC imagery
    theRefImgPt.line = theImageSize.line/2.0;
    theRefImgPt.samp = theImageSize.samp/2.0;
    theRefGndPt.lat  = theLatOffset;
    theRefGndPt.lon  = theLonOffset;
    theRefGndPt.hgt  = theHgtOffset;
 
 
    //---
    // Assign the bounding ground polygon:
    //
    // NOTE:  We will use the base ossimRpcModel for transformation since all
    // of our calls are in full image space (not decimated).
    //---
 
    ossimGpt v0, v1, v2, v3;
    ossimDpt ip0 (0.0, 0.0);
    ossimRpcModel::lineSampleHeightToWorld(ip0, theHgtOffset, v0);
    ossimDpt ip1 (theImageSize.samp-1.0, 0.0);
    ossimRpcModel::lineSampleHeightToWorld(ip1, theHgtOffset, v1);
    ossimDpt ip2 (theImageSize.samp-1.0, theImageSize.line-1.0);
    ossimRpcModel::lineSampleHeightToWorld(ip2, theHgtOffset, v2);
    ossimDpt ip3 (0.0, theImageSize.line-1.0);
    ossimRpcModel::lineSampleHeightToWorld(ip3, theHgtOffset, v3);
 
    theBoundGndPolygon
       = ossimPolygon (ossimDpt(v0), ossimDpt(v1), ossimDpt(v2), ossimDpt(v3));
 
    updateModel();
 
    // Set the ground reference point.
    ossimRpcModel::lineSampleHeightToWorld(theRefImgPt,
                                           theHgtOffset,
                                           theRefGndPt);
 
    if ( theRefGndPt.isLatNan() || theRefGndPt.isLonNan() )
    {
       if (traceDebug())
       {
          ossimNotify(ossimNotifyLevel_DEBUG)
             << "ossimNitfRpcModel::ossimNitfRpcModel DEBUG:"
             << "\nGround Reference Point not valid."
             << " Aborting with error..."
             << std::endl;
       }
       setErrorStatus();
       return false;
    }
 
 
    return true;
 }

◆ print()

std::ostream & ossimplugins::ossimRadarSat2RPCModel::print ( std::ostream & out ) const

virtual

METHOD: print() Fulfills base-class pure virtual. Dumps contents of object to ostream.

Reimplemented from ossimRpcModel.

Definition at line 420 of file ossimRadarSat2RPCModel.cpp.

References ossimRpcModel::print().

 {
    // Capture the original flags.
    std::ios_base::fmtflags f = out.flags();
    
    ossimRpcModel::print(out);
    
    // Reset flags.
    out.setf(f);
    
    return out;
 }

◆ saveState()

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

virtual

Method to save object state to a keyword list.

Parameters

kwl	Keyword list to save to.
prefix	added to keys when saved.

Returns: true on success, false on error.

Reimplemented from ossimRpcModel.

Definition at line 556 of file ossimRadarSat2RPCModel.cpp.

References ossimKeywordlist::add(), ossimString::c_str(), ossimNotify(), ossimNotifyLevel_DEBUG, ossimRpcModel::saveState(), theDecimation, and theProductXmlFile.

 {
    static const char MODULE[] = "ossimRadarSat2RPCModel::saveState";
    
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)<< MODULE << " entered...\n";
    }
    
    bool result = true;
    
    kwl.add(prefix, "decimation", theDecimation);
    
    // Save our state:
    kwl.add(prefix, PRODUCT_XML_FILE_KW, theProductXmlFile.c_str());
    
    if (result)
    {
       // Call base save state:
       result = ossimRpcModel::saveState(kwl, prefix);
    }
    
    if (traceDebug())
    {
       ossimNotify(ossimNotifyLevel_DEBUG)
          << MODULE << " exit status = " << (result?"true":"false\n")
          << std::endl;
    }
    
    return result;
 }

◆ worldToLineSample()

void ossimplugins::ossimRadarSat2RPCModel::worldToLineSample	(	const ossimGpt &	world_point,
		ossimDpt &	image_point
	)		const

virtual

worldToLineSample() Calls ossimRpcModel::worldToLineSample(), then applies (if needed) decimation.

This is a temp work around for decimation RPC NITFs.

Reimplemented from ossimRpcModel.

Definition at line 394 of file ossimRadarSat2RPCModel.cpp.

References theDecimation, ossimRpcModel::worldToLineSample(), ossimDpt::x, and ossimDpt::y.

 {
    // Get the full res (not decimated) point.
    ossimRpcModel::worldToLineSample(world_point, image_point);
    
    // Apply decimation.
    image_point.x = image_point.x * theDecimation;
    image_point.y = image_point.y * theDecimation;
 }

Member Data Documentation

◆ _sensor

SensorParams* ossimplugins::ossimRadarSat2RPCModel::_sensor

private

Definition at line 141 of file ossimRadarSat2RPCModel.h.

Referenced by InitSensorParams(), and initSensorParams().

◆ theDecimation

ossim_float64 ossimplugins::ossimRadarSat2RPCModel::theDecimation

private

Stored from header field "IMAG".

This is a temp work around to handle decimated rpc nitf's.

Definition at line 139 of file ossimRadarSat2RPCModel.h.

Referenced by lineSampleHeightToWorld(), loadState(), open(), saveState(), and worldToLineSample().

◆ theProductXmlFile

ossimFilename ossimplugins::ossimRadarSat2RPCModel::theProductXmlFile

private

Definition at line 145 of file ossimRadarSat2RPCModel.h.

Referenced by loadState(), open(), and saveState().

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

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ ossimRadarSat2RPCModel() [1/3]

◆ ossimRadarSat2RPCModel() [2/3]

◆ ossimRadarSat2RPCModel() [3/3]

◆ ~ossimRadarSat2RPCModel()

Member Function Documentation

◆ dup()

◆ getClassName()

◆ InitSensorParams()

◆ initSensorParams()

◆ lineSampleHeightToWorld()

◆ loadState()

◆ open()

◆ print()

◆ saveState()

◆ worldToLineSample()

Member Data Documentation

◆ _sensor

◆ theDecimation

◆ theProductXmlFile