Measurement Object

See IArrayTransfer Interface for putting and getting typed data.

See IMixer Interface (used with Option S93083A/B)

Description

The Measurement object is probably the most used object in the VNA Object Model. A measurement object represents the chain of data processing algorithms that take raw data from the channel and make it ready for display, which then becomes the scope of the Trace object.

A Measurement object is defined by it's parameter (S11, S22, A/R1, B and so forth). The measurement object is associated with a channel which drives the hardware that produces the data that feeds the measurement. The root of a measurement is the raw data. This buffer of complex paired data then flows through a number of processing blocks: error-correction, trace math, phase correction, time domain, gating, formatting. All of these are controlled through the measurement object.

The ACTIVE measurement is the measurement that will be acted upon if you make a setting from the front panel. It is the measurement whose "button" is pressed in the window with the red "active window" frame. If you create a new measurement, that measurement becomes the active measurement.

Therefore, all automation methods with the word "Active" in them refer to the object associated with the Active measurement, whether that object is a Channel, Window, Trace or Limit line.

Learn about the IMeasurement2 Interface for reading stimulus properties.

Accessing the Measurement object

Dim app As AgilentPNA835x.Application
Set app = CreateObject("AgilentPNA835x.Application", <analyzerName>)

Dim meas As IMeasurement
Set meas = app.ActiveMeasurement

Set meas = app.Measurements(n)

You can access four other objects through the Measurement object: markers, limit test, transform, and gating. For example, because each measurement has its own set of markers, you can set a marker by doing this:

Dim meas as measurement
Set meas = app.ActiveMeasurement
meas.marker(1).Stimulus = 900e6

IMeasurement2 Interface

Some of the properties and methods for the IMeasurement2 Interface return stimulus values that are set using the channel object. The following is the reason these properties and methods are duplicated.

Every measurement carries with it a snapshot of the stimulus properties of the channel that were in effect when the measurement last acquired data. Therefore, it is the measurement that provides the most accurate stimulus description of its data. Any change made to the channel after the measurement was acquired renders the IChannel interface unreliable in terms of describing the measurement.

