Ping Subset

This operator allows you to create a variable containing a subset of the pings in another variable.

You enter the processing settings for this operator on the Ping subset page of the Variable Properties dialog box. The Ping range or Ping ranges can be specified by number, time or distance traveled.

Echoview accepts operands of the following data types as input:

Operand 1

  • Angular position
  • Boolean
  • Color
  • Complex angular position
  • Complex power dB
  • Complex Sv
  • Complex TS
  • Current velocity
  • Linear
  • Multibeam angular position
  • Multibeam boolean
  • Multibeam color
  • Multibeam magnitude
  • Multibeam phase
  • Multibeam Sv
  • Multibeam targets
  • Multibeam TS
  • Multibeam unspecified dB
  • Power dB
  • Pulse compressed complex angular position
  • Pulse compressed complex power dB
  • Pulse compressed complex Sv
  • Pulse compressed complex TS
  • Single targets
  • Sv
  • Target length
  • TS
  • Unspecified dB

Settings

The Ping Subset Variable Properties dialog box pages include (common) Variable Properties pages and these operator pages:

Operands page

Ping Subset page

Settings

Description

Ranges

Select whether the ranges will be specified by ping number, time or distance in meters or nautical miles. Specify the pings in the operand to be used in the virtual variable. Ranges are separated by commas. The actual range of the operand and an example specification are shown.

Number

Specify pings by their numbers, in order. Single numbers or ranges may be used. An unterminated range spans to the last ping.

e.g.: 5,7, 9-20, 25-

Time

Specify pings by one or more times ranges in abbreviated ISO 8601 format.

e.g.: 2012-6-28 12:30 = 13:45, 16:00 =

You can write times in full or you use these abbreviation rules:

Rule Specification Abbreviation Description
OMIT LEADING ZEROS 1970-01-02 03:04:05.06 1970-1-2 3:4:5.06 Leading zeros may be omitted (except in the milliseconds).
OMIT TRAILING ZEROS 1970-1-1 0:0:0.000 1970 An incomplete time is filled in with the minimums (1 or 0).
OMIT LEADING DUPLICATE FIELDS 2012-1-20 = 2012-1-22 2012-1-20 = --22 An omitted leading field takes its value from the previous time.
OMIT UNUSED DATE SEPARATORS 2012-1-20 11:15 = -- :45 2012-1-20 11:15 = :45 If the date is omitted then the dashes are not needed.
Distance (m)

Distance (m) specification is entered as a start distance (m), a dash and a stop distance (m).

e.g. 0-9.5

Distance (nmi)

Distance (nmi) specification is entered as start distance (nmi), a dash and a stop distance (nmi).

e.g. 2.58-4.00

Include the ping ranges

Exclude the ping ranges

Select whether the specified ranges are included or excluded.

Pings

The Pings section lists the actual pings included or excluded, next to the corresponding ranges.

See also

About virtual variables
Operator licensing in Echoview