dm_geocom_api_request_search Subroutine

public pure subroutine dm_geocom_api_request_search(request, search_hz, search_v)

Request of AUT_Search procedure. Creates request for performing an automatic target search.

The function performs an automatic target search within the given search area (requires GeoCOM robotic licence). The search is terminated once the prism appears in the field of view of the ATR sensor. If no prism is found in the specified area, the instrument turns back into the initial position. For an exact positioning onto the prism centre, use the fine-adjust API call afterwards (AUT_FineAdjust).

If the search range of the API function AUT_FineAdjust is expanded, target search and fine positioning are done in one step.

The instrument returns the following responses:

  • grc – GeoCOM return code.
Property Values
Instruments TPS1100, TPS1200, TM30/TS30, TS16
ASCII request %R1Q,9029:<search_hz>,<search_v>,0
ASCII response %R1P,0,0:<grc>

Arguments

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

Prepared request.

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

Horizontal search region [rad].

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

Vertical search region [rad].


Calls

proc~~dm_geocom_api_request_search~~CallsGraph proc~dm_geocom_api_request_search dm_geocom_api_request_search proc~dm_geocom_api_request dm_geocom_api_request proc~dm_geocom_api_request_search->proc~dm_geocom_api_request