Main Page | Modules | Namespace List | Class Hierarchy | Class List | Directories | File List | Namespace Members | Class Members | File Members | Related Pages | Examples | Search for 

DeltaOp Class Reference
[GPS solution algorithms and Tropospheric]

#include <DeltaOp.hpp>

Inheritance diagram for DeltaOp:

Inheritance graph
[legend]
Collaboration diagram for DeltaOp:

Collaboration graph
[legend]
List of all members.

Detailed Description

This class applies the Delta operator (differences on ground-related data) to GNSS data structures.

A typical way to use this class follows:

      // Input observation file stream for ROVER
   RinexObsStream rin("ebre0300.02o");
      // Reference position of receiver station
   Position nominalPos(4833520.2269, 41537.00768, 4147461.489);

      // Input observation file stream for REFERENCE STATION
   RinexObsStream rinRef("garr1900.07o");
      // Reference station nominal position
   Position nominalPosRef(4796983.7690, 160308.7500, 4187339.9860);

      // Some more code and definitions here...

      // GNSS data structure for rover data
   gnssRinex gRin;

      // GNSS data structure for reference station data
   gnssRinex gRef;

      // Set model defaults. A typical C1-based modeling is used
      // Set up rover's modeling object
   ModeledPR model( nominalPos,
                    ionoStore,
                    mopsTM,
                    bceStore,
                    TypeID::C1,
                    true );

      // Set up reference station's modeling object
   ModeledReferencePR modelRef( nominalPosRef,
                                ionoStore,
                                mopsTM,
                                bceStore,
                                TypeID::C1,
                                true );

      // Create an object to compute the single differences
      // of prefit residuals
   DeltaOp delta;


   while(rin >> gRin)
   {

      rinRef >> gRef;   // Be sure that data streams ARE synchronized
                        // before following on!!!

         // Set the reference data to be differenced
      delta.setRefData(gRef.body);

         // Apply model to reference data
      gRef >> modelRef;

         // By default, difference is applied on code prefit residuals
      gRin >> model >> delta >> solver;
   }

The "DeltaOp" object will visit every satellite in the GNSS data structure that is "gRin" and will substract from the specified type or types (code prefit residuals by default) the corresponding data in the "gRef" data structure.

Take notice that in the default case the code prefit residuals were computed by objects of classes such as "ModeledPR" and "ModeledReferencePR" (among others) objects, so those steps are mandatory.

Be warned that, by default, if a given satellite in "gRin" does not have the data required to be differenced, it will be summarily deleted from the data structure.

See also:
NablaOp.hpp for differences on satellite-related data.

Definition at line 127 of file DeltaOp.hpp.

Public Member Functions

 DeltaOp ()
 Default constructor.
 DeltaOp (const satTypeValueMap &gData, const bool &delSats=true)
 Common constructor taking a satTypeValueMap as reference station data.
 DeltaOp (const satTypeValueMap &gData, const TypeID &difftype, const bool &delSats=true)
 Common constructor taking a satTypeValueMap as reference station data.
 DeltaOp (const satTypeValueMap &gData, const TypeIDSet &diffSet, const bool &delSats=true)
 Common constructor taking a satTypeValueMap as reference station data.
 DeltaOp (const gnssSatTypeValue &gData, const bool &delSats=true)
 Common constructor taking a gnssSatTypeValue as reference station data.
 DeltaOp (const gnssSatTypeValue &gData, const TypeID &difftype, const bool &delSats=true)
 Common constructor taking a gnssSatTypeValue as reference station data.
 DeltaOp (const gnssSatTypeValue &gData, const TypeIDSet &diffSet, const bool &delSats=true)
 Common constructor taking a gnssSatTypeValue as reference station data.
 DeltaOp (const gnssRinex &gData, const bool &delSats=true)
 Common constructor taking a gnssRinex as reference station data.
 DeltaOp (const gnssRinex &gData, const TypeID &difftype, const bool &delSats=true)
 Common constructor taking a gnssRinex as reference station data.
 DeltaOp (const gnssRinex &gData, const TypeIDSet &diffSet, const bool &delSats=true)
 Common constructor taking a gnssRinex as reference station data.
