The File_Rename command in Visual3D is used to rename one or more existing C3D files in the workspace. This command is especially helpful when automating naming conventions for large datasets or batch-processing files across multiple subjects or trials.

This is equivalent to selecting File > Rename from the Visual3D application menu. The command provides flexible renaming options, including the ability to use Search/Replace, remove file paths, and rename associated static calibration files.

The command below is as seen on the Visual3D application, the parameters allow for manipulation of the command's options.

File_Rename
! /EXISTING_FILE_NAME=ALL_FILES
! /NEW_FILE_NAME=
! /USE_SEARCH_REPLACE=FALSE
! /SEARCH_FOR=
! /REPLACE_WITH=
! /REMOVE_FILE_PATH=FALSE
! /RENAME_STATIC_CALIBRATION_FILES=TRUE
;

The following table shows the command parameters and descriptions:

The command can be edited in the text editor, or in dialog form. To edit in the dialog, either click on the Edit button in the pipeline workshop or double-click on the pipeline command. The dialog is shown below:

• Existing File(s): Dropdown to select a specific file or ALL_FILES.
• New File Name: Used to rename one file to a new fixed name.
• Remove File Paths: Options to strip the full file path from the file reference in workspace.
• Rename using Search/Replace: Enables the lower section for text substitution.
• Search For/Replace With: Provide the substring to search and the new text to replace it with.
• Also Rename Static Calibration Files: Ensures associated calibration files are renamed accordingly.

The following example will go through the use of the File_Rename command in the Visual3D application.

This example demonstrates how to rename multiple files using search/replace logic.

Assume you have accidentally named your RUNNING trial files with the prefix “Walk”: Sub01_Walk001.c3d, Sub01_Walk002.c3d, etc.

You want to rename these Sub01_Run001.c3d, Sub01_Run002.c3d, etc.

File_Rename
/EXISTING_FILE_NAME=ALL_FILES
! /NEW_FILE_NAME=
/USE_SEARCH_REPLACE=TRUE
/SEARCH_FOR=Walk
/REPLACE_WITH=Run
/REMOVE_FILE_PATH=FALSE
/RENAME_STATIC_CALIBRATION_FILES=TRUE
;

This command scans all loaded files and replaces the word “Walk” with “Run” in each filename. The numeric suffix (e.g., 001, 002) remains unchanged. The static calibration files are renamed along with the motion files.

This example walks through a typical workflow where a CMZ workspace is loaded, gait events are applied, and the resulting workspace in Visual3D is renamed and saved.

Step 1: Clear workspace and load file which does not have Gait Events already loaded

File_New

;


File_Open
/FILE_NAME=Data_Files\Sub04_Workspace.cmz ! USER INPUT - Change to desired file path/name
! /FILE_PATH=
! /SEARCH_SUBFOLDERS=FALSE
! /SUFFIX=
! /SET_PROMPT=File_Open
! /ON_FILE_NOT_FOUND=PROMPT
! /FILE_TYPES_ON_PROMPT=
;

Step 2: Apply automatic gait events and then rename the workspace file to reflect the change.

Automatic_Gait_Events
! /FRAME_WINDOW=8
! /USE_TPR=TRUE
! /TPR_EVENT_INSTANCE=1
;

File_Rename
/EXISTING_FILE_NAME=Data_Files\Sub04_Workspace.cmz
/NEW_FILE_NAME=Sub04_Workspace_with_GaitEvents.cmz
! /USE_SEARCH_REPLACE=FALSE
! /SEARCH_FOR=
! /REPLACE_WITH=
! /REMOVE_FILE_PATH=
! /RENAME_STATIC_CALIBRATION_FILES=TRUE
;

Renames the updated file with a new name to reflect that gait events were added.

• This command only renames files inside the Visual3D workspace. If you want to rename physical files on disk, that must be handled externally.

Back to Pipeline Commands Reference