===== Import_Data_From_Matfile =====

====Overview====

Imports specified signals from a Matfile. This function expects the .mat file to have a specific input. For example, within MATLAB, we write and run the following script:

====Pipeline Command====
<code>
Import_Data_From_Matfile
/SIGNAL_TYPES=
!/SIGNAL_FOLDER=PROCESSED
/SIGNAL_NAMES=
/FILE_NAME=
/MATLAB_NAMES=
;
</code>
====Dialog====
{{:visual3d:documentation:pipeline:file_commands:importmfile.png?400|}}
====Examples====
<code>
array = linspace(0,10,100);
importThisData = {sin(array)};

FRAME_RATE{1,1} = 180;
ANALOG_VIDEO_FRAME_RATIO{1,1} = 0;
FILE_PATH = {'C:\Users\Public\MATLAB\Sub01_Walk001.c3d'};

matDirectory = 'C:\Users\Public\MATLAB\Sub01_Walk001.mat';
save(matDirectory,'importThisData','FILE_PATH','FRAME_RATE','ANALOG_VIDEO_FRAME_RATIO','-v6')
</code>

What is really important is the FILE_PATH. Within your Visual3D workspace, you will presumably have loaded some .c3d files (in this case, Sub01_Walk001.c3d). The address under FILE_PATH must match the location of the original .c3d files, even if that path is different from the path of the Visual3D workspace. If the Import_Data_From_Matfile command executes but doesn't create or populate a folder in the Visual3D workspace, check the FILE_PATH.

FILE_PATH is different from FILE_NAME, which should be the path to the .mat file you wish to import data from.