The R.

matlab Package
April 11, 2007
Version 1.1.3

Date 2007-04-07

Title Read and write of MAT files together with R-to-Matlab connectivity

Author Henrik Bengtsson <[email protected]>

Maintainer Henrik Bengtsson <[email protected]>

Depends R (>= 2.0.0), R.oo

Suggests R.utils

Description This package provides methods to read and write MAT files. It also makes it possible to
communicate (evaluate code, send and retrieve objects etc.) with Matlab v6 or higher running
locally or on a remote host.

License LGPL version 2.1 or newer (the releases)

URL http://www.braju.com/R/

DevelURL http://www.maths.lth.se/help/R/

LazyLoad TRUE

R topics documented:
1. The Matlab server running in Matlab . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Matlab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Non-documented objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
R.matlab-package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Sys.setenv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
as.character.Matlab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
close.Matlab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
evaluate.Matlab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
finalize.Matlab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
getOption.Matlab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
getVariable.Matlab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

1
2 1. The Matlab server running in Matlab

isOpen.Matlab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
open.Matlab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
readMat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
readResult.Matlab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
setFunction.Matlab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
setOption.Matlab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
setVariable.Matlab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
setVerbose.Matlab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
startServer.Matlab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
writeCommand.Matlab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
writeMat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

Index 36

1. The Matlab server running in Matlab

1. The Matlab server running in Matlab

Description
This section gives addition details on the Matlab server. At the end, the MatlabServer.m script and
the InputStreamByteWrapper.java code is shown.

Starting the Matlab server on Windows

Note that you "cannot prevent Matlab from creating a window when starting on Windows systems,
but you can force the window to be hidden, by using " the option -minimize. See http://www.
mathworks.com/support/solutions/data/1-16B8X.html for more information.

MatlabServer.m script

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% MatlabServer
%
% This scripts starts a minimalistic Matlab "server".
%
% When started, the server listens for connections at port 9999 or the
% port number specified by the environment variable 'MATLABSERVER_PORT'.
%
% Troubleshooting: If not working out of the box, add this will to the
% Matlab path. Make sure InputStreamByteWrapper.class is in the same
% directory as this file!
%
% Requirements:
% This requires Matlab with Java support, i.e. Matlab v6 or higher.
%
% Author: Henrik Bengtsson, 2002-2006
1. The Matlab server running in Matlab 3

%
% References:
% [1] http://www.mathworks.com/access/helpdesk/help/techdoc/
% matlab_external/ch_jav34.shtml#49439
% [2] http://staff.science.uva.nl/~horus/dox/horus2.0/user/
% html/n_installUnix.html
% [3] http://www.mathworks.com/access/helpdesk/help/toolbox/
% modelsim/a1057689278b4.html
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

% addpath R/R_LIBS/linux/library/R.matlab/misc/

% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
% Matlab version-dependent setup
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
isVersion7 = eval('length(regexp(version, ''^7'')) ~= 0', '0');
if (~isVersion7)
disp('Matlab v6.x detected.');
% Default save option
saveOption = '';
% In Matlab v6 only the static Java CLASSPATH is supported. It is
% specified by a 'classpath.txt' file. The default one can be found
% by which('classpath.txt'). If a 'classpath.txt' exists in the
% current(!) directory (that Matlab is started from), it *replaces*
% the global one. Thus, it is not possible to add additional paths;
% the global ones has to be copied to the local 'classpath.txt' file.
%
% To do the above automatically from R, does not seem to be an option.
else
disp('Matlab v7.x or higher detected.');
% Matlab v7 saves compressed files, which is not recognized by
% R.matlab's readMat(); force saving in old format.
saveOption = '-V6';
disp('Saving with option -V6.');

% In Matlab v7 both static and dynamic Java CLASSPATH:s exist.

% Using dynamic ones, it is possible to add the file
% InputStreamByteWrapper.class to CLASSPATH, given it is
% in the same directory as this script.
javaaddpath({fileparts(which('MatlabServer'))});
disp('Added InputStreamByteWrapper to dynamic Java CLASSPATH.');
end

% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
% Import Java classes
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
import java.io.*;
4 1. The Matlab server running in Matlab

import java.net.*;

% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
% If an old Matlab server is running, close it
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
% If a server object exists from a previous run, close it.
if (exist('server'))
close(server);
clear server;
end

% If an input stream exists from a previous run, close it.

if (exist('is'))
close(is);
clear is;
end

% If an output stream exists from a previous run, close it.

if (exist('os'))
close(os);
clear os;
end

fprintf(1, '----------------------\n');
fprintf(1, 'Matlab server started!\n');
fprintf(1, '----------------------\n');

% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
% Initiate server socket to which clients may connect
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
port = getenv('MATLABSERVER_PORT');
if (length(port) > 0)
port = str2num(port);
else
% Try to open a server socket on port 9999
port = 9999;
end

