Get Current Instrument Position Update

Returns the position of the last instrument update position received by SA.

 

Input Arguments

 

0

Collection Instrument ID

Instrument ID

The instrument ID of the instrument in question.

1

Export Frame Mode

Reporting Frame

Select between reference frames

2

Boolean

Polar Coordinates?

Choose the display method for the point coordi- nate, either polar or Cartesian

 

Return Arguments

 

3

Double

X / R

Resulting X / R Value Position

4

Double

Y / Theta (Degrees)

Resulting Y / Theta Position

5

Double

Z / Phi (Degrees)

Resulting Z / Phi Position

6

Double

Time Since Update (Sec)

Time in seconds from the last received position updated from the instrument

7

String

TimeStamp (Approximate)

Approximate system date and time of last position

update.

 

Returned Status

 

SUCCESS

The instruments last point location was returned successfully.

FAILURE

The instrument could not be found, or no position was obtained

 

Remarks

This command, like a watch window, will report the last reflector position received by SA. It does not trigger a mea- surement from the instrument. The time duration is an approximate time, roughly accurate to the second and should not be confused with the precise controller times recorded in the measurement details of some instruments. This is for relative reference only and was added with longer term remote monitoring applications in mind.