tsc_UnorientedCircle

class tsc_UnorientedCircle : public tsc_Coordinate

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

The coordinate is a polar position from the station to the point, where the angle component is the horizontal angle as measured by the total station, which is to say it is uncorrected for the horizontal orientation of the instrument.  All other corrections and reductions have been applied, including:

• • Prism constant.

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

  • PPM atmospheric correction.

  • Curvature and refraction.

  • Instrument height.

  • Target height.

All fields are optional (that is, any may be equal to double_Null).  HorzCircle, HorzDist, and VertDist comprise the observation.

While it is possible to construct a tsc_UnorientedCircle 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      HortzDist;      // Horizontal distance

const double      VertDist;       // Vertical distance

virtual tsc_CoordType  Type() const { return tsct_UnorientedCircle; }

Returns the coordinate type.

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

bool IsEmpty      () const;

bool HasHorizontal() const;

bool HasVertical  () const;

bool HasHA        () const;

Resets the coordinate to null values.

void SetEmpty ();

Use these functions to create a tsc_UnorientedCircle from a tsc_RawCircle or tsc_CorrectedCircle given the appropriate or desired environment.

static tsc_UnorientedCircle FromCorrectedCircle (const tsc_CorrectedCircle& corrCircle, class tsc_TsEnvironment& environment);

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