System Console and Toolkit Tcl Command Reference Manual

ID 683101
Date 7/08/2024
Public
Document Table of Contents

2.1.25. set_eye_data

Description

This command sets the eye data to plot in the eye viewer's heat map graph diagram.If the eye property z_unit is set with a list of different z_units then this command accepts a list for each point in the eye diagram. Look at the second example for details.

Availability

EYE_VIEWER

Usage

set_eye_data <rows>

ReturnType

Nothing

Returns

no return value

Arguments

rows
Eye data expressed as a list of lists. Each inner list corresponds to a displayed row in the heat map. The number of elements inside each inner list define the number of columns in the map. The value of these elements define the color intensity of each cell in the heat map.

Example

# The following example draws a dummy eye
set eye_data_str {}
lappend eye_data_str [list 1 1 1 1 1 1 1 1 1 1 ]
lappend eye_data_str [list 1 0.9 0.03 0.004 0.0002 0.0002 0.004 0.03 0.9 1 ]
lappend eye_data_str [list 1 0.05 0.0003 0.000004 0.00000002 0.00000002 0.000004 0.0003 0.05 1 ]
lappend eye_data_str [list 1 0.0005 0.000003 0.00000002 0 0 0.00000002 0.000003 0.0005 1 ]
lappend eye_data_str [list 1 0.05 0.0003 0.000004 0.00000002 0.00000002 0.000004 0.0003 0.9 1 ]
lappend eye_data_str [list 1 0.9 0.03 0.004 0.0002 0.0002 0.004 0.03 0.9 1 ]
lappend eye_data_str [list 1 1 1 1 1 1 1 1 1 1 ]
set_eye_data $eye_data_str

# The following example draws a dummy eye containing multiple values per point in the eye diagram. The values in the per point lists correspond to the values in the z_unit list. There can be an arbitrary number of items in the z_unit list.
set_eye_property Z_UNIT {"BER (Bit Error Rate)" "Total Bits Tested"}
lappend eye_data_str [list [list 1 100000000] [list 1 100000000] [list 1 100000000] [list 1 100000000] [list 1 100000000] [list 1 100000000] [list 1 100000000] [list 1 100000000] [list 1 100000000] [list 1 100000000] ]
lappend eye_data_str [list [list 1 100000000] [list 0.9 100000000] [list 0.03 100000000] [list 0.004 100000000] [list 0.0002 100000000] [list 0.0002 100000000] [list 0.004 100000000] [list 0.03 100000000] [list 0.9 100000000] [list 1 100000000] ]
lappend eye_data_str [list [list 1 100000000] [list 0.05 100000000] [list 0.0003 100000000] [list 0.000004 100000000] [list 0.00000002 100000000] [list 0.00000002 100000000] [list 0.000004 100000000] [list 0.0003 100000000] [list 0.05 100000000] [list 1 100000000] ]
lappend eye_data_str [list [list 1 100000000] [list 0.0005 100000000] [list 0.000003 100000000] [list 0.00000002 100000000] [list 0 100000000] [list 0 100000000] [list 0.00000002 100000000] [list 0.000003 100000000] [list 0.0005 100000000] [list 1 100000000] ]
lappend eye_data_str [list [list 1 100000000] [list 0.05 100000000] [list 0.0003 100000000] [list 0.000004 100000000] [list 0.00000002 100000000] [list 0.00000002 100000000] [list 0.000004 100000000] [list 0.0003 100000000] [list 0.9 100000000] [list 1 100000000] ]
lappend eye_data_str [list [list 1 100000000] [list 0.9 100000000] [list 0.03 100000000] [list 0.004 100000000] [list 0.0002 100000000] [list 0.0002 100000000] [list 0.004 100000000] [list 0.03 100000000] [list 0.9 100000000] [list 1 100000000] ]
lappend eye_data_str [list [list 1 100000000] [list 1 100000000] [list 1 100000000] [list 1 100000000] [list 1 100000000] [list 1 100000000] [list 1 100000000] [list 1 100000000] [list 1 100000000] [list 1 100000000] ]
set_eye_data $eye_data_str