MATLAB Library for Apache Arrow

Status

This is a very early stage MATLAB interface to the Apache Arrow C++ libraries.

The current code only supports reading numeric types from Feather files.

Building from source

Get Arrow and build Arrow CPP

See: Arrow CPP README

Build MATLAB interface to Apache Arrow using MATLAB R2018a or later:

cd arrow/matlab
mkdir build
cd build
cmake ..
make

Non-standard MATLAB and Arrow installations

To specify a non-standard MATLAB install location, use the Matlab_ROOT_DIR CMake flag:

cmake .. -DMatlab_ROOT_DIR=/<PATH_TO_MATLAB_INSTALL>

To specify a non-standard Arrow install location, use the ARROW_HOME CMake flag:

cmake .. -DARROW_HOME=/<PATH_TO_ARROW_INSTALL>

Try it out

Add the src and build directories to your MATLAB path

>> cd(fullfile('arrow', 'matlab'));
>> addpath src;
>> addpath build;

Read a Feather file into MATLAB as a table

>> filename = fullfile('arrow', 'matlab', 'test', 'numericDatatypesWithNoNulls.feather');
>> t = featherread(filename);

This should return a MATLAB table datatype containing the Feather file contents.

Running the tests

>> cd(fullfile('arrow', 'matlab'));
>> addpath src;
>> addpath build;
>> cd test;
>> runtests .;