MATLAB®7Desktop Tools and Development Environment
Help for Using MATLAB4Help Browser Overview...4-3About the Help Browser...4-3Opening the HelpBrowser
2 DesktopLayout Options for Page SetupYo u can specify the following layout o ptions. A preview area shows you theeffects of your selections:• Print h
Other Desktop Features3 Repeat for the other element. If y ou did not select Print header onthe Layout pane, you do not need to specify theHeader font
2 DesktopThe toolbar buttons and menu items in the Web Browser are similar to thosefound in the H elp browser display pane. For more information, see
Other Desktop FeaturesFor m ost items, the selected Web page then opens in your default systemWeb browser, for example, Netscape:• The MathWorks Web S
2 Desktopusers. MATLAB Digest, an electronic bulletin consisting of technical n otes,solutions, and timely announcements to the user community, is iss
PreferencesPreferencesIn this section...“Setting Preferences” on page 2-59“Summary of Preferences” on page 2-60“Preferences File — matlab.prf” on page
2 DesktopSummary of PreferencesPreference What You Can SpecifyGeneral Preferences Toolbox path caching, figure window printing, delete functionbehavio
PreferencesPreferences File — matlab.prfPreferences are stored in a p references file, matlab.prf.Typeprefdir in theCommand Window to see the full pat
2 DesktopFonts Preferences for Desktop ToolsIn this section...“Setting Desktop Fonts” on page 2-62“Desktop Code Font and Desktop Text Font” on page 2-
Fonts Preferences for Deskto p ToolsDesktop Code Font and Desktop Text F ontYo u s pecify separate font characteristics for tools that primarily displ
Help Fonts and Colors Preferences ... 4-39Printed Documentation... 4-42About Printed M anuals...
2 Desktopbrowser. M any users prefer that code display in a monospace font to providebetter alignme nt, and prefer a more narrow font style for t ext
Fonts Preferences for Deskto p ToolsDefaultFontSettingsDefault settings are listed in the following table. Note that Lucida Consoleapproximates thefix
2 DesktopFont TypeDefault Characteristics andSample Tools Using Font Type by DefaultDesktop code font Monospaced, Plain, 10 point • Command History• C
Fonts Preferences for Deskto p ToolsCustom Fonts PreferencesIf you do not want to use the current settings for “Desktop Code Font andDesktop Text Font
2 DesktopTo change the font characteristics the selected tool uses, select a different radiobutton. For Custom, you then specify the font characterist
Fonts Preferences for Deskto p ToolsTool Font Type Font CharacteristicsWorkspace Desktop text SansSerif, Plain, 10 pointArray Editor Desktop text Sans
2 DesktopColors Preferences for Desktop ToolsIn this section...“Setting Colors Used in Deskto p Too ls” on page 2-70“Desktop To ol Colors” on page 2-7
Colors Preferences for Desktop ToolsTo set colors for text and the background,clear the Use system colors check boxand then select colors from the pal
2 DesktopDesktop Tool ColorsUse Desktop toolcolors to change the color of the tex t and background inthe desktop tools. ThecolorsalsoapplytotheImportW
Colors Preferences for Desktop ToolsGray Background ColorFor some UNIX platforms, there is a g ray background color for desktop tools,such as the Edit
Creating Plots from the Workspace Browser ... 5-9Opening Variables and Objects for Viewing and Editing.. 5-9Preferences for the Workspace Bro
2 DesktopThe defau lt colors are listed here:• Keywords — Flow c ontrol functions, such asfor and if,aswellasthecontinuation ellipsis (...), are color
Colors Preferences for Desktop ToolsOther ColorsSpecify the colorforHyperlinks, which applies to links in the CommandWindowandHelpbrowser Index pane.
2 DesktopGeneral Preferences for MATLABIn this section...“Setting General Preferences for MATLAB” on page 2-76“Default Behavior of the Delete F unctio
General P references for MATLABThesepreferences apply to all relevant tools in MATLAB.• Toolbox path caching p reference — see “Toolbox Path Caching i
2 Desktop• “MAT-Files Preferences” on page 2-79• “C onfirmation Dialogs Preferences” on page 2-81• C h apter 9, “Source Control Interface”• “Multithre
General P references for MATLABMAT-Files PreferencesThe MAT-file save format sets the default version compatibility optionMATLAB uses when saving MAT-
2 Desktopallow it, w hich is the primary purpose of this option. U sing th is option isequivalent to runningsave -v7.3. This format of the resulting M
General P references for MATLABmight b e more convenient than changing the preference. For example, usesave with the-v6 optio n to en su re com p atib
2 DesktopWhen the con firmation dialog box does appear, it includes a Do not showthis prompt again check box. If y ou se lect the check bo x in the di
General P references for MATLABConfirmation DialogsCheck Box ItemAbout the ConfirmationDialog Box For More InformationPrompt when editing filesthat do
Accessing Source C ontrol Features ... 5-54Preferences for the Current Directory Browser... 5-54Editing and Debugging M-Files6Be
2 DesktopMultithreading PreferencesIf you run MATLAB on a multiple-CPU system (multiproce ssor o r m ultico re),you can use multithreaded computation,
AccessibilityAccessibilityIn this section...“Software Accessibility Support” on p age 2-85“Documentation Accessibility Support” on page 2-86“Assistive
2 DesktopExcept for scopes and real-time data acquisition, the M athWorks s oftwaredoes not use flashing or blinking text, objects, or other elements
AccessibilityThe following product documentation has been modified (as described b elow )to enhance its accessibility f or people using a screen reade
2 Desktop• JAWS 5.0, 6.0, and 7.0 for Windows (screen reader) from Freedom Scientific• Built-in accessibility aids from Microsoft, including the Magni
AccessibilitySetting Up JAWSMake sure that JAWS is installed on your machine. If it is, there is probably ashortcut to it on the Windows desktop.Setti
2 DesktopBe sure to include that semicolon betw een the end of this directory nameand the text that was already there.7 Click OK three t imes.8 If JAW
Accessibility1 Start JAWS.2 Start M ATLAB.JAWS should start talking to you as you select menu items and work with theMATLAB user interface in other wa
2 Desktoppress the arrow keys to move to the command output and use JAWSkeystrokes to read the output.With this preference set, you cannot use arrow k
3Running Functions —Command Window andHistoryIf you have an active Internet connection, you can watch the Working in theDevelopment E nvironment video
Code Folding—Expanding and Collapsing M-FileConstructs... 6-31Split Screen Display... 6-
3 Running Functions — Command Window and HistoryPreferences for the Co mmandWindow (p. 3-40)Specify options for text, display, tabsize, accessibility,
The Command WindowThe Command WindowIn this section...“About the Command Window” on page 3-3“Opening the Command Window” on page 3-3“Command Window Pr
3 Running Functions — Command Window and HistoryCommand Window PromptThe Command Window prompt,>>, is where you enter statements. Forexample, yo
The Command WindowGetting StartedMessage Bar in the CommandWindowJust below the Command Window menu bar is a message bar that includeslinks to a video
3 Running Functions — Command Window and HistoryHelp for Functions” on page 4-49—for more general information on help, seeChapter 4, “Help for Using M
Running Functions and Programs, and Entering VariablesRunning Functions and Programs, and Entering VariablesIn this section...“Running Statements at t
3 Running Functions — Command Window and HistoryDefinition of a Statement. All of the in f ormation yo u type before pressingEnter or Return is known
Running Functions and Programs, and Entering Variablesthe MATLAB current directory or on the MATLAB search path — for details,see “Search Path” on pag
3 Running Functions — Command Window and History!vi yearlystats.minvokes the vi editor for a file na med yearlystats.m. After the externalprogram comp
Running Functions and Programs, and Entering VariablesUNIX System Path and Running UNIX Programs from MATLABTo run a UNIX program from MATLAB if its d
Using Configurations — Running M-Files with InputArguments in the Editor/Debugger... 6-67Create and Run a Configuration for an M-file...
3 Running Functions — Command Window and History3 Save the file.Thematlab file will modify the PATH environment variable, and then startMATLAB.Evaluat
Running Functions and Programs, and Entering VariablesDisplaying Hyperlinks in the Command WindowYou can use MATLABcommandstocreatehyperlinksintheComm
3 Running Functions — Command Window and HistoryRunning MATLAB Functions by HyperlinkUse matlab: to run a specified statement w hen you click a hyperl
Controlling InputControlling InputIn this section...“Case and Space Sensitivity” on page 3-15“Syntax Highlightin g” on page 3-16“Matching Delimiters (
3 Running Functions — Command Window and HistoryNote that if you use the help function, function names are shown in alluppercase, for example,PLOT, so
Controlling InputMatching Delimiters (Parentheses)Yo u can set a preference for MATLAB to notify you about matched a ndunmatched delimiters. For examp
3 Running Functions — Command Window and HistoryEnter Multiple Lines Without Running ThemTo enter multiple lines before running any of them, use Shift
Controlling Inputheaders =Author Last Name, Author First Name, Author Middle InitialMATLAB produces an error when you do not complete the string, a s
3 Running Functions — Command Window and Historyagaintodisplaythenextmostrecentlinethatbeganwithplo,andsoon.Then press Enter or Return to run the line
Controlling Input• “Tab Completion for Properties” on page 3-25Basic Example — Unique CompletionThis example illustrates a basic use for tab completio
Tuning and Managing M-Files7Directory Reports in Current Directory Browser...7-2Accessing and Using D ire ctory Reports...7-2TODO/FIXME
3 Running Functions — Command Window and HistoryThe resulting list of possible completions includes the variable name youcreated,costs_march, but also
Controlling InputNarrowing Completions Shown . You can narrow the list of completionsshownbytypingacharacterandthenpressingTab if the Command Windowpr
3 Running Functions — Command Window and HistoryContinue narrowing the list in the same way. For the above example, type oand press Tab to further nar
Controlling InputFo r example, t ypemystruct.nand press Tab, which completes the entry mystruct.name,wheremystructcontains no other fields that begin
3 Running Functions — Command Window and Historyset(f, 'paperUnits', 'centimeters'because centimeters istheonlypossiblecompletion.
Controlling InputKey orMouseAction forWindowsPreferenceControlKey forMATLABstandard(Emacs)PreferenceKey or MouseAction forMacintoshPreference Operatio
3 Running Functions — Command Window and HistoryKey orMouseAction forWindowsPreferenceControlKey forMATLABstandard(Emacs)PreferenceKey or MouseAction
Controlling InputKey orMouseAction forWindowsPreferenceControlKey forMATLABstandard(Emacs)PreferenceKey or MouseAction forMacintoshPreference Operatio
3 Running Functions — Command Window and HistoryControlling OutputIn this section...“Echoing Execution” on page 3-30“Suppressing Output” on page 3-30“
Controlling Output--more--indicating there is more output to display. Press one of the following keys.KeyActionEnter or ReturnTo advance to the next l
Text Markup for Indented Text, Lists, and Graphics ... 8-14Text Markup for HTML, LaTeX, and TeX Equation OutputTypes...
3 Running Functions — Command Window and History1.3333e+000 1.2345e-006format +++A complete list and description of available formats is in the refere
Controlling OutputPrinting Command Window ContentsTo print the complete contents of the Command Window, select File > Print.To print only a selecti
3 Running Functions — Command Window and HistorySearching in the Command WindowIn this section...“Introduction” on page 3-34“Find Dialog Box” on page
Searching in the Command WindowMATLAB beeps when a search for Find Next reaches the end of theCommand Window, or when a search for Find Previous reach
3 Running Functions — Command Window and History4 In the Inc Search field, type the text yo u want to find. For example, lookforBoston.As you type the
Searching in the Command WindowWhen you type the next letter, the first occurrence of the text becomeshighlighted. In the exam ple, w hen y ou add the
3 Running Functions — Command Window and History• When the text is not found, Failing appears in the incremental searchfield. Modify the search term i
Searching in the Command WindowIn the example, enter bO in the Inc Search field and incremental search doesnot fin d any matchin g text.3-39
3 Running Functions — Command Window and HistoryPreferences for the Command WindowIn this section...“Text, Display, Accessibility, and Ta b S ize P re
Preferences for the C ommand WindowText DisplaySpecify the format, that is, how output appears in the Command Window.Numeric format. Specify the outpu
Modifying Styles in the M-Book Template ... 8-47Choosing Loose or Compact Format fo r Noteboo k... 8-48Controlling Numeric Output Format
3 Running Functions — Command Window and HistoryNumeric display. Specify spacing of output in the Command Window. Tosuppress b lank lines, usecompact.
Preferences for the C ommand WindowThis preference setting does not impact the number of lines you can recallwhen you use the up arrow key in the Comm
3 Running Functions — Command Window and History• “Command Window Key Bindings” on page 3-44• “E ditor/Debugger Key Bindings” on page 3-45• “Tab Compl
Preferences for the C ommand WindowMATL AB standa rd (Emacs). Allows you to use the control keys listed in“Keyboard Shortcuts in the Command Wind ow”
3 Running Functions — Command Window and HistoryEnable in Editor/Debugger. Selectthecheckboxtousetabcompletionwhen typing functions in the Editor/D eb
Preferences for the C ommand WindowIf the matching delimiter is not visible on the screen, a pop-up w indow appearsand shows the line containing the m
3 Running Functions — Command Window and HistoryMatch on arrow key. Select the check box if you want to be alerted tomatches and mismatches in pairs o
Command History WindowCommand History WindowIn this section...“Overview” on page 3-49“Viewing Statements in the Command History Window” on page 3-50“U
3 Running Functions — Command Window and HistoryMATLAB provides other options for viewing a history of statements. Seealso the following sections:• “R
Command History WindowUsing Statements from the Comm and HistoryWindowYo u can select entries in the Command History window and then perform thefollow
Undoing the Checkout ... 9-13Additional Source Control A ctions on Windows... 9-14Getting the Late st Version of Files fo
3 Running Functions — Command Window and HistorySearching in theCommand History WindowThere are two types of search in the Command History window:• “F
Command History Window2 Type the first letters of the entry you want to find. For example, type my.The Co mmand History window searches backwards and
3 Running Functions — Command Window and HistoryFinding M ultiple Occurrences of the Entry. You can use the up and downarrow keys to search for the ne
Command History WindowTo highlight all instances of the entry, press Ctrl+A. In the example below, allinstances of entries beginning withmy are highli
3 Running Functions — Command Window and HistoryFinding TextSelect Find from the Edit menu to search for specified text using the Finddialog box. Comp
Command History WindowMATLAB beeps when a search for Find Next reaches the end of theCommand History window, or when a search for Find Previous reache
3 Running Functions — Command Window and HistoryTo delete entries in the Command H istory window, first select the entries todelete, using one of thes
Preferences for Comm and HistoryPreferences for Command Histor yIn this section...“Introduction” on page 3-59“Settings” on page 3-59“Saving” on page 3
3 Running Functions — Command Window and Historyone entry for magic(5). If you then run magic(10), the command history filesaves both entries,magic(5)
4Help for Using MATLABThe primary means for getting help is the Help browser, w hich providesdocumentation for all your installed products. O ther for
How to Contact The MathWorkswww.mathworks.comWebcomp.soft-sys.matlab Newsgroupwww.mathworks.com/contact_TS.html Technical [email protected]
Checking Files Out of the Source Control System onUNIX... 9-33Checking Out One or More Files U sing the Curren
4 Help for Using MAT LABHelp Functions (p. 4-44)Use functions to get information,such as help and doc.Getting Pop-Up Help for Functions(p. 4-49)Getpop
Help Browser OverviewHelp Browser OverviewIn this section...“About the Help Browser” on page 4-3“Opening the Help Browser” on page 4-3“Resizing the He
4 Help for Using MAT LABTabs in the Help Navigator pane providedifferent ways to find information.Use the close boxto hide the pane.View documentation
Help Browser OverviewResizing the HelpBrowserTo adjust the relative width of the t wo panes, drag the separator bar b etw eenthem. You can also change
4 Help for Using MAT LAB4-6
Help Browser OverviewTypes of DocumentationThe H elp browser and help f unctions provideaccesstothefollowingtypesof information for all ins talled Mat
4 Help for Using MAT LABIconType ofDocumentation Description and When to UsePrintableDocumentationMost products provide access to the onlinedocumentat
Help Browser Overview• A ccess documentation via your system Web brows er, such as when you arenot running MATLAB or if you prefer your system Web bro
4 Help for Using MAT LABFinding Info rma tion with the Help BrowserIn this section...“Help Navigator” on page 4-10“Contents in the Help Brow ser” on p
Finding Information with the Help BrowserProduct RoadmapWhen you select a product in the Contents pane (any entry with a bookicon), such as MATLAB or
1Startup and ShutdownThis set of topics includes options for customizing the startup and shutdown.Starting MATLAB on WindowsPlatforms (p. 1-2)Ways to
4 Help for Using MAT LAB• Function and block references pages• An inde x of major ex amples in the documentation• The PDF version of the docume nta t
Finding Information with the Help Browseronly applies to the major headings in a document. For pages that begin withlower level headings, the Contents
4 Help for Using MAT LAB1 Click the Ind ex tab.2 Type aword or words in the Enter index term field. As you type, theIndex pane displays matching entri
Finding Information with the Help Browsersensitive. If there is not a matching entry, it displays the page for the letterthat your entry begins with.T
4 Help for Using MAT LAB• For d ifferent but related results, try using the Search for field—fo rinstructions, see “Search Documentation and Demos wit
Finding Information with the Help Browser1 To limit (or extend) the products whose documentation and d emos aresearched, set the product filter.4-17
4 Help for Using MAT LAB2 In the Search for field, type the word or words you want to find and clickGo (or p ress Enter or Return). Some techniques fo
Finding Information with the Help Browserthat contain all sea r ch words, w ith pages containin g a single instance ofeach search word appearing last.
4 Help for Using MAT LABFunction Alternative. From the C ommand Window, use docsearch to openthe Help browser to the Search pane and search for the sp
Finding Information with the Help BrowserFor details, see the docsearch reference page.Wildcards in Search (Partial Word)Yo u can use the wildcard cha
1 Startup and ShutdownStar ting MATLAB on Windows PlatformsIn this section...“Starting MATLAB from the Windows Desktop or a DOS Window” onpage 1-2“Sta
4 Help for Using MAT LABExample Using Boolean Operators in Search. Typeplot* tools NOT time seriesto find all pages that contain the words plot or its
Finding Information with the Help BrowserProblem Tr y These SuggestionsPages are not about searchword, but just mention itTry the Index pane to see mo
4 Help for Using MAT LABProblem Tr y These SuggestionsNo results but you knowthe word should be thereTry variations of the search word by using a wild
Finding Information with the Help BrowserA favorite is implemented as a M ATLAB shortcut, so the dialog box isthe same as for the Shortcut Editor.Favo
4 Help for Using MAT LABViewing Documentation in the Help BrowserIn this section...“About the Display Pane” on page 4-26“BrowsetoOtherPages”onpage4-27
Viewing Documentation in the Help BrowserBrowse to Other PagesUsethearrowbuttonsinthepageandinthetoolbartogotootherpages.4-27
4 Help for Using MAT LABView the next page in a document by clicking the Next page button at thetop or bottom of the page. View the previous page in a
Viewing Documentation in the Help BrowserYo u can change the selection in the Look in field to search for the specifiedtext in other MATLAB desktop to
4 Help for Using MAT LABthem into other tools like the E ditor/D ebugger or Command Window, or intoother applications.View the Page LocationTo vi ew t
Demos in the Help BrowserDemos in the Help BrowserIn this section...“About Demos” on page 4-31“Using Demos” on page 4-32“Adding Your Own Demos” on pag
Starting MATLAB on Windows Platformsassociate with MATLAB. For example, if you accepted the default options,double-clicking an M-file in Windows Explo
4 Help for Using MAT LABUsing DemosTo access demos for the products you have installed,1 Click the Demos tab in the Help Navigator.You can also access
Demos in the Help Browser4 You can then view and run the demo, w ith specific o ptions depending onthe type of demo:4-33
4 Help for Using MAT LAB• For M-file demos, click the Open filename in the Editor link atthe top left. This opens the M-file in the Editor/Debugger. F
Demos in the Help BrowserSearching for DemosYo u can use the Help browser search feature to find demos. Search find wordsin comments or code for M-fil
4 Help for Using MAT LABFunction AlternativeTo open the Demos pane in the Help browser, type demo in the CommandWindow. You can go directly to the dem
Preferences for the Help BrowserPreferences for the Help BrowserIn this section...“Product Filter” on page 4-37“PDF Reader — Specifying Its Location”
4 Help for Using MAT LABExample Using the Product FilterIf you want to perform a search and have many products installed but knowthe information you a
Preferences for the Help BrowserHelp Fonts and Colors PreferencesSet fonts and colors f or the Help browserthesamewayyouwouldforotherdesktop tools. Th
4 Help for Using MAT LAB4-40
Preferences for the Help BrowserUse the same method as you would to specify fonts for any des ktop tool — formore information, see “Fonts Preferences
1 Startup and ShutdownAfter associating a file type with MATLAB, you can open other applicationsusing that file type via the context menu. For example
4 Help for Using MAT LABPrinted DocumentationIn this section...“About Printed Manuals” on page 4-42“Printing a Page from the Help Browser” on page 4-4
Printed DocumentationNote The Help b row ser accesses PDF documentation from the M athWorksWeb site. Therefore, you need Internet access to view or pr
4 Help for Using MAT LABHelp FunctionsIn this section...“About Help Functions” on page 4-44“Summary Table of Help Functions” on page 4-44“View Functio
Help FunctionsFunction DescriptionhelpbrowserOpens the Help browser, the MATLAB interface for accessingdocumentation.helpdeskOpens the Help browser. I
4 Help for Using MAT LABdatabase/setwhich is the set functionforDatabaseToolbox. Clickalinktogotothatset reference page.To directly get the reference
Help FunctionsNote M-file help displayed in the Command Window uses all uppercasecharacters for the function and variable n ames to distinguish them f
4 Help for Using MAT LABhelp database/setCreating M-File Help for Your Own M-FilesYo u can create M-file help for your own M-files and access it using
Getting Pop-Up Help for FunctionsGetting Pop-Up Help for FunctionsMATLAB provides pop-up help for MATLAB functions from both theEditor/Debugger and th
4 Help for Using MAT LAB4-50
Other Forms of HelpOther Forms of HelpIn this section...“Documentation for Other Products” on page 4-51“Product-Specific Help Features” on page 4 -51“
Starting MATLAB on Windows Platformsusing the MATLAB tool associated with that file type. For example, even ifyou associate.mat files with Microsoft A
4 Help for Using MAT LABwho downloads them . To view the files available to download, go tothe MATLAB Central File Exchange page on the MathWorks Web
Other Forms of HelpFirst-time users to the newsgroup shouldreadthenewsgroupFAQ,linkedto from the MATLAB Central page. It is a good practice to try to
4 Help for Using MAT LABProvide FeedbackTo report problems or provide comments or suggestions to The M athWorksabout the documentation, help features,
5Workspace, Search Path,and File OperationsIf you have a n active Internet connection, you can watch the WorkspaceBrowser video demo, the Array Editor
5 Workspace, Search Path, and File OperationsMATLAB WorkspaceIn this section...“About the MATLAB Workspace” on page 5-2“Opening the Workspace Browser”
MATLAB WorkspaceOpening the Workspace BrowserTo open the Workspace browser, select Workspace from the Desktop menuin the MATLAB desktop, or typeworksp
5 Workspace, Search Path, and File Operations• You can select the column on which to sort as well as reverse the sort orderof any column. Click a colu
MATLAB WorkspaceYour variables are:ACMRSc>> whosName Size Bytes Class AttributesA 4x4 128 doubleC 1x3 348 cellM 4x4x24 3072 doubleR 3x4x5 480 do
5 Workspace, Search Path, and File OperationsTheworkspacevariablesaresavedundertheMAT-filenameyouspecified.Yo u can also save the workspace variables
MATLAB Workspaceinformation — see “Data Import and Export” in the MATLAB Programmingdocumentation.Loading a Saved Wo rkspace and Impo rting DataTo loa
1 Startup and ShutdownAssume that when you double-click a .mat file in Windows Explorer, it opensin Microsoft Access, but you want the file to open in
5 Workspace, Search Path, and File OperationsFunction Alternative. Use whos with the -file option.Changing and Copying Variable NamesTo rename a varia
MATLAB WorkspaceViewing Base andFunction Workspaces Using theStackWhen you run M-files, MATLAB a ssigns each function its own w orkspace,called the fu
5 Workspace, Search Path, and File OperationsSome toolboxes allow you to double-click an object in the Workspace brow se rto open a viewer or other to
MATLAB WorkspaceSpecify Maximum Array Size on Which to Compute StatisticsIf you show statistical columns in the Wo rkspace browser, and if you workwit
5 Workspace, Search Path, and File OperationsViewing and Editing Workspace Variables with the ArrayEditorIn this section...“About the Array Editor” on
Viewing and Editing Workspace Variables with the Array Editor1 In the Workspace browser, select the variable you want to open. Shift+clickor Ctrl+clic
5 Workspace, Search Path, and File OperationsNote The maximum array size that you can open in the Array Editor is notlimited by MATLAB, but is based o
Viewing and Editing Workspace Variables with the Array EditorSimilarly, double-click a cell in a cell array to view and edit its contents. Thefollowin
5 Workspace, Search Path, and File OperationsNavigating and Editing Shortcut Keys fo r the ArrayEditorUse the following shortcut keys (sometime s call
Viewing and Editing Workspace Variables with the Array EditorKey ResultTab Move rightWithin a selection, also moves from the lastcolumn to the first c
Starting MATLAB on Macintosh PlatformsStar ting MATLAB on Macintosh PlatformsIn this section...“Starting MATLAB from the Macintosh Desktop” on page 1-
5 Workspace, Search Path, and File Operationsthe Preferences dialog. For more information, see “Prefere nces for the ArrayEditor” on page 5-22.If you
Viewing and Editing Workspace Variables with the Array EditorExample Copying and Pasting Array ElementsIn this example, two elements are copied but th
5 Workspace, Search Path, and File OperationsExample Cutting and Pasting Array ElementsIn this example, the area selected for pasting requires the Arr
Viewing and Editing Workspace Variables with the Array EditorInsert and DeleteintheArrayEditorYo u can insert and delete elements, rows, and columns i
5 Workspace, Search Path, and File OperationsTo create a new variable, select a cell, row, or column in the Array Editor,right-click, and from the con
Search PathSearch PathIn this section...“About the Search Path” on page 5-23“How the Search Path Determines W hich Function to U se” on page 5-24“How
5 Workspace, Search Path, and File Operationsaction so that MATLAB runs the file you want—for more information, see“How the Search Path Determines Whi
Search Path• If you are not sure of the function MATLAB is using, run which for aspecified function and M ATLAB returns the full path to the function.
5 Workspace, Search Path, and File OperationsViewing and Setting the Search PathUse the Set Path dialog box to view and modify the MATLAB se arch path
Search Path• “Viewing the Search Path” on page 5-27• “A dding Directories to the Search Path” on page 5-27• “M oving Directories Within the Search Pat
1 Startup and ShutdownStar tup Directory for MATLABIn this section...“What Is the Startup Directory?” on page 1-8“Startup Directory (Folder) on Window
5 Workspace, Search Path, and File OperationsThe Browse for Folder dialog box opens.2 In the Browse for Folder dialog box, use the view of your file s
Search Path2 Click one of the Move buttons, such as Move to Top. The order of thedirectories changes.3 To use the newly modified search path in future
5 Workspace, Search Path, and File OperationsRestoring the Default Search PathTo restore the default search path, click Default in the Set Path dialog
Search PathCaution Against Saving Files in matlabroot/toolbox. Save any M-filesyou create and any MathWorks supplied M-files that you edit in a direct
5 Workspace, Search Path, and File OperationsBy maintaining an un altered pathdef.m in matlabroot/toolbox/local,you avoid inadvertently removin g dire
Search PathRecovering from Problems with the Search PathIf you get unexpected results that are related to the search path, you can tryto correct the p
5 Workspace, Search Path, and File Operationsa Runrestoredefaultpath; matlabrcThis might run for a few minutes. It sets the search path to include onl
File Management OperationsFile Management OperationsIn this section...“About MATLAB File Operations” on page 5-35“Current D irectory Field” on page 5-
5 Workspace, Search Path, and File OperationsTo change the current directory from thisfield,dooneofthefollowing:• In the field, type the path for the
File Management OperationsThe main tasks you perform with the Current Directory browser are• “Viewing and M aking Changes to Directories” on page 5-38
Startup Director y for MATLABStartup Directory on UNIX PlatformsOn UNIX platforms, the default startup directory is the directory youareinonyourUNIXfi
5 Workspace, Search Path, and File OperationsViewing and Making Changes to DirectoriesYou can change the current directory, view its contents, add dir
File Management Operations1 Set C:\Climate as your current directory.2 Assume that you want to search the Current Directory for the file n amedstandar
5 Workspace, Search Path, and File Operations4 Since the standalone directory is not your intended search target, continuetyping additional letters th
File Management OperationsChanging the DisplayTypes of Files. To specify the types of files shown in the Current Directorybrowser, use the View menu.
5 Workspace, Search Path, and File OperationsContents. In the Current Directory browser, select a file and then viewinformation about the file in the
File Management OperationsAdding Directories to the MATLAB Search PathFrom the Current Directory browser, you can add directories to t he M ATLABsearc
5 Workspace, Search Path, and File Operationsgenerates a warning and does not delete my file.m. Instead use the functionform of the syntax:delete(&apo
File Management Operations3 Press the Enter or Return key.The directory is added.Function Alternative. To create a directory, use themkdir function. F
5 Workspace, Search Path, and File Operationsthe Recycle Bin, select Properties from the context menu, and then, underthe Global tab, select the check
File Management OperationsOpening and Running Files• “Opening Files” on page 5-47• “Running M-Files” on page 5-49Opening FilesYo u can open a file fro
Revision HistoryJune 2004 First printing New for MATLAB 7.0 (Release 14). Formerly part of UsingMATLAB.October 2004 Online only Revised for MATLAB 7.0
1 Startup and ShutdownIn the Start in field, enter the full path to the directory in which you want MATLABto the start. For example, I:\my_matlab_file
5 Workspace, Search Path, and File OperationsYou can also import data from a file. Select the file, ri ght-click, and selectImport Data from the conte
File Management OperationsFile Type Extension ActionVariablenoneOpens the numeric or string array namein the Array Editor; open calls openvar.Othercus
5 Workspace, Search Path, and File OperationsTosearchforfilesinoneormoredirectories, or to search for specifie d text infiles, fo llow these instructi
File Management Operations• To search for text within files, type the text in the Find files containingtext field. For example, search forplot. A lter
5 Workspace, Search Path, and File Operations7 Click a colum n heading to sort the results based on that column. Clickthe column heading again to reve
File Management Operations4 Find Files will not look in any file type in the list whose State check box isselected. It will look in any file type in t
5 Workspace, Search Path, and File Operations5 Click OK to accept the changes and close the Ed it Skipped FileExtensions dialog box.6 When you click F
File Management OperationsHistoryThe drop-down list in the current directory field shows the history of currentdirectories, that is, the most recently
5 Workspace, Search Path, and File Operations• File type• Fi le size• Last modified date• M -file descriptions (the first comm ent line in the M-file,
6Editing and DebuggingM-FilesMATLAB provides powerful tools for creating, editing, and debugging files,as deta iled here. For information about the MA
Startup Director y for MATLABYou can make multiple shortcuts to start MATLAB, each with its own startupdirectory, and with each startup directoryhavin
6 Editing and Debugging M-FilesNavigating in an M-File (p. 6-42)Go to a line number, function,bookmark , back and forward, an dopen a selection.Findin
BeginwithExistingCodeBeginwithExistingCodeIn this section...“Create M-Files from Command Window and History” on page 6-3“Use Existing M-Files and Exam
6 Editing and Debugging M-FilesDemos and ExamplesMATLAB and its toolboxes include demonstrationprograms.Youcanviewthecode in the demos and copy it for
Ways to Edit, Evaluate, a nd Debug M-FilesWays to Edit, Evaluate, and D ebug M-FilesThere are several methods for creating, editing, evaluating, and d
6 Editing and Debugging M-FilesUse preferences for the Editor/Debugger to set up the editing and debuggingenvironment to best m eet your needs.For inf
Starting, Customizing, and C losing the Editor/DebuggerStar ting, Customizing, and Closing the Editor/DebuggerIn this section...“Starting the Editor/D
6 Editing and Debugging M-FilesCreating a New File in the E ditor/DebuggerTocreateanewtextfileintheEditor/Debugger, either click the New M-filebuttono
Starting, Customizing, and C losing the Editor/DebuggerFunction AlternativeType edit in the Command Window to create a new file in theEditor/Debugger.
6 Editing and Debugging M-FilesTo make a document in the Editor/Debugger become the current document,click it, or select it from the Window menu or do
Starting, Customizing, and C losing the Editor/DebuggerFile > Preferences > Editor/Debugger and in the Most recently usedfile list,specifytheNum
1 Startup and ShutdownStar tup OptionsIn this section...“About Startup Options” on p age 1-12“Using the Startup File for MATLAB, startup.m” on page 1-
6 Editing and Debugging M-FilesClick the + next to Editor/Debugger in the left pane to view all categories ofEditor/Debugger preferences. Select a cat
Starting, Customizing, and C losing the Editor/DebuggerWhen working with files created for C/C ++, Java, and HTML, you can specifysyntax highlighting
6 Editing and Debugging M-FilesEntering Statements in the Editor/DebuggerIn this section...“Use Comma nd Window Feature s in the Editor/Debugger” on p
Entering Statements in the Edito r/Debugger• Reverse Case to change the case of each letterThis is useful, for example, when copying syntax from help
6 Editing and Debugging M-Files• “C ommenting in Java and C/C++ Files Using the MATLABEditor/Debugger” on page 6-17• “Commenting in M - File Using A n
Entering Statements in the Edito r/DebuggerCommenting in Java and C/C++ Files Using the MATLABEditor/DebuggerFor Javaand C/C++ files, selecting Text &
6 Editing and Debugging M-FilesTo com m ent a contiguous group of lines, type %{ before the first line and%} afterthelastlineyouwanttocomment. Thisisr
Entering Statements in the Edito r/DebuggerCommenting Out Part of a StatementTo comment out the end of a statement in an M-file, put the commentcharac
6 Editing and Debugging M-FilesNote that Middle Initial is g r een, which is the syntax highlighting color fora comment.MATLAB continues processing th
Entering Statements in the Edito r/Debuggeras you reach the 75th column, the comment automatically continues on thenext line.Tab Completion in the Edi
Startup OptionsAdding Startup Options for Windows PlatformsYo u can add selected startup options (also called command flags or switchesfor the command
6 Editing and Debugging M-Files• “ Tab Co mpletion for Structures” on page 6-2 5• “Tab Completion for Properties” on page 6-26• “U sing Tab for Spacin
Entering Statements in the Edito r/DebuggerMultiple Possible CompletionsIf there is m ore than one name that starts with the characters you typed, whe
6 Editing and Debugging M-FilesYo u can navigate the list of possible completions using up and down arrowkeys, and Page Up and Page Down keys. You can
Entering Statements in the Edito r/DebuggerContinue narrowing the list in the same way. For the above example, type oand press Tab to further narrow t
6 Editing and Debugging M-FilesTab Completion for PropertiesComplete property names for figures in the current workspace using tabcompletion, as in th
Entering Statements in the Edito r/DebuggerUsing Tab for SpacingIf the preference for tab completion is selected, and you want to also use theTab key
6 Editing and Debugging M-FilesAppearance of an M-File — Making F iles More ReadableIn this section...“Syntax Highlightin g” on page 6-28“Indenting” o
Appearance of an M-File — Making Files More ReadableIndentingAutomatic IndentingYoucansetanindenting preference so that program controlentries are aut
6 Editing and Debugging M-Files(a function within a function) in the Editor/Debugger. For details, see in theonline documentation.Line and Column Numb
Appearance of an M-File — Making Files More ReadableRight-Hand Text LimitBy default, a light red vertical line (rule) appears at column 75 in theEdito
1 Startup and Shutdown... matlab.exe -nosplash -r "results"Startup Options in DOS WindowWhen you start MATLAB in a DOS window, include start
6 Editing and Debugging M-FilesCode folding is p articularly useful for improving readability when an M-filecontains numerous subfunctions and you wan
Appearance of an M-File — Making Files More Readable6-33
6 Editing and Debugging M-FilesWhen y ou expand a function, but collapse its associated help code, theEditor/Debugger displays all the function code a
Appearance of an M-File — Making Files More Readable6-35
6 Editing and Debugging M-FilesTo expand code for a construct that is currently collapsed, do one of thefollowing:• Click the plus sign iconto the lef
Appearance of an M-File — Making Files More Readable6-37
6 Editing and Debugging M-FilesCode Folding Behavior and PreferencesBe aware of the following:• You can change the current code folding settings, by s
Appearance of an M-File — Making Files More Readable6-39
6 Editing and Debugging M-FilesAdjustthesizeoftheviewsbydragging the splitter. The pointer assumes anarrow shape when it is positioned on the splitter
Appearance of an M-File — Making Files More Readable• Dragthesplittertoanedgeofthewindow.• Double-click the splitter.• Select Window>Split>Scree
Startup OptionsPlatformOption DescriptionUNIX-nodesktopStart MATLAB without bringing up the MATLABdesktop. Use this option to run without an X-window,
6 Editing and Debugging M-FilesNavigating in an M-FileIn this section...“Going to a Line N umber” on page 6-42“Going to a Function (Subfunctions and N
Navigating in an M-FileFunctions in the list appear alphabetically by name. To order them by theirposition inthe file, click the Line column heading.
6 Editing and Debugging M-FilesTo set a bookmark, position the cursor anywhere in the line and selectGo > Set/Clear Bookmark. A bookmark icon a ppe
Navigating in an M-FileFor example, if you open a file and make changes at lines 3, 9, and 6, useGo > Backto return to line 9, then 3, then 1, and
6 Editing and Debugging M-FilesLines Navigated to Using Go BackUse Go > Back and Forward to go to lines you previo us ly edited or navigate dto via
Navigating in an M-FileFeature Examples NotesDebugging n avig ation Lines with breakpointsthat were stopped at whilerunning, and lines steppedtoA line
6 Editing and Debugging M-Filesthe split, Go > Back and Forward do not go to any lines that were visitedin the lower (or right) view.OpeningaSelect
Finding Text in FilesFinding Text in F ilesIn this section...“Finding Text in the Current File” on page 6-49“Finding and Replacing Text in the Current
6 Editing and Debugging M-FilesThe search begins at the current cursor position. MATLAB finds the textyou specified and highlights it. To find another
Finding Text in Files3 To save the changes to the file, select Save fro m the File menu.You can repeat this formultiplefiles.Function AlternativeforFi
1 Startup and ShutdownPlatformOption DescriptionAll-nosplashStart MATLAB without displaying the MATLAB splashscreen.All-r "statement"Automat
6 Editing and Debugging M-Files3 In the increm en t al se arch fie ld, ty pe the text you want to find. For example,typeplot.As you type t he first le
Finding Text in Files• If you mistype in the incremental search field, use the backspace key toremove the last letters and make corrections.• A fter f
6 Editing and Debugging M-FilesComparing Files — File Comparison ToolIn this section...“What Is the File Comparison Tool?” on page 6-54“Running the Fi
Comparing Files — File Comparison Tool• Tools > Compare Against > Autosave Version to compare the openfile to the Editor/Debugger’s automatic co
6 Editing and Debugging M-Files4 Use features of the File Comparisons tool to work with the results.Increase or Decrease Line Lengths ShownBy default,
Comparing Files — File Comparison Toolvertical ed ges of the window to make it wider. With a na rrower wind ow size, ifthere are more columns shown in
6 Editing and Debugging M-FilesAlternative WaystoAccesstheToolThese are additional ways you can access the tool:• From the MATLAB desktop, select Desk
Keyboard Shortcuts in the Edito r/DebuggerKeyboard Shor tcuts in the Editor/DebuggerFollowing is the list of keys that serv e a s shortcuts for using
6 Editing and Debugging M-FilesKey or MouseAction forWindowsPreferenceAdditionalControl Keyfor EmacsPreferenceKey or M ouseAction forMacintoshPreferen
Keyboard Shortcuts in the Edito r/DebuggerKey or MouseAction forWindowsPreferenceAdditionalControl Keyfor EmacsPreferenceKey or M ouseAction forMacint
Toolbox Path Caching in MATLABToolbox Path Caching in MATLABIn this section...“About Toolbox Path Caching” o n page 1-17“Using the Cache File Upon Sta
6 Editing and Debugging M-FilesSaving, Printing, and Closing Files in the Editor/DebuggerIn this section...“Saving Files” on page 6-62“Printing M -Fil
Saving, Printing, and Closing Files in the Editor/DebuggerNote Save any M-files you create and any M-files from The MathWorksthatyoueditinadirectoryth
6 Editing and Debugging M-FilesThere is a preference to Automatically delete autosave files.Withthis preference selected, when you close an M -file in
Saving, Printing, and Closing Files in the Editor/DebuggerIf each file is open in a separate window, close all the files at once using t heClose All D
6 Editing and Debugging M-FilesRunning M-Files in the E ditor /Debugg erIn this section...“Running M-Files with No Input Arguments in the E ditor/Debu
Running M-Files in the Editor/DebuggerGeneral Display Options, select the check box for E n able datatips inedit mode.Using Configurations — Running M
6 Editing and Debugging M-Files2 ClickthedownarrowontheRunbuttonintheEditor/Debuggertoolbarand select Edit Configurations forfilename, where filename
Running M-Files in the Editor/Debugger3 In the dialog box, e nter MATLAB statements in the MATLAB expressionarea of the dialog box, specifying what yo
6 Editing and Debugging M-FilesThe MATLAB e xpress ion area provides syntax highlighting and showsM-Lint messages, similar to the Editor/Debugger.4 To
Running M-Files in the Editor/Debugger5 You can modify the statements in the MATLAB expression area ofthe dialog box and click Run to see the results
1 Startup and ShutdownWe strongly recommend that you saveanyM-filesyoucreateandanyMathWorks supplied M-files that you edit in a directory that is noti
6 Editing and Debugging M-FilesTo run the config uration, select the configuration name. MATLAB runsthe expression you specified in the configuration.
Running M-Files in the Editor/Debugger• S mall value, e.g., 3, for debugging and testing• Realistic value, e.g.,200 or more, for a specific project• R
6 Editing and Debugging M-Filescollatplot_new_test, describe d in “Create and Run a Configuration foran M-file” on page 6-67.For example, renamecollat
Running M-Files in the Editor/Debugger5 Click Done to close the Edit M-File Configurations dialog box.Find Configurations1 Open any M-file in Editor/D
6 Editing and Debugging M-Files3 Type a term in the filter fieldto find an M-file orconfiguration by name.MATLAB displays only those M -files whose na
Running M-Files in the Editor/Debugger4 ExpandtheM-filenametoseeassociatedconfigurationswhosenamescontain the te rm you entered i n the filter field.
6 Editing and Debugging M-Files5 To see the expression in that configuration, select the configuration, orposition the pointer over the name.6 As you
Running M-Files in the Editor/Debugger3 Select the configuration y ou want to delete.4 Click the Removebutton.5 To undo the last d eletion, click the
6 Editing and Debugging M-FilesTo reassociate configurations1 In the list of configurati on s (left pane), select the M-file. T he AssociatedM-file di
Running M-Files in the Editor/Debugger4 You mightwant to rename the configurations to be consistent with the newM-file name, or at least to not reflec
Toolbox Path Caching in MATLABFunction AlternativeTo update the cache, userehash toolbox. Toalsoupdatethecachefile,userehash toolboxcache. For more in
6 Editing and Debugging M-Files5 For an M-filenamechange,youmightneedtomodifytheconfiguration statements to run correctly. For this examp l e, modifyt
Running M-Files in the Editor/DebuggerSeeAlso—OtherWaystoRunM-FilesfromtheEditor/Debugger• See “Running an M-File with Breakpoints” on p age 6-111 for
6 Editing and Debugging M-FilesFinding Errors, Debugging, and Correcting M-FilesThis section introduces general techniques for finding errors and usin
Finding Errors, Debugging , and Correcting M-FilesTechnique orTo ol Description For More InformationError MessagesWhen you run an M-file with a syntax
6 Editing and Debugging M-FilesTechnique orTo ol Description For More InformationOtherDebuggingTechniques•Addkeyboard statements to the M-file —keyboa
M-Lint Code AnalyzerM-Lint Code AnalyzerIn this section...“What Is M -Lint?” on page 6-87“WaystoUseM-Lint”onpage6-87“M-Lint Automatic C ode Analyzer i
6 Editing and Debugging M-FilesM-Lint Automatic Code Analyzer in theEditor/DebuggerTo use the M-Lintcontinuous code checking in an M-file in theEditor
M-Lint Code Analyzer2 Open an M-file in the Editor/D ebugg er. This example uses the samplefilelengthofline.m:a Open the example file:6-89
6 Editing and Debugging M-Filesopen(fullfile(matlabroot,'help','techdoc','matlab_env','examples','lengtho
M-Lint Code AnalyzerCurrent cursor positionM-Lint message indicator for all messages in entire file:- Red means errors detected- Orange means warnings
1 Startup and ShutdownAdditional Diagnostics with Toolbox Path CachingTo display information about startup time when you start MATLAB, selectthe Enabl
6 Editing and Debugging M-Files4 Click the M-Lint message indicator to go to the next code fragmentcontaininganM-Lintmessage. Thenextcodefragmentisrel
M-Lint Code Analyzerextraneous and you could delete it. But it might be that you actuallyintended to use the variable, as shown in step 6 of this exam
6 Editing and Debugging M-FilesRight-click the highlighted code (for a single-button mouse, use Ctrl+click).The first item in the context menu indicat
M-Lint Code AnalyzerThere is a preference you can set for the color—f or more information, see“Other Colors” on page 2-75.8 You might want to ignore c
6 Editing and Debugging M-Filestemp = diff([data{1}(:) data{2}(:) data{3}(;)]);Multiple messages can represent a single problem or multiple problems.A
M-Lint Code AnalyzerThat single change addressed the issues in all o f the M-Lint messagesfor line 48.Because the change you made removed the only err
6 Editing and Debugging M-FilesSuppressing M-Lint Indicators and MessagesDepending on what stage you are at in completing the M-file, you m ightwant t
M-Lint Code AnalyzerThere are a few different ways to suppress the M-Lint indicators andmessages:• “Ignore Only a Specific Instance” on page 6-99• “Di
6 Editing and Debugging M-FilesRight-click at an M-Lint underline and select the option instructing M-Lintto ignore only this instance of the message,
M-Lint Code AnalyzerM-Lint adds %#ok for a specific message to theend of a line for which you specified the M-Lint messageshould be suppressed.Disable
Other Startup TopicsOther Startup TopicsIn this section...“Error Log Reporter” on page 1-21“Passing Perl Variables on Startup” on page 1-21“Startup an
6 Editing and Debugging M-Filestxt file. You can reuse the settings for any M-f ile, o r provide the settings fileto another user.To use the saved set
Debugging Process a nd FeaturesDebugging Process and FeaturesIn this section...“Ways to Debug M-Files” on page 6-103“Preparing for Debugging” on page
6 Editing and Debugging M-Filesthatareonthesearchpath.Ifallfilestobeusedareinthesamedirectory,you can instead m ake that directory be the current dire
Debugging Process a nd FeaturesCode for collatz.m.function sequence=collatz(n)% Collatz problem. Generate a sequence of integers resolving to 1% For a
6 Editing and Debugging M-FilesTry out collatzplot to see if it w orks correctly. Use a simple input value,for example, 3, and com pare the re sults t
Debugging Process a nd FeaturesSetting BreakpointsSet breakpointstopauseexecutionoftheM-filesoyoucanexaminevalueswhere you think the problem might be.
6 Editing and Debugging M-Filesonly stop at the for statement once. Instead place the breakpoint at the nextline,m=n+1 to stop at each pass through th
Debugging Process a nd FeaturesValid (Red) an d Inv alid (Gray) Breakpoints . Red breakpoints are validstandard breakpoints. If breakpoints are instea
6 Editing and Debugging M-FilesBreakpoints are gray for either of these reasons:• Thefilehasnotbeensavedsincechangesweremadetoit. Savethefileto make b
Debugging Process a nd FeaturesSome useful related functions are•dbtype — Lists the M-file with line numbers in the C ommand Window.•dbstatus —Listsbr
1 Startup and Shutdown#!/usr/local/bin/perl$val = 10;system('matlab -r "test(' . ${val} . ')"');2 Invoke the Perl script
6 Editing and Debugging M-Files• The function displayed in the Stack field o n the toolbar changes toreflect the current function (sometimes referred
Debugging Process a nd FeaturesToolbarButtonDebug MenuItem DescriptionFunctionAlternativeStep Execute the current line of theM-file.dbstepStep In Exec
6 Editing and Debugging M-FilesExamining ValuesWhile the program is paused, you can view the value of any variable currentlyin the workspace. Ex am in
Debugging Process a nd FeaturesViewing Values as Datatips in the Editor/DebuggerIn the Editor/Debugger, position the pointer to the left of a var iabl
6 Editing and Debugging M-FilesCommand Window and M ATLAB displays its current value. For the example,to see the value ofn,typenMATLAB returns the exp
Debugging Process a nd Featuresand the Array Editor opens, showing that n =2asexpected.Evaluating a SelectionSelect a variable or equation in an M -fi
6 Editing and Debugging M-Filescalling function, which automatically runs the rest of the called function andreturns to the next line in the calling f
Debugging Process a nd Featuresprogram is paused, assign a new value to the variable in the CommandWindow, Workspace browser, or Array Editor. Then co
6 Editing and Debugging M-FilesDisabling and Enabling Breakpoints. You can disable selectedbreakpoints so the prog ram temporarily ignores them and ru
Debugging Process a nd Featuresdbclear all in collatzplotBreakpoints a re automatically cleared when you• E nd the MATLAB session• Clear the M-file us
Quitting MATLABQuitting MATLABIn this section...“Ways to Quit MATLAB” on page 1-23“Confirm Quitting MATLAB” on page 1-23“Running a Script W hen Quitti
6 Editing and Debugging M-Files1 Endthedebuggingsession. OnewaytodothisistoselectExit DebugMode from the Debug menu.2 In collatzplot.m line 12, change
Debugging Process a nd Features6 Test the function for a slightly larger value of m,suchas6,tobesuretheresults a re s till accurate. To make it easier
6 Editing and Debugging M-Filescollatzplot(6)7 To make debugging easier, you ran collatzplot for a small value of m.Now that you know it works correct
Debugging Process a nd FeaturesThe following figure shows the lengths of the Collatz series for n =1throughn =500.Running Sections in M-Files That Hav
6 Editing and Debugging M-Fileschoose Evaluate Selection from the context menu. You can also use cellmode to do this.Conditional BreakpointsSet condit
Debugging Process a nd FeaturesThe MAT LAB Ed itor conditional breakpoint dialog box opens as shownin this example.2 Type a condition in the dialo g b
6 Editing and Debugging M-FilesCopying, Modifying, Disabling, and Clearing ConditionalBreakpointsTo copy a conditional breakpoint, right-click the ico
Debugging Process a nd Featuresthat line and select the action. MATLAB prompts you to specify the exactbreakpoint on which to act in that line.When yo
6 Editing and Debugging M-Files• “Function Alternative for Error Breakpoints” on page 6-132Setting Error BreakpointsTo set error breakpoints, select D
Debugging Process a nd FeaturesErrors. When an error occurs, execution stops, unless the error is in atry...catch block. MATLAB enters debug mode and
1 Startup and ShutdownFor more informatio n , see “Confirm ation Dialogs Pre ferences” on page 2-81.You can also display your own quitting confirmatio
6 Editing and Debugging M-FilesMessage Identifier dialog box. An example of an error m essage identifierisMATLAB:UndefinedFunction. Similarly, to obta
Using Cells for Rapid Code Iterati on a nd P ub lishi ng ResultsUsing Cells for Rapid Code Iteration and Publishing ResultsIn this section...“What Are
6 Editing and Debugging M-FilesIf you h ave an active Internet connection, you can watch the Rapid CodeIteration Usi n g Cells video demo for an overv
Using Cells for Rapid Code Iterati on a nd P ub lishi ng ResultsDefining CellsCell features operate on ce lls, where a cell is contiguous lines of cod
6 Editing and Debugging M-Fileslines of code you want in a cell and then select Cell > Insert Cell DividersAround Selection.Yo u can define a cell
Using Cells for Rapid Code Iterati on a nd P ub lishi ng ResultsExample — Define CellsThis example defines two cells for a simple M- file called sine_
6 Editing and Debugging M-Files2 Position the cursor at the start of the first line. Select Cell > Insert CellDivider.The Editor/D ebugger inserts%
Using Cells for Rapid Code Iterati on a nd P ub lishi ng ResultsRemoving CellsTo remove a cell, delete one of the percent signs (%) from the line that
6 Editing and Debugging M-FilesNavigating Among Cells in an M-FileTo move to the next cell, select Cell > Next Cell.Tomovetothepreviouscell,select
Using Cells for Rapid Code Iterati on a nd P ub lishi ng ResultsModifying Values in a CellYou can use cell features to modify numbers in a cell, which
Quitting MATLABmake note of what s eems to cause it and look fo r information about it in theMathWorks Bug Reports database.There are some situations
6 Editing and Debugging M-Files2 Assume you want to produce a smoother curve. Use more values for x in0:1:6*pi. Position the cursor in line 4, next to
Using Cells for Rapid Code Iterati on a nd P ub lishi ng ResultsThe curve is smooth, but becaus e there are m ore values, pro cessing time isslower. I
6 Editing and Debugging M-FilesMATLAB updates the figure.Using Cells in Function M-FilesYou can define an d evaluate cells in f unction M - fi les as
7Tuning and ManagingM-FilesThis set of tools provides useful information about the M-files in a directorythat can help you re fine the files and impro
7 Tuning and Managing M-FilesDirector y Repor ts in Current Directory BrowserIn this section...“Accessing and Using Directory Reports” on page 7-2“TOD
Directory Rep orts in Current Directory BrowserThe report you selected appears as an HTML document in the MATLAB WebBrowser:• In a report,clickafilena
7 Tuning and Managing M-FilesTODO/FIXME ReportThe TODO/FIXME Report shows M-files that contain text strings youincluded as notestoyourself,suchasTODO.
Directory Rep orts in Current Directory Browser7-5
7 Tuning and Managing M-FilesHelp ReportThe Help Report presents a summary view of the help compo ne nt ofyour M-files. InMATLAB, the M -file help com
Directory Rep orts in Current Directory BrowserShow SubfunctionsWithShow subfunctions selected, the Help Report displays helpinformation for all subfu
1 Startup and Shutdown1-26
7 Tuning and Managing M-FilesDescriptionWith Description selected, the Help Report displays the first lin e of help inthe M-file. If the first comment
Directory Rep orts in Current Directory BrowserThe report looks for a line in the M-file help that begins w ith the string Seealso. If the report does
7 Tuning and Managing M-FilesTo access this report, follow the instructions in “Accessing and Using DirectoryReports” on page 7-2.If there is noConten
Directory Rep orts in Current Directory BrowserUse the link s displaye d for each line, or edit the Contents.m file directly, oredittheM-filestomaketh
7 Tuning and Managing M-FilesIf you always want the Contents.m file to reflect all files in the directory,you can automatically generate a newContents
Directory Rep orts in Current Directory BrowserFiles Not In Contents.m. This message appears when a file in the directoryis not inContents.m. These me
7 Tuning and Managing M-FilesThe Dependency Report is similar to running the depfun function, althoughthe two do not provide the exact same results. F
Directory Rep orts in Current Directory BrowserCoverage ReportRun the Coverage Report after you run the Profiler to identify how much of afileranwheni
7 Tuning and Managing M-FilesM-Lint Code Check ReportIn this section...“Running the M-Lint Code Check Directory Report” on page 7-16“Making Changes Ba
M-Lint Code Check ReportClick a line numberto open theM-file in theEditor/Debuggerat the line.Line number andmessagedescribing apotential problemor im
2DesktopIf you have an active Internet connection, you can watch the Working inthe Development Environment video demo for an o ve rview of the majorfu
7 Tuning and Managing M-Files• M-Lint does not provide perfect information about every situation andin some cases, you might not want to make any chan
M-Lint Code Check Report• Use the Help browser Search and Index panes to find documentationabout terms presented in the M-Lint messages.Other techniqu
7 Tuning and Managing M-Files7-20
M-Lint Code Check ReportMessages and Resulting Changes for the lengthofline Example. Thefollowing table describes each message and demonstrates a way
7 Tuning and Managing M-FilesMessage — Code (Original Line Numbers)Explanation and Updated Code (NewLine Numbers)24: 'notline' might be grow
M-Lint Code Check ReportMessage — Code (Original Line Numbers)Explanation and Updated Code (NewLine Numbers)34: 'data' might be growing insi
7 Tuning and Managing M-FilesMessage — Code (Original Line Numbers)Explanation and Updated Code (NewLine Numbers)42: 'data' might be growing
M-Lint Code Check ReportMessage — Code (Original Line Numbers)Explanation and Updated Code (NewLine Numbers)49: Terminate statement with semicolonto s
7 Tuning and Managing M-FilesUpdated M-Lint CodeCheck Report aftermaking changes tothe lenghtofline filebased on M-Lintmessages. Now, nomessagesare re
Profiling fo r Improving PerformanceProfiling for Improving PerformanceIn this section...“What Is Profiling?” on page 7-27“Profiling Proces s and Guid
2 DesktopFonts Preferences for Des kto p Tools(p. 2-62)Use desktop font preferences tospecify the font characteristics forMATLAB desktop tools.Colors
7 Tuning and Managing M-FilesProfiling Process and GuidelinesHere is a general process you can follow to use the Profiler to improveperformance in you
Profiling fo r Improving PerformanceUsing Profiling as a Debugging ToolThe Profiler is a useful tool for isolating problems in your M -f il es.For exa
7 Tuning and Managing M-FilesFor information about the reports generated by the Profiler, see “ProfileSummary Report” on page 7-33 and “Profile Detail
Profiling fo r Improving PerformanceTo profile an M-file or a line of code, follow these steps:1 In the Ru n this code field in the Profiler, type the
7 Tuning and Managing M-Files2 Click Start Profiling (or p ress Enter after typing the statement).While the Profiler is running, the Profile time indi
Profiling fo r Improving Performance2 Start the graphical user interface. (If you d o not want to include its startupprocess in the profile, do not cl
7 Tuning and Managing M-Filesorder by the amount of time they took to process. To sort the functionsalphabetically, click the Function Name link at th
Profiling fo r Improving PerformanceProfile Detail ReportThe Profile Detail report shows profiling results for a selected function thatwas called duri
7 Tuning and Managing M-FilesControlling the Contents of theDetail Report Display (p. 7-36)Customize display to include onlysections you are intereste
Profiling fo r Improving Performance7-37
Overview of the DesktopOver view of th e DesktopIn this section...“About the Desktop” on page 2-3“Summary of Desktop Tools” on page 2-5About the Deskt
7 Tuning and Managing M-FilesProfile Detail Report HeaderThe detail report header includes the name of the function that was profiled,the number of ti
Profiling fo r Improving PerformanceNote that this was not selected in the example. Click a line n umber to viewthat line of code in the sou rce listi
7 Tuning and Managing M-FilesM-Lint ResultsTo include the M-Lint results section in the detail report display, selectthe Show M-Lint results check box
Profiling fo r Improving PerformanceFunction ListingTo include the Function listing s ection in the detail report display, selectthe Show function lis
7 Tuning and Managing M-FilesThe profile FunctionThe Profiler is based on the results returned by the profile function. Thissection describes• “profil
Profiling fo r Improving Performanceprofile Function Syntax SummaryHere is a summary of some of the main forms of profile.Fordetailsaboutthese and oth
7 Tuning and Managing M-Files1 To start profile, type in the Command Windowprofile on2 Execute an M-file. T his example runs the Lotka-Volterra predat
Profiling fo r Improving Performance7 To save the profile report, use the profsave function. This function storesthe profile information in separate H
7 Tuning and Managing M-FilesClockSpeed: 3.0000e+009Name: 'MATLAB'5 The FunctionTable field is an array of structures, where each structurer
Profiling fo r Improving PerformanceIsRecursive: 0PartialData: 07 To view the history data generated by profile,viewtheFunctionHistory,for example,sta
ContentsStartup and Shutdown1Starting MATLABon Windows Pla tfor ms...1-2Starting M ATLAB from the Windows Desktop or a DOSWindow...
2 DesktopView or change thecurrent directory.Move, maximize,minimize or closea window.Enter MATLABstatements at theprompt.Menus change,depending on th
7 Tuning and Managing M-Files7-48
8Publishing ResultsMATLAB provides two different approaches for publishing: using cells andwith the Notebook features for Microsoft Word.Publishing to
8 Publishing ResultsPublishingtoHTML,XML,LaTeX,Word,andPowerPointUsing CellsIn this section...“About Publishing M-Files” on page 8-2“Publishing Script
Publishing to HTML, XML, LaTeX, Word, and PowerPoint Using Cellsthe start of a cell appear as plain text. Comments appearing after code in acell appea
8 Publishing Resultswithin the M-file script, supply a ny input values that you had passed w henyou ran the function.ExampleofPublishingWithoutTextMar
Publishing to HTML, XML, LaTeX, Word, and PowerPoint Using CellsSelect File > Pub lish to HT ML to produce the following result.8-5
8 Publishing ResultsExample of Publishing with Text MarkupThis simple example adds text markup to the sine_wave.m file used in“Example of Publishing W
Publishing to HTML, XML, LaTeX, Word, and PowerPoint Using Cells8-7
8 Publishing Results1 Add a n o verall title and introduction for the published documenta Select Cell > Insert Text Markup > > Document Title
Publishing to HTML, XML, LaTeX, Word, and PowerPoint Using Cellsc Replace the sample equation with the following TeX equation:0 \leq x \leq 6\piThe th
Overview of the DesktopSummary of Desktop ToolsThe following tools are managed by the MATLAB desktop, although not all ofthem appear by default when y
8 Publishing Results8-10
Marking U p Text in Cells for PublishingMarking Up Text in Cells for P ublishingIn this section...“Overview of Text Markup” on page 8-11“Text Markup f
8 Publishing Results• T ype the markup symbols directly in the code. Note that what you type isthe same as the code that results if you instead use th
Marking U p Text in Cells for PublishingFormatHow to ProduceFormat Resulting Code Published Resul tsOveralldocumentheading andintroductorytext1 Positi
8 Publishing ResultsText Markup for Indented Text, Lists, and GraphicsIndented text, lists, and graphics are types of block styles. Block stylescontro
Marking U p Text in Cells for PublishingFormatHow to P roduceFormatResulting Code andExplanation Published ResultsImage1 Position the cursorbeforethel
8 Publishing ResultsFormatHow to P roduceFormatResulting Code andExplanation Published ResultsBulleted list1 Position the cursorbeforethelinewhereyou
Marking U p Text in Cells for PublishingText Markup for HTML, LaTeX, and TeX EquationOutput TypesYo u can specify the output type for a published M-fi
8 Publishing ResultsFormatHow to ProduceFormat Resultin g Code Pu bl ished ResultsHTML markup1 Position the cursorbefore the line whereyou want to add
Marking U p Text in Cells for PublishingFormatHow to ProduceFormat Resultin g Code Pu bl ished ResultsLaTeX markup1 Position the cursorbefore the line
2 DesktopArranging the DesktopIn this section...“Modifying the Desktop Configuration” on page 2-6“Opening and Arrang in g Tools” on page 2-6“Opening a
8 Publishing ResultsText Markup for Bold, Italic, and Monospaced TextFormatsYo u can mark up selected strings in the M-fil e comments so that they a p
Marking U p Text in Cells for PublishingFormat How to Produce Format Resulting Code Published ResultsItalic text Follow these steps to boldexisting te
8 Publishing ResultsText Markup for Inline LinksWhen you specify hypertext links within an M-file, when you publish thedocument the hypertext links be
Marking U p Text in Cells for PublishingFormat How to Produce Format Resulting Code Published ResultsURL ashyperlinkedtext1 Within a comment, position
8 Publishing ResultsPublishing M-Files Using CellsIn this section...“How to Publish an M-File” on page 8-2 4“About Published M-Files” on page 8-25“Mod
Publishing M-Files Using CellsNote Publishing to Microsoft Word and to PowerPoint features are availableonly on Windows systems that have the applicat
8 Publishing ResultsTeX equations are image files as well; in the example, the equation fileissine_wave_eq_eq####.png. MATLAB creates a thumbnail file
Notebook for Publishing to WordNotebook for Publishing to WordIn this section...“Using Notebook to Create an M-book” on page 8-27“See Also Publishing
8 Publishing ResultsCreating or Opening an M-BookCreating an M-Book from MATLABTo create a new M-book from within MATLAB, typenotebookin the Command W
Notebook for Publishing to Word• In Word 2007, Notebook adds the Notebook menu to the Word Add-Instab, as shown in the following illustration. Use thi
Arranging the DesktopTool Action Steps to PerformNavigating amongdesktop toolsThe Window menu displays all ope n desktop tools a nd documents,as well
8 Publishing ResultsMicrosoft product screen shot reprinted with permission from MicrosoftCorporation.Creating an M-Book While Running NotebookWith No
Notebook for Publishing to WordMicrosoft product screen shot reprinted with permission from MicrosoftCorporation.Opening an Existing M-BookYo u can us
8 Publishing ResultsWhen you double-click on an M-book, Microsoft Word opens the M-book andstarts MATLAB if it is not already running. Notebook adds t
Notebook for Publishing to Word3 Selectthefileyouwanttoconvert.4 Click OK.• M icrosoft Word 2007:1 Create a new M-book.2 From the Insert tab, in the T
8 Publishing ResultsEntering MATLABCommands in an M-BookNote A g ood way to learn how to use Notebook is to open the sample M-book,Readme.doc,andtry o
Notebook for Publishing to WordEnsuring Data Consistency in M-BooksAn M-book can be thought of as a sequential record of a MATLAB session.When execute
8 Publishing ResultsDefining MATLAB Commands as Input Cells for NotebookIn this section...“Defining Commands as Input Cells for Notebook” on page 8-36
Defining MATLAB Commands a s Input Cells for NotebookDefining Cell Groups for NotebookYou can col lect several input cells into a single input cell. T
8 Publishing Results• If you select part or all of an output cell but not its input cell, Notebookincludes the input cell in the cell group.When you c
Defining MATLAB Commands a s Input Cells for Notebookthe calc zone. The section break indicators include bold, gray brackets todistinguish them from s
2 DesktopTool Action Steps to PerformGrouping tools together You can group tools so that they overlay each other in the MATLABdesktop. To group tools
8 Publishing Results8-47. W hen you convert an input cell to text, Notebook also converts thecorresponding output cell to text.8-40
Evaluating MATLAB Commands with NotebookEvaluating MATLAB Commands with NotebookIn this section...“Evaluating Input Commands with Notebook” on page 8-
8 Publishing Results3 Specify the input cell to be evaluated by selecting it with the mouse or byplacing the cursor in it. Then select Notebook > E
Evaluating MATLAB Commands with NotebookNote Text or numeric output always comes first, regardless of the order ofthe commands in the group.The illust
8 Publishing Results1 Select the range of cells tha t includes the input cells you want to eval u ate.Yo u can include text that surrounds input cells
Evaluating MATLAB Commands with NotebookThe Notebook Options dialog box opens.2 Select the Stop evaluating on error check box and click OK.Using a Loo
8 Publishing ResultsConverting Output Cells to Text with NotebookYou can convert an output c ell to text by undefining cells. If the output isnumeric
Printing a n d Formatting an M-BookPrinting and F orm atting an M-BookIn this section...“Printing an M-Book” on page 8-47“Modifying Styles in the M-Bo
8 Publishing Resultsshades of gray. To print these cells using black type, you need to modify thecolor of the Input, Output, AutoInit, and Error style
Printing a n d Formatting an M-BookNote Changes you make using the Notebook Options dialog box tak e effectfor output generated after you click OK. To
Arranging the DesktopExample of Documents in the DesktopSome common actions for working with documents in the desktop are• Use the document bar to go
8 Publishing Results1 Select Notebook > Notebook Options.2 In the Notebook Options dialog box, clear the Embed Figures inM-book check box.3 Click O
Printing a n d Formatting an M-BookTo allow graphic output for a cell, re pe at the proce dure. Notebook removesthe(no graph) marker and allows graphi
8 Publishing ResultsAdding White Space Around Graphic Output in NotebookYo u can add w hite space around an embedded figure by moving the boundariesof
Configuring NotebookConfiguring NotebookAfter you install Notebook but before you begin using it, you must configureit. (Notebook is installed as part
8 Publishing ResultsNotebook Feature ReferenceIn this section...“Bring MATLAB to Front” on page 8-54“Define Autoinit Cell” on page 8-55“Define Calc Zo
Notebook Feature ReferenceDefine Autoinit CellDefine AutoInit Cell creates an autoinit cell by converting the currentparagraph, selected text, or inpu
8 Publishing ResultsDefine Input CellDefine Input Cell creates an input cell by converting the current paragraph,selected text, or autoinit ce ll. An
Notebook Feature ReferenceSee AlsoFor more information, see “Evaluating a Calc Zone with Notebook” on page8-44.Evaluate CellEvaluate Cell sends the cu
8 Publishing ResultsSee AlsoFor m ore information, see “Evaluating MATLAB Commands with Notebook”on page 8-41. For information about evaluating the en
Notebook Feature ReferenceResultIf you include text in the selection, Notebook moves it after the cell group.However, if text precedes the first input
2 DesktopUsedocumentbar to go toopendocuments.Click namein title bar togo to opentool.Position documents within thetool using these options.Close, und
8 Publishing ResultsPur ge Selected Output CellsPurge Selected Output Cells deletes all output cells from the currentselection.See AlsoFor more inform
Notebook Feature ReferenceSee AlsoFor information about the Normal style, see “Modifying Style s in the M-BookTemplate” on page 8-47. For information
8 Publishing Results8-62
9Source Control InterfaceThe source control interface provides access to your source control systemfrom MATLAB. Source control systems, also known as
9 Source Control InterfaceTroubleshooting Source ControlProblems on Windows (p. 9-24)Solutions to some co mmon sourcecontrol p roblems.Source Control
Source Control Interface on WindowsSource Control Interface on WindowsIf you use source control systems to manage yo ur file s, you can interfacewith
9 Source Control InterfaceSetting Up the Source Control Interface on WindowsIn this section...“Create Projects in Source Control System” on page 9-4“S
Setting Up the Source Control Interface on WindowsThe following illustration shows the example project in the source controlsystem.To set the working
9 Source Control InterfaceSpecify Source Control System in MATLABIn MATLAB, specify the source control system you want to access. SelectFile > Pref
Setting Up the Source Control Interface on WindowsMATLAB remem be rs preferences between sessions, so you only need toperform this action again when y
Arranging the DesktopSummary of Actions for Arrang ing DocumentsThis table summarizes actions for arranging documents in their tool. Forfurther inform
9 Source Control InterfaceThe following example shows Microsoft Visual SourceSafe.3 In the resulting Name_of_Source_Control_System Login dialog box,pr
Setting Up the Source Control Interface on Windows4 In the resulting Choose project fromName_of_Source_Control_System dialog box, selectthe source con
9 Source Control Interface2 Right-click, and from the context menu, select Source Control > Addto Source Control.3 The resulting Add to source cont
Checking Files Into and Out o f Source Control from MATL AB on WindowsChecking Files Into and Out of Source Control fromMATLAB on WindowsIn this secti
9 Source Control InterfaceCheck Files Out of Source ControlFrom M ATLAB, to che ck out the files you want to mo dify, perform these steps:1 In the Cur
Checking Files Into and Out o f Source Control from MATL AB on WindowsFunction AlternativeThe function alternative is verctrl with the checkout argume
9 Source Control InterfaceAdditional Source Control Actions on WindowsIn this section...“Getting the Latest Version of Files for Viewing or Compiling”
Additional Source Control Actions on Windows2 Right-click, and from the context menu, select Source Control > GetLatest Version.The MATLAB Getlates
9 Source Control Interface3 Click OK.Function AlternativeThe function alternative is verctrl with the remove argument.Showing File HistoryTo show the
Additional Source Control Actions on WindowsA d ialog box, which is specific to your source control system, opens. ForMicrosoft Visual SourceSafe, the
2 DesktopDocument Action OverviewNavigating amongdocumen t s — thedocument barWhen more than one document is open within a to ol, each document iseith
9 Source Control InterfaceThe history presented depends on your source control system. For M icrosoftVisual SourceSafe, the History dialog box opens f
Additional Source Control Actions on Windows2 Right-click, and from the context menu, select SourceControl > Differences.A d ialog box, which is sp
9 Source Control InterfaceFunction AlternativeThe function alternative isverctrl with the showdiff or isdiff argument.Viewing Source Con trol Properti
Additional Source Control Actions on WindowsA dialog box, which is specific to your source control system, opens. Thefollowing example shows the Micro
9 Source Control Interface1 Right-click any directory or file in the MATLAB Current Directory browser2 From the context menu, select Source Control &g
Perfor ming Source Control Actions from the Editor/Debugger, Simulink, or Stateflow o n WindowsPerforming Source Control Actions from theEditor/Debugg
9 Source Control InterfaceTroubleshooting Source Control Problems on WindowsIn this section...“Source C ontrol Error: Provider Not Present or Not Inst
Troubleshooting Sour ce Control Problems on Windowsinstalled on a server for a group to u se, each machine client can run a setupbut is no t required
9 Source Control InterfaceSource Control Interface on UNIXIf you use a source control system to manage your files, y ou can check M-filesand Simulink
SpecifyingtheSourceControlSystemonUNIXSpecifying the Source Control System on UNIXIn this section...“MATLAB Alternative” on page 9-27“Function Alterna
Arranging the DesktopDocument Action OverviewClosing documents To close a document, click the Close box in the document’s title bar.After closing all
9 Source Control InterfaceMATLAB remem be rs preferences between sessions, so you only need toperform this action when you want to access a different
SpecifyingtheSourceControlSystemonUNIXSetting a V iew and Checking Out a Director y withClearCaseonUNIXIf you use ClearCase on a UNIX platform, perfor
9 Source Control InterfaceChecking Files Into the Source Control System o n UNIXIn this section...“Checking In O ne or More Files Using the Current Di
Checking Files Into the Source Contro l S ystem on UNIXThe files are checked into the source control system. If any file containsunsaved changes when
9 Source Control InterfaceFunction AlternativeUse checkin to check files into the source control system. The files can beopen or closed when you usech
Checking Files Out of the Source Control System on UNIXChecking Files Out of the Source Control System on UNIXIn this section...“Checking Out One or M
9 Source Control Interfacec To pre vent others from checking out the f iles while you have themchecked out, select Lock latest version. To check out r
Checking Files Out of the Source Control System on UNIXFor filen, use the com plete p ath and include the file extension.Use theoption argument to• C
9 Source Control InterfaceUndoing the Checkout on UNIXIn this section...“Impact of U ndoing a File Checkout” on page 9-36“Undoing the Checkout for One
Undoing the Checkout on UNIX2 Select File > Source Control > Undo Checkout. MATLAB undoes thechecko ut.Function AlternativeThe undocheckout func
Other Startup Topics ... 1-21Error Log Reporter... 1-21Passing Perl Variables on Startup...
2 DesktopTo use a predefined layout, select Desktop > Desktop Layout,andchooseaconfiguration. See more details in the online documentation.To save
9 Source Control Interface9-38
IndexIndex%comment symbol 6-16create comment 6-17, after functions 3-30; after functions 3-30! function 3-9argument length restrictions 3-10%% 6-135{%
Indexin Help browser 4-24Boolean searching in Help browser 4-21breaking long lines 3-18breaking out of a running program 3-9breakpointsanonymous funct
IndexclearingCommand Window 3-32variables 5-8clicking on multiple item s 2-50clipboard 2-51closingdesktop tools 2-7M-files 6-64MATLAB 1-23code analyze
IndexEditor/Debugger 6-21compressionMAT-files and Fig-Files 2-79conditional breakpoints 6-126configuration managementSee source control system interfa
Indexdelimitermatching in Editor/Debugger 3-46delimiter matchingpreferences 3-46demosusing 4-31Demossearching 4-16desktopcolor preference s 2-70config
Indexarranging documents 6-11closing 6-13closing files 6 -64description 6-7example 6-104go tobookmark 6-43function 6-42line number 6-42horizontal line
Indexfatal error 1-24favorites in Help b rows er 4-24feedback to The MathWorks 4-54Fig-filescompatibility 2-79save options 2-79file exchangefor M-file
Indexembedding in M-book 8-49in M-books 8-49within cell 8-14gray background color in desktop 2-73gray breakpoint icons 6-109gray lines in Editor/Debug
IndexHelp browser 4-13results 4-15tips 4-15initiation (init) file for MATLAB 1-12inline linkswithin cell 8-22inputto MATLAB in Command Window 3-3input
Examples of Desktop ArrangementsExamples of Desktop ArrangementsIn this section...“About These Examples” on page 2-16“Tool Outside of Desktop and Othe
Indexline wrapping 3-42lines (gray) Editor/Debugger 6-136linksCommand Window 3-13in Help browser 4-28listswithin cell 8-14load 5-7locking files on che
IndexMAT-filescompatibility 2-79compression options 2-79creating 5-5defined 5-5loading 5-7preferences 2-79starting MATLAB from 1-2view without loading
Indexoutput 3-31preferences 3-41O%#ok indicator to suppress M-Lint message 7-17open 5-48opening filesCurrent Directory browser 5-47openvar 5-14operati
IndexCommand History window contents 3-57Command Window contents 3-33documentation 4-42help 4-42M-files 6-64printing an M-bookcell markers 8-47color 8
IndexSsavefunction 5-6savingautomatically in Editor/Debugger 6-63M-files 6-62MAT-filespreferences 2-79workspace upon quitting 1-24screen reader 2-87sc
Indexsource control on UNIX p latform sgetting files 9-33locking files 9-33source control system interface 9-1UNIX platforms 9-26preferences 9-27selec
Indexstyles in M-bookmodifying 8-47subfunctiondisplayed in Editor/D ebugger status bar 6-31subfunctionsgoing to in M-file 6-42suggestions to The MathW
IndexUUNC (Universal Naming Convention)pathname 7-3uncomment 6-16Undefine Cells 8-60undoin desktop 2-51in Editor 6-15undocking tools from d esktop 2-7
Indexopening 5-7protecting integrity 8-34saving 5-5tool 5-2viewing 5-3viewing during execution 6-114Workspace browserdescription 5-2plotting variables
2 DesktopAbout These ExamplesScan the illustrations in the following examples for a desktop arrangementsimilar to what you want, and then follow the b
Examples of Desktop ArrangementsHelp browser is undocked from desktop to providea large area for viewing documentation when needed.Four tools in the d
2 DesktopMaximized Tool in Desktop ExampleThis example shows a way you can temporarily increase the size of a tool sothat it occupiesthe entire area o
Examples of Desktop ArrangementsMaximized, the Command Window now occupies the full desktop area.Restoring the Command Window returns it to its origin
2 DesktopMinimized Toolsin Desktop ExampleMinimize a tool inthedesktoptogivetheremainingdesktoptoolsmorespacein the desktop. Minimizing is available o
Examples of Desktop ArrangementsWhen minimized, a tool, such as the Command Window in this example,is represented by a button on the desktop border.Th
2 DesktopHover over or click the button for a minimized tool to temporarily view or use the tool.The tool is temporarily displayed until you select an
Examples of Desktop ArrangementsOn the button for a minimized tool, right-click, and from the context menu,select Restore.The tool resumes the size an
Examples of Useful Shortcuts ... 2-32Creating Shortcuts... 2-33Running Shortcuts...
2 DesktopTiled Documentsin Desktop ExampleWhenyouopenadocument (for ex ample, an M-file), it also opens the tool (forexample, the Editor/Debugger) if
Examples of Desktop ArrangementsThe shortcuts toolbar is hidden.The document bar is at the topedge of the Editor/Debugger.Select a button from the lis
2 DesktopNo Empty Document Tiles ExampleToseemorethantwo documents a t once, select the T ile button and move thepointer across the gird that appears
Examples of Desktop ArrangementsMaximized Documents Outside of the DesktopExampleThis example illus trates a way to provide a la rge area for multiple
2 Desktop• A ccess any document in the Editor/Debugger using the document bar.To show the document b ar on the left side of the Edito r/Debugger,selec
Examples of Desktop ArrangementsDock figures in the desktop and use the float option to arrange them within a Figures group.The document bar is hidden
2 DesktopUndocked Tools and Documents ExampleYou can use toolsand documents outside of the desktop. One way toachieve this is to first undock the to o
Examples of Desktop Arrangements2-31
2 DesktopShor tcuts for MATLAB — Easily Run a Group of StatementsIn this section...“What Is a Shortcut?” on page 2-32“Examples of Useful Shortcuts” on
Shortcuts for MATLAB — Easily Run a Group of Statementscreate a shortcut for even a single function they use frequently, such asclc to clear the Comma
Syntax Highlighting Colors ... 2-73Other Colors... 2-75See Also...
2 Desktopthe Editor/Debugger preferences for ke y bindings, colors, and fonts.Note that if you copy the stateme nts from the Command Window, theprompt
Shortcuts for MATLAB — Easily Run a Group of StatementsFor more informa ti on on the options in the Shortcut E di tor dialog box, clickthe Help button
2 Desktop1 Select statemen ts from the C ommand History windo w, the C ommandWindow, or an M-file.2 Drag the selection to the desktop Shortcuts toolba
Shortcuts for MATLAB — Easily Run a Group of Statements4 Click the icon on the Shortcuts toolbar to run the shortcut. You can alsorun the shortcut fro
2 DesktopWhen y ou move the mouse ove r a shortcut icon , its label appears as a tooltip.To make la bels display in the toolbar, righ t- click the too
Shortcuts for MATLAB — Easily Run a Group of StatementsChanges take effect immediately.3 Click Close.For more information about using the Shortcuts Or
2 DesktopKeyboard Shor tcutsIn this section...“Keyboard Shortcuts (Accelerators or Hot Keys) and Mnemonics” on page2-40“Go To First Letter (Type Ahead
Keyboard ShortcutsWindows 2000, go to Display Control Panel, select Effects, and clear theitem Hide keyboard navigation indicators until I use the Alt
2 DesktopKey ResultCtrl+Shift+Tab Moves to the prev ious open tool or group of tabbed tools in the desktop.Ctrl+Page Down Moves to the next tool withi
Keyboard Shortcuts2-43
Cut,Copy,Paste,andUndoFeatures ... 3-17Enter Multiple Lines Without Running Them... 3-18Entering Multiple Functions in a Line...
2 DesktopOther Desktop FeaturesIn this section...“Start Button for Accessing Tools” on page 2-44“Menus and Context Menus” on page 2-46“Toolbars” on pa
Other Desktop Features2 From the menu and s ubmenu items, select an item to open it. Use the iconsto quickly locate a type of product or tool — see th
2 DesktopIcon Description of Action When OpenedBlock library opens.Document opens in your system Web browser.Customizing the Start ButtonYou can add y
Other Desktop FeaturesToolbarsThe toolbar in the desktop provides easy access to frequently used operations.Position the p ointe r over a button for a
2 DesktopSome tools also h ave their own toolbars, which are located within the tool’sown window. For example, the Current Directory browser has its o
Other Desktop FeaturesStatus BarAlong the bottom of the desktop is the status bar. It displays messages,such as when MATLAB is busy executing statemen
2 DesktopSelecting Multiple ItemsIn many desktop tools, you can select multiple items and then select an actionto perform on all the selected items. S
Other Desktop FeaturesCut, Copy, Paste,andMoveYo u can cut and copy a selection from a desktop tool to the clipboard and thenpaste it from theclipboar
2 Desktopcan drag selections from desktop tools to other applications. For example, youcan drag text from the Editor/Debugger to Microsoft Word.Macint
Other Desktop Features• “ Fonts O ptions for Page Setup” on pag e 2- 54Specifying Page Setup OptionsTo specify page setup options, perform these steps
Komentarze do niniejszej Instrukcji