Import and Export

Import/ Export Movement Data

This is a common topic for MovALyzeR, GripAlyzeR & ScriptAlyzeR. These programs will be referred to as MovAlyzeR on this page.

* Importing or Exporting an Experiment

* Importing Data

* Customized Data Import

Importing or Exporting an Experiment

Export

o Right-click a particular experiment > Export.

~ Specify Export Location: Specify the directory to store the .exp file. When exporting experiment APK, the name of the file will be APK.exp. In addition, Support and Trial files can be generated.

NOTE: The .exp file is editable with Notepad as long as the number of lines is not altered.

~ Include experiment support files (instructions, notes, sorting, etc)? These are additional customization files.

~ Include experiment trials? Trials will be compressed. Still this file can be large.

~ Show subject identities? The subject identities are by default concealed.

Import

An entire MovAlyzeR experiment can be imported after it has been exported by another MovAlyzeR user. To import an experiment you need to have a .exp file for the experiment. If you are importing the trials, you need a .zip file that includes all the trial data (i.e., .hwr and other files).

o Click File > Import > Import Experiment.

o Specify the directory of the .exp file.

o Decide whether to include the trials as well. Currently the limitation is that the trial data need to be online available.

o Decide to delete the .exp file after the import.

Importing Other Data

Ascii data extracted from e.g., Oasis, Eyelink, Gripper, can be imported using the wizard or, if desirable, self-customized.

Data Import Wizard

Click File > Import > Data Import Wizard, and answer the questions.

o Step 1:

Select the input data format and click Next.

Data Formats	Options
MovAlyzeR	Entire directory
Gripper	.dat or .csv files. Allow selection of columns and sequence.
Oasis	.asc or ,csv files.
Eyelink	.asc or ,csv files.

NOTE: .csv are common comma-separated-value files. .dat and .asc files are space-separated-value files.

o Step 2: This step varies for the different data formats (a, b, c, or d).

a. MovAlyzeR data import: Importing external MovAlyzeR data in to the current MovAlyzeR.

o MovAlyzeR data is imported trial by trial.

~ Datapath: Choose the file to be imported from your local drive for the trial you want to import.

~ View data: Clicking this displays the information in the chosen data file in ASCII format.

o To import the remaining trials: At the end of the first trial import, click next instead of finish to loop through the trials for a particular subject, as all the settings are retained until you click finish in the last step.

b. Gripper data import: Importing external GripAlyzeR data in to the current GripAlyzeR.

Trial by Trial:

~ Datapath: Choose the file to be imported from your local drive for the trial you want to import > next.

NOTE: To import additional trials at the same time: At the end of the first trial import, click next instead of finish to loop through the trials for a particular subject, as all the settings are retained until you click finish in the last step.

Group of Trials:

o Gripper data files can also be imported in a group from a folder if the trial files are named ending in sequential numerical order.

EXAMPLE You can import data files S1t01.csv, S1t02.csv.....etc stored in a folder. The first trial to be imported could have a file name ending in any number, say 100. But the following trials you want to import should have file names ending in 101, 102..etc.

~ Datapath: Choose the first file to be imported from your local drive for the group of trials to import. Example, file C:\.....\S1t03.csv.

~ Import multiple starting with above for __ additional trials: Check the option and Choose the number of the sequential files to be imported in addition to current file chosen. Example, 3 files in addition (S1t04, S1t05 and S1t06.csv).

~ Number of lines to skip: If there is additional text (header) in your data file before the columns of data appear, choose the number of lines this text occupies. Do not include column headers in the number of lines.

~ Are there column headers: If there are any column headers in a single line for the columns of data, choose this option.

EXAMPLE

Trial Segment Condition Duration
1 2 1 0.2345
1 3 1 0.4211

Here, "Trial Segment..." is the column header.

~ View data: Clicking this displays the information in the chosen data file in ASCII format.
~ Columns: Choose the columns of data in the file that correspond to the x, y and z, (that is, lower grip, upper grip and load data) and also the order. Note: If you don't choose it using this button, clicking next will automatically ask for it. This choice is also retained for the following trials/group of trials by clicking next in the last step.
o At the last step, clicking 'next' or 'ok' would display the number of trials imported with a message such as "4 trials imported".

c. Oasis data import: Importing external Oasis data in to the current MovAlyzeR.

o Oasis data contains a group of trials in a single .asc or any extension file with columns of data. MovAlyzer uses the input from a single data file and automatically parses the data in to trials.

~ Datapath: Choose the file to be imported from your local drive.

~ View data: Clicking this displays the information in the chosen data file in ASCII format.

o Step 3:

Select the experiment to write the data to. If not defined, setup an experiment using the Experiment Setup Wizard > Click Next.

o Step 4:

Select condition from the list. If not defined, click Create Condition > Type ID, Description, Instruction, Stroke Description, Min, Max #strokes > Click OK > Click Add > Click Next.

NOTE: In case of importing MovAlyzeR data, check Retain Original Conditions if the files in the source directory satisfy eeegggsssCCCnn.hwr where CCC is the condition ID, otherwise all files in the directory will be considered as successive trials.

o Step 5:

Select Group from the list. If not defined, click Add Group > Type ID, Description > Click OK > Next.

o Step 6:

Select Subject from the list. If not defined, click Create Subject > Type ID and First and Last Names > Click OK > Click Next or Finish.

NOTE: The procedure can loop through Steps 2-6 by clicking next in the last step. The previous setting is automatically remembered.

d. Other format data import: Importing other externally formated data (accelerometer, Eyelink) in to current MovAlyzeR.

Same as (a).

Customized Data Import

You can import data yourself by:

o Define the experiment using the Experiment Setup Wizard.

o Create all data files as follows.

File Format

The data have to be stored according to particular rules, which assure the continued integrity of the database.

o Store the x, y, and z (= pen pressure) coordinates on one line (separated by one or more spaces) in ASCII text files.

- Successive coordinate trios are in successive lines separated by CR or CR LF.

- The sampling rate in Hz should be constant.

- The scales of x and y in cm per unit are equal.

- Small or negative pen pressures signify movements above the paper. Larger pen pressures signify that the pen is pressed on the paper.

- Store one trial or condition per file.

File and Directory Names

o The file names and directories should be of the form relative to a particular root directory and stored in specific subdirectories:
\root\eee\ggg\sss\eeegggsssccc01.hwr

with:

- 3-letter alphanumeric experiment code eee,

- 3-letter alphanumeric group code ggg,

- 3-letter alphanumeric subject code sss,

- 3-letter alphanumeric condition code ccc,

- 2-letter numeric trial code starting at 01 with increments of 1 (maximum is 99).

o Create the data root directory \root if needed and the experiment, group, and subject directories:
\root\eee
\root\eee\ggg
\root\eee\ggg\sss

o If need, set the data root path by clicking File > Click Particular or Define New User > Properties > Settings > Root Data Path.

o To see the experiment, groups, and subjects added Refresh the database directory by View > Refresh.

o To see the trials, right click a subject and select Refresh Trials or Right-click a particular experiment > Process > Reprocess Trials.