Comments?E-mail your comments about Synopsysdocumentation to [email protected]
CosmosScope™MATLAB® InterfaceUser GuideVersion V-2004.09, September 2004
i
Copyright Notice and Proprietary InformationCopyright 2004 Synopsys, Inc. All rights reserved. This software and documentation contain confidential and proprietaryinformation that is the property of Synopsys, Inc. The software and documentation are furnished under a license agreement andmay be used or copied only in accordance with the terms of the license agreement. No part of the software and documentation maybe reproduced, transmitted, or translated, in any form or by any means, electronic, mechanical, manual, optical, or otherwise,without prior written permission of Synopsys, Inc., or as expressly provided by the license agreement.
Right to Copy DocumentationThe license agreement with Synopsys permits licensee to make copies of the documentation for its internal use only.Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices, if any. Licensee mustassign sequential numbers to all copies. These copies shall contain the following legend on the cover page:
“This document is duplicated with the permission of Synopsys, Inc., for the exclusive use of__________________________________________ and its employees. This is copy number __________.”
Destination Control StatementAll technical data contained in this publication is subject to the export control laws of the United States of America.Disclosure to nationals of other countries contrary to United States law is prohibited. It is the reader’s responsibility todetermine the applicable regulations and to comply with them.
DisclaimerSYNOPSYS, INC., AND ITS LICENSORS MAKE NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITHREGARD TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
Registered Trademarks (®)Synopsys, AMPS, Arcadia, C Level Design, C2HDL, C2V, C2VHDL, Cadabra, Calaveras Algorithm, CATS, COSSAP,CSim, DelayMill, Design Compiler, DesignPower, DesignWare, EPIC, Formality, HSPICE, Hypermodel, I, iN-Phase,InSpecs, in-Sync, Leda, MAST, Meta, Meta-Software, ModelAccess, ModelTools, NanoSim, OpenVera, PathMill,Photolynx, Physical Compiler, PowerMill, PrimeTime, RailMill, Raphael, RapidScript, Saber, SiVL, SmartLogic, SNUG,SolvNet, Stream Driven Simulator, Superlog, System Compiler, Testify, TetraMAX, TimeMill, TMA, VCS, Vera, and VirtualStepper are registered trademarks of Synopsys, Inc.
Trademarks (™)abraCAD, abraMAP, Active Parasitics, AFGen, Apollo, Apollo II, Apollo-DPII, Apollo-GA, ApolloGAII, Astro, Astro-Rail,Astro-Xtalk, Aurora, AvanTestchip, AvanWaves, BCView, Behavioral Compiler, BOA, BRT, Cedar, ChipPlanner, CircuitAnalysis, Columbia, Columbia-CE, Comet 3D, Cosmos, CosmosEnterprise, CosmosLE, CosmosScope, CosmosSE,Cyclelink, Davinci, DC Expert, DC Expert Plus, DC Professional, DC Ultra, DC Ultra Plus, Design Advisor, DesignAnalyzer, Design Vision, DesignerHDL, DesignTime, DFM-Workbench, DFT Compiler, Direct RTL, Direct Silicon Access,Discovery, DW8051, DWPCI, Dynamic-Macromodeling, Dynamic Model Switcher, ECL Compiler, ECO Compiler,EDAnavigator, Encore, Encore PQ, Evaccess, ExpressModel, Floorplan Manager, Formal Model Checker,FoundryModel, FPGA Compiler II, FPGA Express, Frame Compiler, Galaxy, Gatran, HDL Advisor, HDL Compiler,Hercules, Hercules-Explorer, Hercules-II, Hierarchical Optimization Technology, High Performance Option, HotPlace,HSPICE-Link, iN-Tandem, Integrator, Interactive Waveform Viewer, i-Virtual Stepper, Jupiter, Jupiter-DP, JupiterXT,JupiterXT-ASIC, JVXtreme, Liberty, Libra-Passport, Library Compiler, Libra-Visa, Magellan, Mars, Mars-Rail, Mars-Xtalk,Medici, Metacapture, Metacircuit, Metamanager, Metamixsim, Milkyway, ModelSource, Module Compiler, MS-3200,MS-3400, Nova Product Family, Nova-ExploreRTL, Nova-Trans, Nova-VeriLint, Nova-VHDLlint, Optimum Silicon,Orion_ec, Parasitic View, Passport, Planet, Planet-PL, Planet-RTL, Polaris, Polaris-CBS, Polaris-MT, Power Compiler,PowerCODE, PowerGate, ProFPGA, Progen, Prospector, Proteus OPC, Protocol Compiler, PSMGen, Raphael-NES,RoadRunner, RTL Analyzer, Saturn, ScanBand, Schematic Compiler, Scirocco, Scirocco-i, Shadow Debugger, SiliconBlueprint, Silicon Early Access, SinglePass-SoC, Smart Extraction, SmartLicense, SmartModel Library, Softwire,Source-Level Design, Star, Star-DC, Star-MS, Star-MTB, Star-Power, Star-Rail, Star-RC, Star-RCXT, Star-Sim,Star-SimXT, Star-Time, Star-XP, SWIFT, Taurus, Taurus-Device, Taurus-Layout, Taurus-Lithography, Taurus-OPC,Taurus-Process, Taurus-Topography, Taurus-Visual, Taurus-Workbench, TimeSlice, TimeTracker, Timing Annotator,TopoPlace, TopoRoute, Trace-On-Demand, True-Hspice, TSUPREM-4, TymeWare, VCS Express, VCSi, Venus,Verification Portal, VFormal, VHDL Compiler, VHDL System Simulator, VirSim, and VMC are trademarks ofSynopsys, Inc.
Service Marks ( SM)MAP-in, SVP Café, and TAP-in are service marks of Synopsys, Inc.
SystemC is a trademark of the Open SystemC Initiative and is used under license.ARM and AMBA are registered trademarks of ARM Limited.All other product or company names may be trademarks of their respective owners.
Printed in the U.S.A.
Document Order Number: 00000-000 UAManual Name Manual Type, version V-2004.06
ii
Table Of Contents
Chapter 1. CosmosScope MATLAB Interface User Guide ............................ 5
MATLAB Interface Tool ................................................................................. 5
Accessing the MATLAB Interface Tool ......................................................... 6
MATLAB Interface Window Description ...................................................... 6
MATLAB Interface Menus............................................................................. 7
MATLAB Interface Fields and Lists ............................................................. 7
MATLAB Interface Keyboard Shortcuts ................................................. 8
MATLAB Interface Data Transfer ................................................................ 8
Transferring from Saber Applications to MATLAB................................ 9
Transferring from MATLAB to Saber Applications.............................. 10
CosmosScope AIM Commands .................................................................... 11
AIM Overview ......................................................................................... 13
MATLAB Interface Waveform Commands ................................................. 13
waveform ................................................................................................. 13
wfdata ...................................................................................................... 15
wfdatatype............................................................................................... 16
wfnames................................................................................................... 16
wfnpars.................................................................................................... 17
wfnsegs .................................................................................................... 18
wfparsizes................................................................................................ 18
wfparvalues ............................................................................................. 19
MATLAB Interface Command Limitations ................................................ 20
Index ......................................................................................................... Index-1
Bookshelf ............................................................................................Bookshelf-1
CosmosScope MATLAB Interface User Guide (Sept. 2004) iiiCopyright © 1985-2004 Synopsys, Inc.
Table Of Contents
iv CosmosScope MATLAB Interface User Guide (Sept. 2004)Copyright © 1985-2004 Synopsys, Inc.
chapter 1CosmosScope MATLAB Interface User Guide
MATLAB Interface Tool
The CosmosScope Analysis Interface to MATLAB opens a transcript windowthat allows access to MATLAB software applications, as well as enabling datatransfers between SaberDesigner applications and MATLAB applications.
Text, waveforms, plot files, and Vector/Matrix/Arrays can be selected fromother sources and pasted directly into the MATLAB window.
You can also write AIM language scripts to operate MATLAB throughCosmosScope. The Macro Recorder tool can be used to facilitate developingthese scripts. For more information on writing scripts refer to CosmosScopeMATLAB specific AIM commands.
It is expected that users have some experience with MATLAB and the SaberSimulator.
CosmosScope MATLAB Interface User Guide (Sept. 2004) 1-5Copyright © 1985-2004 Synopsys, Inc.
Chapter 1: CosmosScope MATLAB Interface User Guide
Accessing the MATLAB Interface Tool
The MATLAB Interface tool icon is located in the CosmosScope Tool Bar.
To open or close the MATLAB Interface tool
• Single click on the icon with the left mouse button.
MATLAB Interface Window Description
The MATLAB Interface window allows you to interactively enter MATLABcommands in the Command field, and to transfer data between MATLAB andSaber or CosmosScope applications.
The scrollable transcript window displays MATLAB Interface commands andresponses.
Menu Bar
Transcript Window
Command Field
1-6 CosmosScope MATLAB Interface User Guide (Sept. 2004)Copyright © 1985-2004 Synopsys, Inc.
MATLAB Interface Menus
MATLAB Interface Menus
MATLAB Interface Fields and Lists
The command field is where MATLAB Interface commands are entered.
To execute a MATLAB Interface command
• Type the command in the Command field and press the Return key onyour workstation keyboard.
There are several keyboard shortcuts which can be used to facilitate commandentry.
File > Save Saves the contents of the transcript window as anASCII file. The file is saved under the current filename (if any).
File > Save as Saves the contents of the transcript window as anASCII file. The file is saved under a file name ofyour choice.
File > Close Window Closes the current CosmosScope window, withoutclosing the current MATLAB Interface session.
File > Close Session Closes the current MATLAB Interface window, andcloses the current MATLAB Interface session.
Edit > Cut Removes selected text and moves it into aclipboard. Cut acts like a copy command in thetranscript window.
Edit > Copy Copies selected text in the transcript window into aclipboard.
Edit > Paste Pastes whatever is in the clipboard into thetranscript window.
Edit > Clear Clears the contents of the transcript window.
CosmosScope MATLAB Interface User Guide (Sept. 2004) 1-7Copyright © 1985-2004 Synopsys, Inc.
Chapter 1: CosmosScope MATLAB Interface User Guide
MATLAB Interface Keyboard Shortcuts
MATLAB Interface Data Transfer
MATLAB Interface data translation between matrix tools and Saber orCosmosScope applications may be accomplished using the mouse, or by usingthe AIM command language.
Data transfer using the mouse selection method is the simpler of the two, andis the preferred method when using the CosmosScope MATLAB Interfacewindow. The AIM command method is provided to allow for the developmentof scripts which may be used to control both the CosmosScope MATLABInterface tool and Saber applications with a single command stream. Use ofthe command method requires knowledge of the AIM command language.
To transfer data, select one or more objects in a source window and paste theminto a destination window. Pasting can be accomplished using either themiddle mouse button or the clipboard. The type of translation is determinedby the source and destination windows, and by the type of data you are
Keyboard Key Operation
Control + u Pressing the Control and u keys simultaneously, clearsthe command line field.
Control + a Pressing the Control and a keys simultaneously,moves the cursor to the beginning of a command linestring.
Control + e Pressing the Control and e keys simultaneously,moves the cursor to the end of a command line string.
⇐ The Left Arrow key moves the cursor to the left, onecharacter at a time.
⇒ The Right Arrow key moves the cursor to the right, onecharacter at a time.
⇑ The Up Arrow key displays the previous command in asuccession of commands.
⇓ The Down Arrow key displays the next command in asuccession of commands.
1-8 CosmosScope MATLAB Interface User Guide (Sept. 2004)Copyright © 1985-2004 Synopsys, Inc.
MATLAB Interface Data Transfer
transferring. For MATLAB Interface translation purposes, objects in thefollowing windows are understood to have the following types:
Both waveforms and matrices in a session in the tool window will be convertedto MATLAB Interface waveforms when pasted into CosmosScope. The sameselections pasted into the Guide transcript window results in the creation of aplot file, and the plot file name is written into the Guide transcript window. Ifpasted into an AIM Command Line window, MATLAB Interface waveformsare translated into AIM waveforms and matrices are translated into VMAs.
Similarly, a waveform selected in a CosmosScope graph and pasted into theMATLAB Interface tool window results in the creation of a waveform objectcontaining an independent and dependent variable. A waveform selected in anAIM Command Line window and pasted into the MATLAB Interface tool istranslated into a MATLAB Interface waveform; a VMA is translated into aMATLAB Interface matrix.
In the AIM language, vectors are different from matrices. In MATLAB, vectorsare interpreted as matrices. Because of this difference, row and columnvectors are indistinguishable in AIM. As a result, when a vector is transferredfrom the AIM Command Line window to the MATLAB Interface window, it istreated as a row-vector for the purposes of the transfer.
Transferring from Saber Applications to MATLAB
Transferring using mouse buttons:
• Select the item you wish to paste in the source window using the leftmouse button.
• In CosmosScope graph windows, place the mouse cursor over thesignal name and single click the left mouse button.
• From a Guide transcript window, press and hold the left mousebutton and drag the mouse cursor over the ASCII stringrepresenting the name of the plot file you are transferring.
Window Object Type
MATLAB Interface tool MATLAB Interface name
CosmosScope Graph waveform
Guide Transcript Plot File path name
AIM Command Line Vector/Matrix/Array (VMA)
Other windows ASCII string
CosmosScope MATLAB Interface User Guide (Sept. 2004) 1-9Copyright © 1985-2004 Synopsys, Inc.
Chapter 1: CosmosScope MATLAB Interface User Guide
• In the AIM Command Line window select the VMA or wf handle, orthe variable containing the handle.
• In the Signal Manager and the Calculator press and hold the leftmouse button and drag the mouse cursor over the ASCII stringrepresenting the name of the plot file you are transferring.
• Place the mouse cursor in the MATLAB Interface command field, andsingle click the middle mouse button.
Transferring using the clipboard:
• Select the item as in the previous method.
• In the Saber application, select Edit >Cut or Edit >Copy .
• In the MATLAB Interface tool, select Edit >Paste .
There are a number of MATLAB Commands that allow you to manipulateyour data such as the wfdata command.
Transferring from MATLAB to Saber Applications
Transferring using mouse buttons
• Select the item you wish to paste in either the transcript window or thecommand field using the left mouse button.
• Press and hold the left mouse button, and drag the mouse cursor overthe ASCII string representing the name of the item (waveform ormatrix) you are transferring.
• To complete data transfer, place the mouse cursor in the CosmosScopegraph window, the Guide transcript window, or the AIM Command Linewindow, and single click the middle mouse button.
NOTEYou cannot transfer from MATLAB to either theCalculator or the Signal Manager.
Transferring using the clipboard.
• Select the item as in the previous method.
• In the MATLAB Interface tool, select Edit >Cut or Edit >Copy . Note thatCut behaves like Copy in the transcript window.
• In the Saber or CosmosScope application, select Edit >Paste .
1-10 CosmosScope MATLAB Interface User Guide (Sept. 2004)Copyright © 1985-2004 Synopsys, Inc.
CosmosScope AIM Commands
CosmosScope AIM Commands
The AIM Command Line window can be used to directly interface withMATLAB. You can also write AIM scripts to automate procedures.
The Macro Recorder tool can be helpful in writing AIM scripts. Everysignificant operation performed in the Saber or CosmosScope applications issaved in the scope.log file in the AIM scripting language. The MacroRecorder records the AIM language script in this file, and allows you to editthe script.
To execute a script:
• Use the Command field in the AIM Command Line tool to type sourcepathname/ filename
Several AIM commands are available to facilitate MATLAB Interface usageand allow you to control MATLAB Interface sessions, to transfer data between
CosmosScope Window When transferring data to a CosmosScopegraph window, the data is translated into anAIM waveform.
You can transfer matrices or MATLAB Interfacewaveforms. Note that when matrices aretransferred, they first get converted intoMATLAB Interface waveforms.
Once data has been transferred into AIMwaveform format, all Saber tools, including theCalculator, are available for use.
Guide Transcript Window When transferring data to the Guide transcriptwindow the data is translated into pf (plot file)format.
AIM Command LineWindow
When transferring data to the AIM CommandLine window, AIM waveforms are translatedinto MATLAB Interface waveforms, andmatrices are translated into VMA(Vector/Matrix/Array) format.
CosmosScope MATLAB Interface User Guide (Sept. 2004) 1-11Copyright © 1985-2004 Synopsys, Inc.
Chapter 1: CosmosScope MATLAB Interface User Guide
MATLAB and the Saber Simulator, and to perform MATLAB operations froman AIM command line.
AIM Command Description
matlab open session_name Opens a MATLABsession.
matlab close session_name Closes a MATLABsession.
session_name get source_namedestination_name
Transfers data from aMATLAB session.
session_name put source_namedestination_name
Transfers data to aMATLAB session.
session_name queryexists |dtype |size|vtype source_name
Displays information onMATLAB data.
session_name eval { command_string} Performs MATLABoperations.
MtiTrans:mti2var session_nameMATLAB_variable
Converts a MATLABvariable to an AIM VMA.
MtiTrans:mti2wf session_nameMATLAB_variable
Converts MATLABwaveform object to aCosmosScope waveform.
MtiTrans:mti2pf session_nameMATLAB_variable plotfile_name
Converts MATLABwaveform object to aSaber Simulator plot file.
MtiTrans:var2mti session_nameAIM_variable MATLAB _variable
Converts an AIMvariable to a MATLABvariable.
MtiTrans:wf2mti session_name waveformMATLAB_variable
Converts a CosmosScopewaveform to a MATLABwaveform object.
MtiTrans:pf2mti session_name plotfile_nameMATLAB_variable
Converts a SaberSimulator plot file to aMATLAB waveformobject.
1-12 CosmosScope MATLAB Interface User Guide (Sept. 2004)Copyright © 1985-2004 Synopsys, Inc.
MATLAB Interface Waveform Commands
AIM Overview
AIM is a super-set of the Tcl/Tk scripting language developed by John K.Ousterhout. Detailed information on the AIM scripting language is beyondthe scope of this manual. Information about Tcl/Tk is available in the bookPractical Programming in Tcl and Tk, second edition by Brent B. Welch.Refer to the AIM documentation for additional details and information.
MATLAB Interface Waveform Commands
The following table summarizes the MATLAB Interface waveform commands:
waveform
Using CosmosScope, waveforms are represented as structured data types. ForMATLAB, CosmosScope provides a “waveform” class.
The waveform command creates a waveform object using the givenarguments. The dependent variable names and parameter names arespecified as cell character arrays. If the values are specified without names,the waveform object is created with default names. These names may
Command Description
waveform Creates a waveform object using the given arguments,or displays information on a waveform object.
wfdata Sets or gets the data for a waveform object.
wfdatatype Returns the datatype of the dependent variable valuein a waveform object.
wfnames Sets or gets the names for an existing waveformobject.
wfnpars Returns the number of parameters defined for thewaveform object.
wfnsegs Returns the number of data segments in a waveformobject.
wfparsizes Gets or sets parameter sizes for a waveform object.
wfparvalues Returns the parameter values for a given parameterin the waveform object.
CosmosScope MATLAB Interface User Guide (Sept. 2004) 1-13Copyright © 1985-2004 Synopsys, Inc.
Chapter 1: CosmosScope MATLAB Interface User Guide
subsequently be changed with the wfnames command. The independent,dependent, and variable values are all numeric arrays.
The waveform command has the following formats:
With no arguments, the waveform command creates an empty waveformobject:
If a waveform object is specified as input, the waveform command returns acopy of that object:
waveform_name=waveform()
waveform_name=waveform( waveform_name)
waveform_name=waveform( independent _variable_name,dependent_variable_names)
waveform_name=waveform( independent _variable_name,dependent_variable_names, parameter_names)
waveform_name=waveform( dependent _variable_name)
waveform_name=waveform( independent _variable_name,dependent_variable_names, independent_variable_values,dependent_variable_values)
waveform_name=waveform( independent_variable_values,dependent_variable_values)
waveform_name The name of a MATLAB Interfacewaveform object.
independent _variable_name The name of the independent variablecomponent of a MATLAB Interfacewaveform object.
dependent_variable_names The names of the dependent variablecomponents of a MATLAB Interfacewaveform object.
parameter_names The names of the parameters of a MATLABInterface waveform object.
1-14 CosmosScope MATLAB Interface User Guide (Sept. 2004)Copyright © 1985-2004 Synopsys, Inc.
MATLAB Interface Waveform Commands
wfdata
Sets or gets the data for an existing waveform object. The data includesindependent variable values, dependent variable values, and, optionally,parameter values which correspond to a given segment.
In the first two forms (set forms), the data values are appended to the existingwaveform data as a new data segment. In the other forms (get forms), Thesegment selector may be a scalar value or a vector of valid segment values.Use of the keyword all returns data for all segments. If data for more thanone segment is returned, the size of the data will be that of the largestsegment selected. If no segment selector is specified, the first segment (1) isreturned.
independent_variable_values
The values of the independent variablecomponent of a MATLAB Interfacewaveform object.
dependent_variable_values The values of the dependent variablecomponents of a MATLAB Interfacewaveform object.
waveform_name=wfdata ( waveform_name,independent_variable_values, dependent_variable_values)
waveform_name=wfdata ( waveform_name,independent_variable_values,dependent_variable_values,parameter_values)
[ independent_variable_values,dependent_variable_values,parameter_values] =wfdata( waveform_name)
[ independent_variable_values,dependent_variable_values,parameter_values] =wfdata( waveform_name,selector)
[ independent_variable_values,dependent_variable_values,parameter_values] =wfdata( waveform_name,all)
CosmosScope MATLAB Interface User Guide (Sept. 2004) 1-15Copyright © 1985-2004 Synopsys, Inc.
Chapter 1: CosmosScope MATLAB Interface User Guide
wfdatatype
Returns the datatype of the dependent variable value in a waveform object.
wfnames
Sets or gets the names for an existing waveform object. The names include anindependent variable name, one or more dependent variable names, and,
waveform_name The name of a MATLAB Interface waveformobject.
independent_variable_values
The values of the independent variablecomponent of a MATLAB Interface waveformobject.
dependent_variable_values
The values of the dependent variablecomponents of a MATLAB Interface waveformobject.
parameter_values The values of the parameters of a MATLABInterface waveform object.
selector The default value is 1. The value may be:• a scalar—the segment index of the segment to
be retreived.• a vector—the range of segment indices to be
retreived, e.g., [1 2 3] selects segment 1-3.• the string all —selects all segment values
data_type=wfdatatype( waveform_name)
data_type The name of the MATLAB Interface waveformobject data type.
waveform_name The name of a MATLAB Interface waveformobject.
1-16 CosmosScope MATLAB Interface User Guide (Sept. 2004)Copyright © 1985-2004 Synopsys, Inc.
MATLAB Interface Waveform Commands
optionally, one or more parameter names. The dependent variable names andparameter names are specified as cell character arrays.
wfnpars
Returns the number of parameters defined for the waveform object and takesthe following form:
waveform_name=wfnames( waveform_name,independent_variable_name, dependent_variable_names)
waveform_name=wfnames( waveform_name,independent_variable_name,dependent_variable_names,parameter_names)
[ independent_variable_name, dependent_variable_names,parameter_names] = wfnames( waveform_name)
waveform_name The name of a MATLAB Interface waveformobject.
independent_variable_name
The name of the independent variablecomponent of a MATLAB Interface waveformobject.
dependent_variable_names
The names of the dependent variablecomponents of a MATLAB Interface waveformobject.
parameter_names The names of the parameters of a MATLABInterface waveform object.
number_of_parameters=wfnpar( waveform_name)
waveform_name The name of a MATLAB Interface waveformobject.
number_of_parameters The number of parameters present in thewaveform object.
CosmosScope MATLAB Interface User Guide (Sept. 2004) 1-17Copyright © 1985-2004 Synopsys, Inc.
Chapter 1: CosmosScope MATLAB Interface User Guide
wfnsegs
Returns the number of data segments in the given waveform object and takesthe following form:
wfparsizes
Returns a waveform with its parameter sizes set to the values contained inparameter_size_vector. If parameter_size_vector is specified, it must be a vectorof length number _of_parameters, which is the number of parameter valuesdefined in the waveform object.
Returns the parameter sizes for the waveform object.
number_of_segments=wfnsegs( waveform_name)
waveform_name The name of a MATLAB Interface waveformobject.
number_of_segments number_of_segments
parameter_sizes=wfparsizes( waveform_name)
waveform_name=wfparsizes( waveform_name,parameter_size_vector)
parameter_sizes The name of the parameter sizes in a MATLABInterface waveform object.
waveform_name The name of a MATLAB Interface waveformobject.
parameter_size_vector The number of parameter values in a MATLABInterface waveform object.
1-18 CosmosScope MATLAB Interface User Guide (Sept. 2004)Copyright © 1985-2004 Synopsys, Inc.
MATLAB Interface Waveform Commands
wfparvalues
Returns the parameter values for the index_number parameter in thewaveform object. The first index_number is one.
parameter_values=wfparvalues( waveform_name,index_number)
parameter_values The values of the parameters of a MATLABInterface waveform object.
waveform_name The name of a MATLAB Interface waveformobject.
index_number The index, starting at one, of the parameterwhose values you wish to display.
CosmosScope MATLAB Interface User Guide (Sept. 2004) 1-19Copyright © 1985-2004 Synopsys, Inc.
Chapter 1: CosmosScope MATLAB Interface User Guide
MATLAB Interface Command Limitations
The MATLAB Interface window interface is implemented through the use ofcalls to the MATLAB engine library. The mechanism for MATLAB Interfacecommand execution involves the following steps:
• Fielding a command from user input in the Command field andtransferring that command to MATLAB for execution
• Collecting the resulting output to the MATLAB Interface window inpaged form based on additional user input in the Command field
Limitations in the MATLAB engine library affect the ability to processcommand input, and can affect the way in which some output is displayed.
For example, in the MATLAB “native” command entry window, a long list isdisplayed, a screen at a time. If you wish to view more information, enteringthe more command displays the next screen. In the MATLAB Interfacewindow, a long list will be displayed in its entirety, whether or not theinformation fits in one screen. Use the scroll bars to view the information onescreen at a time.
The other commands that do not behave as expected are described in thefollowing table. This limitation does not apply to multi-line commands. Thesecommands will behave as expected.
MATLABInterfaceCommand
Expected Behavior Actual Behavior
input Displays the provided textstring, waits for input from thekeyboard, and returns the valueentered.
The command does not wait forthe keyboard entry. Itcontinues execution as if anempty string was entered atthe keyboard.
more Controls the paged output forthe MATLAB Interfacecommand window. Pressing theReturn key advances to the nextline or pressing the Space baradvances to the next screen
The command does not wait forinput from the keyboard anddisplays the entire contents atonce.
pause Causes M-files to stop and waitfor the user to press any keybefore continuing.
The pause( n) behaves asexpected. Otherwise thecommand does not pause.
1-20 CosmosScope MATLAB Interface User Guide (Sept. 2004)Copyright © 1985-2004 Synopsys, Inc.
Index
A
Accessing the MATLAB InterfaceTool 6
M
MATLAB Command Limitations 20MATLAB Interface Data Transfer 8MATLAB Interface Fields and Lists 7MATLAB Interface Menus 7MATLAB Interface Tool 5MATLAB Interface Window
Description 6
CosmosScope MATLAB Interface User Guide (Sept. 2004) Index-1Copyright © 1985-2004 Synopsys, Inc.
Index
Index-2 CosmosScope MATLAB Interface User Guide (Sept. 2004)Copyright © 1985-2004 Synopsys, Inc.
BOOKSHELF
CosmosScope™ Calculator Reference Manual
CosmosScope™ MATLAB® Interface User Guide
CosmosScope™ Reference Manual
Saber® and CosmosScope™ AIM User Manual
Saber® and CosmosScope™ Command Line ToolUser Guide
Saber® and CosmosScope™ Draw Tool User Guide
Saber® and CosmosScope™ Macro Recorder UserGuide
Saber® and CosmosScope™ Report Tool Refer-ence Manual
Saber® and CosmosScope™ StateAMS ReferenceManual
Saber® AIM Reference Manual
Saber® Design Browser Tool Reference Manual
Saber® Examples User Guide
Saber® Frameway for Cadence Design FrameworkII User Guide
Saber® Frameway for Mentor Graphics ePD UserGuide
Saber® Frameway for Mentor Graphics FalconFramework User Guide
Synopsys Online Documentation V-2004.09
Saber® Frameway Integrations Quick Start
Saber® Harness Quick Start
Saber® Harness User Guide
Saber® Library and Model User Guide
Saber® Managing Symbols and Models User Guide
Saber® MAST Language Reference Manual
Saber® MAST Language User Guide, Book 1
Saber® MAST Language User Guide, Book 2
Saber® Model Architect Tool User Guide
Saber® Netlist Options Reference Manual
Saber® Parts Gallery Reference Manual
Saber® Property Editor Reference Manual
Saber® Quick Start
Saber® Simulator Co-Simulation With ModelSimQuick Start
Saber® Simulator Co-Simulation With ModelSimUser Guide
Saber® Simulator Co-Simulation With Verilog UserGuide
Saber® Simulator Command Reference Manual
Saber® Simulator Guide Reference Manual
Saber® Simulator Real Time (RT) Interface UserGuide
Synopsys Online Documentation V-2004.09
Saber® Simulator Testify Quick Start
Saber® Simulator Testify User Guide
Saber® Simulink Co-simulation Interface User Man-ual
Saber® Sketch iQBus User Guide
Saber® Sketch User Guide
Saber® User Guide
Synopsys Online Documentation V-2004.09