[Guid("88FF9BFA-2965-4E21-9FE9-88A288313772")]
[ClassInterface(ClassInterfaceType.None)]
[ComVisible(true)]
public class MeasurementImplementation : VnaMeasurementSuite<DeviceConfigurationImplementation>, S21Measurement, GainMeasurement, S11OnePortMeasurement, S11ExternalCouplerMeasurement, OnePortMeasurement, AdapterMeasurement, ExternalBridgeMeasurement, ShuntThruMeasurement, SeriesThruMeasurement, VoltageCurrentGainMeasurement, IDisposable

Remarks

The Measurement interface has been removed because it caused problems in MATLAB R2016a (SystemArgumentException('An item with the same key has already been added.') in mscorlib.dll).

Constructors

MeasurementImplementation(MeasurementTaskHandler, BaseMidLayer.Enumerations.MeasurementMode)

Initializes a new instance of the MeasurementImplementation class.

Declaration

public MeasurementImplementation(MeasurementTaskHandler measurementTaskHandler, BaseMidLayer.Enumerations.MeasurementMode mode = null)

Parameters

Type	Name	Description
MeasurementTaskHandler	measurementTaskHandler	The measurement task handler.
BaseMidLayer.Enumerations.MeasurementMode	mode	The measurement mode.

Properties

Attenuation

Gets the attenuation.

Declaration

public Attenuation Attenuation { get; }

Property Value

Type	Description
Attenuation	The attenuation.

DutSettlingTime

Gets or sets the device under test settling time.

Declaration

public double DutSettlingTime { get; set; }

Property Value

Type	Description
System.Double	The the device under test settling time.

ExternalProbeChannel1

Gets or sets the external probe channel 1.

Declaration

public double ExternalProbeChannel1 { get; set; }

Property Value

Type	Description
System.Double	The external probe channel 1.

ExternalProbeChannel2

Gets or sets the external probe channel 2.

Declaration

public double ExternalProbeChannel2 { get; set; }

Property Value

Type	Description
System.Double	The external probe channel 2.

MeasurementFrequencies

Gets the measurement frequencies from a measurement.

Declaration

public double[] MeasurementFrequencies { get; }

Property Value

Type	Description
System.Double[]

NominalImpedanceZ0

Gets or sets the nominal impedance z0.

Declaration

public double NominalImpedanceZ0 { get; set; }

Property Value

Type	Description
System.Double	The nominal impedance z0.

NumberOfPoints

Gets the number of points.

Declaration

public int NumberOfPoints { get; }

Property Value

Type	Description
System.Int32	The number of points.

Remarks

Returns 1 for single mode.

PortExtension

Gets the port extension.

Declaration

public PortExtension PortExtension { get; }

Property Value

Type	Description
PortExtension

ReceiverBandwidth

Gets or sets the receiver bandwidth.

Declaration

public ReceiverBandwidth ReceiverBandwidth { get; set; }

Property Value

Type	Description
ReceiverBandwidth	The receiver bandwidth.

Shaping

Gets the shaping.

Declaration

public Shaping Shaping { get; }

Property Value

Type	Description
Shaping

StartFrequency

Gets the start frequency.

Declaration

public double StartFrequency { get; }

Property Value

Type	Description
System.Double	The start frequency.

Remarks

Returns frequency value for single mode.

StopFrequency

Gets the stop frequency.

Declaration

public double StopFrequency { get; }

Property Value

Type	Description
System.Double	The stop frequency.

Remarks

Returns frequency value for single mode.

SweepMode

Gets the sweep mode of this test.

Declaration

public SweepMode SweepMode { get; }

Property Value

Type	Description
SweepMode

TerminationChannel1

Gets or sets the termination for channel 1.

Declaration

public Termination TerminationChannel1 { get; set; }

Property Value

Type	Description
Termination	The termination channel1.

TerminationChannel2

Gets or sets the termination for channel 2.

Declaration

public Termination TerminationChannel2 { get; set; }

Property Value

Type	Description
Termination	The termination channel2.

