DST

Returns the last measured corrected distance between the specified cube and the laser instrument.

Mnemonic:

DiSTance.

Syntax:

DST $<$n$>$

n: Cube name or number.

Returns:

Success:

DST 1, n, value

Failure:

DST 0, err_msg

n: Cube number.

value: The distance between the instrument zero point and the retroreflector, in millimeters. This value will be within the range $\pm 1.7 \times 10^{-308}$ to $\pm 1.7 \times 10^{308}$.

err_msg: Should the command fail, this value will be an error message string, explaining the cause of failure. DST may fail if:

• The wrong number of parameters were supplied.
• The cube n cannot be found in the ZY's cube collection.

Remarks:

Because DST returns a previously calculated distance to a cube, the distance must have been measured beforehand using CMEAS or SCN, or the value returned will mean nothing. DST will fail if the system has not been initialized for cubes, or if cube n is out of range. Only a standard cube can return a meaningful distance. The other cubes have the following behavior:

• The reference cube returns 0.
• The benchmark cube returns the Group Refractivity of the air (GRI $\times 1000000$).

Example:

     send: DST 17
  receive: DST 1, 17, 108453.287

See also:

AMP, CMEAS, PHI, SCN