Workbench Command is a set of command-line tools that can be used to perform simple and complex operations within Connectome Workbench.
UPDATE SCENE FILE wb_command -scene-file-update <input-scene-file> - the input scene file <output-scene-file> - the new scene file to create <scene-name-or-number> - name or number (starting at one) of the scene in the scene file [-fix-map-palette-settings] - Fix palette settings for files with change in number of maps [-remove-missing-files] - Remove missing files from SpecFile [-error] - Abort command if there is an error performing any of the operations on the scene file [-verbose] - Print names of files that have palettes updated [-copy-map-one-palette] - repeatable - Copy palettes settings from first map to all maps in a data file <Data File Name Suffix> - Name of palette mapped data file (cifti, metric, volume) [-data-file-add] - repeatable - Add a data file to scene's loaded files <Name of data file> - Name of data file. If a data file not in the current directory, it is best to use an absolute path (a relative path may work). Instead of a data file, this value may be the name of a text file (must end in ".txt") that contains the names of one or more data files, one per line. Example on UNIX to create a text file containing all CIFTI scalar files in the current directory with absolute paths: ls -d $PWD/*dscalar.nii > file.txt [-data-file-remove] - repeatable - Remove a data file from scene's loaded files <Name of data file> - Name of data file. If a data file not in the current directory, it is best to use an absolute path (a relative path may work). Instead of a data file, this value may be the name of a text file (must end in ".txt") that contains the names of one or more data files, one per line. Example on UNIX to create a text file containing all CIFTI scalar files in the current directory with absolute paths: ls -d $PWD/*dscalar.nii > file.txt This command will update a scene for specific changes in data files. "-fix-map-palette-settings" will find all data files that have had a change in the number of maps since the scene scene was created. If the file has its "Apply to All Maps" property enabled, the palette setting in the first map is copied to all maps in the file. Note: This modifies the palette settings for the file in the scene (data file is NOT modified). "-copy-map-one-palette" will copy the palette settings from the first map to all other maps in a data file. This option is typically used when the number of maps in a data file changes. It changes the palette settings in the scene that are applied to the data file when the scene is loaded (the data file is not modified). The name of the data file specified on the command line is matched to the end of file names in the scene. This allows matching multiple files if their names end with the same characters. It also allows including a relative path when there is more than one file with the same name but in different paths and only one of the files to be updated. "-remove-missing-files" Any files that fail to load when the scene is read will be removed from the scene. Thus, if one deletes files prior to running with this option, the deleted files are removed from the scene. "-error" If this option is provided and there is an error while performing any of the scene operations, the command will immediately cease processing and the output scene file will not be created. Otherwise any errors will be listed after the command finishes.