Version 0.2.2 (210 KB) by Keith Ma
Create new MAT-files optimized for partial reading and writing of large arrays
Updated 8 Nov 2021

See the demo at:


This tool solves a few problems I ran into when using "matfile" to manage partial IO, namely:

+ *Inability to control data chunking*: Arrays in MAT-files are saved in "chunks". The most natural and performant way to read/write to these arrays is to access one chunk at a time. MATLAB chooses the chunk size automatically and it may (read: almost certainly) not be the most efficient choice for your workload. The recommended solution is to use third-party tools to
"repack" your MAT-file after you create it (see section "Accelerate Save and Load Operations for Version 7.3 MAT-Files" at This should make us all sad.

+ *Repetitive and cryptic array size initialization (see: Assigning a value to the very last element in the array serves a similar purpose as pre-allocating arrays for in-memory variables. The recommended approach is fine, but not easy for the uninitiated to parse and ugly to look at.

Fortunately, (a) MAT-files are HDF5 formatted under the hood, and (b) MATLAB includes utilities for working with HDF5 files directly (i.e., without any external tools). newmatic provides an alternative interface for creating "customized" MAT-files that perform well for partial IO.

Additional notes:

+ newmatic only allocates arrays. If you want to include other data types (strings, cell arrays, whatever), you can add them to the file created by newmatic in the usual way.

+ This initial version of newmatic depends on the system CLI h5repack (see:, a future update will drop this dependency in favor of the native MATLAB hdf5 interface.

Example Usage

There are two key functions in this package:

+ newmatic_variable is used to define the name, data type, array size, and chunk size for variables created by newmatic

+ newmatic creates a MAT-file with the specified variables

Here is a small example demonstrating how to create a MAT-file with two arrays (created by newmatic) and a cell array (not created by newmatic).

mat = newmatic(...
'my-mat-file.mat', ...
newmatic_variable('x', 'double', [1000, 1000, 20], [1000, 1000, 1]), ...
newmatic_variable('y', 'double', [1000, 10, 10], [5000, 10, 10]));
mat.z = {'a', 'cell', 'array'};

Cite As

Keith Ma (2024). newmatic (, GitHub. Retrieved .

MATLAB Release Compatibility
Created with R2019b
Compatible with any release
Platform Compatibility
Windows macOS Linux
Find more on Workspace Variables and MAT-Files in Help Center and MATLAB Answers
Tags Add Tags

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!

Versions that use the GitHub default branch cannot be downloaded

Version Published Release Notes

Improve compatibility in demo script


Logical variables are read as correct datatype


Drop h5repack dependency in favor of MATLAB's native HDF5 utilities. This change also yields a bug performance improvement for large files (a critical use case).


Improved FEX description


To view or report issues in this GitHub add-on, visit the GitHub Repository.
To view or report issues in this GitHub add-on, visit the GitHub Repository.