Installation

Github repositories

Install the scitran repository and Guillaume Flandin's (JSONio).

git clone https://github.com/vistalab/scitran
git clone https://github.com/gllmflndn/JSONio

Add both repositories to your path, say

chdir(<scitran directory>); addpath(genpath(pwd));
chdir(<JSONio directory>); addpath(genpath(pwd));

To verify the installation use

>> st.verify;
Verified SDK-Flywheel connection.
SDK version 8.0.0
Flywheel release emerald.8.0.1

Downloading the Flywheel SDK

We include the Flywheel sdk as part of the github repository. However, we update this from time-to-time based on releases at Flywheel. The web-site where the releases can be found is

https://github.com/flywheel-io/core/releases

Notes on the rest-client.jar

Installing the Matlab SDK requires that a Dynamic Java Class (rest-client.jar) be on your path. Normally, this is handled automatically by scitran. The rest-client.jar is in the api sub-directory of the flywheel sdk.

We have had some instances in which older versions of the library were not removed from the java path in Matlab. There should be one version of in your java classes as a dynamic directory. You see whether it is there or not by typing into the Matlab prompt:

javaclasspath

This will produce a long list of java classes that Matlab includes, and at the end of the list you should see a listing of the flywheel-sdk/api/rest-client.XXXX.jar

If you find multiple versions of this class, that is bad. This is likely to result in an io.FUNCTION error, say in the ApiClient code. To fix the issue remove unwanted instances using, for example, ....

javarmpath('/Users/wandell/Documents/MATLAB/scitran/local/sdk630/api/rest-client.jar')

The actual remove should be the unwanted version on your path.

Once you have cleaned up the unwanted versions, you can add the rest-client.jar by changing into the flywheel-sdk/api directory and adding the rest-client.jar to your java path as

javaaddpath(fullfile(pwd,'rest-client.jar'));