Data subscription type: Targets integration
The targets integration data subscription string is TargetsIntegration.
This is a composite subscription where target strength (TS) detection and integration parameters must be set. The Sa value is taken only from the accepted single echo trace inside the range.
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
IntegrationState
Description Range Unit Type R/O
This is the "on/off" switch for the integration. Start
Stop		   VT_BSTR N/A
Example: Start
Update
Description Range Unit Type R/O
This is a "selector" that allows you to provide integration value for latest ping or for the calculation interval. UpdatePing
UpdateAccumulate		   VT_BSTR N/A
Example: UpdatePing
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
Margin
Description Range Unit Type R/O
This is a range selector. Use it to set the range over the detected bottom. This range will not be included in integration. <0,200> m VT_I4 N/A
Example: 1
SvThreshold
Description Range Unit Type R/O
This is a threshold selector. Set this threshold to remove the weakest echoes from the integration. <-200,100> dB VT_R8 N/A
Example: -100
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 StructIntegrationDataHeader
  {
  DWORDLONG dlTime;
  };
struct StructIntegrationDataBody
  {
  double dSa;
  };
struct StructIntegrationData
  {
  StructIntegrationDataHeader IntegrationDataHeader;
  StructIntegrationDataBody IntegrationDataBody;
  };
•  dSa (m2/nmi2): In this context the sA value presents the current biomass index.
Subscription string example
TargetsIntegration,
ChannelID=<ChannelID>,
State=Start,
Layertype=Surface,
Range=100,
Rangestart=10,
Margin=0.5,
SvThreshold=-100.0,
MinTSValue=-55.0,
MinEcholength=0.7,
MaxEcholength=2.0,
MaxGainCompensation=6.0,
MaxPhasedeviation=7.0
Related topics
Data subscription types