Data subscription type: Sample data

Input

•

Type = The variant type as defined for certain programming languages

–

VT_BSTR = Text string

–

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 (Power, Angle, Sv, Sp, Ss, TVG20, TVG40)

struct StructTSDataHeader
  {
  DWORDLONG dlTime;
  };
struct StructSampleDataArray
  {
  short nSampleDataElement[30000]; //16-bits sample in logarithmic format
  };
struct StructSampleData
  {
  StructSampleDataHeader SampleDataHeader;
  StructSampleDataArray SampleDataArray;
  };

•

nSampleDataElement[30000]: This is a 16-bit sample in logarithmic format.

Output (PowerAngle)

struct StructTSDataHeader
  {
  DWORDLONG dlTime;
  };
struct StructSamplePowerAngleArray
  {
  short nSampleDataElement[60000]; //Composite sample array for power angle
  };
struct StructSamplePowerAngleValues
  {
  int nPowerValues;
  int nAngleValues;
  };
struct StructSamplePowerAngle
  {
  StructSampleDataHeader SampleDataHeader;
  StructSamplePowerAngleValues SamplePowerAngleValues;
  StructSamplePowerAngleArray SamplePowerAngleArray;
  };

•

nSampleDataElement[60000]: This is a composite sample array for power and angle.

•

nPowerValues: This is the number of power samples.

•

nAngleValues: This is the number of angle values.

Subscription string example

SampleData,

ChannelID=<ChannelID>,

SampleDataType=Power,

Range=200,

RangeStart=3,