Methods	Interface	Description
Activate	IMeasurement	Makes a measurement the active measurement. Shared with the Marker Object
ActivateMarker	IMeasurement	Makes a marker the Active Marker.
ChangeParameter	IMeasurement	Changes the parameter of the measurement.
DataToDivisor	IMeasurement	Superseded with DoReceiverPowerCal Method
DataToMemory	IMeasurement	Stores the active measurement into memory.
Delete	IMeasurement	Deletes the measurement object.
DeleteAllMarkers	IMeasurement	Deletes all of the markers from the measurement.
DeleteMarker	IMeasurement	Deletes a marker from the active measurement.
getData	IMeasurement	Retrieves Complex data from analyzer memory
GetDataBuffer	IMeasurement19	Retrieves trace data (Y data) from the modulation distortion measurement.
GetDataBufferCompact	IMeasurement19	Retrieves compact signal trace data (Y data) from the modulation distortion measurement.
getDataByString	IMeasurement	Retrieves variant data from the specified location in your choice of formats.
GetFilterStatistics	IMeasurement	Returns all four Filter Statistics
GetReferenceMarker	IMeasurement	Returns a handle to the reference marker.
Get SnPData	IMeasurement3	Returns SnP data.
GetSnpDataWithSpecifiedPorts	IMeasurement7	Returns sNp data for the specified ports.
GetTraceStatistics	IMeasurement	Returns the Trace Statistics.
GetXAxisValues	IMeasurement2	Returns the stimulus values for the measurement.
GetXDataBuffer	IMeasurement19	Retrieves frequency tone data from the modulation distortion measurement.
GetXDataBufferCompact	IMeasurement19	Retrieves compact signal frequency tone data from the modulation distortion measurement.
InterpolateMarkers	IMeasurement	Turns All Marker Interpolation ON and OFF for the measurement.
putDataComplex	IMeasurement	Puts complex data into one of five data buffers.
putDataScalar	IMeasurement	Puts formatted variant data into the measurement results buffer.
SearchFilterBandwidth	IMeasurement	Searches the domain with the current BW target.
TraceHoldClear	IMeasurement16	Resets the currently-stored data points to the live data trace and restarts the currently-selected Trace Hold type.
WriteSnpFileWithSpecifiedPorts	IMeasurement7	Write sNp data for specified ports to a file.
Properties	Interface	Description
ActiveMarker	IMeasurement	Returns a handle to the Active Marker object.
ActiveXAxisRange	IMeasurement14	Sets the X-axis range to display for GCX, SMC, and VMC measurements.
BalancedMeasurement	IMeasurement5	Sets the measurement type that is used with balanced topologies.
BandwidthTarget	IMeasurement	The insertion loss value at which the bandwidth of a filter is measured.
BandwidthTracking	IMeasurement	Turns Bandwidth Tracking function ON and OFF.
CalibrationName	IMeasurement2	Returns the name of the cal type.
CalibrationType	IMeasurement	Superseded with CalibrationTypeID_property
CalibrationTypeID	IMeasurement2	Sets or returns the cal type for the current measurement.
Center	IMeasurement2	Returns the stimulus value of the center point for the measurement.
channelNumber	IIMeasurement	Returns the channel number. Shared with the Channel Object
CustomMeasurementConfiguration	IIMeasurement12	Provides access to custom measurement properties and methods.
Domain	IMeasurement2	Returns the domain (frequency, time, power) for the measurement.
ElectricalDelay	IMeasurement	Sets electrical delay.
ElecDelayMedium	IMeasurement2	Sets or returns the characteristic of the electrical delay medium.
ElecDistanceDelay	IMeasurement11	Sets delay in distance
ElecDistanceDelayUnit	IMeasurement11	Sets distance units
ErrorCorrection	IMeasurement	Set or get the state of error correction for the measurement.
ErrorCorrectionIndicator	IMeasurement14	Returns the error correction status of the measurement.
FilterBW	IMeasurement	Returns the results of the SearchBandwidth method.
FilterCF	IMeasurement	Returns the Center Frequency result of the SearchBandwidth method.
FilterLoss	IMeasurement	Returns the Loss value of the SearchBandwidth method.
FilterQ	IMeasurement	Returns the Q (quality factor) result of the SearchBandwidth method.
Format	IMeasurement	Sets display format.
FormatUnit	IMeasurement9	Sets units for unratioed measurements.
Gating	IMeasurement	Controls Time Domain Gating.
GroupDelayAperture	IMeasurement13	Provides access to the Group Delay Aperture settings.
InterpolateCorrection	IMeasurement	Turns ON and OFF the calculation of new error terms when stimulus values change.
InterpolateMemory	IMeasurement18	Sets or returns the state of the memory data interpolation.
InterpolateNormalization	IMeasurement	Superseded with DoReceiverPowerCal Method
IsSparameter	IMeasurement2	Returns true if measurement represents an S-Parameter.
LimitTest	IMeasurement	Collection for iterating through the Limit Segment objects (Limit Lines).
LimitTestFailed	IMeasurement	Returns the results of limit testing
LoadPort	IMeasurement	Returns the load port number associated with an S-parameter reflection measurement.
LogMagnitudeOffset	IMeasurement	Superseded with DoReceiverPowerCal Method
MagnitudeOffset	IMeasurment4	Offsets the magnitude of the entire data trace to a specified value.
MagnitudeSlopeOffset	IMeasurment4	Offsets the magnitude of the data trace to a value that changes linearly with frequency.
Marker	IMeasurement	Provides access to Marker settings.
Marker State	IMeasurement3	Sets or returns the ON / OFF state of a marker.
Mean	IMeasurement	Returns the mean value of the measurement.
MeasurementEquation	IMeasurement6	Access Equation Editor
Name	IMeasurement	Sets or returns the name of the measurement.
NAWindow	IMeasurement	Controls the part of the display that contains the graticule, or what is written on the display.
Normalization	IMeasurement	Superseded with DoReceiverPowerCal Method
Number	IMeasurement	Returns the number of the measurement.
NumberOfPoints	IMeasurement2	Returns the Number of Points of the measurement.
Parameter	IMeasurement	Returns the measurement Parameter.
PeakToPeak	IMeasurement	Returns the Peak to Peak value of the measurement.
PhaseOffset	IMeasurement	Sets the Phase Offset for the active channel.
PNOP	IMeasurement13	Provides access to the Power Normal Operating Point marker search object.
PSaturation	IMeasurement13	Provides access to the Power Saturation marker search object.
ReceivePort	IMeasurement2	Returns the receiver port of the measurement.
ReferenceMarkerState	IMeasurement	Turns the reference marker ON or OFF
ShowStatistics	IMeasurement	Displays and hides the measurement statistics (peak-to-peak, mean, standard deviation) on the screen.
Smoothing	IMeasurement	Turns ON and OFF data smoothing.
SmoothingAperture	IMeasurement	Specifies or returns the amount of smoothing as a ratio of the number of data points in the measurement trace.
SourcePort	IMeasurement2	Returns the source port of the measurement.
Span	IMeasurement2	Returns the stimulus span (stop - start) for the measurement.
StandardDeviation	IMeasurement	Returns the standard deviation of the measurement.
Start	IMeasurement2	Returns the stimulus value of the first point for the measurement.
StatisticsRange	IMeasurement	Sets the User Range number for calculating measurement statistics.
Stop	IMeasurement2	Returns the stimulus value of the last point for the measurement.
Trace	IMeasurement	Controls scale, reference position, and reference line.
TraceDeviationType	IMeasurement20	Calculates deviation from a least-squares fit line.
TraceHoldType	IMeasurement16	Sets the type of trace hold to perform.
TraceMath	IMeasurement	Performs math operations on the measurement object and the trace stored in memory.
TraceMax	IMeasurement10	Maximizes the active trace.
TraceTitle	IMeasurement8	Writes and reads a trace title.
TraceTitleState	IMeasurement8	Turns trace title ON and OFF
Transform	IMeasurement	Controls Time Domain transforms.
Uncertainty	IMeasurement17	Returns a handle to the (Dynamic) Uncertainty Object.
UserRangeMax	IMeasurement15	Sets the stimulus stop value for the specified User Range.
UserRangeMin	IMeasurement15	Sets the stimulus start value for the specified User Range.
View	IMeasurement	Sets (or returns) the type of trace displayed on the screen.
WGCutoffFreq	IMeasurement2	Sets or returns the value of the waveguide cut off frequency.
XAxis	IMeasurement17	Sets the X-axis of the selected measurement to a DC Source.
XAxisDomain	IMeasurement17	Sets and returns the X-Axis domain of the selected DIQ measurement.

