Data subscription type: Echogram

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.

PixelCount

Description	Range	Unit	Type	R/O
This is the number of pixels/values to be returned by this subscription.	<0,10000>		VT_I4	N/A
Example:	500

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

TVGType

Description	Range	Unit	Type	R/O
This is the Time Variable Gain (TVG) parameter setting.	Pr Sv Sp TS SpAndTS		VT_BSTR	N/A
Example:	Sv

EchogramType

Description	Range	Unit	Type	R/O
This is the echogram type in use.	Surface Bottom Trawl		VT_BSTR	N/A
Example:	Surface

CompressionType

Description	Range	Unit	Type	R/O
This is the interpolation method. If the number of samples is larger than the requested number of pixels, select how to interpolate.	Mean Peak		VT_BSTR	N/A
Example:	Mean

ExpansionType

Description	Range	Unit	Type	R/O
This is the extrapolation method. If the number of samples is less than the requested number of pixels, select how to extrapolate.	Interpolation Copy		VT_BSTR	N/A
Example:	Interpolation

Output

struct StructEchogramHeader
  {
  DWORDLONG dlTime;
  double range;
  double rangeStart;
  };
struct StructEchogramArray
  {
  short nEchogramElement[30000];
  };
struct StructEchogram
  {
  StructEchogramHeader EchogramHeader;
  StructEchogramArray EchogramArray;
  };

•

nEchogramElement[30000]: This is the echogram information on a 16-bit logarithmic format.

Subscription string example

Echogram,

ChannelID=<ChannelID>,

PixelCount=500,

Range=200,

RangeStart=3,

TVGType=TS,

EchogramType=Surface,

CompressionType=Mean,

ExpansionType=Interpolation