Sort
Results
Output to Trial
Output to File
Formatting the Text
The PlugIn tries to calculate the results for the trial for which the pipeline is being run, based on the Events and the Trajectories which you have selected for each analyzer. If the events or trajectories necessary for the calculation are not found in the trial, then no result will be produced for that analyzer.
The automatic cycle detection algorithm at the heart of the PlugIn ensures that even when events are missing for a certain cycle, the actual results for detected cycles in different contexts remain synchronised.
This causes the PlugIn to sort the results of the analysis so that all the Left context results appear first, followed by the Right context results, with the General context results last, for each cycle of results which are output.
If this option is not selected, the results are presented in the order in which the analyzers appear in the main Analyzers page.
This option tells the plugin to insert the results of the analysis into
the C3D file. This allows the results to be kept with the original trial data
and this should be compatible with other C3D file reading software which are
"analysis aware". You can access and display this data in Vicon Polygon, for
example.
Vicon Polygon has an in-built parameter calculator, which will overwrite
the parameters in your C3D file if you do not disable the feature (the
default is "on"). To do this, import a C3D file into Polygon, open the folder
and subject to reveal an analysis icon. Right click on the analysis icon to
display the pop-up menu, and click on "Properties". This should bring up the
"Gait Cycle Parameter Generation Options" dialog. At the bottom of the
dialog, in the "Other" section, make sure "Automatically Generate Parameters"
is not selected. If you do want to calculate the parameters using
Polygon, you can do so on an individual basis by selecting "Generate Params"
from the pop-up menu.
Selecting Output to File allows you to export the results of the analysis
to a text file.
You can choose any filename for your output file. Use the browse button to do this, or to select a convenient folder, and/or edit the text box manually.
You can also use "Keyword Tokens", to define a name for your file which depends on the trial which is being analyzed. You can put the tokens anywhere within normal text. The PlugIn will replace the tokens with text which is specific for the trial. Each token must appear inside square brackets, without spaces. The names are not case sensitive. The recognised tokens are :-
[TRIALFOLDER]
This will be replaced by the full path of the folder in which the trial files are located.
[TRIALNAME]
The base name of the trial will be inserted, but without any path or extension.
[C3DFILE]
This specifies the full path and name of the associated c3d file for the trial for which the pipeline is being run.
[ASCIIFILE]
This inserts the file path and name of the CSV file which is normally generated by the ASCII export PlugIn.
In this mode, the PlugIn will output the text in a spreadsheet compatible format, which should allow further statistical analysis of your results in a large number of different packages. All the analysis results for each cycle in a trial are output in a single line, tab separated.
This mode is a particularly useful when you are extracting data from a large number of different trials, in which case you should select the "Always Append" option, and ensure that you have a filename which is consistent for the range of different trials you want to process.
If the file does not exist, or is empty, the PlugIn generates a new
tab delimited row of column headings for each of the analyzers. If you are
using this setting with the append option, you should be careful to delete
the results file or its contents if you make any changes to the analyzer
settings, since this may cause the result values to be aligned under the
wrong column headings.
Tip :- For instant viewing of the results, include the ApplicationLinker process in the pipeline, to show the text file in a simple text editor, at the end of the pipeline processing.
Use this text box to specify what the PlugIn should insert into the spreadsheet field if it is unable to calculate a value for a particular cycle.
If this option is selected, the plugin will always add any new analysis results to the end of the selected file. This is useful in conjunction with the Spreadsheet Columns format when you are building up a single file of data from several different trials, or if you want to see a combined Text Report of all trials for a single subject.