Measurement¶

Robotic total stations integrate dual axis compensators, that can measure the crosswise and lengthwise inclination of the instrument. The accuracy of these measurements is usually in the domain of arcseconds. If the inclination has to be known with better reliability, multiple measurements have to be taken, preferably in different horizontal positions of the instrument.

Requirements¶

GeoCOM capable robotic total station

Results¶

The measurements can be saved to a file in CSV format. The output contains the horizontal angle that the instrument was facing at the moment of the measurement, the cross inclination and the length inclination. If the instrument was oriented to an existing coordinate system at the time, then the horizontal angles are whole circle bearings in that system, otherwise they are relative to the arbitrary orientation.

Examples¶

Measure in 3 positions, starting from hz=0 and print results¶

iman measure inclination -z -p 3 COM1

Measure 2 cycles of 3 positions and save results in CSV¶

iman measure inclination -c 2 -p 3 -o inclination.csv COM1

Usage¶

iman measure inclination¶

Measure instrument inclination in multiple positions.

The total station turns and measures the crosswise and lengthwise inclination in the given number of positions and cycles. For every position, the two inclination components, as well as the bearing is recorded for later processing.

This command requires a GeoCOM capable robotic total station.

iman measure inclination [OPTIONS] PORT

Options

-b, --baud <baud>¶

Serial speed

Options:¶: 1200 | 2400 | 4800 | 9600 | 19200 | 38400 | 56000 | 57600 | 115200 | 230400 | 921600

-t, --timeout <timeout>¶: Serial timeout

-a, --attempts <attempts>¶: Number of connection attempts

--sync-after-timeout¶: Attempt to synchronize message que after a timeout

-o, --output <output>¶: File to save output to

-p, --positions <positions>¶: Number of positions to measure around the circle

-z, --zero¶: Start from hz==0 (otherwise start from current orientation)

-c, --cycles <cycles>¶: Repetition cycles

Arguments

PORT¶

Required argument

Serial port that the instrument is connected to (must be a valid identifier like COM1 or /dev/usbtty0)