Scan position algorithm

This position operator selectively discards and introduces GPS fixes in order to ensure that the position of each ping within a single scan is the same. This is generally necessary as a preparation for 3D schools detection on instrument or target-lock scanned data.

The algorithm requires two operands:
	a position variable -	containing the GPS fixes to be adjusted
	an acoustic variable -	containing the pings which contain the scans. Note: Must be of ping mode 3 (H-mode) or 4 (V-mode).
and two settings:
	Allowable movement -	specifying the maximum distance the position of any ping is to be modified by (m). This is set on the Scan position page of the Variable properties dialog box.
	Target-locked variable -	A property of the acoustic variable, which, optionally, identifies a second acoustic variable as target locked. This is set on the Data page of the Variable properties dialog box for the acoustic variable.

They are used as follows:

Each ping in the acoustic variable is grouped into a target-locked ping pair if possible.
For each target-locked ping pair determined in Step 1, if any:
1. Calculate the average position of the two pings.
2. If the position of either ping is greater than the Allowable movement from the average position discard this target-locked ping pair.
Each ping in the acoustic variable is grouped into a frame if possible, ignoring requirement 2.b.i of the frame definition (that the position of each ping is the same).
For each frame determined in Step 3, if any:
1. Calculate the average position of the pings in the frame
2. If the position of any ping in the frame is greater than the Allowable movement from the average position discard this frame.
GPS fixes are then copied from the position variable with the following modifications:
1. For each target-locked ping pair found, if any:
  1. GPS fixes which occur between the time of first ping and the second ping are discarded
  2. two GPS fixes, both at the average position of the two pings are inserted:
    - one at the time of the first ping and
    - the other at the time of the second ping.
    This ensures that the position of both pings is identical, meeting requirement 2.a of the schools detection algorithm.
2. For each frame found, if any:
  1. GPS fixes which are between the start and end time of the frame are discarded
  2. two GPS fixes, both at the average position of the pings in the frame are inserted:
    - one at the time of the first ping in the frame and
    - the other at the time of the last ping in the frame.
    This ensures that the position of all pings in the frame is identical, meeting requirement 2.b.i of the frame definition.

Notes:

This ensures that the position of each ping in each detected frame is the same, and hence that requirement 2.b.i will be met when detecting 3D schools using the instrument scanning algorithm.
It also ensures that the position of each ping in each detected target-locked ping pair is the same, and hence that requirement 2.a will be met when detecting 3D schools using the target-locked scanning algorithm.
Statistics describing the detected frames are recorded on the Notes page of the Variable Properties dialog box on the resulting variable.
The WGS84 model is used for all position calculations.

Scan position algorithm

See also