jmex

jmex is a data/struct exchange tool between MATLAB and Java. It was developed to swap vectors and matrices between MATLAB and amodeus. jmex only uses Java 7 functionality in order to be compatible with common MATLAB versions.

The communication is client/server based. MATLAB hosts the server.

The messages passed between client and server are similar to structs., i.e. a collection of named fields with associated multi-dimensional arrays of type double.

In MATLAB, to run the demoApp follow these 3 steps:

init

1. import the jar file to the classpath using the command

   javaaddpath('jmex-0.0.1.jar')

2. start a server in MATLAB in the main window

   server = ch.ethz.idsc.jmex.matlab.MfileContainerServer()

run [Option 1]

3. in MATLAB call the demo app

   demoApp(server)

4. To test the software package, in a console you could now run

   ./rundemoclient.sh

run [Option 2]

3. in MATLAB call the demo app

   demoMatsimApp(server)

4. To test the software package, in a console you could now run

   ./runmatsimdemo.sh

close

5. The server is closed in MATLAB using

   server.close()

Remark

It is not recommended to start the server from an m.file! Instead, the server instance should be accessible from the global scope in order to be able to close it properly.

Include in your project

Modify the pom file of your project to specify repository and dependency of the tensor library:

<repositories>
  <repository>
    <id>tensor-mvn-repo</id>
    <url>https://raw.github.com/idsc-frazzoli/jmex/mvn-repo/</url>
    <snapshots>
      <enabled>true</enabled>
      <updatePolicy>always</updatePolicy>
    </snapshots>
  </repository>
</repositories>

<dependencies>
  <dependency>
    <groupId>ch.ethz.idsc</groupId>
    <artifactId>jmex</artifactId>
    <version>0.0.2</version>
  </dependency>
</dependencies>

The source code is attached to the jar file for your convenience.