HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » visual3d » documentation » pipeline » file_commands » Export C3DFile
visual3d:documentation:pipeline:file_commands:export_c3dfile

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
visual3d:documentation:pipeline:file_commands:export_c3dfile [2024/06/26 20:05] – removed sgrangervisual3d:documentation:pipeline:file_commands:export_c3dfile [2025/06/09 21:23] (current) – wikisysop
Line 1: Line 1:
 +====== Export C3DFile ======
 +
 +===== Overview =====
 +
 +The **Export_C3DFile** command is available in the Visual3D as a way to export a C3D file.
 +  * The manual option is through the Export Menu commands that can be found in the File Menu. A dialog will open and allow you to make selections for how you wish to have the data exported.
 +  * The additional feature of the pipeline command that is not available in the menu command is the ability to use wildcards to export multiple C3D files.
 +
 +===== Pipeline Command =====
 +
 +The command below is as seen on the Visual3D application, it has many parameters as there are many options to manipulate this command.
 +
 +<code>
 +Export_C3DFile
 +! /OLD_FILE_NAME=
 +! /NEW_FILE_NAME=
 +! /DESTINATION_FOLDER=
 +! /SUFFIX=_
 +! /CREATE_FOLDER_PATH=FALSE
 +! /PROMPT_FOR_NEW_FILE=TRUE
 +! /IF_NEWFILE_EXISTS_REPLACE=FALSE
 +! /EXPORT_ENDIAN=
 +! /TRUNCATE_POINT_LABELS=FALSE
 +! /USE_ORIGINAL_START_FRAME=FALSE
 +! /EXPORT_START_FRAME=1
 +! /EXPORT_END_FRAME=EOF
 +! /EXPORT_PROCESSED_TARGET_DATA=FALSE
 +! /EXPORT_PROCESSED_ANALOG_DATA=FALSE
 +! /TRUNCATE_PARAMETER_SECTION=FALSE
 +/EXPORT_ALL_LANDMARKS=FALSE
 +! /EXPORT_DIGITIZING_LANDMARKS=FALSE
 +! /EXPORT_FUNCTIONAL_LANDMARKS=FALSE
 +! /EXPORT_EMPTY_TARGETS=FALSE
 +! /EVENT_LABELS=
 +! /EXPORT_OLD_EVENT_LABELS=FALSE
 +;
 +</code>
 +
 +===== Command Parameters =====
 +
 +The **Export_C3DFile** command parameter definitions are found below:
 +
 +|**Parameter**|**Description**|
 +|**/OLD_FILE_NAME=**|The name of a c3d file in the workspace. Wildcards (*) are acceptable.|
 +|**/NEW_FILE_NAME=**|The names of the files to be exported.|
 +|**/DESTINATION_FOLDER=**|The name of the folder to save the files. If no folder is specified, the user is prompted for the folder.|
 +|**/SUFFIX=**|The suffix is added to the new filename.|
 +|**/CREATE_FOLDER_PATH=FALSE**|If 'TRUE', creates the destination folder if it doesn't exist.|
 +|**/PROMPT_FOR_NEW_FILE=TRUE**|If 'TRUE', opens a dialog to allow the user to choose the destination C3D name.|
 +|**/EXPORT_ENDIAN=**|The endian for the exported file.|
 +|**/TRUNCATE_POINT_LABELS=FALSE**|Exports all point labels with 4 characters.|
 +|**/USE_ORIGINAL_START_FRAME=FALSE**|If 'TRUE', keeps the original start frame of the file.|
 +|**/EXPORT_START_FRAME=1**|Frame to start the export from.|
 +|**/EXPORT_END_FRAME=EOF**|Frame to end the export on ('EOF' = end of file).|
 +|**/EXPORT_PROCESSED_TARGET_DATA=FALSE**|If 'TRUE', exports processed marker data.|
 +|**/EXPORT_PROCESSED_ANALOG_DATA=FALSE**|If 'TRUE', exports processed analog data.|
 +|**/TRUNCATE_PARAMETER_SECTION=FALSE**|If 'TRUE', trims parameter section for compatibility.|
 +|**/EXPORT_ALL_LANDMARKS=FALSE**|(TRUE or FALSE) Export Landmarks as Targets.|
 +|**/EXPORT_DIGITIZING_LANDMARKS=FALSE**|(TRUE or FALSE) Export Digitizing Landmarks as Targets.|
 +|**/EXPORT_EMPTY_TARGETS=FALSE**|If 'TRUE', includes empty target signals in export.|
 +|**/EVENT_LABELS=**|Specify which event labels to export.|
 +|**/EXPORT_OLD_EVENT_LABELS=FALSE**|If 'TRUE", uses old event label format for compatibility.|
 +
 +===== Dialog =====
 +
 +The command can be edited in a 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:
 +
 +{{:visual3d:documentation:pipeline:file_commands:exportc3dfile_dialogbox.png?500|}}
 +
 +  * **File to Export**: Dropdown to select the currently loaded motion file (C3D) from the workspace.
 +  * **New File Name**: Field to define the new exported C3D file name.
 +  * **Export Folder**: Directory where the exported file will be saved. You can browse to select a location.
 +  * **File Suffix**: Text suffix added to the original filename.
 +  * **Replace File if it Exists**: If checked, allows overwriting existing C3D files with the same name.
 +  * **Prompt for new file if folder and filename are blank**: Ensures a prompt appears if no filename or folder is specified.
 +  * **Select Old 4/18 Character Event Labels in Header to Export**: Text field or listbox to manually enter or select legacy event labels.
 +  * **Export Original First Frame**: Maintains the original file's start frame (otherwise export starts at frame 1 or a specified value.
 +  * **Export All Landmarks as Targets**: Includes digitized anatomical landmarks in the export as regular target points.
 +  * **Export Functional Joint Landmarks as Targets**: Exports joint center landmarks as target markers.
 +  * **Export Unnamed and Empty Targets**: Includes targets that do not have reliable tracking or are unnamed.
 +  * **Export Processed Target Data**: Exports the filtered or otherwise processed marker data instead of raw target signals.
 +  * **Export Processed Analog Data**: Exports processed analog signals (e.g., filtered EMG) instead of raw analog data.
 +  * **4 Character Labels**: If checked, trims target names to four characters for older software compatibility.
 +  * **Truncate Parameters Section**: Reduces the parameter section to the minimum required set (useful for older systems or simpler exports).
 +  * **Export Old 4/18 Character Event Labels in Header**: Uses older event label format in the C3D header for compatibility with legacy systems. 
 +  * **Endian**: Dropdown to select the endian format (PC, VAX, SGI) for the binary C3D output.
 +  * **Export Start Frame**: Specifies which frame of the motion file to begin exporting.
 +  * **Export End Frame**: Specifies the final frame to export. Default is EOF (End of File).
 +
 +===== Examples =====
 +
 +The following examples will go through the use of the **Export_C3DFile** command in the Visual3D application.
 +
 +
 +==== Example 1: Exporting between Event_Labels ====
 +
 +Only a START_FRAME and an END_FRAME are available as parameters for the export command. To export between EVENT_LABELS:
 +
 +<code>
 +Set_Pipeline_Parameter_From_Expression
 +/PARAMETER_NAME=START_FRAME
 +/EXPRESSION=1+EVENT_LABEL::ORIGINAL::START*PARAMETERS::POINT::RATE
 +/AS_INTEGER=TRUE
 +;
 +Set_Pipeline_Parameter_From_Expression
 +/PARAMETER_NAME=ENDFRAME
 +/EXPRESSION=1+EVENT_LABEL::ORIGINAL::END*PARAMETERS::POINT::RATE
 +/AS_INTEGER=TRUE
 +;
 +
 +Export_C3DFile
 +/OLD_FILE_NAME=C:\Demo Files\CaseAMD\amd001.c3d
 +/NEW_FILE_NAME=test.c3d
 +/DESTINATION_FOLDER=Z:\scottselbie 1\Desktop\test\
 +/SUFFIX=
 +/EXPORT_ENDIAN=1
 +! /TRUNCATE_POINT_LABELS=FALSE
 +! /USE_ORIGINAL_START_FRAME=FALSE
 +/EXPORT_START_FRAME=::START_FRAME
 +/EXPORT_END_FRAME=::END_FRAME
 +! /EXPORT_PROCESSED_TARGET_DATA=FALSE
 +! /EXPORT_PROCESSED_ANALOG_DATA=FALSE
 +! /TRUNCATE_PARAMETER_SECTION=FALSE
 +/EXPORT_ALL_LANDMARKS=FALSE
 +! /EXPORT_DIGITIZING_LANDMARKS=FALSE
 +! /EXPORT_FUNCTIONAL_LANDMARKS=FALSE
 +! /EXPORT_EMPTY_TARGETS=FALSE
 +! /EVENT_LABELS=
 +! /EXPORT_OLD_EVENT_LABELS=FALSE
 +;
 +</code>
 +==== Example 2: Exporting all C3D files from the Workspace ====
 +
 +This example will export all C3D files in the Workspace
 +
 +<code>
 +Export_C3DFile
 +/Old_File_Name= *.c3d
 +!/New_File_Name=
 +/Destination_Folder=
 +/Suffix=
 +!/Export_Endian=
 +!/Truncate_Point_Labels=
 +!/USE_ORIGINAL_START_FRAME=FALSE
 +!/EXPORT_START_FRAME=1
 +!/EXPORT_END_FRAME=EOF
 +!/Export_Processed_Data= false
 +!/Truncate_Parameter_Section=false
 +!/Export_Junk_Targets=false
 +!/Export_Old_Event_Labels=false
 +!/Event_Labels=
 +;
 +</code>
 +
 +Note that the **/Destination_Folder=** is not specified in the command above. To have control over the destination folder for the exported C3D file, the entire path to the exported file should be specified. Often this is done by adding a pipeline command to prompt the user for the Folder Path.
 +
 +<code>
 +! This will allow the user to set the folder path for the destination files
 +Set_Pipeline_Parameter_To_Folder_Path
 +/PARAMETER_NAME= FOLDER
 +/PARAMETER_VALUE=
 +;
 +
 +! Export all C3D files in the Workspace to the Folder path specified by the user
 +Export_C3DFile
 +/Old_File_Name= *.c3d
 +!/New_File_Name=
 +/Destination_Folder=::FOLDER
 +/Suffix=
 +!/Export_Endian=
 +!/Truncate_Point_Labels=
 +!/USE_ORIGINAL_START_FRAME=FALSE
 +!/EXPORT_START_FRAME=1
 +!/EXPORT_END_FRAME=EOF
 +!/Export_Processed_Data= false
 +!/Truncate_Parameter_Section=false
 +!/Export_Junk_Targets=false
 +!/Export_Old_Event_Labels=false
 +!/Event_Labels=
 +;
 +</code>
 +
 +==== Exporting Processed Signals ====
 +
 +If **/Export_Processed_Data= TRUE**, Visual3D exports only data from the TARGET PROCESSED folder.
 +
 +If there are no signals in the PROCESSED folder, the exported C3D file will contain no POINT data.
 +
 +<code>
 +! This will allow the user to set the folder path for the destination files
 +Set_Pipeline_Parameter_To_Folder_Path
 +/PARAMETER_NAME= FOLDER
 +/PARAMETER_VALUE=
 +;
 +
 +! Export all C3D files in the Workspace to the Folder path specified by the user
 +! Visual3D exports only data from the TARGET PROCESSED folder
 +Export_C3DFile
 +/Old_File_Name= *.c3d
 +!/New_File_Name=
 +/Destination_Folder=::FOLDER
 +/Suffix=
 +!/Export_Endian=
 +!/Truncate_Point_Labels=
 +!/USE_ORIGINAL_START_FRAME=FALSE
 +!/EXPORT_START_FRAME=1
 +!/EXPORT_END_FRAME=EOF
 +/Export_Processed_Data= TRUE
 +!/Truncate_Parameter_Section=false
 +!/Export_Junk_Targets=false
 +!/Export_Old_Event_Labels=false
 +!/Event_Labels=
 +!/Number_Of_Frames_To_Export=ALL
 +;
 +</code>
 +
 +----
 +[[Visual3D:Documentation:Pipeline:General_Information:Pipeline_Commands_Reference|Back to Pipeline Commands Reference]]
 +
 +
  
visual3d/documentation/pipeline/file_commands/export_c3dfile.1719432316.txt.gz · Last modified: 2024/06/26 20:05 by sgranger