Log and download .li file

First, start a logging session and download your file. For more detailed information on the API's please visit our API Reference:

Datalogger | API Reference       download_file       Datalogger Examples for MATLAB

% moku example: Basic Datalogger
% (c) 2025 Liquid Instruments Pty. Ltd.

%% Connect to your Moku
i = MokuDatalogger('192.168.###.###');
try
    % Set-up the Datalogger
    i.set_acquisition_mode('mode','Precision');
    i.set_samplerate(1e3);
    i.generate_waveform(1, 'Sine', 'amplitude',1, 'frequency',10e3);

    % Start the data logging session
    logging_request = i.start_logging('duration',10);
    log_file = logging_request.file_name;
    location = logging_request.location;

    % Set up to display the logging process
    progress = i.logging_progress();
    while progress.complete < 1
        fprintf('%d seconds remaining \n',progress.time_remaining)
        pause(1);
        progress = i.logging_progress();
    end

    % Download the log file from the Moku to current directory
    i.download_file(location, log_file, log_file);
    fprintf('Downloaded log file to local directory. %s\n', log_file)

catch ME
    % End the current connection session with your Moku
    i.relinquish_ownership();
    rethrow(ME)
end

% End the current connection session with your Moku
i.relinquish_ownership();

This will output a trace similar to this:

9 seconds remaining 
... 
0 seconds remaining 
File downloaded successfully!
Downloaded log file to local directory. MokuDataLoggerData_20250116_131731.li

Mokucli method

Ensure you have mokucli installed, you can download it from the Utilities page.

From your MATLAB Command Window, you can convert to your desired file type; csv, npy, mat, or hdf5. We'll be converting to .mat for this example. 

>> ! mokucli convert MokuDataLoggerData_20250116_131731.li --format=mat
[===========================================================================] 
Done.

LI File Converter method

Alternatively, you can convert the file using the LI File Converter GUI, this can be accessed from the Moku: App or downloaded from the Utilities page

You can choose the file type, then drag and drop the file to the converter, or open the file from the converter using “File | Open file” or "Ctrl/Cmd + O"

Analyze data

You can then use the converted file to analyze your data, adjust the file_name and channels parameters to match your experiment.

file_name = 'MokuDataLoggerData_20250116_131731.mat';
channels = 2;
disp(file_name);

if ~isfile(file_name)
    error('Convert failed, no file received');
end

data = struct('time', [], 'ch1', []);
file = load(file_name);
data.time = file.moku.data(:, 1);
for i = 1:channels
    data.(['ch', num2str(i)]) = file.moku.data(:, i+1);
end

keys = fieldnames(data);
for k = 1:numel(keys)
    key = keys{k};
    disp([key, ': ', mat2str(data.(key)(1:3)), ' ... [', num2str(data.(key)(end)), ']']);
end

fig = figure('Position', [100, 100, 1000, 300]);
hold on;
for i = 1:channels
    plot(data.time, data.(['ch', num2str(i)]), 'DisplayName', ['Channel ', num2str(i)]);
end
title('Logged Data');
grid on;
xlabel('Time (s)');
ylabel('Voltage (V)');
legend show;
hold off;

This will return something similar to

MokuDataLoggerData_20250116_131731.mat
time: [0;0.001;0.002] ... [9.999]
ch1: [0.00137754767956721;0.00140193458810245;0.00135472403439962] ... [0.0011665]
ch2: [0.0156492042681293;0.0155779194585648;0.0155710410997472] ... [0.015813]