Class CompositeContainerParameterDataAccess

A composite container parameter data access object.

Inheritance

System.Object

CompositeContainerParameterDataAccess

Implements

ICompositeContainerParameterDataAccess

System.IDisposable

Namespace: MESL.SqlRace.Domain

Assembly: MESL.SqlRace.Domain.dll

Syntax

public class CompositeContainerParameterDataAccess : Object, ICompositeContainerParameterDataAccess, IDisposable

Constructors

CompositeContainerParameterDataAccess(ICompositeSession, List<ICompositeSession>, IDictionary<CompositeSessionKey, String>, String, ICompositePdaExecutionService)

Initializes a new instance of the CompositeContainerParameterDataAccess class.

Declaration

public CompositeContainerParameterDataAccess(ICompositeSession primarySession, List<ICompositeSession> sessions, IDictionary<CompositeSessionKey, string> parameterIdentifiers, string parameterIdentifiersList, ICompositePdaExecutionService executionService)

Parameters

Type	Name	Description
ICompositeSession	primarySession	The primary session.
System.Collections.Generic.List<ICompositeSession>	sessions	The sessions.
System.Collections.Generic.IDictionary<CompositeSessionKey, System.String>	parameterIdentifiers	The parameter identifier.
System.String	parameterIdentifiersList	An unique identifier to identify the parameter list. Usually p1|p2|...
ICompositePdaExecutionService	executionService	The execution service.

CompositeContainerParameterDataAccess(ICompositeSession, List<ICompositeSession>, String, ICompositePdaExecutionService)

Initializes a new instance of the CompositeContainerParameterDataAccess class.

Declaration

public CompositeContainerParameterDataAccess(ICompositeSession primarySession, List<ICompositeSession> sessions, string parameterIdentifier, ICompositePdaExecutionService executionService)

Parameters

Type	Name	Description
ICompositeSession	primarySession	The primary session.
System.Collections.Generic.List<ICompositeSession>	sessions	The sessions.
System.String	parameterIdentifier	The parameter identifier.
ICompositePdaExecutionService	executionService	The execution service.

Fields

DefaultSampleTime

Default sample time.

Declaration

protected const int DefaultSampleTime = 10000000

Field Value

Type	Description
System.Int32

Properties

IsInitialized

Gets or sets a value indicating whether this instance is initialized.

Declaration

public bool IsInitialized { get; set; }

Property Value

Type	Description
System.Boolean	true if this instance is initialized; otherwise, false.

ParameterIdentifier

Identifier

Declaration

public string ParameterIdentifier { get; }

Property Value

Type	Description
System.String

SampleTime

Gets or sets the sample time (in nanoseconds) for the data. This value will only affect requests to get data (using the GetNextData method ) and will not affect calls to get samples (using the GetNextSamples/GetPreviousSamples methods).

Declaration

public long SampleTime { get; set; }

Property Value

Type	Description
System.Int64

Remarks

This time is the interval between data samples. For example: 1,000,000 ns = 1000Hz 10,000,000 ns = 100Hz 100,000,000 ns = 10Hz 1,000,000,000 ns = 1Hz If this value is not set then the default sample time is 100Hz (10,000,000 ns).

UnderlyingPdas

Gets the underlying PDAs.

Declaration

public IReadOnlyDictionary<CompositeSessionKey, ICompositeParameterDataAccess> UnderlyingPdas { get; }

Property Value

Type	Description
System.Collections.Generic.IReadOnlyDictionary<CompositeSessionKey, ICompositeParameterDataAccess>	The underlying PDAs.

Remarks

Here for legacy tests that reference what was an internally-visible member variable.

Methods

Dispose()

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Declaration

public void Dispose()

Finalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

Declaration

protected override void Finalize()

GetDataStatistics(Int64, Int64, Boolean, StatisticOption, Boolean)

Gets the data statistics.

Declaration

public Dictionary<CompositeSessionKey, CompositeStatistics> GetDataStatistics(long startTimeStamp, long duration, bool weightStatistics, StatisticOption statisticOption, bool isEos = false)

Parameters

Type	Name	Description
System.Int64	startTimeStamp	The start time stamp.
System.Int64	duration	The duration.
System.Boolean	weightStatistics	if set to true [weight statistics].
StatisticOption	statisticOption	The statistic option.
System.Boolean	isEos	Whether the request is for an Eos statistic, false by default

