tsc_StationCalcSingleBacksight

Use this class for computing the position of a station using a known station point and a single backsight to a known point.

Constructor

tsc_StationCalcSingleBacksight (class tsc_StationSetup& station);

Constructs an instance for computing the given station using a single backsight observation.  The station must be "in progress" - it must have been started but not ended or aborted.

Public methods

virtual tsc_StationResults  CalculateStation();

Computes the station orientation from the last backsight observation and returns the results.  The results are not stored anywhere but reside in the tsc_StationResults instance.  Depending on the current state of the station setup in the database, some (or all) values may have null values.

The supplied backsight list will be used to find the first backsight as the single point to orientate towards, other backsights will be ignored unless they are measuring the same point in which case F1/F2 pairs and MTAs will be calculated, including any relevant residuals.

The returned tsc_StationResults will contain the backsight that was used for the station, including a reference to the observation and the calculated residuals.

The results may be used to update the station by calling the UpdateStation() method on tsc_StationSetup, and the residuals may be written to the database by using the WriteResiduals() method also in tsc_StationSetup.  It is normal to only write the residuals once, at the end of the station setup.

virtual tsc_StationResults CalculateStationWithFreeScale();

virtual tsc_StationResults CalculateStationWithFreeScale (const tsc_BacksightList& useBacksights);

This overload allows the scale factor to be calculated along with other station parameters.

Where a backsight list is supplied only backsights to the first known point will be considered.

virtual tsc_StationResults CalculateStationWithFixedScale(const double& scaleFactor = 1.0);

virtual tsc_StationResults CalculateStationWithFixedScale (const tsc_BacksightList& useBacksights, double fixedScaleFactor);

This overload allows the scale factor to be fixed at the supplied value.  If the given value is double_Null, the scale factor will be calculated.

virtual void UpdateStation (const tsc_StationResults& results);

From the results of the calculation, updates the station record and the backbearing record.