virtual DeltaOp & setRefData (const satTypeValueMap &gData)
 Method to set the satTypeValueMap data object holding reference station data.
virtual DeltaOp & setRefData (const gnssSatTypeValue &gData)
 Method to set the gnssSatTypeValue data object holding reference station data.
virtual DeltaOp & setRefData (const gnssRinex &gData)
 Method to set the gnssRinex data object holding reference station data.
virtual satTypeValueMap getRefData (void) const
 Method to get the satTypeValueMap data object holding reference station data.
virtual DeltaOp & setDeleteMissingSats (const bool &deleteSats)
 Method to set if satellites present in reference station data but missing in input data will be deleted from the later (this is the default behaviour).
virtual bool getDeleteMissingSats (void) const
 Method to get the deleteMissingSats field value, i.e., if missing satellites will be deleted (returns true) or not (returns false).
virtual DeltaOp & setDiffType (const TypeID &difftype)
 Method to set the data values to be differenced.
virtual DeltaOp & addDiffType (const TypeID &difftype)
 Method to add a data value type to be differenced.
virtual DeltaOp & setDiffTypeSet (const TypeIDSet &diffSet)
 Method to set a set of data values to be differenced.
virtual DeltaOp & addDiffTypeSet (const TypeIDSet &diffSet)
 Method to add a set of data value types to be differenced.
virtual TypeIDSet getDiffTypeSet (void) const
 Method to get the set of data value types to be differenced.
virtual satTypeValueMap & Process (satTypeValueMap &gData) throw (ProcessingException)
 Returns a reference to a satTypeValueMap object after differencing data type values given in 'diffTypes' field with respect to reference station data in 'refData' field.
virtual gnssSatTypeValue & Process (gnssSatTypeValue &gData) throw (ProcessingException)
 Returns a reference to a gnssSatTypeValue object after differencing data type values given in 'diffTypes' field with respect to reference station data in 'refData' field.
virtual gnssRinex & Process (gnssRinex &gData) throw (ProcessingException)
 Returns a reference to a gnnsRinex object after differencing data type values given in 'diffTypes' field with respect to reference station data in 'refData' field.
virtual int getIndex (void) const
 Returns an index identifying this object.
virtual std::string getClassName (void) const
 Returns a string identifying this object.
virtual ~DeltaOp ()
 Destructor.

Constructor & Destructor Documentation

DeltaOp (   )  [inline]
 

Default constructor.

By default, it will difference prefitC data and will delete satellites present in reference station data but missing in input data.

Definition at line 135 of file DeltaOp.hpp.

DeltaOp (  const satTypeValueMap &  gData,
const bool &  delSats = true
)  [inline]
 

Common constructor taking a satTypeValueMap as reference station data.

By default it will difference prefitC data and will delete satellites present in reference station data but missing in input data.

Parameters:
gData satTypeValueMap data object holding reference station data.
delSats Boolean value setting if satellites present in reference station data but missing in input data will be deleted from the later (this is the default behaviour).

Definition at line 154 of file DeltaOp.hpp.

DeltaOp (  const satTypeValueMap &  gData,
const TypeID &  difftype,
const bool &  delSats = true
)  [inline]
 

Common constructor taking a satTypeValueMap as reference station data.

By default it will delete satellites present in reference station data but missing in input data.

Parameters:
gData satTypeValueMap data object holding reference station data.
difftype TypeID of data values to be differenced.
delSats Boolean value setting if satellites present in reference station data but missing in input data will be deleted from the later (this is the default behaviour).

Definition at line 174 of file DeltaOp.hpp.

DeltaOp (  const satTypeValueMap &  gData,
const TypeIDSet &  diffSet,
const bool &  delSats = true
)  [inline]
 

Common constructor taking a satTypeValueMap as reference station data.

By default it will delete satellites present in reference station data but missing in input data.

Parameters:
gData satTypeValueMap data object holding reference station data.
diffSet TypeIDSet of data values to be differenced.
delSats Boolean value setting if satellites present in reference station data but missing in input data will be deleted from the later (this is the default behaviour).

