+ All Categories
Home > Documents > CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy...

CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy...

Date post: 05-Nov-2020
Category:
Upload: others
View: 3 times
Download: 0 times
Share this document with a friend
26
Comments? E-mail your comments about Synopsys documentation to [email protected] CosmosScope™ MATLAB® Interface User Guide Version V-2004.09, September 2004
Transcript
Page 1: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

Comments?E-mail your comments about Synopsysdocumentation to [email protected]

CosmosScope™MATLAB® InterfaceUser GuideVersion V-2004.09, September 2004

Page 2: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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

Page 3: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

ii

Page 4: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 5: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

Table Of Contents

iv CosmosScope MATLAB Interface User Guide (Sept. 2004)Copyright © 1985-2004 Synopsys, Inc.

Page 6: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 7: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 8: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 9: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 10: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 11: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 12: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 13: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 14: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 15: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 16: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 17: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 18: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 19: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 20: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 21: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 22: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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.

Page 23: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

Index

Index-2 CosmosScope MATLAB Interface User Guide (Sept. 2004)Copyright © 1985-2004 Synopsys, Inc.

Page 24: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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

Page 25: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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

Page 26: CosmosScope™ MATLAB® Interface User Guideu.dianyuan.com/bbs/u/24/1103983004.pdf · Each copy shall include all copyrights, trademarks, service marks, and proprietary rights notices,

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


Recommended