dm_geocom_api_request_set_orientation Subroutine

public pure subroutine dm_geocom_api_request_set_orientation(request, hz)

Request of TMC_SetOrientation procedure. Creates request for orientating the instrument in horizontal direction.

The API function is a combination of an angle measurement to get the horizontal offset and setting the angle offset afterwards, in order to orientate to a target. Before the new orientation can be set, an existing distance must be cleared by calling API function TMC_DoMeasure with command GEOCOM_TMC_CLEAR.

The instrument returns the following responses:

• grc – GeoCOM return code.

Property	Values
Instruments	TPS1100, TPS1200, TM30/TS30, TS16
ASCII request	%R1Q,2113:<hz>
ASCII response	%R1P,0,0:<grc>

Arguments

Type	Intent	Optional	Attributes		Name
type(request_type),	intent(out)			::	request	Prepared request.
real(kind=r8),	intent(in)			::	hz	Horizontal orientation [rad].