For the experimentation or even direct application of the ADplot in your clinical practice, a downloadable application for MatLab and sample data has been compiled.
The application is ready to run using exported EXCEL files from the Polygon software of the Vicon Motion Analysis system. At the Custom Input Files section you may find instructions on the requirements and how to set the parameters of the application for using as input a custom data file.
The installation procedure is simple.
Download the ADplotMatLab.zip file.
Move the zipped file to a folder of your preference and unzip its content.
Set this path as your Matlab current directory.
There are two m files to use for the creation of the required ADplot:
The first file is AD_Plot_1_Single_Trial.m.
The secont file is the ADplot_2_Multi_Trial.m.
When executing the AD_Plot_1_Single_Trial.m file there are two steps in the procedure:
In the first step you are prompted to select an excel file that includes the Averaged Normal Graph Data.
In the second step you are prompted to select an excel file that includes the Subject Graph Data.
This is it.
The application creates a folder named after the name of the file that contained the Subject Graph Data in the folder ADplot_Reports. Inside this folder the application creates five graphs for the selected trial.
a) The Gait Kinematics Graph with the Right & Left GGDIs and the GGAI on the top left corner.
b) One report that contains the combined Gait Asymmetry & Deviation Graphs
c) The TriPlane ADplot
d) The Global ADplot
e) The Laterality Global ADplot
The application also creates an Excel file in the folder ADplot_Indexes named after the name of the file that contained the Subject Graph Data which includes the calculated values of the indexes of the 12 graphs of the gait report.
These EXCEL files are the input data files that are used by the second MatLab Script the ADplot_2_Multi_Trial.m.
This script is used fr the creation of Multi ADplots and Summary ADplots for user specified groups of trials. The definition of the group of trials, is a manual procedure that has to be prepared by the user. This procedure requires from the user to prepare a text file (i.e. groupa.txt) inside the Input_MultiTrial folder.
Then open the file and insert any number of lines to define the group selected trials using the following format.
subject1.xls,1,2
subject2.xls,1,2
subject3.xls,1,2
Each line must contain an Excel file name and two numbers separated by comma. The two numbers can either 1 or 2.
1=Right Side Deviation Indexes and 2=Left Side Deviation Indexes
The first number after the Excel file name and the first comma, defines the selected Deviation Indexes from the specific EXCEL file to be used to create the RIGHT side for the group graphs.
The second number after the second comma, defines the selected Deviation Indexes from the specific EXCEL file to be used to create the LEFT side for the group graphs.
In most cases the EXCEL file name will be followed by ,1,2 values.
There are cases though where there is a need to group selected limbs for group analysis (i.e. Operated Limbs and Non Operated or in Hemiplegic patients Involved and Uninvoled limbs).
In most cases the EXCEL file name can be followed in some lines by ,1,2 and other line by ,2,1 values.
When all trials have been included to compile the group definition then save the txt file.
Everything is ready to run the ADplot_2_Multi_Trial.m script.
When executing the ADplot_2_Multi_Trial.m file there is one step in the procedure:
You are prompted to select a group file from the ones you have created to proceed with the production of respective graphs.
This is it.
The application creates a folder named after the name of the group file that you have just selected in the folder ADplot_Reports. Inside this folder the application creates three graphs for the selected group.
a) The Group Analysis ADplot
b) The Gait Consistency ADplot
c) The Unified Summary ADplot
The application also creates an Excel file in the folder ADplot_Indexes named after the selected group name which includes the calculated values of the indexes of the 12 graphs of the Unified Summary ADplot.
For creating your own Normal Data Input file.
Right click in Polygon trial panel the normal data file and select the Send to EXCEL.
Save the exported EXCEL file under the name NormalData.xlsx in the folder Input_NormalData
Caution this version of the ADplot application supports a normalization of 50 samples for the graphs creation. Thus gait graph data must me exported for every 2 % of the gait cycle.
For creating your own Data Input file.
Right click in Polygon trial panel the l data file and select the Send to EXCEL.
Save the exported EXCEL file using AnyTrialName.xlsx in the folder Input_GaitData
Caution this version of the ADplot application supports a normalization of 50 samples for the graphs creation. Thus gait graph data must me exported for every 2 % of the gait cycle.
For the creation of a custom input file the following steps must be followed.
Use your Motion Analysis System to create the classical gait report.
Export the gait graph data for the Right and Left side in an EXCEL file "trialname.xlsx" in a sheet named "Data". The following 12 graphs must be included.
Gait Graph export list
Caution this version of the ADplot application supports a normalization of 50 samples for the graphs creation. Thus gait graph data must me exported for every 2 % of the gait cycle.
Save the EXCEL file in the Input_GaitData folder.
Open the GaitDataColumns.txt file located in the ADplot_Sys folder.
Edit the GaitDataColumns.txt file to set the appropriate parameters for reading the file.
The default parameters of the file are the following (these are set for the Vicon Polygon exported file)
1, 1, 1, 2, 3, 52
2, 2, 3, 4, 3, 52
3, 3, 5, 6, 3, 52
4, 1, 7, 8, 3, 52
5, 2, 9, 10, 3, 52
6, 3, 11, 12, 3, 52
7, 1, 13, 14, 3, 52
8, 2, 15, 16, 3, 52
9, 3, 17, 18, 3, 52
10, 1, 19, 20, 3, 52
11, 2, 21, 22, 3, 52
12, 3, 23, 24, 3, 52
The 1st and 2nd number of each row should remain unchanged.
The first number is the reference as shown in the graph list above (i.e.
Pelvic Tilt Post(-) Ant (+)
Pelvic Obliquity Up(+) Down(-)
....
The second number refers to the plane of the graph
1 = Sagittal
2 = Frontal
3 = Tranverse
The 3rd number refers to the Right Side Graph Data and must be matched to the appropriate column number of the Custom Gait Analysis Data file.
The 4th number refers to the Left Side Graph Data and must be matched to the appropriate column number of the Custom Gait Analysis Data file.
The 6th number refers to the starting row of the graph data in the Custom Gait Analysis Data file.
The 7th number refers to the ending row of the graph data in the Custom Gait Analysis Data file.
Example: If the Right side Pelvic Tilt Post(-) Ant (+) graph data is located in the 5th column and the left side in the 6th column starting from row 4 to 53 then the file must be update as follows
1,1,5,6,4,53