Class MeasurementImplementation
The measurement class from the automation interface, contains all Measurements.
Inheritance
Implements
Namespace: OmicronLab.VectorNetworkAnalysis.AutomationInterface
Assembly: OmicronLab.VectorNetworkAnalysis.AutomationInterface.dll (3.22.1690.0)
Syntax
[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 |
|
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 |