User Tools

Site Tools


sift:command_line

This is an old revision of the document!


Sift Command Line

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 or python script it is possible to completely automate processing

Running Sift From Command Line

To start sift in command line mode, open a command line console, navigate to Sift's install directory and run sift with any argument that starts with a single dash (-) if you do not want to run any commands as Sift is launched you can instead pass -NoGUI

Command Line Overview

  • Commands are prefixed with a dash these are considered a reserved character, but Sift will ignore any dashes that are within double quotes so file-name.txt will cause an error, where “file-name.txt” will not.
  • Commands and parameters are case insensitive
  • any parameters containing a space or a dash (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
  • Some commands have a default parameter, in these cases the parameter name can be omitted, for example with -loadLib the directory parameter name is optional. so either of the following will work: -loadLib directory “folder path” or -loadLib “folder path”. These parameters are marked as default in the list below
  • Commands can be entered all at once in the same command that launches sift, or one at a time
  • 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)
  • Most commands have one or more aliases that will be accepted

Help Command

If at any point you need help remembering a command or its parameters you can use the help function. Enter the command -Help to receive a list of all available commands within the command line:

This will display the commands default name and any aliases separated by |'s, below each will be a brief description of the command as well as a list of all it's parameters

From here, if you want some more information about a specific command and its parameters you can enter the command of interest and pass it the help parameter, this will give a more detailed description of the command and its parameters:

This will display the command name and any accepted aliases, and below that a list of all parameters complete with a description and some more details about the parameter:

  • Whether or not this parameter is required for the command to run
  • The default value of the parameter if its not passed
  • The expected data type of the parameter

Command Reference


-LoadLib / -l


Search the provided directory and all sub directories for .cmz files and load them

Parameters

directory (DEFAULT) (REQUIRED)
A path to the root directory to be searched recursively for .cmzs

  • Data Type: Directory
  • Default Value: N/A

libQuery
A query to refine the files loaded into the library.

  • Data Type: String
  • Default Value: NULL

libSubjTags
A list of subject tags.

  • Data Type: String
  • Default Value: NULL

-LoadQuery / -q


Load and calculate a predifined query

Parameters

file (DEFAULT) (REQUIRED)
Path to the .q3d containing query definitions

  • Data Type: File
  • Default Value: N/A

-RunPCA / -pca


Run Principal Compnent Analysis

Parameters

name (DEFAULT) (REQUIRED)
The name of the new PCA being computed

  • Data Type: String
  • Default Value: N/A

numPCs
The number of dimensions to reduce to

  • Data Type: Integer
  • Default Value: 4

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

  • Data Type: True / False
  • Default Value: false

-RunLOF / -lof


Run Local Outlier Factor

Parameters

autoExclude
If passed any outliers found will be excluded automatically

  • Data Type: True / False
  • Default Value: false

grouping
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

  • Data Type: String
  • Default Value: combined group
  • Options: combined group, group, workspace

manualThreshold
The threshold to consider when searching for outliers

  • Data Type: Decimal
  • Default Value: 3

numNeighbors
How many neighbors should each point be compared to

  • Data Type: Integer
  • Default Value: 14

numPasses
How many iterations of the test should be run

  • Data Type: Integer
  • Default Value: 1

numPCs
How many principal components should the test be run on

  • Data Type: Integer
  • Default Value: 2

PCsVariance
Determine the numbe of PCs by variance explained

  • Data Type: Decimal
  • Default Value: 95

scaleToVariability
Scale all calculated values to the variavility explained by the PC

  • Data Type: True / False
  • Default Value: false

-RunKMeans / -kmeans


Run K-Means cluster

Parameters

clusters
How many clusters to sort the data into

  • Data Type: Integer
  • Default Value: 2

customSeed
Provide a seed for the random first centroid (produces repeatable results)

  • Data Type: Integer
  • Default Value: 0

grouping
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

  • Data Type: String
  • Default Value: combined group
  • Options: combined group, group, workspace

iterations
How many iterations of the test should be run

  • Data Type: Integer
  • Default Value: 1

numPCs
The number of principal components to run the test on

  • Data Type: Integer
  • Default Value: 2

PCsVariance
Determine the number of PCs by variance explained

  • Data Type: Decimal
  • Default Value: 95

scaleToVariability
Scale all calculated values to the variavility explained by the PC

  • Data Type: True / False
  • Default Value: false

-RunSPE / -spe


Run Squared Prediction Error

Parameters

alphaValue
The alpha threshold used to determine outliers: 0.1, 0.05, 0.025, 0.01, 0.005

  • Data Type: Decimal
  • Default Value: 0.1
  • Options: 0.1, 0.05, 0.025, 0.01, 0.005

autoExclude
If passed any outliers found will be exclude automatically

  • Data Type: True / False
  • Default Value: false

numPCs
The number of principal components to run the test on

  • Data Type: Integer
  • Default Value: 2

PCsVariance
scale calculated values to variability explained

  • Data Type: Decimal
  • Default Value: 95

-RunMah / -mah


Run Mahalanobis Distance test

Parameters

