tsc_Station

Represents a station object, one of which exists in the database for every conventional total station setup. This class is a read-only copy of a station in the database and contains no members to alter it. 

A station is actually a collection of database records, described in greater detail on the How Stations Work page.

Contrast this with the tsc_StationSetup class which is a writeable class used to add a station setup to the current job and control its progress.

A station may be in progress or be complete, and if it is complete and also the last station in the database, then it may also be the one currently in use for surveying.  Any number of stations may exist in a job, however all but the last station should be considered unchangeable.

bool Exists ();
True if this station setup exists. If the instance has not been obtained from a valid station in a database, returns false.

 bool InProgress ();
This station setup is currently in progress and is incomplete.

bool IsCurrentSurvey ();
This station setup is complete and is the current survey station in use.

bool SameStation (const tsc_Station& rhs);
Compares the 2 stations and returns true if they are the same object. This is NOT a simple value compare.

double InstrumentCorrectedHeight ();
Corrected height of the instrument in metres.

tsc_String  Model ();
Returns the instrument model name.

tsc_String  Serial ();
Returns the instrument's serial number string.

tsc_String  FirmwareVersion ();
Return's the instrument's firmware version information.

double CarrierWavelength ();
An internally generated value that represents the characteristics of the instrument's EDM equipment.

double Pressure ();
The atmospheric pressure in hPa (millibars). double_Null if no pressure was available.

double Temperature ();
The temperature in Celsius. double_Null if no temperature was available.

double PPM ();
PPM correction either computed from pressure & temperature, or keyed in directly.

double RefractionCoefficient ();
The refraction coefficient for the instrument.

bool AppliesEarthCurvatureCorrection ();
Whether the correction for the Earth's curvature is applied to measurements.

bool AppliesRefractionCorrection ();
Whether the correction for atmospheric refraction is applied to measurements.

tsc_String  StationName ();
The name of the station. This is the same as the name of the point at the station's position.

tsc_Grid  StationLocation ();
The location of the best point for the station.

tsc_GridDeltas StationLocationStdError ();
The standard errors determine when calculating the station point by a setup method such as Resection.  For station setups defined on existing coordinates these errors will be double_Null.

double StationScaleFactor ();
The scale factor used for the station.

bool ScaleFactorIsFixed ();
Flag indicating whether the scale factor was calculated from the observations.

double ScaleFactorStdError();
Standard error of the calculation used to determine the scale factor. May be double_Null.

double InstrumentHeight ();
Corrected height of the instrument.

tsc_String  BacksightName ();
Name of the backsight point.

double F1OrientationCorrection ();
Angle applied to HA to make it an azimuth for face 1 observations.

double F2OrientationCorrection ();
Angle applied to HA to make it an azimuth for face 2 observations.

double OrientationCorrectionStdError ();
The standard error calculated for the orientation correction.

tsc_PointList BacksightPoints ();
Retrieves a list of all backsight observations taken from this station.

tsc_BacksightList  BacksightDetails ();
Creates a list of the details of all backsight observations taken from this station.

tsc_XmlElement GetStationJxl ();
Returns complete job xml for the station, including atmosphere, instrument, backsight, etc.
More information about JXL and a link to the schema can be found on this page.
Note that modifying the returned XML elements will not affect any objects in the database.

tsc_Station& operator= (const tsc_Station &rhs);
Copies of tsc_Station refer to the same object.

tsc_Station (const tsc_Station &rhs);
The copy constructor creates a reference to the same object.