The File_Save_As command is used to save the currently active workspace to a new file, rather than overwriting the original.

• Works similar to a “Save As” button: the user can specify a new file name and destination folder.
• This command is commonly used when you want to preserve the original CMZ file, and instead save a modified version with updates (e.g., added events, new model data, etc.)

Important Note:

There is an important distinction between this command and File_Save.

• File_Save saves directly to the currently open CMZ file.
• File_Save_As creates a new file- nothing is overwritten unless you specify the same name.

The command below is as seen on the Visual3D application, it has parameters as options to manipulate this command.

File_Save_As
!/FILE_NAME=
!/FOLDER=
!/SET_PROMPT=Save CMZ file as
!/SAVE_EMBEDDED_GRAPHICS=FALSE
!/CREATE_FOLDER_PATH=FALSE
;

The following table shows the command parameters and descriptions.

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

• Select Filename: Choose or type the name of the new CMZ file you want to save.
• Select Folder: Choose the folder where the new file should be saved. If the filename entered above includes a full path, this folder selection is ignored.
• Checkbox - if file path doesn't exist, create a new one: If checked, Visual3D will automatically create the folder path if it does not exist yet.
• Prompt: This text appears as the title of the Save dialog if you're prompting the user.

The following examples will go through the use of the File_Save_As command in the Visual3D application.

This pipeline loads a file, computes model-based data - in this case the Left Knee Angle, and saves the updated version as a new CMZ.

File_Open
!/FILE_NAME=Subject01
!/FILE_PATH=Trials/
!/SEARCH_SUBFOLDERS=FALSE
!/SUFFIX=_Gait.cmz
!/SET_PROMPT=
!/ON_FILE_NOT_FOUND=SKIP
!/FILE_TYPES_ON_PROMPT=
;

Compute_Model_Based_Data
/RESULT_NAME=Left_Knee_Angle
/SUBJECT_TAG=
/FUNCTION=JOINT_ANGLE
/SEGMENT=Left_Knee
!/REFERENCE_SEGMENT=Pelvis
!/RESOLUTION_COORDINATE_SYSTEM=LAB
!/USE_CARDAN_SEQUENCE=TRUE
!/NORMALIZATION=FALSE
;

File_Save_As
!/FILE_NAME=Subject01_Updated.cmz
!/FOLDER=Processed/
!/SET_PROMPT=Save updated CMZ
!/SAVE_EMBEDDED_GRAPHICS=FALSE
!/CREATE_FOLDER_PATH=TRUE
;

This pipeline loads a trial, detects peak vertical force, extracts the Force Value at this event, and saves a new version including 3D graphics output.

File_Open
!/FILE_NAME=Participant_Trial03
!/FILE_PATH=GaitData/
!/SEARCH_SUBFOLDERS=FALSE
!/SUFFIX=.cmz
!/SET_PROMPT=
!/ON_FILE_NOT_FOUND=PROMPT
!/FILE_TYPES_ON_PROMPT=
;

Event_Global_Maximum
/RESULT_EVENT_NAME=Peak_Vertical_Force
/SIGNAL_TYPES=ANALOG
/SIGNAL_FOLDER=ORIGINAL
/SIGNAL_NAMES=Force
/SIGNAL_COMPONENTS=Z
/FRAME_OFFSET=0
/TIME_OFFSET=
/EVENT_SEQUENCE=RHS,RTO
/EXCLUDE_EVENTS=
/EVENT_SEQUENCE_INSTANCE=0
/EVENT_SUBSEQUENCE=
/SUBSEQUENCE_EXCLUDE_EVENTS=
/EVENT_SUBSEQUENCE_INSTANCE=0
/THRESHOLD=500
;

Metric_Signal_Value_At_Event
/SIGNAL_FOLDER=EVENT_LABEL
/SIGNAL_LABEL=Z
/EVENT_NAME=Peak_Vertical_Force
/RESULT_METRIC_NAME=Vertical_Force_Peak
;

File_Save_As
!/FILE_NAME=Participant_Trial03_ForcePeak.cmz
!/FOLDER=Saved_Metrics/
!/SET_PROMPT=Save trial with force peak
!/SAVE_EMBEDDED_GRAPHICS=TRUE
!/CREATE_FOLDER_PATH=TRUE
;

—

Back to Pipeline Commands Reference