Import of MATLAB Data Files

Introduction

The command converts MATLAB files (.mat) into UniPlot-netCDF files or netCDF files into MATLAB files. A MATLAB installation is not necessary.

MATLAB is a trademark of The MathWorks, Inc. (http://www.mathworks.de).

MATLAB files in the ControlDesk format can be loaded. ControlDesk is a trademark of dSpace GmbH. (http://www.dspace.de).

Usage

• Start UniPlot.
• Choose File=>Import Data.
• Choose Type “MATLAB File (*.mat)”.
• Select one or more MATLAB files.

Elements

The following MATLAB file elements are loaded:

Vector

A MATLAB vector is saved as a channel in the NC file. The element name is used as the channel name. The vector must contain at least 2 values.

Matrix

Each column of a MATLAB matrix is saved as a channel. The matrix can be imported, if the following conditions are met:

• The matrix must have at least 2 columns and 2 rows.
• A string matrix with the identical number of columns must exist beside the matrix in the same structure.
• The first row of the string matrix must contain valid names.

The names of the first row are used as channel names. If the string matrix contains more than one row, the second row is used as units. All other rows are ignored.

Example of a valid structure for a matrix with 3 columns and 2 rows:

* o = [. Data = rand(2,3), Header = ["C1", "C2", "C3"]]
* o
[.
    Data = matrix 2 x 3 [0.566211, 0.82072, 0.325495, 0.34008, 0.895177, ...]
    Header = string-matrix 1 x 3 ["C1", ...]
]
object (obj at 0x386C4BC)
*

Other Elements

The following elements are used for the import if available:

channel_info: Is an array of structures. The structure name should match a channel name. Each structure element is saved as a channel attribute. Predefined elements: C_format, add_offset, datatype, long_name, scale_factor, title, units.

globals: Contains scalar elements which are saved as global attributes in the NC file.

order: Is a string array with channel names which sets the order in the NC file.

Example:

* matlab_load(GetRootDirectory() + "samples/map-data.mat")
[.
    BEEWG = matrix 1 x 78 [1002.5, 461.7, 350.3, 322, 302.6, ...]
    CO = matrix 1 x 78 [0.6, 0.08, 0, 0.05, 0.05, ...]
    order = string-matrix 2 x 1 ["BEEWG", "CO", ...]
    channel_info = [.
        BEEWG = [.
            C_format = "%.2lf"
            add_offset = 0
            datatype = "real4"
            long_name = "BEEWG/g/kWh"
            scale_factor = 1
            title = "BEEWG"
            units = "g/kWh"
        ]
        CO = [.
            C_format = "%.2lf"
            add_offset = 0
            datatype = "real4"
            long_name = "CO/%"
            scale_factor = 1
            title = "CO"
            units = "%"
        ]
    ]
    globals = [.
        Creator = "UniPlot Excel Converter v2"
        Origin = "D:\uniplot_du\samples\map-data.xls [map]"
        Source = "Uniplot Software GmbH (www.uniplot.de)"
        missing_value = 1e+10
    ]
]

Export of netCDF files to MATLAB

A netCDF file can be saved as a MATLAB file. See File=>Export Data.

History

• UniPlot 5.14.5, March 26, 2010: Renamed _channel_info to channel_info, _globals to globals and _ to order.
• UniPlot 5.11.1, September 01, 2009: ControlDesk format added.
• UniPlot 5.10.2, June 03, 2009: Import of MAT-4-Files.
• UniPlot 5.10.1, May 17, 2009: Save matrix columns as channels added.
• UniPlot 5.10.0, April 30, 2009: MATLAB Import-Filter added.

Uniplot Software GmbH

Am Seekanal 16

15834 Rangsdorf

Germany

Tel.: +49 (0) 33708/73754

Fax.: +49 (0) 33708/73755

E-Mail: support@uniplot.de

Internet: http://www.uniplot.com

_id-1736791