alphaValue
The alpha threshold used to determine outliers: 0.1, 0.05, 0.025, 0.01, 0.005

  • Data Type: Decimal
  • Default Value: 0.1
  • Options: 0.1, 0.05, 0.025, 0.01, 0.005

autoExclude
If passed any outliers found will be excluded automatically

  • Data Type: True / False
  • Default Value: false

grouping
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

  • Data Type: String
  • Default Value: combined group
  • Options: combined group, group, workspace

numPasses
How many iterations of the test should be run

  • Data Type: Integer
  • Default Value: 1

numPCs
The number of principal components to run the test on

  • Data Type: Integer
  • Default Value: 2

PCsVariance
Determing the number of PCs by variance explained instead of number

  • Data Type: Decimal
  • Default Value: 95

scaleToVariance
scale calculated values to variability explained

  • Data Type: True / False
  • Default Value: false

-RunV3D / -s / -plpath


Run pipelines via the V3D engine

Parameters

exportLog
If passed the processing log will be exported to the file provided

  • Data Type: File
  • Default Value: NULL

onLib
If passed the the loaded library will be updated using the provided script(s)

  • Data Type: True / False
  • Default Value: false

script (DEFAULT) (REQUIRED)
A path to the script file to be run, multiple scripts can be passed by repeating the parameter

  • Data Type: List
  • Default Value: N/A

-RunV3DCommand / -c


