tsc_TsEnvironment

tsc_TsEnvironment encapsulates the environment of a total station measurement.  It contains the following information via its Station and Target members:

• • Instrument data (model name, serial number, precisions, correction information, etc)

  • Target data (height, type, name, prism constant, etc)

  • Station data (type, instrument height, backsight information, etc)

  • Atmospheric data (pressure, temperature, PPM, etc)

Properties are provided in a form which closely follows the Job XML format in terms of name, format, units, and semantics.  Some properties are optional; for instance, if no atmospheric temperature was taken (either manually or automatically), the Temperature method will return double_Null.

A tsc_TsEnvironment instance can be obtained in a number of ways.  When required for an existing point, the TsEnvironment method on the tsc_Point class may be used.  When required for a point that is in the process of being measured, the current environment may be obtained from the CurrentTsEnvironment method in the tsc_Database class.

The current environment is always closely related to the currently open job; in any other job it is simply the most recently stored.  Note that the current target details may differ from the last target within the job.

To get the environment for a tsc_TsModes object use the GetEnvironment method - note that this will be the current jobs environment overloaded with changes that the modes object specifies.

It is possible to request a tsc_TsEnvironment where none exists, for instance by requesting the current environment when no station has been started.  In such cases a valid tsc_TsEnvironment is returned, but its member Exists() methods will return false and the value for all other properties will be empty, null, or some default value.

Constructors

tsc_TsEnvironment (const class tsc_Point &forPoint)
Obtains the environment used to measure the given point.

tsc_TsEnvironment()
Gets the current environment.

Properties

tsc_Station   Station
Contains a reference to the station.

tsc_Target    Target
Contains a reference to the target.