Returns

Type	Description
System.Collections.Generic.Dictionary<CompositeSessionKey, CompositeStatistics>

GetNextData(Dictionary<CompositeSessionKey, Int64[]>, SampleModeType, Boolean, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, DataStatusType[]>)

Returns sampled data for each of the timestamps passed in the call, using the timestamps provided for each session rather than allowing SQLRace to apply the offset

Declaration

public void GetNextData(Dictionary<CompositeSessionKey, long[]> sampleTimestamps, SampleModeType sampleMode, bool interpolate, ref Dictionary<CompositeSessionKey, double[]> data, ref Dictionary<CompositeSessionKey, DataStatusType[]> status)

Parameters

Type	Name	Description
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Int64[]>	sampleTimestamps	The sample timestamps for each session.
SampleModeType	sampleMode	The sample mode.
System.Boolean	interpolate	If set to true, returned data is interpolated.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	data	Sampled data.
System.Collections.Generic.Dictionary<CompositeSessionKey, DataStatusType[]>	status	DataStatusType of the sample.

GetNextData(Dictionary<CompositeSessionKey, Int64[]>, Boolean, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, DataStatusType[]>)

Returns the next sampled data values and status based on the timestamps requested using min/max sampler. Uses timestamps provided for each secondary session rather than relying on SQLRace to do this

Declaration

public void GetNextData(Dictionary<CompositeSessionKey, long[]> timestamps, bool interpolate, ref Dictionary<CompositeSessionKey, double[]> minimumValues, ref Dictionary<CompositeSessionKey, double[]> maximumValues, ref Dictionary<CompositeSessionKey, DataStatusType[]> status)

Parameters

Type	Name	Description
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Int64[]>	timestamps	Timestamps for all sessions at which to return data.
System.Boolean	interpolate	If set to true, returned data is interpolated.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	minimumValues	The minimum values.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	maximumValues	The maximum values.
System.Collections.Generic.Dictionary<CompositeSessionKey, DataStatusType[]>	status	DataStatusType of the sample.

GetNextData(Dictionary<CompositeSessionKey, Int64[]>, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, DataStatusType[]>)

Returns sampled data for each of the timestamps passed in the call, using the timestamps provided for each session rather than allowing SQLRace to apply the offset

Declaration

public void GetNextData(Dictionary<CompositeSessionKey, long[]> sampleTimestamps, ref Dictionary<CompositeSessionKey, double[]> data, ref Dictionary<CompositeSessionKey, DataStatusType[]> status)

Parameters

Type	Name	Description
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Int64[]>	sampleTimestamps	The sample timestamps.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	data	Sampled data.
System.Collections.Generic.Dictionary<CompositeSessionKey, DataStatusType[]>	status	DataStatusType of the sample.

Remarks

Uses SampleModeType.Mean and does not use linear interpolation between samples.

GetNextData(Int32, SampleModeType, Boolean, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, DataStatusType[]>)

Gets the next sampled data values and status based on the number of samples requested.

Declaration

public void GetNextData(int numberOfSamples, SampleModeType sampleMode, bool interpolate, ref Dictionary<CompositeSessionKey, double[]> data, ref Dictionary<CompositeSessionKey, DataStatusType[]> status)

Parameters

Type	Name	Description
System.Int32	numberOfSamples	Number of samples to retrieve.
SampleModeType	sampleMode	The sample mode.
System.Boolean	interpolate	If set to true, returned data is interpolated.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	data	Sampled data.
System.Collections.Generic.Dictionary<CompositeSessionKey, DataStatusType[]>	status	DataStatusType of the sample.

Remarks

On completion of this call, the CurrentTime will be set to the end of the returned data.

GetNextData(Int32, Boolean, ref Dictionary<CompositeSessionKey, MinimumMaximumMeanDouble[]>, ref Dictionary<CompositeSessionKey, DataStatusType[]>)

Returns the next sampled data values and status based on the number of samples requested using min/max/mean sampler.

Declaration

public void GetNextData(int numberOfSamples, bool interpolate, ref Dictionary<CompositeSessionKey, MinimumMaximumMeanDouble[]> minimumMaximumMeanValues, ref Dictionary<CompositeSessionKey, DataStatusType[]> status)

Parameters

