Preliminary documentation for Ice 3.7.1 Beta. Do not use in production applications. Refer to the space directory for other releases.

This page provides important information for users of the Ice for MATLAB distribution.

On this page:

Overview of the Ice for MATLAB Distribution

Ice for MATLAB is available as a toolbox for MATLAB versions R2016a and R2017a. Each toolbox provides the following components:

  • Ice library for MATLAB
  • Standard Slice files
  • Slice-to-MATLAB compiler (slice2matlab)


Installing the Ice for MATLAB Distribution

Download the toolbox for your MATLAB version:

Now open MATLAB and navigate to the directory that contains the toolbox file. Double-click on the toolbox file to begin the installation.

Upon completion, MATLAB places the toolbox files in the Add-Ons directory specified in your Preferences settings. By default, this is a directory in your Documents folder.

You can manage the toolbox by choosing Add-Ons / Manage Add-Ons.

Using Ice for MATLAB

The installation process automatically appends the add-on directories to your MATLAB path. The installation includes a MATLAB script named slice2matlab that you can use to easily run the Slice-to-MATLAB compiler from the MATLAB console. To verify that Ice is installed, try running the script:

>> slice2matlab -h

The Ice manual provides a complete description of the MATLAB mapping, including the options for generating MATLAB code from Slice definitions.

At a minimum, your application will need to load the Ice library by calling loadlibrary as follows:

MATLAB
loadlibrary('ice', @iceproto)

 

Using the Sample Programs

Sample programs are provided in a separate GitHub repository. You can browse this repository to see build and usage instructions for all supported programming languages. Simply clone this repository:

git clone -b matlab https://github.com/zeroc-ice/ice-demos.git
cd ice-demos

  • No labels