src/io_matlab.h File Reference

STATUS: work in progress io_matlab MATLAB-input-output for (EEG)-data. More...

#include "array.h"
#include "eeg.h"

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
Array *	read_array_matlab (const char *file, const char *varname)
	read a MATLAB-array from a .mat file.
EEG *	read_eeglab_file (const char *file)
	read EEG struct from EEGlab (MATLAB) .set-file.
int	write_array_matlab (const Array *a, const char *varname, const char *file, bool append)
	save Array-struct as MATLAB .mat file.
int	write_eeglab_file (EEG *eeg, const char *file)
	write EEG-struct to EEGlab-compatible MATLAB file.

---

Detailed Description

STATUS: work in progress io_matlab MATLAB-input-output for (EEG)-data.

eeglab/matlab file reader functions if matio library is installed

Definition in file io_matlab.h.

---

Function Documentation

Array* read_array_matlab	(	const char *	file,
		const char *	varname
	)

read a MATLAB-array from a .mat file.

Todo:

Currently, the returned array is always DOUBLE.

Parameters:

	file	the .mat file
	varname	the name of the variable in the .mat file; can be NULL, in this case the first variable is read.

Returns:

the Array-struct or NULL in case an error occurred

Definition at line 204 of file io_matlab.c.

EEG* read_eeglab_file

(

const char *

file

)

read EEG struct from EEGlab (MATLAB) .set-file.

This reader uses MatIO to parse EEGlab files and construct a LibEEGTools EEG struct. It was developed with EEGlab version 6.01b.

Currently, the EEGlab set must be "epoched", that means that the data must be three-dimensional with channels x n x trials. Continuous data is not yet supported and the reader will fail.

The reader currently works only if the storage is in single .set file (as opposed to a pair of .set and .dat file).

Parameters:

file

eeglab .set file

Returns:

the EEG struct

Definition at line 45 of file io_matlab.c.

int write_array_matlab	(	const Array *	a,
		const char *	varname,
		const char *	file,
		bool	append
	)

save Array-struct as MATLAB .mat file.

Currently, the function converts all arrays to double-arrays. Should be easy to implement for arbitrary types if needed.

Parameters:

	a	the Array
	varname	MATLAB-name of the array
	file	the filename
	append	if TRUE, the function tries to open() the file, else it is overwritten

Returns:

error code

Definition at line 330 of file io_matlab.c.

int write_eeglab_file	(	EEG *	eeg,
		const char *	file
	)

write EEG-struct to EEGlab-compatible MATLAB file.

This write uses MatIO to create an EEGlab file. It was developed with EEGlab version 6.01b.

Todo:

NOT IMPLEMENTED!

Parameters:

	eeg	the struct
	file	eeglab .set file

Returns:

error code

Definition at line 303 of file io_matlab.c.