tsc_Backsight

Backsights are observations which are made to known points in order to compute the position and/or the horizontal orientation of a total station.   The backsight objects should all "belong" to a single station in a survey core job database.  That is, the observations to the points should all have been made from the same station location.

Public members

tsc_Point Observation;

The observation to the backsight.

tsc_Point Known;

The best known position of the same name as the observation which can be resolved to a grid coordinate. The known point may be a keyed-in control point, a GNSS observation, a point computed by cogo operations, or anything in between. This point will be selected by Survey Core and will be the "best" point of the same name as the observation.

tsc_Residuals Residuals;

This class contains the computed residuals, plus some information about how the calculation was performed.  There may be no residuals information available, in which case all fields will be empty (eg, double_Null) and the UsedDimensions member of tsc_Residuals will contain zero.

int UseDimensions;

Set this to the number of dimensions of this observation to be used in any calculations, or set to zero to exclude this observation completely.  When a tsc_BacksightList is populated from a station, this field in each backsight is initialised to the number of dimensions available in the known point.  The following values may be present or set:

• • 0 - The point is to be excluded from all calculations.

  • 1 - Only the vertical component of the point is to be used.

  • 2 - The two horizontal components of the coordinate are to be used.

  • 3 - Both the vertical and horizontal components are to be used.

tsc_Backsight& operator= (const tsc_Backsight& backsight);

Assigning the backsight makes a copy of all members, however the points refer to the same database objects.

Constructors

Construction is mostly for internal use.  The copy constructor behaves in the same way as assignment.

tsc_Backsight ();

tsc_Backsight (tsc_Point& observation, tsc_Point& known, tsc_Residuals& residuals);

tsc_Backsight (const tsc_Backsight& backsight);