IMeasurement History

Interface	Introduced with VNA Rev:
IMeasurement	1.0
IMeasurement2	3.0
IMeasurement3	4.0
IMeasurement4	4.2
IMeasurement5	5.0
IMeasurement7	6.2
IMeasurement8	7.2
IMeasurement9	8.35
IMeasurement10	8.35
IMeasurement11	8.50
IMeasurement12	9.00
IMeasurement13	9.20
IMeasurement14	9.22
IMeasurement15	9.40
IMeasurement16	10.25
IMeasurement17	10.30
IMeasurement18	10.49
IMeasurement19	13.60
IMeasurement20	13.80

IArrayTransfer Interface

Description

Contains methods for putting data in and getting data out of the analyzer using typed data. This interface transfers data more efficiently than the IMeasurement Interface. However, this interface is only usable from VB6, C, and C++.

See a VB.net example using this interface.

Methods	Description
getComplex	Retrieves real and imaginary data from the specified buffer.
getNAComplex	Retrieves typed NAComplex data from the specified buffer.
getPairedData	Retrieves magnitude and phase data pairs from the specified buffer.
getScalar	Retrieves scalar data from the specified buffer.
putComplex	Puts real and imaginary data into the specified buffer.
putNAComplex	Puts typed NAComplex data into the specified buffer.
putScalar	Puts scalar data into the measurement result buffer.
Properties	Description
None

IArrayTransfer History

Interface	Introduced with VNA Rev:
IArrayTransfer	1.0

Measurement Object

Description

Accessing the Measurement object

IMeasurement2 Interface

See Also:

Methods

Interface

Description

Properties

Interface

Description

IMeasurement History

Description

Methods

Description

Properties

Description

IArrayTransfer History