Type	Name	Description
System.Int32	numberOfSamples	Number of samples to retrieve.
System.Boolean	interpolate	If set to true, returned data is interpolated.
System.Collections.Generic.Dictionary<CompositeSessionKey, MinimumMaximumMeanDouble[]>	minimumMaximumMeanValues	The minimum/maximum/mean values.
System.Collections.Generic.Dictionary<CompositeSessionKey, DataStatusType[]>	status	DataStatusType of the sample.

Remarks

Does not use linear interpolation between samples. On completion of this call, the CurrentTime will be set to the end of the returned data.

GetNextData(Int32, Boolean, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, DataStatusType[]>)

Returns the next sampled data values and status based on the number of samples requested using min/max sampler.

Declaration

public void GetNextData(int numberOfSamples, bool interpolate, ref Dictionary<CompositeSessionKey, double[]> minimumValues, ref Dictionary<CompositeSessionKey, double[]> maximumValues, ref Dictionary<CompositeSessionKey, DataStatusType[]> status)

Parameters

Type	Name	Description
System.Int32	numberOfSamples	Number of samples to retrieve.
System.Boolean	interpolate	If set to true, returned data is interpolated.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	minimumValues	The minimum values.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	maximumValues	The maximum values.
System.Collections.Generic.Dictionary<CompositeSessionKey, DataStatusType[]>	status	DataStatusType of the sample.

Remarks

On completion of this call, the CurrentTime will be set to the end of the returned data.

GetNextData(Int32, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, DataStatusType[]>)

Returns the next sampled data values and status based on the number of samples requested.

Declaration

public void GetNextData(int numberOfSamples, ref Dictionary<CompositeSessionKey, double[]> data, ref Dictionary<CompositeSessionKey, DataStatusType[]> status)

Parameters

Type	Name	Description
System.Int32	numberOfSamples	Number of samples to retrieve.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	data	Sampled data.
System.Collections.Generic.Dictionary<CompositeSessionKey, DataStatusType[]>	status	DataStatusType of the sample.

Remarks

Uses SampleModeType.Mean and does not interpolate between samples. On completion of this call, the CurrentTime will be set to the end of the returned data.

GetNextData(Int32, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, DataStatusType[]>)

Returns the next sampled data values and status based on the number of samples requested using min/max sampler.

Declaration

public void GetNextData(int numberOfSamples, ref Dictionary<CompositeSessionKey, double[]> minimumValues, ref Dictionary<CompositeSessionKey, double[]> maximumValues, ref Dictionary<CompositeSessionKey, DataStatusType[]> status)

Parameters

Type	Name	Description
System.Int32	numberOfSamples	Number of samples to retrieve.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	minimumValues	The minimum values.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	maximumValues	The maximum values.
System.Collections.Generic.Dictionary<CompositeSessionKey, DataStatusType[]>	status	DataStatusType of the sample.

Remarks

Does not use linear interpolation between samples. On completion of this call, the CurrentTime will be set to the end of the returned data.

GetNextData(Int64[])

Returns sampled data for each of the timestamps passed in the call, allowing SQLRace to apply offsets for secondary sessions

Declaration

public Dictionary<CompositeSessionKey, ParameterValues> GetNextData(long[] sampleTimestamps)

Parameters

Type	Name	Description
System.Int64[]	sampleTimestamps	The sample timestamps.

Returns

Type	Description
System.Collections.Generic.Dictionary<CompositeSessionKey, ParameterValues>

Remarks

Uses SampleModeType.Mean and does not use linear interpolation between samples.

GetNextData(Int64[], SampleModeType, Boolean)

Returns sampled data for each of the timestamps passed in the call, allowing SQLRace to apply offsets for secondary sessions

Declaration

public Dictionary<CompositeSessionKey, ParameterValues> GetNextData(long[] sampleTimestamps, SampleModeType sampleMode, bool interpolate)

Parameters

Type	Name	Description
System.Int64[]	sampleTimestamps	The primary session sample timestamps.
SampleModeType	sampleMode	The sample mode.
System.Boolean	interpolate	If set to true, returned data is interpolated.

Returns

Type	Description
System.Collections.Generic.Dictionary<CompositeSessionKey, ParameterValues>

GetNextData(Int64[], SampleModeType, Boolean, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, DataStatusType[]>)

Returns sampled data for each of the timestamps passed in the call.

Declaration