Methods

CalculateMeasurementTime()

Calculates the measurement time the HW will need to execute the current sweep.

Declaration

public override double CalculateMeasurementTime()

Returns

Type	Description
System.Double	The time in seconds.

Remarks

This calculation does include the actual measurement time, the DUT delay and detector measurements, but NOT e.g. switching time for e.g. shaped attenuators.

Clone()

Clones this instance. This can be used to e.g. perform calibrations without altering the actual suite.

Declaration

public override IMeasurementSuite<DeviceConfigurationImplementation> Clone()

Returns

Type	Description
IMeasurementSuite<DeviceConfigurationImplementation>

ConfigureCustomSweep(ref Double[])

Configures the custom sweep.

Declaration

public void ConfigureCustomSweep(ref double[] frequencies)

Parameters

Type	Name	Description
System.Double[]	frequencies	The frequencies.

Remarks

Call by reference is required to avoid compiler error in VBA: "Function or interface marked as restricted, or the function uses an Automation type not supported in Visual Basic".

ConfigureSinglePoint(Double)

Configures the single point.

Declaration

public void ConfigureSinglePoint(double frequency)

Parameters

Type	Name	Description
System.Double	frequency	The frequency.

ConfigureSweep(Double, Double, Int32, SweepMode)

Configures the sweep.

Declaration

public void ConfigureSweep(double startFrequency, double stopFrequency, int numberOfPoints, SweepMode sweepMode)

Parameters

Type	Name	Description
System.Double	startFrequency	The start frequency.
System.Double	stopFrequency	The stop frequency.
System.Int32	numberOfPoints	The number of points.
SweepMode	sweepMode	The sweep mode.

Dispose(Boolean)

Releases unmanaged and - optionally - managed resources.

Declaration

protected override void Dispose(bool disposing)

Parameters

Type	Name	Description
System.Boolean	disposing	`true` to release both managed and unmanaged resources; `false` to release only unmanaged resources.

ExecuteMeasurement()

Executes the test with the specified mode synchronous.

Declaration

public ExecutionState ExecuteMeasurement()

Returns

Type	Description
ExecutionState	ExecutionStatus object with information about the measurement.

ExecuteMeasurementAsync()

Executes the test with the specified mode asynchronous.

Declaration

public Task<ExecutionState> ExecuteMeasurementAsync()

Returns

Type	Description
Task<ExecutionState>	ExecutionStatus object with information about the measurement.

GetSourceLevel(LevelUnit)

Gets the source level.

Declaration

public double GetSourceLevel(LevelUnit unit)

Parameters

Type	Name	Description
LevelUnit	unit	The unit.

Returns

Type	Description
System.Double	Source Level.

SetSourceLevel(Double, LevelUnit)

Sets the source level.

Declaration

public void SetSourceLevel(double level, LevelUnit unit)

Parameters

Type	Name	Description
System.Double	level	The level.
LevelUnit	unit	The unit.

StopCurrentExecution()

Stops the current execution.

Declaration

public void StopCurrentExecution()

StopCurrentExecutionAsync()

Stops the current execution asynchronous.

Declaration

public Task StopCurrentExecutionAsync()

Returns

Type	Description
Task

Events

NewResultAvailable

Occurs when a new gain measurement result is available.

Declaration

public event NewResultAvailableDelegate NewResultAvailable

Event Type

Type	Description
NewResultAvailableDelegate

Remarks

NOT supported in Delphi and MatLab. Alternatively one can wait for the completion of the execution.

Explicit Interface Implementations

AdapterMeasurement.Calibration

Gets the impedance calibration settings.

Declaration

ImpedanceCalibration AdapterMeasurement.Calibration { get; }

Returns

Type	Description
ImpedanceCalibration	The calibration settings.

AdapterMeasurement.Results

Gets the results of the test.

Declaration

ImpedanceResult AdapterMeasurement.Results { get; }

Returns

Type	Description
ImpedanceResult

ExternalBridgeMeasurement.Calibration

Gets the impedance calibration settings.

