Product Documentation
Virtuoso Visualization and Analysis XL SKILL Reference
Product Version IC23.1, November 2023

rfWrlsMeasContour

rfWrlsMeasContour(
t_sig
[ ?maxValue n_maxVaue ]
[ ?minValue n_minValue ]
[ ?numCont n_numCont ]
[ ?closeCont g_closeCont ]
[ ?modifier t_modifier ]
)
=> n_family / nil

Description

Draws contours of system measurements from simulation results of envelope loadpull analysis.

Arguments

t_sig

Name of the system metrics to be analyzed.

For example:

  • Adjacent Channel Power Ratio (ACPR)
  • Bit Error Rate (BER)
  • Error Vector Magnitude (EVM)
  • Frequency Shift Keying Error (FSK Error)
  • Main Channel Mean Power (MCP)
  • Peak-to-Average Power Ratio (PAPR)
  • RMS Voltage

?maxValue n_maxVaue

The largest value of the contour to be drawn.

If you do not specify the value of this argument, the largest value of the contour from simulation results is used.

?minValue n_minValue

The smallest value of the contour to be drawn.

If you do not specify the value of this argument, the smallest value of the contour from simulation results is used.

?numCont n_numCont

Number of contours to be drawn.

?closeCont g_closeCont

Specifies whether to draw a closed contour.

Valid values are:

  • t: Draws a closed contour.
  • nil: Draws an open contour.

?modifier t_modifier

Unit modifier.

Depending on the system metric to be analyzed, valid values can be one of the following:

  • dBm/50ohm
  • Watt/50ohm
  • dB20
  • RMS Volt
  • dBm
  • Watt
  • Percent
  • dBunit

Value Returned

n_family

Family of wave representing the contours drawn for the specified system measurement.

nil

Indicates an error.

Examples

The following example opens simulation results of envelope loadpull analysis stored in the specified directory.

openResults("/servers/user/ENVLPLoadpull/simulation/lib/cell/maestro/results/maestro/ExplorerRORun.0/1/lib:cell:1/psf")
=> "/servers/user/ENVLPLoadpull/simulation/lib/cell/maestro/results/maestro/ExplorerRORun.0/1/lib:cell:1/psf"

The following example lists the results available in the currently open results directory.

results()
=> (envlpldp model instance output designParamVals
    primitives subckts variables
)

The following example selects the result envlpldp.

selectResults('envlpldp)
=> stdobj@0x31e55ad0

The following example lists the outputs available in the selected result.

outputs()
=> 
("WPRB1.rmsvol" "WPRB0.rmsvol" "LOAD.rmsvol" "WPRB1.ber.1" "WPRB1.fskerr.1"
    "WPRB0.ber.1" "WPRB0.fskerr.1" "WPRB1.acpr.left1" "WPRB1.acpr.right1"
    "WPRB1.mcp" "WPRB0.acpr.left1" "WPRB0.acpr.right1" "WPRB0.mcp"
    "LOAD.acpr.left1" "LOAD.acpr.right1" "LOAD.mcp" "WPRB1.papr"
    "WPRB0.papr" "LOAD.papr" "/Gamma"
)

The following example creates a waveform object wave1, which represents 9 constant MCP contours for the measurement WPRB0.mcp. In this example, note that the largest and smallest values of the contours are taken from the simulation results of envelope loadpull analysis.

wave1=rfWrlsMeasContour("WPRB0.mcp" ?numCont 9 ?closeCont t ?modifier "dBm/50ohm")
=> srrWave:0x365ec040

The following example creates a Waveform window and returns its window ID.

win1=awvCreatePlotWindow()
=> window:3

The following example sets display mode of the Waveform window win1 to smith.

awvSetDisplayMode(win1 "smith")
=> t

The following example sets the Smith display of the Waveform window win1 to impedance.

awvSetSmithModeType(win1 "impedance")
=> t

The following example plots the waveform object wave1 in the Waveform window win1.

awvPlotWaveform(
    win1
    list(wave1)
    ?expr list("constantMCPContour")
    )
=> t

The following example creates a waveform object wave2, which represents 9 constant RMS voltage contours for the measurement WPRB1.rmsvol. In this example, note that the largest and smallest values of contours are taken from the simulation results of envelope loadpull analysis. The unit modifier is Watt/50ohm.

wave2=rfWrlsMeasContour("WPRB1.rmsvol" ?numCont 9 ?closeCont t ?modifier "Watt/50ohm")
=> srrWave:0x365ec170

The following example creates a Waveform window and returns its window ID.

win2=awvCreatePlotWindow()
window:4

The following example sets display mode of the Waveform window win2 to smith.

awvSetDisplayMode(win2 "smith")
=> t

The following example sets the Smith display of the Waveform window win2 to impedance.

awvSetSmithModeType(win2 "impedance")
=> t

The following example plots the waveform object wave2 in the Waveform window win2.

awvPlotWaveform(
    win2
    list(wave2)
    ?expr list("constRMSVoltageContour")
    )
=> t


Return to top
 ⠀
X