public void GetNextData(long[] sampleTimestamps, SampleModeType sampleMode, bool interpolate, ref Dictionary<CompositeSessionKey, double[]> data, ref Dictionary<CompositeSessionKey, DataStatusType[]> status)

Parameters

Type	Name	Description
System.Int64[]	sampleTimestamps	The sample timestamps.
SampleModeType	sampleMode	The sample mode.
System.Boolean	interpolate	If set to true, returned data is interpolated.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	data	Sampled data.
System.Collections.Generic.Dictionary<CompositeSessionKey, DataStatusType[]>	status	DataStatusType of the sample.

GetNextData(Int64[], Boolean)

Returns the next sampled data values and status based on the timestamps requested using min/max sampler.

Declaration

public Dictionary<CompositeSessionKey, ParameterValues> GetNextData(long[] timestamps, bool interpolate)

Parameters

Type	Name	Description
System.Int64[]	timestamps	Timestamps at which to return data.
System.Boolean	interpolate	If set to true, returned data is interpolated.

Returns

Type	Description
System.Collections.Generic.Dictionary<CompositeSessionKey, ParameterValues>

GetNextData(Int64[], Boolean, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, DataStatusType[]>)

Returns the next sampled data values and status based on the timestamps requested using min/max sampler. Allows SQLRace to apply offsets for secondary sessions

Declaration

public void GetNextData(long[] timestamps, bool interpolate, ref Dictionary<CompositeSessionKey, double[]> minimumValues, ref Dictionary<CompositeSessionKey, double[]> maximumValues, ref Dictionary<CompositeSessionKey, DataStatusType[]> status)

Parameters

Type	Name	Description
System.Int64[]	timestamps	Primary session Timestamps at which to return data.
System.Boolean	interpolate	If set to true, returned data is interpolated.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	minimumValues	The minimum values.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	maximumValues	The maximum values.
System.Collections.Generic.Dictionary<CompositeSessionKey, DataStatusType[]>	status	DataStatusType of the sample.

GetNextData(Int64[], ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, DataStatusType[]>)

Returns sampled data for each of the timestamps passed in the call.

Declaration

public void GetNextData(long[] sampleTimestamps, ref Dictionary<CompositeSessionKey, double[]> data, ref Dictionary<CompositeSessionKey, DataStatusType[]> status)

Parameters

Type	Name	Description
System.Int64[]	sampleTimestamps	The sample timestamps.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	data	Sampled data.
System.Collections.Generic.Dictionary<CompositeSessionKey, DataStatusType[]>	status	DataStatusType of the sample.

Remarks

Uses SampleModeType.Mean and does not use linear interpolation between samples.

GetNextSamples(Int32)

Returns the next raw data samples, their DataStatusType and timestamps between the current time and the endTime provided. NOTE: This method does not deal with Single Lap compare

Declaration

public Dictionary<CompositeSessionKey, ParameterValues> GetNextSamples(int numberOfSamples)

Parameters

Type	Name	Description
System.Int32	numberOfSamples	The end time.

Returns

Type	Description
System.Collections.Generic.Dictionary<CompositeSessionKey, ParameterValues>	The number of samples available.

GetNextSamples(Int32, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, DataStatusType[]>, ref Dictionary<CompositeSessionKey, Int64[]>)

Returns the next raw data samples, their DataStatusType and timestamps from the current time.

Declaration

public int[] GetNextSamples(int numberOfSamples, ref Dictionary<CompositeSessionKey, double[]> data, ref Dictionary<CompositeSessionKey, DataStatusType[]> status, ref Dictionary<CompositeSessionKey, long[]> time)

Parameters

Type	Name	Description
System.Int32	numberOfSamples	The number of samples required.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	data	Raw data samples.
System.Collections.Generic.Dictionary<CompositeSessionKey, DataStatusType[]>	status	DataStatusType of the raw samples.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Int64[]>	time	Timestamps for the raw samples.

Returns

Type	Description
System.Int32[]	The number of samples available for each underlying PDA

GetNextSamples(Int64, Boolean)

Returns the next raw data samples, their DataStatusType and timestamps between the current time and the endTime provided.

Declaration

public Dictionary<CompositeSessionKey, ParameterValues> GetNextSamples(long endTime, bool useRelativeTimes = false)

Parameters

Type	Name	Description
System.Int64	endTime	The end time.
System.Boolean	useRelativeTimes	Use relative times.

Returns

