tsc_CorrectedCircle

class tsc_CorrectedCircle : public tsc_Coordinate

This class represents a corrected measurement from a Total station.  All distances are in metres, all angles in radians.

Corrections that have been applied:

• • Prism constant.

  • Prism VA correction for S Series 360 prism and the S Series Multitrack prism.

  • PPM atmospheric correction.

  • Curvature and refraction.

All fields are optional.  HorzCircle, VertCircle, and EDMDistance comprise the raw observation; all the other fields hold supplemental information about the measurement which will be missing if the instrument did not supply them or if the coordinate was converted from some other form such as a grid.  EDMDistance will be empty (ie, HasDistance returns false) if the measurement was angles-only.

While it is possible to construct a tsc_CorrectedCircle object in a plugin, it is more common to obtain one either by calculating one from a different type of observation.

const double      HorzCircle;     // Horizontal angle

const double      VertCircle;     // Vertical angle

const double      SlopeDistance;  // Distance measured by the EDM

const tsc_Face    Face;           // Which instrument face was used (VA also implies the face)

virtual tsc_CoordType  Type() const { return tsct_CorrectedCircle; }

Returns the coordinate type.

The following methods can be used to test which parts of the coordinate are present.

bool IsEmpty      () const;

bool HasVertical  () const;

bool HasHorizontal() const;

bool HasDistance  () const;

Resets the coordinate.

void SetEmpty ();

This function creates a tsc_CorrectedCircle from a tsc_RawCircle given the appropriate or desired environment.

static tsc_CorrectedCircle FromRawCircle (const tsc_RawCircle& rawCircle, class tsc_TsEnvironment& environment);