HAS-Motion Software Documentation

It is possible to run sift from the command line, this offers several advantages:

• With no need to update a GUI or plots the application will run much faster
• With experience it makes it possible to quickly execute commands
• Creating a bat file it is possible to completely automate processing

To start sift in command line mode, open a command line console, navigate to sifts install directory and run sift with the argument –NoGUI

• Commands are prefixed with two dashes (–) these are considered a reserved character, so file and parameter names can not contain two consecutive dashes
• Commands and parameters are case insensitive
• any parameters containing a space (e.g. a folder path) must be wrapped in double quotes (“”)
• Command parameters are named not positional, so the order they are passed does not matter
• Commands can be entered all at once in the same command that launches sift, or one at a time
• Enter the command –Help to get a list of all available commands
• Pass the parameter –Help to any command to get a list and description of all of its parameters
• To exit pass the command –Exit, or press Ctrl + C to quickly exit at any time (Sift will exit once the current command finishes executing)

All commands and their parameters are listed below

Load in a library of CMZs

Path to the directory containing the CMZs to be loaded, all sub-directories will be searched as well.

--LoadLib directory "C:\library folder"

Load a saved query from a .q3d file

The path to the .q3d file containing the query

--LoadQuery file "C:\library folder\query.q3d"

Run Local Outlier Factor

If passed any outliers found will be excluded automatically

How should data be grouped before running?

• Combined Groups: All data points will be compared
• Groups: Data will be compared within groups
• Workspace: Data will be compared within workspaces

_{Default: Combined Groups}

The threshold to consider when searching for outliers
_{Default: 2.00}

How many neighbors should each point be compared to?
_{Default: 10}

How many iterations of the test should be run
_{Default: 1}

How many principal components should the test be run on
_{Default: 2}

Determine the number of PCs by variance explained (replaces NumPCs if used)
_{Default: 95.0}

If passed scale all calculated values to the variability explained by the PC

--RunLOF autoExclude manualThreshold "3" numNeighbors "20" numPasses "2" numPCs "2" scaleToVariability

Run K-Means clustering

How many clusters to sort the data into
_{Default: 2}

If provided use as a seed for the random first centroid (produces repeatable results)

How should data be grouped before running:

• Combined Groups: All data points will be compared
• Groups: Data will be compared within groups
• Workspaces: Data will be compared within workspaces

_{Default: Combined Groups}

How many iterations of the test should be run
_{Default: 5}

The number of principal components to run the test on
_Default:2

Determine the number of principal components by variance explained (replaces NumPCs if used)
_{Default: 95.0}

If passed scale all calculated values to the variability explained by the PC

--RunKMeans clusters "3" customerSeed "0" grouping "combined groups" iterations "1" numPCs "2" scaleToVariability

Run squared prediction error

The alpha threshold used to determine outliers: 0.1, 0.05, 0.025, 0.01, 0.005
_{Default: 0.05}

If passed any outliers will be excluded automatically

The number of Principal Components to run the test on _{Default: 2} == PCsVariance == scale calculated values to variability explained _{Default: 95.0}

--RunSPE alphaValue "0.005" autoExclude numPCs "2"

Run a Mahalanobis distance test

The threshold used to determine outliers: 0.1, 0.05, 0.025, 0.01, 0.005
_{Default: 0.05}

If passed any outliers found will be excluded automatically

How should data be grouped before running:

• Combined Groups: All data points will be compared
• Groups: Data will be compared within groups
• Workspace: Data will be compared within workspaces

_{Default: Combined Groups}

How many iterations of the test should be run
_{Default: 1}

The number of principal components to run the test on
_{Default: 2}

Determining the number of PCs by variance explained
_{Default: 95.0}

If passed scale calculated values to variability explained

--LoadMah alphaValue "0.1" autoExclude grouping "groups" numPasses "3" numPCs "2" scaleToVariance

Register via events

Use local maximum as a registration point

The lower bounds of the local max

The upper bounds of the local max

Use the local minimum as a registration point

The lower bounds of the local min

The upper bounds of the local min

Register by maximum

Register by minimum

The name for registered curve group created

--RegisterCurves max name "AnkleAngleX_Reg"

Create a General Linear Model

The grouping used for the model: Workspace / Group
_{Default: Group}

The name of the GLM being created

--CreateGLM name "New GLM" grouping "group"

Run Statistical Parametric Mapping

The name of the GLM used when creating the SPM

The first grouping to compare

The second grouping to compare

The name of the SPM being created

--RunSPM name "New SPM" glm "New GLM" group1 "AnkleAngleX1_Reg" group2 "AnkleAngleX2_Reg"

Run Dynamic Time Warping

The name of the DTW test being run

How many standard deviations to test for: 1-3
_{Default: 1}