Type	Description
System.Collections.Generic.Dictionary<CompositeSessionKey, ParameterValues>	The number of samples available.

GetNextSamples(Int64, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, DataStatusType[]>, ref Dictionary<CompositeSessionKey, Int64[]>)

Returns the next raw data samples, their DataStatusType and timestamps between the current time and the endTime provided.

Declaration

public int[] GetNextSamples(long endTime, ref Dictionary<CompositeSessionKey, double[]> data, ref Dictionary<CompositeSessionKey, DataStatusType[]> status, ref Dictionary<CompositeSessionKey, long[]> time)

Parameters

Type	Name	Description
System.Int64	endTime	The end time.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	data	Raw data values.
System.Collections.Generic.Dictionary<CompositeSessionKey, DataStatusType[]>	status	DataStatusType of the raw data values
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Int64[]>	time	Timestamps of the raw data values.

Returns

Type	Description
System.Int32[]	The number of samples available.

GetPreviousSamples(Int32)

Returns the previous raw data samples, their DataStatusType and timestamp, starting at numberOfSamples. NOTE: This method does not deal with Single Lap compare

Declaration

public Dictionary<CompositeSessionKey, ParameterValues> GetPreviousSamples(int numberOfSamples)

Parameters

Type	Name	Description
System.Int32	numberOfSamples	The end time.

Returns

Type	Description
System.Collections.Generic.Dictionary<CompositeSessionKey, ParameterValues>	Number of samples available for each underlying PDA

GetPreviousSamples(Int32, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, DataStatusType[]>, ref Dictionary<CompositeSessionKey, Int64[]>)

Returns the previous raw data samples, their DataStatusType and time based on the number of samples requested.

Declaration

public int[] GetPreviousSamples(int numberOfSamples, ref Dictionary<CompositeSessionKey, double[]> data, ref Dictionary<CompositeSessionKey, DataStatusType[]> status, ref Dictionary<CompositeSessionKey, long[]> time)

Parameters

Type	Name	Description
System.Int32	numberOfSamples	Number of samples to retrieve.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	data	Raw data values.
System.Collections.Generic.Dictionary<CompositeSessionKey, DataStatusType[]>	status	DataStatusType of the raw data values.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Int64[]>	time	Timestamps of the raw data values.

Returns

Type	Description
System.Int32[]	The number of samples available for each underlying PDA

GetPreviousSamples(Int64)

Returns the previous raw data samples, their DataStatusType and timestamp, starting at endTime. NOTE: This method does not deal with Single Lap compare

Declaration

public Dictionary<CompositeSessionKey, ParameterValues> GetPreviousSamples(long endTime)

Parameters

Type	Name	Description
System.Int64	endTime	The end time.

Returns

Type	Description
System.Collections.Generic.Dictionary<CompositeSessionKey, ParameterValues>	Number of samples available for each underlying PDA

GetPreviousSamples(Int64, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, DataStatusType[]>, ref Dictionary<CompositeSessionKey, Int64[]>)

Returns the previous raw data samples, their DataStatusType and timestamp, starting at endTime.

Declaration

public int[] GetPreviousSamples(long endTime, ref Dictionary<CompositeSessionKey, double[]> data, ref Dictionary<CompositeSessionKey, DataStatusType[]> status, ref Dictionary<CompositeSessionKey, long[]> time)

Parameters

Type	Name	Description
System.Int64	endTime	The end time.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	data	Raw data values.
System.Collections.Generic.Dictionary<CompositeSessionKey, DataStatusType[]>	status	DataStatusType of the raw data values.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Int64[]>	time	Timestamps of the data.

Returns

Type	Description
System.Int32[]	Number of samples available for each underlying PDA

GetSamples(Int32, Int64, Int64, ref Dictionary<CompositeSessionKey, Double[]>, ref Dictionary<CompositeSessionKey, DataStatusType[]>, ref Dictionary<CompositeSessionKey, Int64[]>)

Returns a number of raw data samples between a start and end sample time.

Declaration

public int[] GetSamples(int maximumNumberOfSamples, long startTimeStamp, long endTimeStamp, ref Dictionary<CompositeSessionKey, double[]> data, ref Dictionary<CompositeSessionKey, DataStatusType[]> status, ref Dictionary<CompositeSessionKey, long[]> time)

Parameters

