Get Observation Info

Obtains details for a given observation, including the source instrument, azimuth/elevation/distance (for spherical measurement devices), and the status for the observation (active vs. inactive).

 

Input Arguments

 

0

Point Name

Point Name

The name of the point to examine

 

1

 

Integer

 

Observation Index

The index of the observation to examine. Index 0 is the first observation for the target, Index 1 is the second, etc.

 

Return Arguments

 

2

Collection Instrument ID

Resulting Instrument

The instrument that obtained the observation.

3

Vector

Resultant Vector

The distance, azimuth, and elevation of the obser- vation (in that order).**

4

Boolean

Active?

Indicates whether the observation is active.

5

String

Timestamp

Indicates measurement time accurate to seconds.

6

Double

RMS Error

RMS error of observation.

7

Double

Temperature (degF)

Temperature from observation info data

8

Double

Pressure (in. Hg)

Pressure from observation info data

9

Double

Humidity (% RH)

Humidity from observation info data

10

String

Info Data

Full info data string from selected observation

 

Returned Status

 

SUCCESS

The observation information was obtained successfully.

FAILURE

The point or observation index could not be found.

 

Remarks

A zero will be returned for the RMS error for those observations that do not have them, while -1 will be returned for temperature/pressure and humidity.

 

 

**The theta values returned from this check are raw instrument specific values. For example, a point 15 degrees toward Y from X is reported as either 345 or -15 depending on the instrument (theta or 360-theta). Confirm which value your instrument returns, particularly with Total Stations.