Differences

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

--- visual3d:documentation:pipeline:file_commands:export_c3dfile [2024/07/12 13:29] – removed sgranger
+++ visual3d:documentation:pipeline:file_commands:export_c3dfile [2024/12/27 16:51] (current) – [Example: Exporting between Event_Labels] wikisysop
@@ Line 1: / Line 1: @@
+====== Export C3DFile ======
+{{:ExportC3DPipeline.png}}
+There are two ways to export to a C3D File. One 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 other way is to use the **Export_C3DFile** command. 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. This page discusses the command **Export_C3DFile**
+===== Pipeline Command =====
+The **Export_C3DFile** command parameter definitions are found below:
+|**Export_C3DFile**               |                                                                                                                                                     ||
+|**/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 will be added to the new file name.                                                                                                       ||
+|**/Export_Endian=**              |The endian for the exported file.                                                                                                                    ||
+|**/Truncate_Point_Labels=**      |(true or false) exports all point labels with 4 characters.                                                                                          ||
+|**/Export_Processed_Data=**      |(true or false) exports data from the PROCESSED folder instead of the ORIGINAL folder.                                                               ||
+|**/Truncate_Parameter_Section=** |(true or false) truncates the parameter section.                                                                                                     ||
+|**/USE_ORIGINAL_START_FRAME**=   |Visual3D always refers to the first frame of data as Frame 1. Some C3D files specify a different start frame that Visual3D stores for possible export||
+|**/EXPORT_START_FRAME**= 1       |The first frame of data to export                                                                                                                    ||
+|**/EXPORT_END_FRAME**= EOF       |The last frame of data to export                                                                                                                     ||
+|**/Export_All_Landmarks=**       |(true or false) Export Landmarks as Targets.                                                                                                         ||
+|**/Export_Digitizing_Landmarks=**|(true or false) Export Digitizing Landmarks as Targets.                                                                                              ||
+|**/Export_Functional_Landmarks=**|(true or false) Export Functional Joint Landmarks as Targets.                                                                                        ||
+|**/Export_Empty_Targets=**       |(true or false) Signals that contain no data will not be exported.                                                                                   ||
+|**/Export_Old_Event_Labels=**    |(true or false) Export Event Labels in the Header Section.                                                                                           ||
+|**/Event_Labels=**               |List of Event_Labels to be exported. If empty, all Event labels\\ (up to a maximum of 18 if Old Event Labels are selected) will be exported.         ||
+===== Example: 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: 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]]