Using Workbench Command

Workbench Command is a set of command-line tools that can be used to perform simple and complex operations within Connectome Workbench.

Full Documentation:

Documentation Home
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.