% Ports 1-1023 are reserved for the Internet Assigned Numbers Authority.
% Ports 49152-65535 are dynamic ports for the OS. [3]
if (port < 1023 | port > 65535)
error('Cannot not open connection. Port (''MATLABSERVER_PORT'') is out of range [
end

fprintf(1, 'Trying to open server socket (port %d)...', port);

server = ServerSocket(port);
1. The Matlab server running in Matlab 5

fprintf(1, 'done.\n');

% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
% Wait for client to connect
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
% Create a socket object from the ServerSocket to listen and accept
% connections.
% Open input and output streams

% Wait for the client to connect

clientSocket = accept(server);

fprintf(1, 'Connected to client.\n');

% ...client connected.
is = DataInputStream(getInputStream(clientSocket));
%is = BufferedReader(InputStreamReader(is0));
os = DataOutputStream(getOutputStream(clientSocket));

% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
% The Matlab server state machine
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
% Commands
commands = {'eval', 'send', 'receive', 'send-remote', 'receive-remote', 'echo'};

% As long as we receive data, echo that data back to the client.

state = 0;
while (state >= 0),
if (state == 0)
cmd = readByte(is);
fprintf(1, 'Received cmd: %d\n', cmd);
if (cmd < -1 | cmd > length(commands))
fprintf(1, 'Unknown command code: %d\n', cmd);
else
state = cmd;
end

%-------------------
% 'eval'
%-------------------
elseif (state == strmatch('eval', commands, 'exact'))
bfr = char(readUTF(is));
fprintf(1, '"eval" string: "%s"\n', bfr);
try
eval(bfr);,
6 1. The Matlab server running in Matlab

writeByte(os, 0);
fprintf(1, 'Sent byte: %d\n', 0);
flush(os);
catch,
fprintf(1, 'EvaluationException: %s\n', lasterr);
writeByte(os, -1);
fprintf(1, 'Sent byte: %d\n', -1);
writeUTF(os, lasterr);
fprintf(1, 'Sent UTF: %s\n', lasterr);
flush(os);
end
flush(os);
state = 0;

%-------------------
% 'send'
%-------------------
elseif (state == strmatch('send', commands, 'exact'))
tmpname = sprintf('%s.mat', tempname);
expr = sprintf('save %s %s', tmpname, saveOption);
ok = 1;
for k=1:length(variables),
variable = variables{k};
if (exist(variable) ~= 1)
lasterr = sprintf('Variable ''%s'' not found.', variable);
ok = 0;
break;
end;
expr = sprintf('%s %s', expr, variable);
end;
if (~ok)
writeInt(os, -1);
writeUTF(os, lasterr);
else
disp(expr);
eval(expr);
writeUTF(os, tmpname);
end

answer = readByte(is);
fprintf('answer=%d\n', answer);

state = 0;

%-------------------
% 'send-remote'
%-------------------
elseif (state == strmatch('send-remote', commands, 'exact'))
1. The Matlab server running in Matlab 7

tmpname = sprintf('%s.mat', tempname);

expr = sprintf('save %s %s', tmpname, saveOption);
ok = 1;
for k=1:length(variables),
variable = variables{k};
if (exist(variable) ~= 1)
lasterr = sprintf('Variable ''%s'' not found.', variable);
ok = 0;
break;
end;
expr = sprintf('%s %s', expr, variable);
end;
if (~ok)
writeInt(os, -1);
writeUTF(os, lasterr);
else
disp(expr);
eval(expr);
file = File(tmpname);
maxLength = length(file);
clear file;
writeInt(os, maxLength);
fprintf(1, 'Send int: %d (maxLength)\n', maxLength);
fid = fopen(tmpname, 'r');
count = 1;
while (count ~= 0)
[bfr, count] = fread(fid, 65536, 'int8');
if (count > 0)
write(os, bfr);
% fprintf(1, 'Wrote %d byte(s).\n', length(bfr));
end;
end;
fclose(fid);
% fprintf(1, 'Wrote!\n');
fprintf(1, 'Send buffer: %d bytes.\n', maxLength);
delete(tmpname);
clear bfr, count, maxLength, fid, tmpname;
end
flush(os);

answer = readByte(is);
fprintf('answer=%d\n', answer);

state = 0;

%-------------------
% 'receive-remote'
%-------------------
8 1. The Matlab server running in Matlab

elseif (state == strmatch('receive-remote', commands, 'exact'))

len = readInt(is);
fprintf(1, 'Will read MAT file structure of length: %d bytes.\n', len);

reader = InputStreamByteWrapper(4096);
bfr = [];
count = 1;
while (len > 0 & count > 0)
count = reader.read(is, min(4096, len));
if (count > 0)
bfr = [bfr; reader.bfr(1:count)];
len = len - count;
end;
end;

clear reader count len;

tmpfile = sprintf('%s.mat', tempname);

% tmpfile = 'tmp2.mat';
% disp(bfr');
% disp(tmpfile);
fh = fopen(tmpfile, 'wb');
fwrite(fh, bfr, 'int8');
fclose(fh);

clear fh, bfr;

load(tmpfile);

delete(tmpfile);
clear tmpfile;
writeByte(os, 0);

state = 0;

%-------------------
% 'receive'
%-------------------
elseif (state == strmatch('receive', commands, 'exact'))
filename = char(readUTF(is));
fprintf(1, 'Will read MAT file: "%s"\n', filename);
load(filename);
clear filename;
writeByte(os, 0);
state = 0;
end
end
1. The Matlab server running in Matlab 9

% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
% Shutting down the Matlab server
% - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

fprintf(1, '-----------------------\n');
fprintf(1, 'Matlab server shutdown!\n');
fprintf(1, '-----------------------\n');
writeByte(os, 0);
close(os);
close(is);
close(server);

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% HISTORY:
% o Extended the accepted range of ports from [1023,49151] to [1023,66535].
% 2006-05-08
% o BUG FIX: The error message string for reporting port out of range
% was invalid and gave the error '... Line: 109 Column: 45 ")" expected,
% "identifier" found.'. Thanks Alexander Nervedi for reporting this.
% 2006-01-21
% o Now an error is thrown if port number is out of (safe) range.
% o Added option to specify the port number via the system environment
% variable MATLABSERVER_PORT, after request by Wang Yu, Iowa State Univ.
% 2005-03-08
% o BUG FIX: substring() is not recognized by Matlab v7. Using regexp()
% which works in Matlab 6.5 and 7. Workaround eval('try', 'catch').
% Thanks Patrick Drechsler, University of Wuerzburg for the bug report.
% 2005-02-24
% o Now the dynamic Java classpath is set for Matlab v7 or higher. This
% will simplify life for Matlab v7 users.
% 2005-02-22
% o Added javaaddpath() to include InputStreamByteWrapper.class.
% Thanks Yichun Wei for feedback and great suggestions.
% 2005-02-11
% o If Matlab v7 or higher is detected, all MAT structures are saved with
% option '-V6' so readMat() in R.matlab can read them.
% 2002-09-02 [or maybe a little bit earlier]
% o Created.
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

InputStreamByteWrapper.(class|java) script

The Java class InputStreamByteWrapper is needed in order for Matlab to receive data via a data
stream. R sends data via a data stream if, and only if, the connection was setup for "remote"
10 1. The Matlab server running in Matlab

communication, that is, with argument remote=TRUE).

import java.io.*;

/*********************************************************************
% Compile from within Matlab with:
% !javac InputStreamByteWrapper.java

% Matlab example that reads a file using Java code and writes it
% back to a temporary file using Matlab code. Finally the contents
% of the new file is displayed.

reader = InputStreamByteWrapper; % Default buffer size is 4096 bytes.

in = java.io.FileInputStream('InputStreamByteWrapper.java');

bfr = [];
len = 1;
while (len > 0)
len = reader.read(in, 16); % Read 16 bytes at the time (offset=0).
if (len > 0)
bfr = [bfr; reader.bfr(1:len)]; % Add bytes to my Matlab buffer.
end
end

close(in);
clear in, reader;

disp(bfr');

tmpfile = tempname;
fh = fopen(tmpfile, 'wb');
fwrite(fh, bfr, 'char');
fclose(fh);

type(tmpfile);
*********************************************************************/
public class InputStreamByteWrapper {
public static byte[] bfr = null;

public InputStreamByteWrapper(int capasity) {

bfr = new byte[capasity];
}

public InputStreamByteWrapper() {
this(4096);
}
Matlab 11

public int read(InputStream in, int offset, int length) throws IOException {
return in.read(bfr, offset, length);
}

public int read(InputStream in, int length) throws IOException {

return read(in, 0, length);
}

public int read(InputStream in) throws IOException {

return in.read(bfr);
}
}

/*********************************************************************
HISTORY:
2002-09-02 [or maybe a little bit earlier]
o Created.
*********************************************************************/

Matlab Matlab client for remote or local Matlab access

Description
Package: R.matlab
Class Matlab

Object
~~|
~~+--Matlab

Directly known subclasses:

public static class Matlab

extends Object

Usage
Matlab(host="localhost", port=9999, remote=!(host %in% c("localhost", "127.0.0.1"))
12 Matlab

Arguments
host Name of host to connect to.
port Port number on host to connect to.
remote If TRUE, all data to and from the Matlab server will be transferred through the
socket connection, otherwise the data will be transferred via a temporary
file.

Fields and Methods

Methods:

as.character Gets a string describing the current Matlab connection.

close Closes connection to Matlab server.
evaluate Evaluates a Matlab expression.
finalize Finalizes the object if deleted.
getOption Gets the value of an option.
getVariable Gets one or several Matlab variables.
isOpen Checks if connection to the Matlab server is open.
open Tries to open a connection to the Matlab server.
readResult Reads results from the Matlab server.
setFunction Defines a Matlab function.
setOption Sets the value of an option.
setVariable Sets one or several Matlab variables.
setVerbose Sets the verbose level to get more details about the Matlab access.
startServer Static method which starts a Matlab server.
writeCommand Writes (sends) a command to the Matlab server.

Methods inherited from Object:

,<-, [[, [[<-, as.character, attach, attachLocally, clearCache, clone, detach, equals, extend, final-
ize, gc, getEnvironment, getFields, getInstanciationTime, getStaticInstance, hasField, hashCode, ll,
load, objectSize, print, save

Requirements

In order for R to communicate with Matlab, Matlab v6 or higher is needed. It will not work with
previous versions, because they do not support Java!

We use the term server to say that Matlab acts like a server with regard to R. Note that it a standard
Matlab session that runs.

Also, the starting of the MatlabServer is simplier from Matlab v7, although it is pretty straightfor-
ward for Matlab v6 too (this has to do with the fact that in Matlab v7, the for remote-data-transfer
required Java class can be dynamically added to the Matlab Java classpath).
Matlab 13

Remote and non-remote connections

When a remote connection (argument remote=TRUE) is used, data is send to and from Matlab via
a data stream. This is needed when R is running on a host with a seperated file system than the one
Matlab is running on.
If not connection "remotely" (remote=FALSE), data is communicated via the file system, that is,
by saving and reading it to temporary MAT files.

Troubleshooting: If "remote" transfers are used, the InputStreamByteWrapper Java class must be
found by Matlab, otherwise an error will occur in Matlab as soon as data is send from R to Matlab.
In all other cases, the above Java class is not needed.

Starting the Matlab server from within R

The Matlab server may be started from within R by calling Matlab$startServer(). By de-
fault ’matlab’ is called; if named differently set options(matlab="matlab6.5"), say. The
method is experimental and may not work on your system. By default the Matlab server listens for
connections on port 9999. For other ports, set argument port, e.g. Matlab$startServer(port=9998).
Note that the code will not halt and wait for Matlab to get started. Thus, you have to make sure
you will wait long enough for the server to get up and running before the R client try to connect.
By default, the client will try once a second for 30 seconds before giving up. Moreover, on non-
Windows systems, the above command will start Matlab in the background making all Matlab
messages be sent to the R output screen. In addition, the method will copy the MatlabServer and
InputStreamByteWrapper files to the current directory and start Matlab from there.

Starting the Matlab server without R

If the above does not work, the Matlab server may be started manually from Matlab itself. Please
follow the below instructions carefully.
To be done once:
In Matlab, add the path to the directory where MatlabServer.m sits. See help pathtool in Mat-
lab on how to do this. In R you can type system.file("externals", package="R.matlab")
to find out the path to MatlabServer.m.
For Matlab v6 only: Contrary to Matlab v6, Matlab v6 cannot find the InputStreamByteWrapper
class automatically. Instead, the so called Java classpath has to be set. In Matlab, type which(’classpath.txt’)
to find where the default Matlab classpath.txt file is located. Copy this file to the current directory
and append the path (the directory) to InputStreamByteWrapper.class file, which is the same as the
path of the MatlabServer.m you identified above.

Lazy alternative: Instead of setting path and classpaths, you may try to copy the MatlabServer.m
and InputStreamByteWrapper.class to the current directory from which Matlab is then started.
To start the server:
In order to start the Matlab server, type

matlab -nodesktop -nosplash -r MatlabServer

If using Matlab v6, make sure your classpath.txt is the current directory!
14 Matlab

This will start Matlab and immediately call the MatlabServer(.m) script. Here is how it should look
like when the server starts:

< M A T L A B >
Copyright 1984-2004 The MathWorks, Inc.
Version 7.0.1.24704 (R14) Service Pack 1
September 13, 2004

To get started, type one of these: helpwin, helpdesk, or demo.

For product information, visit www.mathworks.com.

Matlab v7.x or higher detected.

Saving with option -V6.
Added InputStreamByteWrapper to dynamic Java CLASSPATH.
----------------------
Matlab server started!
----------------------
Trying to open server socket (port 9999)...done.

Alternatively you can start Matlab and type MatlabServer at the prompt.
By default the Matlab server listens for connections on port 9999. For other ports, set environment
variable MATLABSERVER_PORT.

Confirmed Matlab versions

This package has been confirmed to work successfully out of the box together with Matlab v6.1.0.450
(R12.1), Matlab v6.5.0.180913a (R13), Matlab v7.0.0.19901 (R14), Matlab v7.0.1.24704 (R14SP1),
Matlab v7.0.4.365 (R14SP2), and Matlab v7.2.0.232 (R2006a). [If you successfully use a higher
Matlab version, please tell us, so we can share it here.]
It does not work with Matlab v5 or before!

Security
There is no security in the communication with the Matlab server. This means that if you start the
Matlab server, it will wait for requests via the connection at the specified port. As long as your R
session has not connected to this port, others may be able to steal the connection and send malicious
commands (if they know the R.matlab protocol). The Matlab server only allows one connection. In
other words, if you are connected it is not possible for others to connect to the Matlab server.

Matlab server is timing out

It might be that an *evaluate() call to the Matlab server takes a long time for the server to finish
resulting in a time-out exception. By default this happens after 30 seconds, but it can be changed
by modifying options, cf. setOption().
Matlab 15

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

See Also
Stand-alone methods readMat() and writeMat() for reading and writing MAT file structures.

Examples
## Not run:
# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# This example will try to start the Matlab server on the local machine,
# and then setup a Matlab object in R for communicating data between R
# and Matlab and for sending commands from R to Matlab.
# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# Start Matlab server on the local machine (if this fails,
# see help(Matlab) for alternatives).
Matlab$startServer()

# Create a Matlab client object used to communicate with Matlab

matlab <- Matlab()

# If you experience any problems, ask for detailed outputs

# by uncommenting the next line
# setVerbose(matlab, -2)

# Connect to the Matlab server, which must already be running

if (!open(matlab))
throw("Matlab server is not running: waited 30 seconds.")

# Run Matlab expressions on the Matlab server

evaluate(matlab, "A=1+2;", "B=ones(2,20);")

# Get Matlab variables

data <- getVariable(matlab, c("A", "B"))
cat("Received variables:\n")
str(data)

# Set variables in Matlab

ABCD <- matrix(rnorm(10000), ncol=100)
str(ABCD)
setVariable(matlab, ABCD=ABCD)

# Retrieve what we just set

data <- getVariable(matlab, "ABCD")
cat("Received variables:\n")
str(data)

# Create a function (M-file) on the Matlab server

setFunction(matlab, " \
function [win,aver]=dice(B) \
%Play the dice game B times \
16 R.matlab-package

gains=[-1,2,-3,4,-5,6]; \
plays=unidrnd(6,B,1); \
win=sum(gains(plays)); \
aver=win/B; \
");

evaluate(matlab, "[w,a]=dice(1000);")
res <- getVariable(matlab, c("w", "a"))
print(res)

# When done, close the Matlab client, which will also shutdown
# the Matlab server and the connection to it.
close(matlab)

## End(Not run)

Non-documented objects
Non-documented objects

Description
This page contains aliases for all "non-documented" objects that R CMD check detects in this
package.
Almost all of them are generic functions that have specific document for the corresponding method
coupled to a specific class. Other functions are re-defined by setMethodS3() to default methods.
Neither of these two classes are non-documented in reality. The rest are deprecated methods.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

R.matlab-package Package R.matlab

Description
This package provides methods to read and write MAT files. It also makes it possible to communi-
cate (evaluate code, send and retrieve objects etc.) with Matlab v6 or higher running locally or on a
remote host.
In brief, this package provides a one-directional interface from R to Matlab, with communication
taking place via a TCP/IP connection and with data transferred either through another connection or
via the file system. On the Matlab side, the TCP/IP connection is handled by a small Java add-on.
The methods for reading and writing MAT files are stable. The R to Matlab interface, that is the
Matlab class, is less prioritized and should be considered a beta version.
For package history, see showHistory(R.matlab).
R.matlab-package 17

Requirements
This is a cross-platform package implemented in plain R. This package depends on the R.oo pack-
age [1].
To use the Matlab class or requesting verbose output messages, the R.utils package is loaded when
needed (and therefore required at in those cases).
The readMat() and writeMat() methods do not require a Matlab installation neither do they
depend on the Matlab class.
To connect to Matlab, Matlab v6 or higher is required. It does not work with Matlab v5 or before
(because there those version does not support Java). For confirmed Matlab versions, see help() on
the "Matlab" class.

Installation
To install this package do

install.packages("R.matlab")
Required packages are installed in the same way.
To get the "devel" version, see http://www.braju.com/R/.

To get started
To get started, see:
1. readMat() and writeMat() - For reading and writing MAT files (Matlab is not needed).
2. Matlab - To start Matlab and communicate with it from R.

Miscellaneous
A related initiative is RMatlab by Duncan Temple Lang and Omegahat. It provides a bi-directional
interface between the R and Matlab languages. For more details, see http://www.omegahat.
org/RMatlab/. To call R from Matlab on Windows (only), see MATLAB R-link by Robert Hen-
son available at the Matlab Central File Exchange (http://www.mathworks.com/matlabcentral/
fileexchange/loadFile.do?objectId=5051).

How to cite this package

Whenever using this package, please cite [2] as

@TECHREPORT{BengtssonH_2005,
author = {Bengtsson, Henrik},
title = {{R.matlab} - Local and remote {M}atlab connectivity in {R}},
institution = {Mathematical Statistics, Centre for Mathematical Sciences,
Lund University, Sweden},
year = {2005},
type = {{Preprint in Mathematical Sciences (manuscript in progress)}},
note = {[manuscript in progress]},
18 R.matlab-package

url = {http://www.maths.lth.se/help/R/R.matlab/},
}

Troubleshooting
In general:
For trouble shooting in general, rerun erroneous function with verbose/debug messages turned on.
For readMat() and writeMat() see their help. For communication with a Matlab server, use

matlab <- Matlab()

setVerbose(matlab, threshold=-2)

The lower the threshold is the more information you will see.

Cannot connect to Matlab:

If R fails to connect to Matlab, make sure to try the the example in help(Matlab) first. Make sure
that the Matlab server is running before trying to connect to it from R first. If Matlab is running but
open() times out, make sure Matlab is listening to the same port that R is trying to connect to. If
that does not help, try to increase the time-out limit, see help(open.Matlab).

Expected an ’answer’ from Matlab, but kept receiving nothing.:

When spawning a really long Matlab process by evaluate(), you may get the above error mes-
sage.
Reason: This happens because evaluate() expect a reply from Matlab as soon as Matlab is
done. The waiting should be "blocked", i.e. it should wait until it receives something. For un-
known reasons, this is not always happening. The workaround we have implemented is to try
readResult/maxTries waiting readResult/interval seconds inbetween.
Solution: Increase the total waiting time by setting the above options, e.g.

setOption(matlab, "readResult/interval", 10); # Default is 1 second

setOption(matlab, "readResult/maxTries", 30*(60/10)); # ~30 minutes

Wishlist
Here is a list of features that would be useful, but which I have too little time to add myself. Con-
tributions are appreciated.

• Add a function, say, Matlab$createShortcut() which creates a Windows shortcut to

start the Matlab server by double clicking it. It should be possible to create it in the current
directory or to the Desktop. Maybe it is possible to do this upon installation and even to a
Start -> All Programs -> R menu.
• To improve security, update the MatlabServer.m script to allow the user to specify a "pass-
word" to be send upon connection from R in order for Matlab to accept the connection. This
password should be possible to specify from the command line when starting Matlab. If not
given, no password is required.
• Add additional methods to the Matlab class. For instance, inline function in Matlab could
have its own method.
R.matlab-package 19

• Wrap up common Matlab commands as methods of the Matlab class, e.g. who(matlab),
clear(matlab) etc. Can this be done automatically using "reflection", so that required
arguments are automatically detected?
• Add support for reading (and writing) sparse matrices to be represented by the sparse matrix
class defined in the SparseM package.
• Add access to Matlab variables via "$" and "$<-", e.g. matlab$A and matlab$A <-
1234. Is this wanted? Maybe the same for functions, e.g. matlab$dice(1000). Is it
possible to return multiple return values?

If you consider implement some of the above, make sure it is not already implemented by down-
loading the latest "devel" version!

Acknowledgements

Thanks to the following people who contributed with valuable feedback, suggestions, and code:

• Patrick Drechsler, Biocenter, University of Wuerzburg.

• Andy Jacobson, Atmospheric and Oceanic Sciences Program, Princeton University.
• Chris Sims, Department of Economics, Princeton University.
• Wang Yu, ECE Department, Iowa State University.
• Yichun Wei, Department of Biological Sciences, University of Southern California.

License

The releases of this package is licensed under LGPL version 2.1 or newer.
The development code of the packages is under a private licence (where applicable) and patches sent
to the author fall under the latter license, but will be, if incorporated, released under the "release"
license above.

References

1 H. Bengtsson, The R.oo package - Object-Oriented Programming with References Using Standard R
Code, In Kurt Hornik, Friedrich Leisch and Achim Zeileis, editors, Proceedings of the 3rd Interna-
tional Workshop on Distributed Statistical Computing (DSC 2003), March 20-22, Vienna, Austria.
http://www.ci.tuwien.ac.at/Conferences/DSC-2003/Proceedings/

[2] Henrik Bengtsson, R.matlab - Local and remote Matlab connectivity in R, Mathematical Statis-
tics, Centre for Mathematical Sciences, Lund University, Sweden, 2005. (manuscript in progress).

Author(s)

Henrik Bengtsson (http://www.braju.com/R/)

20 as.character.Matlab

Sys.setenv Sys.setenv

Description
If you searched for help on Sys.setenv but got this page instead, you are most likely running R
v2.5.0 or newer. Then, see the above link or help(Sys.setenv, package="base").
The reason for adding the same to this package is that in R v2.4.x only Sys.putenv() is avail-
able. To make this package work on both system, Sys.setenv() is set to Sys.putenv() on
R v2.4.x and needs to be document in order for the package to pass the tests.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

as.character.Matlab
Gets a string describing the current Matlab connection

Description
Gets a string describing the current Matlab connection.

Usage
## S3 method for class 'Matlab':
as.character(x, ...)

Arguments
... Not used.

Value
Returns a character string.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

See Also
For more information see Matlab.
close.Matlab 21

close.Matlab Closes connection to Matlab server

Description
Closes connection to Matlab server. After closing the connection the Matlab server can never more
be access again.

Usage
## S3 method for class 'Matlab':
close(con, ...)

Arguments
... Not used.

Value
Returns what *close() returns.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

See Also
For more information see Matlab.

evaluate.Matlab Evaluates a Matlab expression

Description
Evaluates one or several Matlab expressions on the Matlab server. This method will not return until
the Matlab server is done.
If an error occured in Matlab an exception will be thrown. This expection can be caught by
tryCatch().
If you receieve error message Excepted an ’answer’ from Matlab, but kept receiving nothing, see
"Troubleshooting" under ?R.matlab.

Usage
## S3 method for class 'Matlab':
evaluate(this, ..., collapse=";")
22 finalize.Matlab

Arguments
... One or several string with Matlab expressions. If several strings are given they
will be concatenated with the separator collapse.
collapse Separator to be used to concatenate expressions.

Value
Returns (invisibly) NULL if expressions were evaluated successfully. An exception might also be
thrown.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

See Also
For more information see Matlab.

finalize.Matlab Finalizes the object if deleted

Description
Finalizes the object if deleted. If a Matlab connection is opened, it is closed.
Note that you should never have to call this method explicitly. It is called automatically whenever
the object is removed from memory (by the garbage collector).

Usage
## S3 method for class 'Matlab':
finalize(this, ...)

Arguments
... Not used.

Value
Returns nothing.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

See Also
For more information see Matlab.
getOption.Matlab 23

getOption.Matlab Gets the value of an option

Description
Gets the value of an option where the option is specified like a file pathname, e.g. "readResult/maxTries".
See *setOption() for what options are available. See the Options class for details.

Usage
## S3 method for class 'Matlab':
getOption(this, ...)

Arguments
... Arguments passed to getOption() of the Options class.

Value
Returns the value of the option.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

See Also

*setOption(). For more information see Matlab.

getVariable.Matlab Gets one or several Matlab variables

Description
Gets one or several Matlab variables from the Matlab server. The transfer of the data can be done lo-
cally via a temporary file (remote=FALSE) or through the socket connection (remote=TRUE),
which is always available.

Usage
## S3 method for class 'Matlab':
getVariable(this, variables, remote=this$remote, ...)
24 isOpen.Matlab

Arguments
variables String vector of Matlab containing names of variable that are to be retrieved
from the Matlab server.
remote If TRUE the variables are transferred on the socket connection, otherwise
they are transferred via a temporary file.
... Not used.

Value
Returns a list structure containing the Matlab variables as named values.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

See Also
For more information see Matlab.

isOpen.Matlab Checks if connection to the Matlab server is open

Description
Checks if connection to the Matlab server is open.

Usage
## S3 method for class 'Matlab':
isOpen(con, ...)

Arguments
... Not used.

Value
Returns TRUE if connection is open, otherwise FALSE.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

See Also
For more information see Matlab.
open.Matlab 25

open.Matlab Tries to open a connection to the Matlab server

Description
Tries to open a socket connection to the Matlab server. If the connection could not be opened it the
first time it will try to open it every interval second up to trials times.

Usage
## S3 method for class 'Matlab':
open(con, trials=30, interval=1, ...)

Arguments
trials The number of trials before giving up.
interval The interval in seconds between trials.
... Not used.

Value
Returns TRUE if a socket connection to the Matlab server was successfully opened, otherwise
FALSE.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

See Also
For more information see Matlab.

readMat Reads a MAT file structure from a connection or a file

Description
Reads a MAT file structure from an input stream, either until End of File is detected or until
maxLength bytes has been read. Using maxLength it is possible to read MAT file structure
over socket connections and other non-terminating input streams. In such cases the maxLength
has to be communicated before sending the actual MAT file structure.
Both the MAT version 4 and MAT version 5 file formats are supported. The implementation is
based on [1].
From Matlab v7, compressed MAT version 5 files are used by default [3]. These are not supported.
Use save -V6 in Matlab to write a MAT file compatible with Matlab v6, that is, to write a non-
compressed MAT version 5 file. Note: Do not mix up version numbers for the Matlab software and
the Matlab file formats.
26 readMat

Usage
## Default S3 method:
readMat(con, maxLength=NULL, fixNames=TRUE, verbose=FALSE, ...)

Arguments
con Binary connection to which the MAT file structure should be written to. A
string is interpreted as filename, which then will be opened (and closed after-
wards).
maxLength The maximum number of bytes to be read from the input stream, which should
be equal to the length of the MAT file structure. If NULL, data will be read until
End Of File has been reached.
fixNames If TRUE, names of Matlab variables and fields are renamed such that they are
valid variables names in R.
verbose Either a logical, a numeric, or a Verbose object specifying how much
verbose/debug information is written to standard output. If a Verbose object,
how detailed the information is is specified by the threshold level of the object.
If a numeric, the value is used to set the threshold of a new Verbose object. If
TRUE, the threshold is set to -1 (minimal). If FALSE, no output is written (and
neither is the R.utils package required).
... Not used.

Details
For the MAT v5 format, cell structures are read into R as a list structure.
Sparse matrices are converted into plain matrices, which means that some matrices will be too large
to be allocated.

Value
Returns a named list structure containing all variables in the MAT file structure.

Author(s)
Henrik Bengtsson, Mathematical Statistics, Lund University. The internal MAT v4 reader was
written by Andy Jacobson at Program in Atmospheric and Oceanic Sciences, Princeton University.

References
[1] The MathWorks Inc., Matlab - MAT-File Format, version 5, June 1999.
[2] The MathWorks Inc., Matlab - Application Program Interface Guide, version 5, 1998.
[3] The MathWorks Inc., Matlab - MAT-File Format, version 7, October 2004, http://www.
mathworks.com/access/helpdesk/help/pdf_doc/matlab/matfile_format.pdf

See Also
writeMat().
readMat 27

Examples

path <- system.file("mat-files", package="R.matlab")

# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# Reading all example files
# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
for (version in 4:5) {
cat("Loading all MAT v", version, " example files in ",
path, "...\n", sep="")

pattern <- sprintf("-v%d.mat$", version)

filenames <- list.files(pattern=pattern, path=path, full.names=TRUE)

for (filename in filenames) {

cat("Reading MAT file: ", basename(filename), "\n", sep="")
mat <- readMat(filename)
if (interactive()) {
cat("Press ENTER to view data:")
readline()
}
print(mat)
}
}

# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# Assert that sparse matrices are read identically in MAT v4 and v5
# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
mat4 <- readMat(file.path(path, "SparseMatrix3-v4.mat"))
mat5 <- readMat(file.path(path, "SparseMatrix3-v5.mat"))
diff <- sum(abs(mat4$sparseM - mat5$sparseM))
if (diff > .Machine$double.eps)
stop("Failed to read identical MAT v4 and MAT v5 sparse matrices.")

# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# Assert that signed and unsigned integers are read correctly
# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
bs <- readMat(file.path(path, "unsignedByte.mat"))
if (!identical(as.vector(bs$A), as.double(126:255)))
stop("Error reading unsigned bytes saved by Matlab.")

is <- readMat(file.path(path, "unsignedInt.mat"))

if (!identical(as.vector(is$B), as.double(127:256)))
stop("Error reading unsigned ints saved by Matlab.")

# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# Example of a Matlab struct
# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
# File was created by
# s = struct('type',{'big','little'}, 'color','red', 'x',{3,4})
# 1x2 struct array with fields:
# type
# color
28 readResult.Matlab

# x
# save structLooped.mat s -v6
mat <- readMat(file.path(path, "structLooped.mat"))

# Extract the structure

s <- mat$s

# Field names are always in the first dimension

fields <- dimnames(s)[[1]]
cat("Field names: ", paste(fields, collapse=", "), "\n", sep="");

print(s)

# Get field 'type'

print(s["type",,])

# Get substructure s(:,2)

print(s[,,2])

readResult.Matlab Reads results from the Matlab server

Description
Reads results from the Matlab server.
This method is for internal use only.

Usage
## S3 method for class 'Matlab':
readResult(this, ...)

Arguments
... Not used.

Value
Returns an R object.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

See Also
For more information see Matlab.
setFunction.Matlab 29

setFunction.Matlab Defines a Matlab function

Description
Creates an M-file on the Matlab server machine (in the working directory) containing the specified
Matlab function definition.

Usage
## S3 method for class 'Matlab':
setFunction(this, code, name=NULL, collapse="
", ...)

Arguments
code The Matlab function definition.
name Optional name of the function, which will defined the name of the M-file where
the function is stored. If NULL, the name is extracted from the code.
collapse The string that the code lines, if there are more than one, is going to be concat-
tenated with.
... Not used.

Value
Returns nothing.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

See Also
For more information see Matlab.

Examples
## Not run: code <- c(
"function [win,aver]=dice(B)",
"%Play the dice game B times",
"gains=[-1,2,-3,4,-5,6];",
"plays=unidrnd(6,B,1);",
"win=sum(gains(plays));",
"aver=win;"
)

setFunction(matlab, code)
evaluate(matlab, "[w,a]=dice(1000);")
 30 setOption.Matlab

res <- getVariable(matlab, c("w", "a"))

print(res)

## End(Not run)

setOption.Matlab Sets the value of an option

Description
Sets the value of an option where the option is specified like a file pathname, e.g. "readResult/maxTries".
See the Options class for details.

Usage
## S3 method for class 'Matlab':
setOption(this, ...)

Arguments
... Arguments passed to HYPERLINK(setOption())(setOption()) of the
Options class.

Value
Returns the previous value of the option.

Available options
readResult/maxTries The maximum number of times the connection is check for an answer from the Matlab server
before giving up. Default values is 30 times.
readResult/interval The interval in seconds between each poll for an answer. Default interval is 1 (second).
With default values of the above options, the R Matlab client waits 30 seconds for a reply from the
Matlab server before giving up.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

See Also

*getOption(). For more information see Matlab.

setVariable.Matlab 31

setVariable.Matlab Sets one or several Matlab variables

Description
Sets one or several R variables on the Matlab server. The transfer of the data can be done locally
via a temporary file (remote=FALSE) or through the socket connection (remote=TRUE),
which is always available.

Usage
## S3 method for class 'Matlab':
setVariable(this, ..., remote=this$remote)

Arguments
... Named R variables to be set in Matlab.
remote If TRUE the variables are transferred on the socket connection, otherwise
they are transferred via a temporary file.

Value
Returns nothing. If the Matlab server did not received the variables successfully an exception is
thrown.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

See Also
For more information see Matlab.

setVerbose.Matlab Sets the verbose level to get more details about the Matlab access

Description
Sets the verbose level to get more details about the Matlab access.

Usage
## S3 method for class 'Matlab':
setVerbose(this, threshold=0, ...)
32 startServer.Matlab

Arguments
threshold A threshold that the level argument of any write method has to be equal to or
larger than in order to the message being written. Thus, the lower the threshold
is the more and more details will be outputted. If a large numeric or FALSE,
no verbose output will be given.
... Not used.

Details
If the threshold is set to zero (default) general comments about the Matlab access is given, such as
the Matlab server is started etc. If the threshold is -1, details about the communication with the
Matlab server is given. If the threshold is -2, low-level details about the communication with the
Matlab server is given, such as what commands are sent etc.

Value
Returns the previous threshold value (an integer) used.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

See Also
For more information see Matlab.

startServer.Matlab 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
Matlab$startServer(matlab=getOption("matlab"), port=9999, minimize=TRUE, options=c(

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 connect. The default port is 9999.
writeCommand.Matlab 33

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
TRUE, the new window is minimized, otherwise not. This argument is ignored
on non-Windows systems.
options A character vector of options used to call the Matlab application.
... Not used.

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
(from InputStreamByteWrapper.java). These files exists in the externals/ directory 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.

Value
Returns nothing.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

See Also
For more information see Matlab.

writeCommand.Matlab
Writes (sends) a command to the Matlab server

Description
Writes (sends) a command to the Matlab server.
This method is for internal use only.

Usage
## S3 method for class 'Matlab':
writeCommand(this, cmd, ...)
34 writeMat

Arguments
... Not used.

Value
Returns nothing.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

See Also
For more information see Matlab.

writeMat Writes a MAT file structure

Description
This function takes the given variables (...) and places them in a MAT file structure, which is
then written to a binary connection.
Currently only the MAT version 5 file format is supported.

Usage
## Default S3 method:
writeMat(con, ..., matVersion="5", onWrite=NULL, verbose=FALSE)

Arguments
con Binary connection to which the MAT file structure should be written to. A
string is interpreted as filename, which then will be opened (and closed after-
wards).
... Named variables to be written.
matVersion A character string specifying what MAT file format version to be written to
the connection. If "5", a MAT v5 file structure is written. No other formats are
currently supported.
onWrite Function to be called just before starting to write to connection. Since the MAT
file structure does not contain information about the total size of the structure
this argument makes it possible to first write the structure size (in bytes) to the
connection.
writeMat 35

verbose Either a logical, a numeric, or a Verbose object specifying how much

verbose/debug information is written to standard output. If a Verbose object,
how detailed the information is is specified by the threshold level of the object.
If a numeric, the value is used to set the threshold of a new Verbose object. If
TRUE, the threshold is set to -1 (minimal). If FALSE, no output is written (and
neither is the R.utils package required).
Note that ... must not contain variables with names equal to the arguments matVersion and
onWrite, which were choosen because we believe they are quite unique to this write method.

Value
Returns (invisibly) the number of bytes written. Any bytes written by any onWrite function are not
included in this count.

Author(s)
Henrik Bengtsson (http://www.braju.com/R/)

See Also
readMat().

Examples
A <- matrix(1:27, ncol=3)
B <- as.matrix(1:10)

filename <- paste(tempfile(), ".mat", sep="")

writeMat(filename, A=A, B=B)

data <- readMat(filename)
print(data)

unlink(filename)

## Not run:
# When writing to a stream connection the receiver needs to know in
# beforehand how many bytes are available. This can be done by using
# the 'onWrite' argument.
onWrite <- function(x)
writeBin(x$length, con=x$con, size=4, endian="little");
writeMat(con, A=A, B=B, onWrite=onWrite)
## End(Not run)
Index

∗Topic IO open.Matlab, 25
readMat, 25 readResult.Matlab, 28
writeMat, 34 setFunction.Matlab, 29
∗Topic classes setOption.Matlab, 30
Matlab, 11 setVariable.Matlab, 31
∗Topic documentation setVerbose.Matlab, 31
1. The Matlab server startServer.Matlab, 32
running in Matlab, 2 writeCommand.Matlab, 33
Non-documented objects, 16 ∗Topic package
Sys.setenv, 20 R.matlab-package, 16
∗Topic file * close, 21
readMat, 25 * evaluate, 14
writeMat, 34 * getOption, 30
∗Topic internal * setOption, 23
as.character.Matlab, 20 1. The Matlab server running
close.Matlab, 21 in Matlab, 2, 33
evaluate.Matlab, 21
finalize.Matlab, 22 as.character, 12
getOption.Matlab, 23 as.character,Matlab-method
getVariable.Matlab, 23 (as.character.Matlab), 20
as.character.Matlab, 20
isOpen.Matlab, 24
Non-documented objects, 16
character, 20, 32–34
open.Matlab, 25
close, 12
readResult.Matlab, 28
close,Matlab-method
setFunction.Matlab, 29
(close.Matlab), 21
setOption.Matlab, 30 close.Matlab, 21
setVariable.Matlab, 31 connection, 11, 23–26, 31, 34
setVerbose.Matlab, 31
startServer.Matlab, 32 evaluate, 12
Sys.setenv, 20 evaluate (Non-documented
writeCommand.Matlab, 33 objects), 16
∗Topic methods evaluate,Matlab-method
as.character.Matlab, 20 (evaluate.Matlab), 21
close.Matlab, 21 evaluate.Matlab, 21
evaluate.Matlab, 21
finalize.Matlab, 22 FALSE, 24–26, 32, 35
getOption.Matlab, 23 finalize, 12
getVariable.Matlab, 23 finalize,Matlab-method
isOpen.Matlab, 24 (finalize.Matlab), 22

36
INDEX 37

finalize.Matlab, 22 Matlab.setVerbose
(setVerbose.Matlab), 31
getOption, 12, 23 Matlab.startServer
getOption (Non-documented (startServer.Matlab), 32
objects), 16 Matlab.writeCommand
getOption,Matlab-method (writeCommand.Matlab), 33
(getOption.Matlab), 23
getOption.Matlab, 23 Non-documented objects, 16
getVariable, 12 NULL, 22, 29
getVariable (Non-documented numeric, 26, 32, 35
objects), 16
getVariable,Matlab-method Object, 11
(getVariable.Matlab), 23 open, 12
getVariable.Matlab, 23 open,Matlab-method (open.Matlab),
25
help, 17 open.Matlab, 25
Options, 23, 30
integer, 32
isOpen, 12 R.matlab (R.matlab-package), 16
isOpen (Non-documented objects), R.matlab-package, 16
16 R.utils, 17, 26, 35
isOpen,Matlab-method readMat, 14, 17, 25, 35
(isOpen.Matlab), 24 readResult, 12
isOpen.Matlab, 24 readResult (Non-documented
objects), 16
list, 26 readResult,Matlab-method
logical, 26, 35 (readResult.Matlab), 28
readResult.Matlab, 28
Matlab, 11, 17, 20–25, 28–34
Matlab.as.character setFunction, 12
(as.character.Matlab), 20 setFunction (Non-documented
Matlab.close (close.Matlab), 21 objects), 16
Matlab.evaluate setFunction,Matlab-method
(evaluate.Matlab), 21 (setFunction.Matlab), 29
Matlab.finalize setFunction.Matlab, 29
(finalize.Matlab), 22 setOption, 12, 14
Matlab.getOption setOption (Non-documented
(getOption.Matlab), 23 objects), 16
Matlab.getVariable setOption,Matlab-method
(getVariable.Matlab), 23 (setOption.Matlab), 30
Matlab.isOpen (isOpen.Matlab), 24 setOption.Matlab, 30
Matlab.open (open.Matlab), 25 setVariable, 12
Matlab.readResult setVariable (Non-documented
(readResult.Matlab), 28 objects), 16
Matlab.setFunction setVariable,Matlab-method
(setFunction.Matlab), 29 (setVariable.Matlab), 31
Matlab.setOption setVariable.Matlab, 31
(setOption.Matlab), 30 setVerbose, 12
Matlab.setVariable setVerbose (Non-documented
(setVariable.Matlab), 31 objects), 16
38 INDEX

setVerbose,Matlab-method
(setVerbose.Matlab), 31
setVerbose.Matlab, 31
startServer, 12
startServer (Non-documented
objects), 16
startServer,Matlab-method
(startServer.Matlab), 32
startServer.Matlab, 32
Sys.setenv, 20, 20

TRUE, 11, 24–26, 31, 33, 35

tryCatch, 21

vector, 33
Verbose, 26, 35

writeCommand, 12
writeCommand (Non-documented
objects), 16
writeCommand,Matlab-method
(writeCommand.Matlab), 33
writeCommand.Matlab, 33
writeMat, 14, 17, 26, 34