Write-only

Description

Performs a new measurement and opens a template view.

VB Syntax

plts.Measure(settings, templateViewName)

Variable

(Type) - Description

plts

(object) - A PLTSApplication object

settings

(string) Measurement settings in xml format:

<MeasurementSettings>

    <WizardWorkMode>NewMeas</WizardWorkMode>

//Must be NewMeas

    <CalAction>LoadCal</CalAction>

//Must be LoadCal

    <SelectedAnalysisViewName>MyTestTemplate</SelectedAnalysisViewName>

//Template view name to be opened after measurement

    <NumOfSweepPoints>2000</NumOfSweepPoints>

//Number of sweep points (set in the PNA)

    <VelocityFactor>1</VelocityFactor>

//Velocity factor

    <AverageFactor>1</AverageFactor>

//Average factor

    <IFBandWidthKHz>30</IFBandWidthKHz>

//IF bandwidth in kHz

    <IsLogSweep>false</IsLogSweep>

//Log sweep or not log sweep (false is not log sweep)

    <CalSetName>api_repeate_meas</CalSetName>

//Cal set name (set in the PNA)

    <CalDateTime>10/26/2015 09:29:27.320</CalDateTime>

//Cal date and time

    <NumOfDutPort>4</NumOfDutPort>

//Number of DUT ports

    <NumOfPnaPort>4</NumOfPnaPort>

//Number of PNA ports (must be the same as DUT port number)

    <PortMap>1|1|label|2|2|label|3|3|label|4|4|label|</PortMap>

//Single-ended port mapping (can be found in a PLTS exported sNp file header)

    <DiffPortMap>1|2P|2|2P|0|UC|0|UC|</DiffPortMap>

//Differential port mapping (can be found in a PLTS exported sNp file header)

    <Description>Default 4-Port Configuration</Description>

//Port mapping description

    <VnaPortsList>1,2,3,4</VnaPortsList>

//Available PNA test port list

</MeasurementSettings>

templateViewName

(string) Name of template view (case sensitive).

Return Type

Not Applicable

Default

None

Examples

Dim xmlMeasSettings As XElement = _

  <MeasurementSettings>

    <WizardWorkMode>NewMeas</WizardWorkMode>

    <CalAction>LoadCal</CalAction>

    <SelectedAnalysisViewName>MyTestTemplate</SelectedAnalysisViewName>

    <NumOfSweepPoints>2000</NumOfSweepPoints>

    <VelocityFactor>1</VelocityFactor>

    <AverageFactor>1</AverageFactor>

    <IFBandWidthKHz>30</IFBandWidthKHz>

    <IsLogSweep>false</IsLogSweep>

    <CalSetName>api_repeate_meas</CalSetName>

    <CalDateTime>10/26/2015 09:29:27.320</CalDateTime>

    <NumOfDutPort>4</NumOfDutPort>

    <NumOfPnaPort>4</NumOfPnaPort>

    <PortMap>1|1|label|2|2|label|3|3|label|4|4|label|</PortMap>

    <DiffPortMap>1|2P|2|2P|0|UC|0|UC|</DiffPortMap>

    <Description>Default 4-Port Configuration</Description>

    <VnaPortsList>1,2,3,4</VnaPortsList>

  </MeasurementSettings>

Dim docobj As object = Nothing

Dim viewobj As object = Nothing

app.Measure(xmlSettings.ToString(), docobj, videwobj)

See an example program.

C++ Syntax

HRESULT Measure(BSTR settings, BSTR templateViewName, IDispatch** ppDoc, IDispatch** ppView);

Interface

IPLTSApplication