Type	Name	Description
System.Int32	maximumNumberOfSamples	The maximum number of samples to request.
System.Int64	startTimeStamp	The start time stamp.
System.Int64	endTimeStamp	The end time stamp.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Double[]>	data	Raw data values.
System.Collections.Generic.Dictionary<CompositeSessionKey, DataStatusType[]>	status	DataStatusType of the raw data values.
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Int64[]>	time	Timestamps of the data.

Returns

Type	Description
System.Int32[]	The number of samples available for each underlying PDA

GetSamplesCount(Int64, Int64)

Gets the sample counts of all underlying sessions.

Declaration

public Dictionary<CompositeSessionKey, Dictionary<SessionKey, Nullable<long>>> GetSamplesCount(long startTimeStamp, long endTimeStamp)

Parameters

Type	Name	Description
System.Int64	startTimeStamp	The start time stamp.
System.Int64	endTimeStamp	The end time stamp.

Returns

Type	Description
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Collections.Generic.Dictionary<SessionKey, System.Nullable<System.Int64>>>	The sample count for each underlying session.

GetSamplesCountEstimate(Int64, Int64)

Returns the theoretical sample count between a specified start and end time based on the highest frequency channel for this PDA's Parameter. If the return value is zero means that was impossible to calculate the sample count, or this PDA is created on a SlowRow parameter

Declaration

public Dictionary<CompositeSessionKey, Dictionary<SessionKey, Nullable<long>>> GetSamplesCountEstimate(long startTimeStamp, long endTimeStamp)

Parameters

Type	Name	Description
System.Int64	startTimeStamp	Start time stamp of the data.
System.Int64	endTimeStamp	End time stamp of the data.

Returns

Type	Description
System.Collections.Generic.Dictionary<CompositeSessionKey, System.Collections.Generic.Dictionary<SessionKey, System.Nullable<System.Int64>>>	Theoretical sample count between the start and end time, or zero if it was impossible to calculate, or this PDA is created on a SlowRow parameter.

GoTo(Double)

Positions the ParameterDataAccess object to a specific position (i.e. when the X Axis is not Time) within the parameter's data. This value can be used to set the start point for GetNextData calls.

Declaration

public void GoTo(double position)

Parameters

Type	Name	Description
System.Double	position	Required position.

GoTo(Int64)

Positions the ParameterDataAccess object to a specific time within the parameter's data. This value can be used to set the start point for GetNextData calls.

Declaration

public void GoTo(long time)

Parameters

Type	Name	Description
System.Int64	time	Required time location in nano-seconds.

SetMapper(String)

Sets the mapper to be used for GetNextData calls. The mapper is identified by its name. The API includes default mappers for time (which is the default for a PDA) and distance. These are named "time" and "distance" respectively. The API caller may specify another mapping name for a custom mapper that has been registered with the API (see MapperService). If a mapper is set which is not registered then an invalid argument exception will be thrown.

Declaration

public void SetMapper(string mapper)

Parameters

Type	Name	Description
System.String	mapper	The name of the mapper.

SetSampleIncrement(Double)

Sets the current sample increment for the PDA, when the X Axis is not Time

Declaration

public void SetSampleIncrement(double increment)

Parameters

Type	Name	Description
System.Double	increment	The required sample increment.

SetSampleIncrement(Int64)

Sets the current sample increment for the PDA, in nanoseconds (supersedes SampleTime). This value will only affect requests to get data (using the GetNextData method ) and will not affect calls to get samples (using the GetSamples/GetNextSamples/GetPreviousSamples methods).

Declaration

public void SetSampleIncrement(long increment)

Parameters

Type	Name	Description
System.Int64	increment	The required sample increment

Remarks

This time is the interval between data samples. For example: 1,000,000 ns = 1000Hz 10,000,000 ns = 100Hz 100,000,000 ns = 10Hz 1,000,000,000 ns = 1Hz If this value is not set then the default sample time is 100Hz (10,000,000 ns).

Events

Invalidated

Occurs when [invalidated].

Declaration

public event EventHandler Invalidated

Event Type

Type	Description
System.EventHandler

UnderlyingDataSourceChanged

Occurs when [underlying data source changed]. This event will be raised if the source data context of one of the underlying PDAs of this composite PDA change - any previously-requested data is invalid.

Declaration

public event EventHandler UnderlyingDataSourceChanged

Event Type

Type	Description
System.EventHandler

Implements

ICompositeContainerParameterDataAccess

System.IDisposable