Definition at line 195 of file DeltaOp.hpp.

DeltaOp (  const gnssSatTypeValue &  gData,
const bool &  delSats = true
)  [inline]
 

Common constructor taking a gnssSatTypeValue as reference station data.

By default it will difference prefitC data and will delete satellites present in reference station data but missing in input data.

Parameters:
gData gnssSatTypeValue data object holding reference station data.
delSats Boolean value setting if satellites present in reference station data but missing in input data will be deleted from the later (this is the default behaviour).

Definition at line 217 of file DeltaOp.hpp.

DeltaOp (  const gnssSatTypeValue &  gData,
const TypeID &  difftype,
const bool &  delSats = true
)  [inline]
 

Common constructor taking a gnssSatTypeValue as reference station data.

By default it will delete satellites present in reference station data but missing in input data.

Parameters:
gData gnssSatTypeValue data object holding reference station data.
difftype TypeID of data values to be differenced.
delSats Boolean value setting if satellites present in reference station data but missing in input data will be deleted from the later (this is the default behaviour).

Definition at line 237 of file DeltaOp.hpp.

DeltaOp (  const gnssSatTypeValue &  gData,
const TypeIDSet &  diffSet,
const bool &  delSats = true
)  [inline]
 

Common constructor taking a gnssSatTypeValue as reference station data.

By default it will delete satellites present in reference station data but missing in input data.

Parameters:
gData gnssSatTypeValue data object holding reference station data.
diffSet TypeIDSet of data values to be differenced.
delSats Boolean value setting if satellites present in reference station data but missing in input data will be deleted from the later (this is the default behaviour).

Definition at line 258 of file DeltaOp.hpp.

DeltaOp (  const gnssRinex &  gData,
const bool &  delSats = true
)  [inline]
 

Common constructor taking a gnssRinex as reference station data.

By default it will difference prefitC data and will delete satellites present in reference station data but missing in input data.

Parameters:
gData gnssRinex data object holding reference station data.
delSats Boolean value setting if satellites present in reference station data but missing in input data will be deleted from the later (this is the default behaviour).

Definition at line 279 of file DeltaOp.hpp.

DeltaOp (  const gnssRinex &  gData,
const TypeID &  difftype,
const bool &  delSats = true
)  [inline]
 

Common constructor taking a gnssRinex as reference station data.

By default it will delete satellites present in reference station data but missing in input data.

Parameters:
gData gnssRinex data object holding reference station data.
difftype TypeID of data values to be differenced.
delSats Boolean value setting if satellites present in reference station data but missing in input data will be deleted from the later (this is the default behaviour).

Definition at line 298 of file DeltaOp.hpp.

DeltaOp (  const gnssRinex &  gData,
const TypeIDSet &  diffSet,
const bool &  delSats = true
)  [inline]
 

Common constructor taking a gnssRinex as reference station data.

By default it will delete satellites present in reference station data but missing in input data.

Parameters:
gData gnssRinex data object holding reference station data.
diffSet TypeIDSet of data values to be differenced.
delSats Boolean value setting if satellites present in reference station data but missing in input data will be deleted from the later (this is the default behaviour).

Definition at line 318 of file DeltaOp.hpp.

virtual ~DeltaOp (   )  [inline, virtual]
 

Destructor.

Definition at line 464 of file DeltaOp.hpp.

Member Function Documentation

virtual DeltaOp& addDiffType (  const TypeID &  difftype  )  [inline, virtual]
 

Method to add a data value type to be differenced.

Parameters:
difftype TypeID of data values to be added to the ones being differenced.

Definition at line 395 of file DeltaOp.hpp.

DeltaOp & addDiffTypeSet (  const TypeIDSet &  diffSet  )  [virtual]
 

Method to add a set of data value types to be differenced.

Parameters:
diffSet TypeIDSet of data values to be added to the ones being differenced.

Definition at line 58 of file DeltaOp.cpp.

std::string getClassName (  void   )  const [virtual]
 

Returns a string identifying this object.

Implements ProcessingClass.

Definition at line 48 of file DeltaOp.cpp.

virtual bool getDeleteMissingSats (  void   )  const [inline, virtual]
 