Run a single V3D pipeline command (Can be used multiple times to execute multiple commands

Parameters

command (DEFAULT) (REQUIRED)
The pipeline command to be executed

  • Data Type: String
  • Default Value: N/A

-dirpath


Set a global variable to the passed path

Parameters

path (DEFAULT) (REQUIRED)
The path to set

  • Data Type: Directory
  • Default Value: N/A

-RegisterCurves / -rc


Register curves

Parameters

eventSequence
Register by events

  • Data Type: True / False
  • Default Value: false

localMax
Use local maximum

  • Data Type: True / False
  • Default Value: false

localMaxLower
The lower bounds of the local max

  • Data Type: Integer
  • Default Value: -1

localMaxUpper
The upper bounds of the local max

  • Data Type: Integer
  • Default Value: -1

localMin
use local minimum

  • Data Type: True / False
  • Default Value: false

localMinLower
The lower bounds of the local minimum

  • Data Type: Integer
  • Default Value: -1

localMinUpper
The upper bounds of the local minimum

  • Data Type: Integer
  • Default Value: -1

max
Register by maximum

  • Data Type: True / False
  • Default Value: false

min
Register by minimum

  • Data Type: True / False
  • Default Value: false

name (DEFAULT) (REQUIRED)
The name for the group after curve registration

  • Data Type: String
  • Default Value: N/A

-CreateGLM / -glm


Create a General Linear Model

Parameters

grouping
The grouping used for the model : Workspace / Group

  • Data Type: String
  • Default Value: group
  • Options: workspace, group

name (DEFAULT) (REQUIRED)
The name of the GLM being created

  • Data Type: String
  • Default Value: N/A

test
The intended test type for the model : One sample t-test, Two sample t-test, Paired t-test

  • Data Type: String
  • Default Value: two_sample
  • Options: one_sample, two_sample, paired, one_way_anova

workspaceMeans
If using workspace means, instead of the individual traces

  • Data Type: True / False
  • Default Value: false

-RunSPM1ttest


Run Statistical Parameteric Mapping One-Sample T-Test

Parameters

alpha (REQUIRED)
The alpha value to threshold with

  • Data Type: Decimal
  • Default Value: N/A

glm (REQUIRED)
The name of the GLM to use when creating the SPM

  • Data Type: String
  • Default Value: N/A

group (REQUIRED)
The name of the group to test

  • Data Type: String
  • Default Value: N/A

name (REQUIRED)
The name of the SPM being created

  • Data Type: String
  • Default Value: N/A

twoTailed
If two-tailed inference (as opposed to one-tailed)

  • Data Type: True / False
  • Default Value: false

-RunSPM2ttest / -spm


Run Statistical Parameteric Mapping Two-Sample T-Test

Parameters

alpha (REQUIRED)
The alpha value to threshold with

  • Data Type: Decimal
  • Default Value: N/A

glm (REQUIRED)
The name of the GLM to use when creating the SPM

  • Data Type: String
  • Default Value: N/A

group1 (REQUIRED)
The name of the first group to test

  • Data Type: String
  • Default Value: N/A

group2 (REQUIRED)
The name of the second group to test

  • Data Type: String
  • Default Value: N/A

name (REQUIRED)
The name of the SPM being created

  • Data Type: String
  • Default Value: N/A

twoTailed
If two-tailed inference (as opposed to one-tailed)

  • Data Type: True / False
  • Default Value: false

-RunSPMpairedttest


Run Statistical Parameteric Mapping Paired T-Test

Parameters

alpha (REQUIRED)
The alpha value to threshold with

  • Data Type: Decimal
  • Default Value: N/A

glm (REQUIRED)
The name of the GLM to use when creating the SPM

  • Data Type: String
  • Default Value: N/A

group1 (REQUIRED)
The name of the first group to test

  • Data Type: String
  • Default Value: N/A

group2 (REQUIRED)
The name of the second group to test

  • Data Type: String
  • Default Value: N/A

name (REQUIRED)
The name of the SPM being created

  • Data Type: String
  • Default Value: N/A

twoTailed
If two-tailed inference (as opposed to one-tailed)

  • Data Type: True / False
  • Default Value: false

-RunSPMOneWayAnova


Run Statistical Parameteric Mapping Paired T-Test

Parameters

alpha (REQUIRED)
The alpha value to threshold with

  • Data Type: Decimal
  • Default Value: N/A

glm (REQUIRED)
The name of the GLM to use when creating the SPM

  • Data Type: String
  • Default Value: N/A

name (REQUIRED)
The name of the SPM being created

  • Data Type: String
  • Default Value: N/A

twoTailed
If two-tailed inference (as opposed to one-tailed)

  • Data Type: True / False
  • Default Value: false

-RunDTW / -dtw


Run Dynamic Time Warping

Parameters

name (REQUIRED)
The name of the DTW test being run

  • Data Type: String
  • Default Value: N/A

standardDeviations
How many standard deviation to test for: 1-3

  • Data Type: Integer
  • Default Value: 1
  • Options: 1, 2, 3

-ExportData / -ex


Export queried data

Parameters

allSequencesNorm
CommandExport all sequences normalized

  • Data Type: True / False
  • Default Value: false

allSequencesTime
CommandExport all time based sequences

  • Data Type: True / False
  • Default Value: false

eventsNorm
CommandExport all events normalized

  • Data Type: True / False
  • Default Value: false

eventsOrig
CommandExport all time based events

  • Data Type: True / False
  • Default Value: false

exportFormat
What format should be exported: Standard ASCII, Transposed ASCII, SPSS ASCII, P2D

  • Data Type: String
  • Default Value: standard
  • Options: standard, transposed, spss, p2d

file (REQUIRED)
Desired path for the text export to be saved

  • Data Type: File
  • Default Value: N/A

groupMean
CommandExport the mean value of each group

  • Data Type: True / False
  • Default Value: false

groupStdDev
CommandExport the standard deviation of each group

  • Data Type: True / False
  • Default Value: false

normalizedTo
Normalize values to…

  • Data Type: String
  • Default Value: 101

precision
How many decimal places should values be displayed to

  • Data Type: String
  • Default Value: 4

workspaceMean
CommandExport the mean of each workspace

  • Data Type: True / False
  • Default Value: false

workspaceStdDev
CommandExport the standard deviation of each workspace

  • Data Type: True / False
  • Default Value: false

-ExportSummaryStatistics


Export summary statistics

Parameters

addMetrics
Export metrics

  • Data Type: True / False
  • Default Value: false

exportFormat
What format should be exported: Standard ASCII, Transposed ASCII, SPSS ASCII, P2D

  • Data Type: String
  • Default Value: standard
  • Options: standard, transposed, spss, p2d

file (REQUIRED)
Desired path for the text export to be saved

  • Data Type: File
  • Default Value: N/A

max
Export the maximum value

  • Data Type: True / False
  • Default Value: false

maxEventPoint
Export the maximum event point

  • Data Type: True / False
  • Default Value: false

maxStdDev
Export the maximum standard deviation

  • Data Type: True / False
  • Default Value: false

mean
Export the mean value

  • Data Type: True / False
  • Default Value: false

meanStdDev
Export the mean standard deviation

  • Data Type: True / False
  • Default Value: false

min
Export the minimum value

  • Data Type: True / False
  • Default Value: false

minEventPoint
Export the minimum event point

  • Data Type: True / False
  • Default Value: false

minStdDev
Export the minimum standard deviation

  • Data Type: True / False
  • Default Value: false

normalizeMetrics
Normalize exported metrics

  • Data Type: True / False
  • Default Value: false

precision
How many decimal places should values be displayed to

  • Data Type: String
  • Default Value: 4

results
Export results for: Groups, Workspaces, Instances

  • Data Type: String
  • Default Value: groups
  • Options: groups, workspaces, instances

-ExportRegisteredCurves


Export results of curve registration

Parameters

exportFormat
What format should be exported: Standard ASCII, Transposed ASCII, SPSS ASCII, P2D

  • Data Type: String
  • Default Value: standard
  • Options: standard, transposed, spss, p2d

file (REQUIRED)
Desired path for the text export to be saved

  • Data Type: File
  • Default Value: N/A

landmarkAll
Export all landmarks

  • Data Type: True / False
  • Default Value: false

landmarkMeans
Export the landmark mean value

  • Data Type: True / False
  • Default Value: false

precision
How many decimal places should values be displayed to

  • Data Type: String
  • Default Value: 4

registeredCurves
Export registered curves

  • Data Type: True / False
  • Default Value: false

warpingFunctions
Export all warping functions

  • Data Type: True / False
  • Default Value: false

-ExportDTW


Export Dynamic Time Warping results

Parameters

costFunctions
Export cost functions

  • Data Type: True / False
  • Default Value: false

exportFormat
What format should be exported: Standard ASCII, Transposed ASCII, SPSS ASCII, P2D

  • Data Type: String
  • Default Value: standard
  • Options: standard, transposed, spss, p2d

file (REQUIRED)
Desired path for the text export to be saved

  • Data Type: File
  • Default Value: N/A

foundAnomalies
Export all outliers found with dynamic time warping

  • Data Type: True / False
  • Default Value: false

precision
How many decimal places should values be displayed to

  • Data Type: String
  • Default Value: 4

-ExportSPM


Export Statistical Parameteric Mapping results

Parameters

bMatrix
Export the B Matrix used

  • Data Type: True / False
  • Default Value: false

exportFormat
What format should be exported: Standard ASCII, Transposed ASCII, SPSS ASCII, P2D

  • Data Type: String
  • Default Value: standard
  • Options: standard, transposed, spss, p2d

file (REQUIRED)
Desired path for the text export to be saved

  • Data Type: File
  • Default Value: N/A

precision
How many decimal places should values be displayed to

  • Data Type: String
  • Default Value: 4

residualMatrix
Export the residual matrix

  • Data Type: True / False
  • Default Value: false

spm
Export the statistical parameteric map

  • Data Type: True / False
  • Default Value: false

-ExportPCA


Export Principal Component Analysis results

Parameters

eigenVectors
Export the eigen vectors

  • Data Type: True / False
  • Default Value: false

exportFormat
What format should be exported: Standard ASCII, Transposed ASCII, SPSS ASCII, P2D

  • Data Type: String
  • Default Value: standard
  • Options: standard, transposed, spss, p2d

file (REQUIRED)
Desired path for the text export to be saved

  • Data Type: File
  • Default Value: N/A

groupScores
Export group scores

  • Data Type: True / False
  • Default Value: false

groupStdDev
Export group standard deviation

  • Data Type: True / False
  • Default Value: false

kMeans
Export K-Means results

  • Data Type: True / False
  • Default Value: false

lof
Export local outlier factor results

  • Data Type: True / False
  • Default Value: false

lofThreshold
Export threshould to determine an LOF outlier

  • Data Type: True / False
  • Default Value: false

mahDis
Export the mahalanobis distance results

  • Data Type: True / False
  • Default Value: false

mahDisThreshold
Export the threshold used to determine a mahalanobis distance outlier

  • Data Type: True / False
  • Default Value: false

mean595
Export the mean plus or minus 5 and 95%

  • Data Type: True / False
  • Default Value: false

meanSD
Export the mean plus or minus one standard deviation

  • Data Type: True / False
  • Default Value: false

precision
How many decimal places should values be displayed to

  • Data Type: String
  • Default Value: 4

spe
Export squared prediction error results

  • Data Type: True / False
  • Default Value: false

speThreshold
Export the threshold to determine an SPE outlier

  • Data Type: True / False
  • Default Value: false

varianceExplained
Export the variance explained

  • Data Type: True / False
  • Default Value: false

workspaceScores
Export workspace scores

  • Data Type: True / False
  • Default Value: false

-ExportPlotSignalTime / -ExportPlotST / -EPST


Parameters

dataStyle
The data style to use when generating plot.

  • Data Type: String
  • Default Value: Workspace
  • Options: Workspace, Group, Sub Group, Cluster

filePath (DEFAULT) (REQUIRED)
The file path the plot will be saved to.

  • Data Type: File
  • Default Value: N/A

groupDispersion
If passed group dispersion will be plotted

  • Data Type: True / False
  • Default Value: false

groupDispersionType
The type of dispersion to be displayed for groups

  • Data Type: String
  • Default Value: One Standard Deviation
  • Options: One Standard Deviation, Two Standard Deviations, Interquartile Range

groupMean
If passed group mean will be plotted

  • Data Type: True / False
  • Default Value: false

height
The height of the image exported.

  • Data Type: Integer
  • Default Value: 1000

legend
Which corner should the legend be displayed in, if not passed no legend will be displayed

  • Data Type: String
  • Default Value: NULL
  • Options: , Top Left, Top Right, Bottom Left, Bottom Right

rawTraces
If passed indivdual traces will be plotted

  • Data Type: True / False
  • Default Value: false

title
The title of the plot.

  • Data Type: String
  • Default Value: ###

width
The width of the image exported.

  • Data Type: Integer
  • Default Value: 1000

workspaceDispersion
If passed workspace dispersion will be plotted

  • Data Type: True / False
  • Default Value: false

workspaceDispersionType
The type of dispersion to be displayed for workspaces

  • Data Type: String
  • Default Value: One Standard Deviation
  • Options: One Standard Deviation, Two Standard Deviations, Interquartile Range

workspaceMean
If passed workspace mean will be plotted

  • Data Type: True / False
  • Default Value: false

xLabel
Label for the X-Axis.

  • Data Type: String
  • Default Value: ###

XRange
The display range of the X Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

yLabel
Label for the Y-Axis.

  • Data Type: String
  • Default Value: ###

YRange
The display range of the Y Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

-ExportPlotMetric / -ExportPlotM / -EPM


Parameters

dataStyle
The data style to use when generating plot.

  • Data Type: String
  • Default Value: Workspace
  • Options: Workspace, Group, Sub Group, Cluster

filePath (DEFAULT) (REQUIRED)
The file path the plot will be saved to.

  • Data Type: File
  • Default Value: N/A

groupDispersion
If passed group dispersion will be plotted

  • Data Type: True / False
  • Default Value: false

groupDispersionType
The type of dispersion to be displayed for groups

  • Data Type: String
  • Default Value: One Standard Deviation
  • Options: One Standard Deviation, Two Standard Deviations, Interquartile Range

groupMean
If passed group mean will be plotted

  • Data Type: True / False
  • Default Value: false

height
The height of the image exported.

  • Data Type: Integer
  • Default Value: 1000

legend
Which corner should the legend be displayed in, if not passed no legend will be displayed

  • Data Type: String
  • Default Value: NULL
  • Options: , Top Left, Top Right, Bottom Left, Bottom Right

meanPlotStyle
How should means be displayed

  • Data Type: String
  • Default Value: Bar Chart
  • Options: Bar Chart, Stacked Bar Chart, Box Plot

metricGrouping
How should workspace means be grouped?

  • Data Type: String
  • Default Value: No Group
  • Options: No Group, Group, Workspace

rawTraces
If passed indivdual traces will be plotted

  • Data Type: True / False
  • Default Value: false

title
The title of the plot.

  • Data Type: String
  • Default Value: ###

width
The width of the image exported.

  • Data Type: Integer
  • Default Value: 1000

workspaceDispersion
If passed workspace dispersion will be plotted

  • Data Type: True / False
  • Default Value: false

workspaceDispersionType
The type of dispersion to be displayed for workspaces

  • Data Type: String
  • Default Value: One Standard Deviation
  • Options: One Standard Deviation, Two Standard Deviations, Interquartile Range

workspaceMean
If passed workspace mean will be plotted

  • Data Type: True / False
  • Default Value: false

xLabel
Label for the X-Axis.

  • Data Type: String
  • Default Value: ###

XRange
The display range of the X Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

yLabel
Label for the Y-Axis.

  • Data Type: String
  • Default Value: ###

YRange
The display range of the Y Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

-ExportPlotPairSignal / -ExportPlotPS / -EPPS


Parameters

dataStyle
The data style to use when generating plot.

  • Data Type: String
  • Default Value: Workspace
  • Options: Workspace, Group, Sub Group, Cluster

filePath (DEFAULT) (REQUIRED)
The file path the plot will be saved to.

  • Data Type: File
  • Default Value: N/A

groupDispersion
If passed group dispersion will be plotted

  • Data Type: True / False
  • Default Value: false

groupDispersionType
The type of dispersion to be displayed for groups

  • Data Type: String
  • Default Value: One Standard Deviation
  • Options: One Standard Deviation, Two Standard Deviations, Interquartile Range

groupMean
If passed group mean will be plotted

  • Data Type: True / False
  • Default Value: false

height
The height of the image exported.

  • Data Type: Integer
  • Default Value: 1000

legend
Which corner should the legend be displayed in, if not passed no legend will be displayed

  • Data Type: String
  • Default Value: NULL
  • Options: , Top Left, Top Right, Bottom Left, Bottom Right

pair (REQUIRED)
Add a pair of two groups, seperare group names with '|' eg. “GROUP_1|GROUP_2”

  • Data Type: List
  • Default Value: N/A

rawTraces
If passed indivdual traces will be plotted

  • Data Type: True / False
  • Default Value: false

title
The title of the plot.

  • Data Type: String
  • Default Value: ###

width
The width of the image exported.

  • Data Type: Integer
  • Default Value: 1000

workspaceDispersion
If passed workspace dispersion will be plotted

  • Data Type: True / False
  • Default Value: false

workspaceDispersionType
The type of dispersion to be displayed for workspaces

  • Data Type: String
  • Default Value: One Standard Deviation
  • Options: One Standard Deviation, Two Standard Deviations, Interquartile Range

workspaceMean
If passed workspace mean will be plotted

  • Data Type: True / False
  • Default Value: false

xLabel
Label for the X-Axis.

  • Data Type: String
  • Default Value: ###

XRange
The display range of the X Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

yLabel
Label for the Y-Axis.

  • Data Type: String
  • Default Value: ###

YRange
The display range of the Y Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

-ExportPlotPairMetric / -ExportPlotPM / -EPPM


Parameters

dataStyle
The data style to use when generating plot.

  • Data Type: String
  • Default Value: Workspace
  • Options: Workspace, Group, Sub Group, Cluster

filePath (DEFAULT) (REQUIRED)
The file path the plot will be saved to.

  • Data Type: File
  • Default Value: N/A

groupDispersion
If passed group dispersion will be plotted

  • Data Type: True / False
  • Default Value: false

groupDispersionType
The type of dispersion to be displayed for groups

  • Data Type: String
  • Default Value: One Standard Deviation
  • Options: One Standard Deviation, Two Standard Deviations, Interquartile Range

groupMean
If passed group mean will be plotted

  • Data Type: True / False
  • Default Value: false

height
The height of the image exported.

  • Data Type: Integer
  • Default Value: 1000

jitterX
The random offset of each point on the X Axis

  • Data Type: Decimal
  • Default Value: 0

jitterY
The random offset of each pointer on the Y Axis

  • Data Type: Decimal
  • Default Value: 0

legend
Which corner should the legend be displayed in, if not passed no legend will be displayed

  • Data Type: String
  • Default Value: NULL
  • Options: , Top Left, Top Right, Bottom Left, Bottom Right

pair (REQUIRED)
Add a pair of two groups, seperare group names with '|' eg. “GROUP_1|GROUP_2”

  • Data Type: List
  • Default Value: N/A

rawTraces
If passed indivdual traces will be plotted

  • Data Type: True / False
  • Default Value: false

title
The title of the plot.

  • Data Type: String
  • Default Value: ###

width
The width of the image exported.

  • Data Type: Integer
  • Default Value: 1000

workspaceDispersion
If passed workspace dispersion will be plotted

  • Data Type: True / False
  • Default Value: false

workspaceDispersionType
The type of dispersion to be displayed for workspaces

  • Data Type: String
  • Default Value: One Standard Deviation
  • Options: One Standard Deviation, Two Standard Deviations, Interquartile Range

workspaceMean
If passed workspace mean will be plotted

  • Data Type: True / False
  • Default Value: false

xLabel
Label for the X-Axis.

  • Data Type: String
  • Default Value: ###

XRange
The display range of the X Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

yLabel
Label for the Y-Axis.

  • Data Type: String
  • Default Value: ###

YRange
The display range of the Y Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

-ExportPlotSPM / -EPSPM


Parameters

dataStyle
The data style to use when generating plot.

  • Data Type: String
  • Default Value: Workspace
  • Options: Workspace, Group, Sub Group, Cluster

filePath (DEFAULT) (REQUIRED)
The file path the plot will be saved to.

  • Data Type: File
  • Default Value: N/A

height
The height of the image exported.

  • Data Type: Integer
  • Default Value: 1000

legend
Which corner should the legend be displayed in, if not passed no legend will be displayed

  • Data Type: String
  • Default Value: NULL
  • Options: , Top Left, Top Right, Bottom Left, Bottom Right

title
The title of the plot.

  • Data Type: String
  • Default Value: ###

width
The width of the image exported.

  • Data Type: Integer
  • Default Value: 1000

xLabel
Label for the X-Axis.

  • Data Type: String
  • Default Value: ###

XRange
The display range of the X Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

yLabel
Label for the Y-Axis.

  • Data Type: String
  • Default Value: ###

YRange
The display range of the Y Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

-ExportPlotResiduals / -ExportPlotR / -EPR


Parameters

dataStyle
The data style to use when generating plot.

  • Data Type: String
  • Default Value: Workspace
  • Options: Workspace, Group, Sub Group, Cluster

filePath (DEFAULT) (REQUIRED)
The file path the plot will be saved to.

  • Data Type: File
  • Default Value: N/A

height
The height of the image exported.

  • Data Type: Integer
  • Default Value: 1000

legend
Which corner should the legend be displayed in, if not passed no legend will be displayed

  • Data Type: String
  • Default Value: NULL
  • Options: , Top Left, Top Right, Bottom Left, Bottom Right

title
The title of the plot.

  • Data Type: String
  • Default Value: ###

width
The width of the image exported.

  • Data Type: Integer
  • Default Value: 1000

xLabel
Label for the X-Axis.

  • Data Type: String
  • Default Value: ###

XRange
The display range of the X Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

yLabel
Label for the Y-Axis.

  • Data Type: String
  • Default Value: ###

YRange
The display range of the Y Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

-ExportPlotB / -EPB


Parameters

dataStyle
The data style to use when generating plot.

  • Data Type: String
  • Default Value: Workspace
  • Options: Workspace, Group, Sub Group, Cluster

filePath (DEFAULT) (REQUIRED)
The file path the plot will be saved to.

  • Data Type: File
  • Default Value: N/A

height
The height of the image exported.

  • Data Type: Integer
  • Default Value: 1000

legend
Which corner should the legend be displayed in, if not passed no legend will be displayed

  • Data Type: String
  • Default Value: NULL
  • Options: , Top Left, Top Right, Bottom Left, Bottom Right

title
The title of the plot.

  • Data Type: String
  • Default Value: ###

width
The width of the image exported.

  • Data Type: Integer
  • Default Value: 1000

xLabel
Label for the X-Axis.

  • Data Type: String
  • Default Value: ###

XRange
The display range of the X Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

yLabel
Label for the Y-Axis.

  • Data Type: String
  • Default Value: ###

YRange
The display range of the Y Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

-ExportPlotVarianceExplained / -ExportPlotVE / -EPVE


Parameters

dataStyle
The data style to use when generating plot.

  • Data Type: String
  • Default Value: Workspace
  • Options: Workspace, Group, Sub Group, Cluster

filePath (DEFAULT) (REQUIRED)
The file path the plot will be saved to.

  • Data Type: File
  • Default Value: N/A

height
The height of the image exported.

  • Data Type: Integer
  • Default Value: 1000

legend
Which corner should the legend be displayed in, if not passed no legend will be displayed

  • Data Type: String
  • Default Value: NULL
  • Options: , Top Left, Top Right, Bottom Left, Bottom Right

title
The title of the plot.

  • Data Type: String
  • Default Value: ###

width
The width of the image exported.

  • Data Type: Integer
  • Default Value: 1000

xLabel
Label for the X-Axis.

  • Data Type: String
  • Default Value: ###

XRange
The display range of the X Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

yLabel
Label for the Y-Axis.

  • Data Type: String
  • Default Value: ###

YRange
The display range of the Y Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

-ExportPlotLoadingVector / -ExportPlotLV / -EPLV


Parameters

dataStyle
The data style to use when generating plot.

  • Data Type: String
  • Default Value: Workspace
  • Options: Workspace, Group, Sub Group, Cluster

filePath (DEFAULT) (REQUIRED)
The file path the plot will be saved to.

  • Data Type: File
  • Default Value: N/A

flipPC
If passed, invert PC

  • Data Type: True / False
  • Default Value: false

height
The height of the image exported.

  • Data Type: Integer
  • Default Value: 1000

legend
Which corner should the legend be displayed in, if not passed no legend will be displayed

  • Data Type: String
  • Default Value: NULL
  • Options: , Top Left, Top Right, Bottom Left, Bottom Right

pcNumber
The principal component to plot.

  • Data Type: Integer
  • Default Value: 1

title
The title of the plot.

  • Data Type: String
  • Default Value: ###

width
The width of the image exported.

  • Data Type: Integer
  • Default Value: 1000

xLabel
Label for the X-Axis.

  • Data Type: String
  • Default Value: ###

XRange
The display range of the X Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

yLabel
Label for the Y-Axis.

  • Data Type: String
  • Default Value: ###

YRange
The display range of the Y Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

-ExportPlotWorkspaceScores / -ExportPlotWS / -EPWS


Parameters

dataStyle
The data style to use when generating plot.

  • Data Type: String
  • Default Value: Workspace
  • Options: Workspace, Group, Sub Group, Cluster

filePath (DEFAULT) (REQUIRED)
The file path the plot will be saved to.

  • Data Type: File
  • Default Value: N/A

height
The height of the image exported.

  • Data Type: Integer
  • Default Value: 1000

legend
Which corner should the legend be displayed in, if not passed no legend will be displayed

  • Data Type: String
  • Default Value: NULL
  • Options: , Top Left, Top Right, Bottom Left, Bottom Right

normalizeScores
If passed workspace scores will be normalized

  • Data Type: True / False
  • Default Value: false

title
The title of the plot.

  • Data Type: String
  • Default Value: ###

width
The width of the image exported.

  • Data Type: Integer
  • Default Value: 1000

XAxisPC
Principal Component represented on the X Axis

  • Data Type: Integer
  • Default Value: 1

xLabel
Label for the X-Axis.

  • Data Type: String
  • Default Value: ###

XRange
The display range of the X Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

YAxisPC
Prinicipal Component represented on the Y Axis

  • Data Type: Integer
  • Default Value: 2

yLabel
Label for the Y-Axis.

  • Data Type: String
  • Default Value: ###

YRange
The display range of the Y Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

-ExportPlotGroupScores / -ExportPlotGS / -EPGS


Parameters

dataStyle
The data style to use when generating plot.

  • Data Type: String
  • Default Value: Workspace
  • Options: Workspace, Group, Sub Group, Cluster

filePath (DEFAULT) (REQUIRED)
The file path the plot will be saved to.

  • Data Type: File
  • Default Value: N/A

height
The height of the image exported.

  • Data Type: Integer
  • Default Value: 1000

legend
Which corner should the legend be displayed in, if not passed no legend will be displayed

  • Data Type: String
  • Default Value: NULL
  • Options: , Top Left, Top Right, Bottom Left, Bottom Right

title
The title of the plot.

  • Data Type: String
  • Default Value: ###

width
The width of the image exported.

  • Data Type: Integer
  • Default Value: 1000

xLabel
Label for the X-Axis.

  • Data Type: String
  • Default Value: ###

XRange
The display range of the X Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

yLabel
Label for the Y-Axis.

  • Data Type: String
  • Default Value: ###

YRange
The display range of the Y Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

-ExportPlotReconstruction / -ExportPlotR / -EPR


Parameters

dataStyle
The data style to use when generating plot.

  • Data Type: String
  • Default Value: Workspace
  • Options: Workspace, Group, Sub Group, Cluster

filePath (DEFAULT) (REQUIRED)
The file path the plot will be saved to.

  • Data Type: File
  • Default Value: N/A

group
What group to reconstruct, pass multiple times to select multiple groups, do not pass to select all

  • Data Type: List
  • Default Value: NULL

groupMean
If passed group mean will be plotted

  • Data Type: True / False
  • Default Value: false

height
The height of the image exported.

  • Data Type: Integer
  • Default Value: 1000

legend
Which corner should the legend be displayed in, if not passed no legend will be displayed

  • Data Type: String
  • Default Value: NULL
  • Options: , Top Left, Top Right, Bottom Left, Bottom Right

pc
What PCs to reconstruct, pass multiple times to select multiple PCs, do not pass to select all

  • Data Type: List
  • Default Value: NULL

title
The title of the plot.

  • Data Type: String
  • Default Value: ###

width
The width of the image exported.

  • Data Type: Integer
  • Default Value: 1000

workspace
What workspace to reconstruct, pass multiple times to select multiple workspaces, do not pass to select all

  • Data Type: List
  • Default Value: NULL

xLabel
Label for the X-Axis.

  • Data Type: String
  • Default Value: ###

XRange
The display range of the X Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

yLabel
Label for the Y-Axis.

  • Data Type: String
  • Default Value: ###

YRange
The display range of the Y Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

-ExportPlotExtreme / -ExportPlotE / -EPE


Parameters

dataStyle
The data style to use when generating plot.

  • Data Type: String
  • Default Value: Workspace
  • Options: Workspace, Group, Sub Group, Cluster

filePath (DEFAULT) (REQUIRED)
The file path the plot will be saved to.

  • Data Type: File
  • Default Value: N/A

height
The height of the image exported.

  • Data Type: Integer
  • Default Value: 1000

legend
Which corner should the legend be displayed in, if not passed no legend will be displayed

  • Data Type: String
  • Default Value: NULL
  • Options: , Top Left, Top Right, Bottom Left, Bottom Right

pcNumber

  • Data Type: Integer
  • Default Value: 1

plotType

  • Data Type: String
  • Default Value: StdDevRecon
  • Options: StdDevRecon, 595Recon, 595Raw

title
The title of the plot.

  • Data Type: String
  • Default Value: ###

width
The width of the image exported.

  • Data Type: Integer
  • Default Value: 1000

xLabel
Label for the X-Axis.

  • Data Type: String
  • Default Value: ###

XRange
The display range of the X Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

yLabel
Label for the Y-Axis.

  • Data Type: String
  • Default Value: ###

YRange
The display range of the Y Axis: “X,Y”

  • Data Type: String
  • Default Value: ###

-SelectSignals / -sig


Select queried signals (if no parameters are passed all signals are selected)

Parameters

group
The name of a group to be selected (pass multiple times to select more than one)

  • Data Type: List
  • Default Value: NULL

workspace
The name of a workspace to be selcted (pass multiple time to select more than one)

  • Data Type: List
  • Default Value: NULL

-SelectMetrics / -met


Select queried metrics (if no parameters are passed all metrics are selected)

Parameters

group
The name of the group to be selected (pass multiple times to select more than one)

  • Data Type: List
  • Default Value: NULL

workspace
The name of the workspace to be selected (pass multiple times to select more than one)

  • Data Type: List
  • Default Value: NULL

-SaveProject / -sv


Save the current project

Parameters

file (DEFAULT) (REQUIRED)
The path and name of the file

  • Data Type: File
  • Default Value: N/A

-LoadProject / -ld


Load a previously saved project

Parameters

file (DEFAULT) (REQUIRED)
The path and name of project to be loaded

  • Data Type: File
  • Default Value: N/A

LoadLib
If passed the library associated with the file will be loaded

  • Data Type: True / False
  • Default Value: false

-ClearProject / -clr


Clear and create a new project workspace

Parameters


-CreateWatcher / -cw


Creates a directory watcher

Parameters

delay
The number of ms to wait before executing scripts after watcher is triggered

  • Data Type: Integer
  • Default Value: 3000

directory (REQUIRED)
The directories to be watched, pass multiple times to add more directories

  • Data Type: List
  • Default Value: N/A

name (REQUIRED)
The name of the watcher being created

  • Data Type: String
  • Default Value: N/A

overwrite
If passed and existing watchers with the same name will be overwritten

  • Data Type: True / False
  • Default Value: false

recursive
If passed all subdirectories will be watched as well

  • Data Type: True / False
  • Default Value: false

script (REQUIRED)
A list of paths to the scripts to execute when the watcher is triggered

  • Data Type: List
  • Default Value: N/A

triggerOnDelete
If passed watcher will be triggered when a file is deleted

  • Data Type: True / False
  • Default Value: false

-ActivateWatcher / -aw


Activate the passed watcher(s), if no watcher is passed activate all watchers

Parameters

name (DEFAULT)
The name of the watcher to be activated

  • Data Type: List
  • Default Value: NULL

-DeactivateWatcher / -daw


Deactivate the passed watcher(s), if no watcher is passed deactivate all watchers

Parameters

name (DEFAULT)
The name of the watcher to be deactivated

  • Data Type: List
  • Default Value: NULL

-DeleteWatcher / -dw


Deletes the passed watcher if it exists

Parameters

name (DEFAULT) (REQUIRED)
The name of the watcher to be deleted

  • Data Type: String
  • Default Value: N/A

-ListWatchers / -lw


List all watchers

Parameters


-LaunchMinimized


Set Sift to lauch minimized to the system tray by default.

Parameters

disable
If passed Sift will will no longer launch minimized to the system tray.

  • Data Type: True / False
  • Default Value: false

-LaunchBackgroundInstance / -LaunchTray


Immediatly launch a background instance of Sift in the system tray.

Parameters


-Exit / -x


Exit Sift

Parameters


-SetEnginePluginsFolder / -SEPF


Set the location the engine will look for plugins e.g Meta-Commands

Parameters

folderPath (DEFAULT) (REQUIRED)
The path to the engine plugins folder

  • Data Type: Directory
  • Default Value: N/A
sift/command_line.1757614027.txt.gz · Last modified: 2025/09/11 18:07 by sgranger