Learn R Programming
R.matlab (version 3.3.0)

Matlab$startServer: Static method which starts a MATLAB server

Description

Static method which starts a MATLAB server on the local machine. Note that MATLAB v6 or later is required, since the MATLAB server relies on Java.

Usage

## Static method (use this):
## Matlab$startServer(matlab=getOption("matlab"), port=9999, minimize=TRUE,
##   options=c("nodesktop", "nodisplay", "nosplash"), workdir=".", ...)
## Don't use the below:
## S3 method for class 'Matlab':
startServer(this, matlab=getOption("matlab"), port=9999, minimize=TRUE,
  options=c("nodesktop", "nodisplay", "nosplash"), workdir=".", ...)

Arguments

matlab
An optional character string specifying the name of the matlab command, if different from "matlab". An absolute path are possible.
port
An optional integer in [1023,65535]. If given, the environment variable MATLABSERVER_PORT is set specifying which port the MATLAB server should listen to for clients trying to conn
minimize
When starting MATLAB on Windows, it is always opened in a new window (see 1. The MATLAB server running in MATLAB). If this argument is
options
A character vector of options used to call the MATLAB application.
workdir
The working directory to be used by MATLAB.
...
Not used.

Value

  • Returns nothing.

Details

This method is currently supported on Windows and Unix systems. Other systems are untested, but might work anyway.

Note that this method will return immediately upon calling system() internally, i.e. you will not receive a return value telling wether MATLAB was successfully started or not.

To specify the full path to the matlab software set the matlab option, e.g. options(matlab="/opt/bin/matlab6.1"). If no such option exists, the value "matlab" will be used.

The MATLAB server relies on two files: 1) MatlabServer.m and 2) InputStreamByteWrapper.class These files exists in the externals/ and java/ directories of this package. However, if they do not exist in the current directory, which is the directory where MATLAB is started, copies of them will automatically be made.

See Also

For more information see Matlab.