Matlab LMDB wrapper
C C++ Matlab Other Makefile
Switch branches/tags
Nothing to show
Clone or download
Latest commit 66729a0 Sep 29, 2016
Failed to load latest commit information.
+lmdb Added stat() API Jun 9, 2015
include Fixed uint8 blob issue Dec 9, 2014
src Added stat() API Jun 9, 2015
test Added stat() API Jun 9, 2015
.gitignore Initial commit Oct 10, 2014
LICENSE.txt Initial commit Oct 10, 2014
Makefile Cleaned up Makefile Jan 21, 2015 Update Sep 29, 2016

Matlab LMDB

Matlab LMDB wrapper for UNIX environment.

See also matlab-leveldb.

The package does not contain any data serialization. Use char for storing keys and values. You will need to serialize any Matlab variables to directly save in the database. For example, using num2str and str2double. There are different serialization options, such as this serialization package or JSON format. Those using Caffe might want to use a Datum converter in the caffe-extension branch.


Specify the MATLABDIR path.

make MATLABDIR=/usr/local/MATLAB/R2015a
make test

Edit Makefile to customize the build process.

In the caffe-extension branch, also specify the path to caffe.

make MATLABDIR=/usr/local/MATLAB/R2015a CAFFEDIR=../caffe


% Open and close.
database = lmdb.DB('./db', 'MAPSIZE', 1024^3);
clear database;
readonly_database = lmdb.DB('./db', 'RDONLY', true, 'NOLOCK', true);
clear readonly_database;

% Read and write.
database.put('key1', 'value1');
database.put('key2', 'value2');
value1 = database.get('key1');

% Iterator.
database.each(@(key, value) disp([key, ': ', value]));
count = database.reduce(@(key, value, count) count + 1, 0);

% Cursor.
cursor = database.cursor('RDONLY', true);
  key = cursor.key;
  value = cursor.value;
clear cursor;

% Transaction.
transaction = database.begin();
  transaction.put('key1', 'value1');
  transaction.put('key2', 'value2');
catch exception
clear transaction;

% Dump.
keys = database.keys();
values = database.values();

See help documentation of each function, or visit LMDB documentation to understand the flags.

Caffe extension

The caffe-extension branch includes utilities to convert Datum protocol buffer.

% Make plain datum.
image = imread('peppers.png');
label = 1;
datum = caffe_pb.toDatum(image, label);

% Make encoded datum.
fid = fopen('peppers.png', 'r');
png_image = fread(fid, inf, 'uint8=>uint8');
label = 1;
datum = caffe_pb.toEncodedDatum(png_image, label);

% Read datum.
[png_image, label] = caffe_pb.fromDatum(datum);


  • Finer transaction API.