--RunDTW name "New DTW" standardDeviations "2"

Execute one or more Visual3D pipeline scripts via the V3D Engine, currently this only works if a library has be loaded and a query run

A path to a .v3s script file, this parameter can be used more than once to load multiple scripts, the scripts will be executed in the order the are passed

--RunV3d script "C:\library folder\Script One.v3s" script "C:\library folder\Script Two.v3s"

Run Principal Component Analysis on all queries

The name for the PCA to be created

How many principal components should be created
_{Default: 4}

If passed PCA will be run on the mean of each workspace and not the individual traces

--RunPCA name "New PCA" numPCs "3" workspaceMean

Export queried data results in an ascii text file

The path and name of the .txt file to export

How many decimal places to display in exported values
_{Default: 4}

The format of the exported ASCII file: Standard, SPSS, Transposed, P2D
_{Default: Standard}

Number of points to normalize the export data to
_{Default: 101}

If passed the group mean will be exported

If passed the workspace standard deviation will be exported

If passed all normalized sequences will be exported

If passed all time based sequences will be exported

--ExportData file "C:\library folder\exports\Data Export.txt"  precision "2" exportFormat "standard" normalizedTo "100" groupMean groupStdDev workspaceMean workspaceStdDev allSequenceNorm allSequencesTime

Export PCA results to a .txt file

The path and name of the .txt file to export

How many decimal places to display in exported values
_{Default: 4}

The format of the exported ASCII file: Standard, SPSS, Transposed, P2D
_{Default: Standard}

The format of the exported ASCII file: Standard, Transposed, SPSS, P2D

If passed the workspace scores will be exported

If passed the group scores will be exported

If passed the group standard deviation will be exported

If passed the variance explained by each PC will be exported

If passed all eigen vectors will be exported

If passed the mean +/- one standard deviation will be exported

If passed the mean +/- 5 and 95% will be exported

--ExportPCA fileName "C:\library folder\exports\PCA Export.txt" precision "4" exportFormat "transposed" workspaceScores groupScores groupStdDev varianceExplained eigenVectors meanSD mean595

Export summary statistics to a .txt file

The path and name of the .txt file to export

How many decimal places to display in exported values
_{Default: 4}

The format of the exported ASCII file: Standard, SPSS, Transposed, P2D
_{Default: Standard}

The format of the exported ASCII file: Standard, Transposed, SPSS, P2D

If passed the maximum value will be exported

If passed the maximum event point will be exported

If passed the maximum standard deviation will be exported

If passed the mean value will be exported

If passed the mean standard deviation will be exported

If passed the the minimum value will be exported

If passed the minimum event point will be exported

If passed the minimum standard deviation will be exported

Normalize exported metrics

Export results for: Groups, Workspaces, Instances

--ExportSummaryStatistics file "C:\library folder\exports\Summary Statistics Export.txt" precision "2" exportFormat "SPSS" max maxEventPoint maxStdDev mean meanStdDev min minEventPoint minStdDev normalizeMetrics results "groups"

Export any results of curve registration

The path and name of the .txt file to export

How many decimal places to display in exported values
_{Default: 4}

The format of the exported ASCII file: Standard, SPSS, Transposed, P2D
_{Default: Standard}

The format of the exported ASCII file: Standard, Transposed, SPSS, P2D

If passed all landmarks will be exported

If passed the mean of all landmarks will be exported

If passed registered curves will be exported

If passed warping functions will be exported

--ExportRegisteredCurves file "C:\library folder\exports\Registered Curves Export.txt" precision "3" exportFormat "transposed" landmarkAll landmarkMeans registeredCurves warpingFunctions

Export Dynamic Time Warping results

The path and name of the .txt file to export

How many decimal places to display in exported values
_{Default: 4}

The format of the exported ASCII file: Standard, SPSS, Transposed, P2D
_{Default: Standard}

The format of the exported ASCII file: Standard, Transposed, SPSS, P2D

If passed cost functions will be exported

If passed all anomalies will be exported

--ExportDTW file "C:\library folder\exports\Dynamic Time Warping Export.txt" precision "3" exportFormat "transposed"  foundAnomalies costFunctions

Export Statistical Parametric Mapping Results

The path and name of the .txt file to export

How many decimal places to display in exported values
_{Default: 4}

The format of the exported ASCII file: Standard, SPSS, Transposed, P2D
_{Default: Standard}

The format of the exported ASCII file: Standard, Transposed, SPSS, P2D

If passed the B Matrix used will be exported

If passed the Residual Matrix will be exported

If passed the Statistical Parametric Map will be exported

--ExportSPM file "C:\library folder\exports\Statistical Parametric Map Export.txt" precision "5" exportFormat "transposed" bMatrix residualMatrix spm