Declaration

ImpedanceCalibration ExternalBridgeMeasurement.Calibration { get; }

Returns

Type	Description
ImpedanceCalibration	The calibration settings.

ExternalBridgeMeasurement.Results

Gets the results of the test.

Declaration

ImpedanceResult ExternalBridgeMeasurement.Results { get; }

Returns

Type	Description
ImpedanceResult

GainMeasurement.Calibration

Gets the gain calibration settings.

Declaration

GainCalibration GainMeasurement.Calibration { get; }

Returns

Type	Description
GainCalibration	The calibration settings.

GainMeasurement.Results

Gets the results of the test.

Declaration

GainResults GainMeasurement.Results { get; }

Returns

Type	Description
GainResults

OnePortMeasurement.Calibration

Gets the impedance calibration settings.

Declaration

ImpedanceCalibration OnePortMeasurement.Calibration { get; }

Returns

Type	Description
ImpedanceCalibration	The calibration settings.

OnePortMeasurement.Results

Gets the results of the test.

Declaration

ImpedanceResult OnePortMeasurement.Results { get; }

Returns

Type	Description
ImpedanceResult

S11ExternalCouplerMeasurement.Calibration

Gets the impedance calibration settings.

Declaration

ImpedanceCalibration S11ExternalCouplerMeasurement.Calibration { get; }

Returns

Type	Description
ImpedanceCalibration	The calibration settings.

S11ExternalCouplerMeasurement.Results

Gets the results of the test.

Declaration

ReflectionResult S11ExternalCouplerMeasurement.Results { get; }

Returns

Type	Description
ReflectionResult

S11OnePortMeasurement.Calibration

Gets the impedance calibration settings.

Declaration

ImpedanceCalibration S11OnePortMeasurement.Calibration { get; }

Returns

Type	Description
ImpedanceCalibration	The calibration settings.

S11OnePortMeasurement.Results

Gets the results of the test.

Declaration

ReflectionResult S11OnePortMeasurement.Results { get; }

Returns

Type	Description
ReflectionResult

S21Measurement.Calibration

Gets the gain calibration settings.

Declaration

GainCalibration S21Measurement.Calibration { get; }

Returns

Type	Description
GainCalibration	The calibration settings.

S21Measurement.Results

Gets the results of the test.

Declaration

GainResults S21Measurement.Results { get; }

Returns

Type	Description
GainResults

SeriesThruMeasurement.Calibration

Gets the impedance calibration settings.

Declaration

MultiModeCalibration SeriesThruMeasurement.Calibration { get; }

Returns

Type	Description
MultiModeCalibration	The calibration settings.

SeriesThruMeasurement.Results

Gets the results of the test.

Declaration

ImpedanceResult SeriesThruMeasurement.Results { get; }

Returns

Type	Description
ImpedanceResult

ShuntThruMeasurement.Calibration

Gets the impedance calibration settings.

Declaration

MultiModeCalibration ShuntThruMeasurement.Calibration { get; }

Returns

Type	Description
MultiModeCalibration	The calibration settings.

ShuntThruMeasurement.Results

Gets the results of the test.

Declaration

ImpedanceResult ShuntThruMeasurement.Results { get; }

Returns

Type	Description
ImpedanceResult

VoltageCurrentGainMeasurement.Calibration

Gets the calibration.

Declaration

MultiModeCalibration VoltageCurrentGainMeasurement.Calibration { get; }

Returns

Type	Description
MultiModeCalibration	The calibration.

VoltageCurrentGainMeasurement.Results

Gets the results of the test.

Declaration

ImpedanceResult VoltageCurrentGainMeasurement.Results { get; }

Returns

Type	Description
ImpedanceResult

Implements

S21Measurement

GainMeasurement

S11OnePortMeasurement

S11ExternalCouplerMeasurement

OnePortMeasurement

AdapterMeasurement

ExternalBridgeMeasurement

ShuntThruMeasurement

SeriesThruMeasurement

VoltageCurrentGainMeasurement

IDisposable