Method to get the deleteMissingSats field value, i.e., if missing satellites will be deleted (returns true) or not (returns false).

Definition at line 375 of file DeltaOp.hpp.

virtual TypeIDSet getDiffTypeSet (  void   )  const [inline, virtual]
 

Method to get the set of data value types to be differenced.

Definition at line 419 of file DeltaOp.hpp.

References gpstk::TypeIDSet.

int getIndex (  void   )  const [virtual]
 

Returns an index identifying this object.

Implements ProcessingClass.

Definition at line 43 of file DeltaOp.cpp.

virtual satTypeValueMap getRefData (  void   )  const [inline, virtual]
 

Method to get the satTypeValueMap data object holding reference station data.

Definition at line 358 of file DeltaOp.hpp.

virtual gnssRinex& Process (  gnssRinex &  gData  )  throw (ProcessingException) [inline, virtual]
 

Returns a reference to a gnnsRinex object after differencing data type values given in 'diffTypes' field with respect to reference station data in 'refData' field.

Parameters:
gData Data object holding the data.

Implements ProcessingClass.

Definition at line 450 of file DeltaOp.hpp.

virtual gnssSatTypeValue& Process (  gnssSatTypeValue &  gData  )  throw (ProcessingException) [inline, virtual]
 

Returns a reference to a gnssSatTypeValue object after differencing data type values given in 'diffTypes' field with respect to reference station data in 'refData' field.

Parameters:
gData Data object holding the data.

Implements ProcessingClass.

Definition at line 439 of file DeltaOp.hpp.

satTypeValueMap & Process (  satTypeValueMap &  gData  )  throw (ProcessingException) [virtual]
 

Returns a reference to a satTypeValueMap object after differencing data type values given in 'diffTypes' field with respect to reference station data in 'refData' field.

Parameters:
gData Data object holding the data.

Definition at line 80 of file DeltaOp.cpp.

References GPSTK_THROW, and gpstk::SatIDSet.

virtual DeltaOp& setDeleteMissingSats (  const bool &  deleteSats  )  [inline, virtual]
 

Method to set if satellites present in reference station data but missing in input data will be deleted from the later (this is the default behaviour).

Parameters:
deleteSats Boolean stating if satellites will be deleted (true) or not (false).

Definition at line 369 of file DeltaOp.hpp.

virtual DeltaOp& setDiffType (  const TypeID &  difftype  )  [inline, virtual]
 

Method to set the data values to be differenced.

Parameters:
difftype TypeID of data values to be differenced.
Warning:
The previously set type values will be deleted. If this is not what you want, see method addDiffType.

Definition at line 386 of file DeltaOp.hpp.

virtual DeltaOp& setDiffTypeSet (  const TypeIDSet &  diffSet  )  [inline, virtual]
 

Method to set a set of data values to be differenced.

Parameters:
diffSet TypeIDSet of data values to be differenced.
Warning:
The previously set type values will be deleted. If this is not what you want, see method addDiffType.

Definition at line 406 of file DeltaOp.hpp.

virtual DeltaOp& setRefData (  const gnssRinex &  gData  )  [inline, virtual]
 

Method to set the gnssRinex data object holding reference station data.

Parameters:
gData gnssRinex data object holding reference station data.

Definition at line 352 of file DeltaOp.hpp.

References gnssData::body.

virtual DeltaOp& setRefData (  const gnssSatTypeValue &  gData  )  [inline, virtual]
 

Method to set the gnssSatTypeValue data object holding reference station data.

Parameters:
gData gnssSatTypeValue data object holding reference station data.

Definition at line 342 of file DeltaOp.hpp.

References gnssData::body.

virtual DeltaOp& setRefData (  const satTypeValueMap &  gData  )  [inline, virtual]
 

Method to set the satTypeValueMap data object holding reference station data.

Parameters:
gData satTypeValueMap data object holding reference station data.

Definition at line 332 of file DeltaOp.hpp.

The documentation for this class was generated from the following files:
Generated on Wed Feb 8 03:31:30 2012 for GPS ToolKit Software Library by  doxygen 1.3.9.1