Data subscription type: ADCP Backscatter

There are four separate backscatter data subscription types, one for each ADCP beam. Both input and output strings are equivalent for all of them. Only the data subscription strings differ.

Input

The data subscription strings are:

•

BackscatterFore

•

BackscatterAft

•

BackscatterStarboard

•

BackscatterPort

•

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.

SampleDataType

Description	Range	Unit	Type	R/O
This is the type of sample data requested for this subscription.	Power Angle Sv Sp Ss TVG20 TVG40 PowerAngle Complex4Float32 Complex3 Float32		VT_BSTR	N/A
Example:	Power

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

Output

struct StructTSDataHeader
  {
  DWORDLONG dlTime;
  };
struct StructSampleDataArray
  {
  short nSampleDataElement[30000];
  };
struct StructSampleData
  {
  StructSampleDataHeader SampleDataHeader;
  StructSampleDataArray SampleDataArray;
  };

Subscription string example

Example 1 BackscatterFore

Example 2 BackscatterStarboard

ADCP,

BackscatterFore,

ChannelID=<ChannelID>,

Range=100,

Rangestart=10,

ADCP,

BackscatterStarboard,

ChannelID=<ChannelID>,

Range=100,

Rangestart=10,

Example 3 BackscatterAft

Example 4 BackscatterPort

ADCP,

BackscatterAft,

ChannelID=<ChannelID>,

Range=100,

Rangestart=10,

ADCP,

BackscatterPort,

ChannelID=<ChannelID>,

Range=100,

Rangestart=10,