dm_geocom_api_request_set_distance Subroutine

public pure subroutine dm_geocom_api_request_set_distance(request, slope_dist, height_offset, inc_mode)

Request of TMC_SetHandDist procedure. Creates request for setting the slope distance and height offset.

The function is used to set the manually measured slope distance and height offset for a following measurement. Additionally, an inclination and an angle measurement are started to determine the coordinates of the target. The vertical angle is corrected to π/2 or 3π/2, depending on the face of the instrument. The previously measured distance is cleared.

The argument inc_mode must be one of the following:

  • GEOCOM_TMC_MEA_INC – Use sensor (a priori sigma).
  • GEOCOM_TMC_AUTO_INC – Automatic mode (sensor/plane).
  • GEOCOM_TMC_PLANE_INC – Use plane (a priori sigma).

The instrument returns the following responses:

  • grc – GeoCOM return code.
Property Values
Instruments TPS1100, TPS1200, TM30/TS30, TS16
ASCII request %R1Q,2019:<slope_dist>,<height_offset>,<inc_mode>
ASCII response %R1P,0,0:<grc>

Arguments

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

Prepared request.

real(kind=r8), intent(in) :: slope_dist

Slope distance [m].

real(kind=r8), intent(in) :: height_offset

Height offset [m].

integer, intent(in) :: inc_mode

Inclination measurement mode (GEOCOM_TMC_INCLINE_PRG).


Calls

proc~~dm_geocom_api_request_set_distance~~CallsGraph proc~dm_geocom_api_request_set_distance dm_geocom_api_request_set_distance proc~dm_geocom_api_request dm_geocom_api_request proc~dm_geocom_api_request_set_distance->proc~dm_geocom_api_request