Data subscription type: Target Strength (TS) detection
The target strength (TS) detection data subscription string is TSDetection.
Input
•  Type = The variant type as defined for certain programming languages
–  VT_BSTR = Text string
–  V_R8 = double, 8 bytes
–  VT_I4 = Integer 4 bytes
•  R/O = Read only
•  N/A = not applicable
•  If no value is provided in the XML input string, the example value in each table is used as default.
LayerType
Description Range Unit Type R/O
This is the current layer type. Surface
Bottom
Pelagic
  VT_BSTR N/A
Example: Surface
Range
Description Range Unit Type R/O
If the depth range is selected to be individual for each channel, this parameter sets the range for specified channel. <0,10000> m VT_I4 N/A
Example: 500
RangeStart
Description Range Unit Type R/O
This is the start range for the selected channel. <0,10000> m VT_I4 N/A
Example: 10
MinTSValue
Description Range Unit Type R/O
This is the Minimum Target Strength (TS) Value, also known as Minimum Threshold. <-120,50> dB VT_R8 N/A
Example: –50.0
This is a parameter setting in Single Target Detection dialog box. The target strength (TS) for a single target must exceed this threshold (in dB) to be accepted. This setting applies to both CW and FM operation.
MinEchoLength
Description Range Unit Type R/O
This is the Minimum Echo Length, <0,20>   VT_R8 N/A
Example: 0.8
This is a parameter setting in Single Target Detection dialog box. If you set Minimum Echo Length to 0.8, all echoes shorter than 0.8 times the length of the transmitted pulse will be deleted. This setting only applies to CW operation.
MaxEchoLength
Description Range Unit Type R/O
This is the Maximum Echo Length. <0,20>   VT_R8 N/A
Example: 1.8
This is a parameter setting in Single Target Detection dialog box. If you set Maximum Echo Length to 1.8, all echoes longer than 1.8 times the length of the transmitted pulse will be deleted. This setting only applies to CW operation.
MaxGainCompensation
Description Range Unit Type R/O
This is the Maximum Gain Compensation. <0,12>   VT_R8 N/A
Example: 6.0
This is a parameter setting in Single Target Detection dialog box. Targets located off centre will offer weaker echoes due to the beam properties. The EK80 system automatically compensates for this using a mathematical model, and you can manually control the effect of this algorithm by defining a maximum gain value. This setting applies to both CW and FM operation.
MaxPhaseDeviation
Description Range Unit Type R/O
This is the Maximum Phase Deviation. <0,100>   VT_R8 N/A
Example: 8.0
This is a parameter setting in Single Target Detection dialog box. Several single targets occurring at the same range will give you echoes in different parts of the beam’s cross section. To remove the bad targets, the angle (phase) between the samples in the echo are measured. If the angle is too large, the echoes are deleted. This setting applies to both CW and FM operation.
Output
struct StructTSDataHeader
  {
  DWORDLONG dlTime;
  };
struct StructEchoTrace
  {
  double Depth; // (m) This is the depth of the target.
  double TSComp; // (dB) This is the compensated
Target Strength (TS) value.
  double TSUncomp; // (dB) This is the uncompensated
Target Strength (TS) value.
  double AlongshipAngle; // (deg) This is the
angle offset in the alongship direction.
  double AthwartshipAngle; // (deg) This is the
angle offset in the athwartship direction.
  double sa; // In this context the sA value presents
the current biomass index.
  };
struct StructTSDataBody
  {
  WORD NoOfEchoTraces; // This information identifies
the number of individual targets (single fish) in the depth layer.
  StructEchoTrace EchoTraceElement[100];
  };
struct StructTSData
  {
  StructTSDataHeader TSDataHeader;
  StructTSDataBody TSDataBody;
  };
Subscription string example
TSDetection,
ChannelID=<ChannelID>,
LayerType=Surface,
Range=200,
RangeStart=3,
MinTSValue=-55,
MinEcholength=0.7,
MaxEcholength=2.0,
MaxGainCompensation=6.0,
MaxPhasedeviation=7.0