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

eyeMaskViolationPeriodCount

eyeMaskViolationPeriodCount(
o_eyeMaskWaveform
)
=> n_periods / nil

Description

Returns the number of periods that contain eye mask violation.

Arguments

o_eyeMaskWaveform

Waveform ID of the eye diagram with eye mask overlaid on it.

Value Returned

n_periods

Scalar value showing number of periods that contain an eye mask violation.

nil

If there is an error.

Examples

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

win1=awvCreatePlotWindow()
=> window:3

The following example opens simulation results stored in the specified directory.

openResults("/servers/user/design/prbs.raw")
=> "/servers/user/design/prbs.raw"

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

results()
=> tran()

The following example selects the tran result of the results directory.

selectResult('tran)
=> stdobj@0x31b6fb30

The following example creates a waveform object jitter, representing the waveform of the signal jitter, which is available in the tran result of the results directory.

jitter=v("jitter")
=> srrWave:0x35e3b020

The following example creates a waveform object eye, representing an eye diagram that is generated by applying the eyeDiagram function on the jitter signal.

eye=eyeDiagram(jitter 200n 1.4u 2*40n ?autoCenter t)
=> srrWave:0x35e3b030

The following example creates a waveform object eyeMaskR that represents the eye diagram eye with an eye mask of the rectangle geometry placed over it at the specified coordinates.

eyeMaskR=eyeMask(eye "s" '(21n 0.179) '(21n 0.805) '(58n 0.805) '(58n 0.179))
=> srrWave:0x35df1040

The following example plots the waveform object eyeMaskR in the Waveform window that you created using the function awvCreatePlotWindow.

awvPlotWaveform(
    win1
    list(eyeMaskR)
    ?expr list("eyeWithMask")
    ?color list("y6")
    ?index list(1)
    ?lineType list("line")
    ?lineStyle list("dash")
    ?lineThickness list("thick")
    )
=> t

Observe that the eye mask appears in red color, which indicates that there are number of periods that contain eye mask violations.

The following example returns the number of periods for which the eye diagram intersects with the specified eye mask eyeMaskR.

eyeMaskViolationPeriodCount(eyeMaskR)
=> 12

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

win2=awvCreatePlotWindow()
=> window:4

The following example creates another waveform object eMaskR that represents the eye diagram eye with an eye mask of the rectangle geometry placed over it at the specified coordinates.

eMaskR=eyeMask(eye "s" '(30n 0.250) '(30n 0.750) '(50n 0.750) '(50n 0.250))
=> srrWave:0x35df1050

The following example plots the waveform object eMaskR in the Waveform window that you created using the function awvCreatePlotWindow.

awvPlotWaveform(
    win2
    list(eMaskR)
    ?expr list("eyeWithMask")
    ?color list("y2")
    ?index list(1)
    ?lineType list("line")
    ?lineStyle list("dash")
    ?lineThickness list("thick")
    )
=> t

Observe that the eye mask appears in green color, which indicates that there are no periods that contain eye mask violations.

The following example returns the number of periods for which the eye diagram intersects with the specified eye mask eMaskR.

eyeMaskViolationPeriodCount(eMaskR)
=> 0


Return to top
 ⠀
X