Differences

This shows you the differences between two versions of the page.

--- sift:command_line [2025/12/18 14:58] – sgranger
+++ sift:command_line [2026/08/21 16:02] (current) – wikisysop
@@ Line 1: / Line 1: @@
-===== Sift Command Line =====
+====== Sift Command Line ======
-It is possible to run sift from the command line, this offers several advantages:
+Running Sift from the command line offers several advantages:
-  * With no need to update a GUI or plots the application will run much faster
+  * 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
+  * With experience, it makes it possible to quickly execute commands
-  * Creating a bat file or python script it is possible to completely automate processing
+  * Creating a bat file or python script makes it possible to completely automate processing
@@ Line 38: / Line 38: @@
+----
 ===== Command Reference =====
+----
+==== -LoadLib / -l ====
+----
+Search the provided directory and all sub directories for .cmz files and load them into the library
+=== Parameters ===
+__**directory (DEFAULT) (REQUIRED) **__ \\
+A path to the root directory to be searched recursively for .cmzs
+  * **Data Type:** String (Directory)
+  * **Default Value:** N/A
+__**libQuery **__ \\
+The query used to refine the files loaded into the library
+  * **Data Type:** String
+  * **Default Value:** NULL
+__**libSubjTags **__ \\
+A list of subject tags that must be included within the .cmzs
+  * **Data Type:** String
+  * **Default Value:** NULL
+<code> -LoadLib "C:\Library Location\Data" libQuery "RUN AND NOT(OLD)" libSubjTags "RUN"</code>
 ----
 ==== -LoadLib / -l ====
@@ Line 203: / Line 223: @@
   * **Default Value:** false
 <code> -BuildNormalDatabase "C:\Library\ND.sift" group "AnkleAngleX" summaryStats "Mean" summaryStats "Mode" librarySummary</code>
+----
+==== -MakeHybridModel ====
+----
+Adds the MakeHybridModel module to the build CMZ function.
+=== Parameters ===
+__**currentFileDirectory (DEFAULT) (REQUIRED) **__ \\
+Path to library directory
+  * **Data Type:** String (Directory)
+  * **Default Value:** N/A
+__**modelTemplateFile (REQUIRED) **__ \\
+Path to MDH settings file
+  * **Data Type:** String (File Path)
+  * **Default Value:** N/A
+<code> -MakeHybridModel modelTemplateFile "C:\Data Folder\ModelFile.mdh" currentFileDirectory "C:\Data Folder\DataFiles\" </code>
+----
+==== -MergeData / -Merge ====
+----
+Adds the MergeData module to the build CMZ function.
+=== Parameters ===
+__**mergeScriptFile (DEFAULT) (REQUIRED) **__ \\
+Path to V3S script file
+  * **Data Type:** String (File Path)
+  * **Default Value:** N/A
+<code> -MergeData mergeScriptFile "C:\Data Folder\Merge Script.v3s" </code>
+----
+==== -AddMetaData / -Merge ====
+----
+Adds the AddMetaData module to the build CMZ function.
+=== Parameters ===
+__**metaFile (REQUIRED) **__ \\
+Path to CSV metadata file
+  * **Data Type:** String (File Path)
+  * **Default Value:** N/A
+__**settingsFile (DEFAULT) **__ \\
+Path to XML settings file for metaData selections
+  * **Data Type:** String (File Path)
+  * **Default Value:** NULL
+<code> -AddMetaData metaFile "C:\Data Folder\MetaData.csv" settings File "C:\Data Folder\Meta Settings File.xml" </code>
+----
+==== -TagByFile ====
+----
+Adds the TagByFile module to the build CMZ function.
+=== Parameters ===
+__**MaskAndTag (DEFAULT) (REQUIRED) **__ \\
+String containing the file mask followed by the tag to assign the file. These should be separated with a colon ':'
+  * **Data Type:** List
+  * **Default Value:** N/A
+<code>  - TagByFile MaskAndTag "*run.c3d:run" </code>
+----
+==== -AddV3DScript ====
+----
+Adds the V3D Script module to the build CMZ function.
+=== Parameters ===
+__**scriptFile (DEFAULT) (REQUIRED) **__ \\
+Path to script file
+  * **Data Type:** List
+  * **Default Value:** N/A
+<code> -AddV3DScript scriptFile "C:\Data Folder\pipeline.v3s" </code>
+----
+==== -BuildCMZ ====
+----
+Main function for building CMZ workspaces. Calls sub functions
+        ~ directory
+        ~ settingsFile
+        ~ preview
+=== Parameters ===
+__**directory (DEFAULT) (REQUIRED) **__ \\
+A path to the root directory to be searched recursively for .c3ds
+  * **Data Type:** String (Directory)
+  * **Default Value:** N/A
+__**settingsFile**__ \\
+A .xml file containing buildCMZ dialog settings saved from the GUI
+  * **Data Type:** String (File Path)
+  * **Default Value:** N/A
+__**preview**__ \\
+If passed Sift will provide a preview of the build it will run and ask the user if they wish to continue.
+  * **Data Type:** Boolean (True / False)
+  * **Default Value:** false
+<code> -BuildCMZ directory ".../../" settingsFile "/.../buildSettings.xml" preview</code>
 ----