eyediagram

Generate eye diagram

Syntax

eyediagram(x,n)

eyediagram(x,n,period)

eyediagram(x,n,period,offset)

eyediagram(x,n,period,offset,plotstring)

eyediagram(x,n,period,offset,plotstring,h)

h = eyediagram(___)

Description

eyediagram(x,n) generates an eye diagram for signal x, plotting n samples in each trace. The labels on the horizontal axis of the diagram range between –1/2 and 1/2. The function assumes that the first value of the signal and every nth value thereafter, occur at integer times.

eyediagram(x,n,period) sets the labels on the horizontal axis to the range between –period/2 to period/2.

eyediagram(x,n,period,offset) specifies the offset for the eye diagram. The function assumes that the (offset + 1)th value of the signal and every nth value thereafter, occur at times that are integer multiples of period.

eyediagram(x,n,period,offset,plotstring) specifies plot attributes for the eye diagram.

eyediagram(x,n,period,offset,plotstring,h) generates the eye diagram in an existing figure whose handle is h.

Note

Use of hold on to plot multiple signals in the same figure is not supported.

h = eyediagram(___) returns the handle to the figure that contains the eye diagram. You can specify any of the input argument combinations from the previous syntaxes.

Examples

Generate Eye Diagram of Filtered QPSK Signal

Generate an eyediagram of a filtered QPSK signal.

Generate random symbols. Apply QPSK modulation to get a modulated signal.

data = randi([0 3],1000,1);
modSig = pskmod(data,4,pi/4);

Specify the number of output samples per symbol parameter. Create a transmit filter object, txfilter.

sps=4;
txfilter = comm.RaisedCosineTransmitFilter('OutputSamplesPerSymbol',sps);

Filter the modulated signal modSig.

txSig = txfilter(modSig);

Display the eye diagram.

eyediagram(txSig,2*sps)

Input Arguments

x — Input signal

vector | matrix

Input signal, specified as a vector or matrix.

The interpretation of x and the number of plots depend on the shape and complexity of x.

• If x is a real-valued two-column matrix, the function interprets the first column as in-phase components and the second column as quadrature components. The two components appear in different subplots of a single figure window.

• If x is a complex-valued vector, the function interprets the real part as in-phase components and the imaginary part as quadrature components. The two components appear in different subplots of a single figure window.

• If x is a real-valued vector, the function interprets the vector as a real signal. The figure window contains a single plot.

Data Types: double
Complex Number Support: Yes

n — Number of samples per trace

integer greater than 1

Number of samples per trace, specified as an integer greater than 1.

Data Types: double

period — Trace period

1 (default) | positive scalar

Trace period, specified as a positive scalar. The labels on the horizontal axis of the eye diagram range between –period/2 to period/2.

Data Types: double

offset — Offset value

0 (default) | integer in the range from 0 to (n–1)

Offset value, specified as an integer in the range 0 to (n–1). The function assumes that the (offset + 1)th value of the signal and every nth value thereafter, occur at times that are integer multiples of the input period.

Data Types: double

plotstring — Plot attributes

'b-' (default) | character vector | string scalar

Plot attributes, specified as a character vector or string scalar containing symbols.

This argument sets the plotting symbol, line type, and color for the eye diagram. The format and meaning of the symbols are the same as in the plot function. For example, the default value 'b-' produces a solid blue line.

Data Types: char | string

h — Figure handle

Figure object

Figure handle to an existing figure that contains an eye diagram, specified as a Figure object. h must be a handle to a figure that the eyediagram function previously generated.

Output Arguments

h — Figure handle

Figure object

Figure handle, returned as a Figure object. To modify properties of this object, see Figure.

Version History

Introduced before R2006a