Documentation

matlab (Windows)

StartMATLABprogram fromWindowssystem prompt

Syntax

matlab
matlab option1 ... optionN

Description

matlabstarts the MATLAB®program from the Microsoft®Windows®system prompt. Here the termmatlabrefers to the command you type, and MATLAB refers to the program).

Thematlabcommand:

  • Determines the MATLAB root folder, the value returned by thematlabrootfunction.

  • Processes command-line options and passes other options to MATLAB.

example

matlaboption1 ... optionNstarts MATLAB with the specified startup options.

Input Arguments

expand all

一个或多个启动选项, specified as strings corresponding to valid startup options from the following tables.

Display Options

Option Result
-noFigureWindows

Disable the display of figure windows in MATLAB.

-nosplash

Do not display the splash screen during startup.

Execute MATLAB Script or Function

Option Result

-rstatement

Execute the MATLABstatement,指定为一个撑g or as the name of a MATLAB script or function. Ifstatementis MATLAB code, enclose the string with double quotation marks. Ifstatementis the name of a MATLAB function or script, do not specify the file extension and do not use quotation marks. Any required file must be on the MATLAB search path or in the startup folder.

Example:-r "disp(['Current folder: ' pwd])"

Example:-r myscript

Set Initial Working Folder

The initial working folder is the current folder when MATLAB starts. For more information, seeMATLAB Startup Folder.

Option Result

-sdfolder

Set the MATLAB startup folder tofolder,指定为一个撑g.

Example:matlab -sd "C:\work"

-useStartupFolderPref

Set the MATLAB startup folder to the value specified by theInitial working folderoption in theGeneral Preferencespanel.

Debugging Options

Option Result

-logfilefilename

Copy Command Window output, including error log reports, in tofilename,指定为一个撑g.

Example:-logfile output.log

-jdbportnumber

Enable use of the Java®debugger. The Java debugger uses the defaultportnumbervalue 4444 to communicate with MATLAB.

The port number is optional. However, to use the Java debugger while running multiple MATLAB sessions, you must provide a port number. Theportnumbervalue must be an integer in the range 0–65535. The integer cannot be reserved or currently in use by another application on your system.

Use Single Computational Thread

By default, MATLAB uses the multithreading capabilities of the computer on which it is running.

Option Result
-singleCompThread

Limit MATLAB to a single computational thread.

Disable Searching Custom Java Class Path

Option Result
-nouserjavapath

Disable use ofjavaclasspath.txtandjavalibrarypath.txtfiles. For more information, seeSpecifying Java Startup Options.

OpenGLLibrary Options

These options control the use of software OpenGL®libraries when MATLAB detects a graphics driver with known issues. For more information, seeGraphics Features with OpenGL Requirements.

Option Result
-softwareopengl

Force MATLAB to start with software OpenGL libraries.

-nosoftwareopengl

Disable auto-selection of OpenGL software.

COM Automation Server Options

Option Result

-automation

Start MATLAB as a Component Object Model (COM) Automation server. MATLAB does not display the splash screen and minimizes the window. Use for a single call to MATLAB.

-regserver

Register MATLAB as a COM Automation server in the Windows registry. MATLAB displays a minimized command window; close this window.

You must have administrator privileges to change the Windows registry. Based on your User Account Control (UAC) settings, you might need to right-click a Windows Command Processor and selectRun as administrator. If that option is not available, contact your system administrator.

MATLAB remains registered until you use the-unregserveroption.

Alternatively, you can register MATLAB from the MATLAB command prompt. Type:

!matlab -regserver
MATLAB displays a minimized command window. To continue working with MATLAB, open this window and exit MATLAB.

-unregserver

Remove MATLAB COM server entries from the registry.

Wait forMATLABto Terminate

By default, when you call thematlab从脚本命令,命令开始MATLABnd then immediately executes the next statements in the script. The-waitoption pauses the script until MATLAB terminates.

Option Result

-wait

Use in a startup script to process the results from MATLAB. Calling MATLAB with this option blocks the script from continuing until the results are generated.

Specify License File

For more information, see Understanding License Files in theLicense Management(Installation, Licensing, and Activation) documentation.

Option Result

-clicense

Use the License File,license,指定为一个撑g, a colon-separated list of license file names, or aport@hostentry. If specifying multiple files, separate the names by semicolons and enclose the entire list in quotation marks. If the path to your license file contains a space, enclose the path name in quotation marks.

Example:-c "c:\TMW license\license_agreement.txt"

Open Student Version

Option Result

-student

Open student version of MATLAB.

Help Options

Option Result
-h

Display startup options without starting MATLAB.

-help

Same as-hoption.

-?

Same as-hoption.

Examples

expand all

matlab -nosplash
matlab -logfile output.log

Tips

Was this topic helpful?