Communications Toolbox™

Using EyeScope

Starting EyeScope with an Argument

You can start EyeScope so it is displaying an eye diagram object. To start EyeScope so it is displaying an eye diagram object, type the following at the MATLAB^® command line:

eyescope(h)

Note   h is a handle to an eye diagram object presently in the workspace.

Back to Top

Starting a new Session

Starting a new session purges EyeScope memory, returning EyeScope to an empty plot display. If changes have been made to an open session and you start a new session, you will be prompted to save the open session.

Back to Top

Opening a Session

To open session, choose the file name and location of the session file. The file extensions for a session file is .eds, which stands for eye diagram scope. If changes have been made to a session that is presently open and you try to open up a new session, you will be prompted to save the session that is presently open before the new session can start.

To open a session:

1. Click File > Open Session.

   The Select File To Open Window appears.

   

2. Navigate to the EyeScope session file you want, and click Open.

Back to Top

Saving a Session

The Save Session selection saves the current session, updating the session file. A session file includes the eye diagram object, eyescope options, and plot control selections.

If you attempt to save a session that you have not previously saved, EyeScope will prompt you for a file name and location. Otherwise, the session is saved to the previously selected file.

To save a session, follow these steps:

1. Click File > Save Session.

2. Navigate to the folder where you want to save the EyeScope session file and click Save.

Back to Top

Importing an Eye Diagram Object

The Import menu selection imports an eye diagram object from either the workspace or a MAT-file to EyeScope. The imported variable name will be reconstructed to reflect the origin of the eye diagram object.

If an object is imported from the workspace, the variable name will be ws_object name, where object name is the name of the original variable.

If the object is imported from a MAT-file, then the file name (without the path) precedes the object name.

Importing an object creates a copy of the object, using the naming convention previously described. EyeScope displays the object's contents as configured when the object was imported. EyeScope does not track any object changes made in the workspace (or to the .mat file) from which the object was imported.

To import an eye diagram object:

1. Click File > Import Eye Diagram Object

   The Import eye diagram object window appears.

   

   The contents panel of the of the Import eye diagram object window displays all eye diagram objects available in the source location.

2. From the Import eye diagram object window, select the source for the object being imported.

   • Select From workspace to import an eye diagram object directly from the workspace.

   • Select From File to choose an eye diagram object file that was previously saved and click Browse to select the file to be loaded.

3. Click Import.

Back to Top

Exporting an Eye Diagram Plot

EyeScope allows you to export the eye diagram plot to a separate MATLAB figure window. From the MATLAB figure window, along with other tasks, you can print, zoom, or edit the plot.

To export an eye diagram figure:

• Click File > Export Eye Diagram Figure

  The MATLAB figure window, containing the exported image, appears.

  

Back to Top

Selecting Which Eye Diagram Object Settings To Display

The Eye Diagram Object Settings View allows you to select which object settings display in the eye diagram object settings panel. You make your selections in the Configure eye diagram object settings view window, where a shuttle control allows you to add, remove, or reorder the settings you are including.

To add an eye diagram object setting:

1. Click Options > Eye Diagram Object Settings View

   The Configure eye diagram object settings view window appears.

   

2. Locate any items to be added in the list of Available items, and left-click to select.

   Note   To select multiple items, you can either press and hold the <Shift> key and left-click or press and hold the <Ctrl> key and left-click.

   When you select an item, the Quick help panel displays information about the item. If you select multiple items, Quick help displays information pertaining to the last item you select.

3. Click Add.

   Note   Using the Move Up orMove Down buttons, you can change the order in which the eye diagrams settings you select appear.

4. Click OK .

Back to Top

Selecting Which Eye Diagram Measurements To Display

You can modify the contents of the measurement panel by selecting which eye diagram measurements display in the eye diagram object settings panel. You make your selections in the Configure measurements view window, where a shuttle control allows you to add, remove, or reorder the settings you are including.

Adding An Eye Diagram Measurement Setting

1. Click Options > Measurements View

   The Configure measurements window appears.

   

2. Locate any items to be added in the list of Available items, and left-click to select.

   Note   To select multiple items, you can either press and hold the <Shift> key and left-click or press and hold the <Ctrl> key and left-click.

   When you select an item, the Quick help panel displays information about the item. If you select multiple items, Quick help displays information pertaining to the last item you select.

3. Click Add.

   Note   Using the Move Up or Move Down buttons, you can change the order in which the eye diagrams settings you select appear.

4. Click OK .

Back to Top

Using the Help Menu

The Help menu provides access to the EyeScope and Eye Diagram reference pages.

Back to Top

The EyeScope Environment

Function Reference