dm_geocom_api_request_get_full_measurement Subroutine

public pure subroutine dm_geocom_api_request_get_full_measurement(request, wait_time, inc_mode)

Request of TMC_GetFullMeas procedure. Creates request to query angle, inclination, and distance measurement values.

The GeoCOM function returns angle, inclination, and distance measurement data, including accuracy and measurement time. This command does not issue a new distance measurement. A distance measurement has to be started in advance. If the distance is valid, the function ignores wait_time and returns the results immediately. If no valid distance is available, and the measurement unit is not activated, the angle measurement result is returned after the waiting time.

The instrument returns the following responses:

  • grc – GeoCOM return code.
  • hz – Horizontal angle [rad].
  • v – Vertical angle [rad].
  • angacc – Accuracy of angles [rad].
  • xinc – Transverse axis inclination [rad].
  • linc – Longitude axis inclidation [rad].
  • incacc – Inclination accuracy [rad].
  • sdist – Slope distance [m].
  • disttime – Time of distance measurement [msec].
Property Values
Instruments TPS1200, TM30/TS30, TS16
ASCII request %R1Q,2167:<wait_time>,<inc_mode>
ASCII response %R1P,0,0:<grc>,<hz>,<v>,<angacc>,<xinc>,<linc>,<incacc>,<sdist>,<disttime>

Arguments

Type IntentOptional Attributes Name
type(request_type), intent(out) :: request

Prepared request.

integer, intent(in) :: wait_time

Delay to wait for the distance measurement to finish [msec].

integer, intent(in) :: inc_mode

Inclination measurement mode (GEOCOM_TMC_INCLINE_PRG).


Calls

proc~~dm_geocom_api_request_get_full_measurement~~CallsGraph proc~dm_geocom_api_request_get_full_measurement dm_geocom_api_request_get_full_measurement proc~dm_geocom_api_request dm_geocom_api_request proc~dm_geocom_api_request_get_full_measurement->proc~dm_geocom_api_request