MATLAB DataPlugin 21.0 Readme

April 2021

This file contains installation instructions and compatibility information for MATLAB DataPlugin.

You can find more release information on ni.com.


Overview

Supported Operating Systems

Application Software Support

Installation Instructions

Product Security and Critical Updates

New Features

Automating the Installation of NI Products

Unsupported Windows Operating Systems

Legal Information


Overview

MATLAB DataPlugin provides support for MAT files are written by MATLAB from The Mathworks. This DataPlugin helps you import and export MATLAB files, and directly read files in the .mat file extension.
MATLAB® is a registered trademark of The MathWorks, Inc.
 

Supported Features (reading):

  • Import level 4, 5 and 7.1 MATLAB® files.
  • Files with homogeneous variable types of less than 3D dimensionality.
  • Homogeneous variables of data type CHAR, LOGICAL, INT8, UINT8, DOUBLE, SINGLE, INT16, UINT16, INT32, UINT32, INT64, and UINT64.
  • Loading all allowable variables from a given *.MAT file and ignoring any non-allowable variables during import.
  • Reading text channels from the MATLAB file.
  • STRUCT data, where each field is a variable.
  • CELL data from *.DAT files.
  • COMPRESSED data from *.MAT files.
  • BigEndian data type.
  • LittleEndian data type.
  • Complex single data type.

Supported Features (writing):

  • Export level 4 and 5 MATLAB® files.
    Note: If you want to export files to level 4, please make sure the "Description" property of Root begins with "MATLAB 4.0", as the default export format is level 5.
  • The DataPlugin displays channels in the Data Portal as *.MAT files by sending those channels to variables in the same way as they were originally imported.
  • Writing text channels to strings from the MATLAB® file.
  • A separate time channel is created for waveform channels.
  • Only supports 124 characters.
  • Can insert character between group name and channel name. (Please see DataPlugin Parameter Area in the readme file to learn more or contact dataplugins@ni.com.)
  • The DataPlugin no longer decorates variable names with a 'v_' prefix.
  • The DataPlugin no longer writes a log file.

Non-Supported Features:

  • Loading variables in a *.MAT file of heterogeneous data types such as OBJECT and FUNCTION.
  • Variables with an unsupported data type are ignored.
  • Reading and writing of mat files formated in version 7.3 (HDF5).

Note  This DataPlugin is available for 32-bit and 64-bit applications.

Related Links:

Methods for Working with DIAdem and The MathWorks, Inc. MATLAB® software: Data Transfer and Interprogram Communication

DataPlugin Parameter

Parameter to control DataPlugin functionality:  <SwitchLabel>value</SwitchLabel>
Please have a look into the help system of your application to find the usage of "DataPlugin Parameter" for loading and saving bulk data.

Switch Label Value Description
matrixmode Row, Column, Automatic Use this parameter to select channel wise. ==> (Default = Automatic) This parameter only works for the original mapping. The new mapping option <concatenatestructure> will concatenate all the elements (m*n) of one matrix, so <matrixmode> doesn't work for it.
endian little, big Use this parameter to set the byte order of the file. ==> (Default = big)
concatenatestructure true Use this parameter to concatenate matrix of structures. ==> (Default = false).
makewaveformchannels true Use this parameter to create waveform channels. ==> (Default = false).
makescalarasproperties true Use this parameter to make scalar channels as properties of the channelgroups. ==> (Default = false).
support3Dmatrix true Supports 3D data. ==> (Default = false).
separategroupchannelname _ Supports in case of exporting data, a separator character for the generated export channel naming ([groupname][channelname]). By setting this character to "_" the DataPluign will insert "_" between groupname and channelname ([groupname]<char>[channelname]). Any character is valid. ==> (Default-Character = <empty>).
nogroupnames true Supports in case of exporting data, the generated export channel naming. Default is ([groupname]<SeperatorChar>[channelname]). This switch remove the group name and the SeparatorCharacter from the generation rule for exported channel names ==> (Default = false). 

Supported Operating Systems

  • Windows 10 64 Bit
  • Windows Server 2019
  • Windows Server 2016

Application Software Support

MATLAB DataPlugin supports the application software that support DataPlugins, for example DIAdem, SystemLink and LabVIEW.

Installation Instructions

Installing a C++ DataPlugin

Download the MATLAB DataPlugin installer from ni.com/dataplugins. NI software includes NI Package Manager to handle the installation. Refer to the NI Package Manager Manual for more information about installing, removing, and upgrading NI software using NI Package Manager.

Product Security and Critical Updates

Visit ni.com/security to view and subscribe to receive security notifications about NI products. Visit ni.com/critical-updates for information about critical updates from NI.

New Features

  • Support for complex single data added.

Automating the Installation of NI Products

You can automate the installation of most NI products using command-line arguments to suppress some or all of the installer user interface and dialog boxes.

If the NI product you are installing uses Microsoft .NET 4.6.2, the .NET installer may run before any NI software installs and may require a reboot before the installation of NI software begins. To avoid a .NET reboot, install .NET 4.6.2 separately before you install NI software.

For more information about automating the installation of NI products, refer to Automating an Installer in the NI Package Manager manual.

Unsupported Windows Operating Systems

MATLAB DataPlugin no longer supports Windows Vista/XP/7/8.x, Windows Server 2003/2008/2012, or any 32-bit Windows operating system. Versions of this product that ship after May 1, 2021, may not install or execute correctly on these operating systems. For detailed information about NI operating system support, visit http://www.ni.com/r/win32bitsupport.


Legal Information

Copyright

© 2008–2021 National Instruments Corporation. All rights reserved.

Under the copyright laws, this publication may not be reproduced or transmitted in any form, electronic or mechanical, including photocopying, recording, storing in an information retrieval system, or translating, in whole or in part, without the prior written consent of National Instruments Corporation.

NI respects the intellectual property of others, and we ask our users to do the same. NI software is protected by copyright and other intellectual property laws. Where NI software may be used to reproduce software or other materials belonging to others, you may use NI software only to reproduce materials that you may reproduce in accordance with the terms of any applicable license or other legal restriction.

End-User License Agreements and Third-Party Legal Notices

You can find end-user license agreements (EULAs) and third-party legal notices in the following locations after installation:

  • Notices are located in the <National Instruments>\_Legal Information and <National Instruments> directories.
  • EULAs are located in the <National Instruments>\Shared\MDF\Legal\license directory.
  • Review <National Instruments>\_Legal Information.txt for information on including legal information in installers built with NI products.

U.S. Government Restricted Rights

If you are an agency, department, or other entity of the United States Government ("Government"), the use, duplication, reproduction, release, modification, disclosure or transfer of the technical data included in this manual is governed by the Restricted Rights provisions under Federal Acquisition Regulation 52.227-14 for civilian agencies and Defense Federal Acquisition Regulation Supplement Section 252.227-7014 and 252.227-7015 for military agencies.

IVI Foundation Copyright Notice

Content from the IVI specifications reproduced with permission from the IVI Foundation.

The IVI Foundation and its member companies make no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The IVI Foundation and its member companies shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.

Trademarks

Refer to the NI Trademarks and Logo Guidelines at ni.com/trademarks for information on NI trademarks. Other product and company names mentioned herein are trademarks or trade names of their respective companies.

Patents

For patents covering the NI products/technology, refer to the appropriate location: Help»Patents in your software, the patents.txt file on your media, or the NI Patent Notice at ni.com/patents.

378543A-01