Differences

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

--- visual3d:documentation:pipeline:file_commands:remove_prefix_from_point_labels [2024/07/17 15:23] – sgranger
+++ visual3d:documentation:pipeline:file_commands:remove_prefix_from_point_labels [2025/01/14 21:00] (current) – Cleaned up page, in progress. wikisysop
@@ Line 1: / Line 1: @@
-====== Remove Prefix From Point Labels ======
+===== Remove Prefix From Point Labels =====
-Remove the prefix from marker names.
+This pipeline command allows you to remove the specified prefix(es) from [[visual3d:documentation:c3d_signal_types:target_data_type|TARGET]] (marker) names within the active files.
 ==== Command ====
-**Remove_Prefix_From_Point_Labels**
+<code>
+Remove_Prefix_From_Point_Labels
 ! /PREFIX=
 ! /INCLUDE_CAL_FILE=TRUE
 ! /OVERWRITE_C3D_FILE=FALSE
-**;**
+;
-Some motion capture manufacturer's software provides an option to add a prefix to all of the marker labels. This causes Visual3D a big problem because Visual3D assumes that markers are named consistently between files, especially between the standing trial and the movement trials.
+</code>
-This command can be used to remove marker prefix from targets.
+Some motion capture manufacturers' software provides an option to add a prefix to all of the marker labels. This has the potential to cause a big problem when reading these files in Visual3D, since an assumption is made that markers are named consistently between files, especially between the standing trial and the movement trials.
-==== /Prefix Parameter ====
+This command can be used to remove the marker prefix from [[visual3d:documentation:c3d_signal_types:target_data_type|TARGET]]s.
+=== /Prefix Parameter ===
 If the PREFIX parameter is specified, only this prefix will be removed from the signal names.
-If the PREFIX parameter is left blank, Visual3D looks for the C3D Parameter Group called "SUBJECTS" and the parameter "LABEL_PREFIXES". This could contain several entries, and Visual3D searches the TARGETS for signals containing these names and the prefix is removed from the name.
+If the PREFIX parameter is left blank, Visual3D looks for the [[visual3d:documentation:c3d_signal_types:c3d_format#c3d_parameter_format|C3D Parameter Group]] called "SUBJECTS" and the parameter "LABEL_PREFIXES". This could contain several entries, and Visual3D searches the [[visual3d:documentation:c3d_signal_types:target_data_type|TARGET]]s for signals containing these names and the prefix is removed from the name.
-We have seen instances where the manufacturer stores these values incorrectly.
+We have seen instances where the manufacturer stores these values incorrectly. In this case, the user should manually specify the prefix and the C3D Parameters are ignored.
-In this case, the user should manually specify the prefix and the C3D Parameters are ignored.
+=== /Include_Cal_File ===
-==== /Include_Cal_File ====
 If TRUE, the model files will be modified as well.
-==== /Overwrite_C3D_File ====
+=== /Overwrite_C3D_File ===
 If TRUE, the modified c3d file will be exported.
@@ Line 37: / Line 38: @@
 Given a file with marker names
+  - MarkerSet_C7
+  - MarkerSet_L_ACR
+  - MarkerSet_L_CLAV
+  - MarkerSet_L_FARM_1
+  - MarkerSet_L_FARM_2
+  - MarkerSet_L_FARM_3
+  - etc.
-MarkerSet_C7
+The prefix to be removed is: MarkerSet_
-MarkerSet_L_ACR
-MarkerSet_L_CLAV
-MarkerSet_L_FARM_1
-MarkerSet_L_FARM_2
-MarkerSet_L_FARM_3
-etc
-The prefix to be removed is
-MarkerSet_
 The command acts on all [Active_Files|active files], so ensure that you have selected the files you want modified.
 The command parameters are:
-**Remove_Prefix_From_Point_Labels**
+<code>
+Remove_Prefix_From_Point_Labels
 /PREFIX=MarkerSet_
 ! /INCLUDE_CAL_FILE=TRUE
 ! /OVERWRITE_C3D_FILE=FALSE
-**;**
+;
+</code>
 The result is:
-C7
+  - C7
-L_ACR
+  - L_ACR
-L_CLAV
+  - L_CLAV
-L_FARM_1
+  - L_FARM_1
-L_FARM_2
+  - L_FARM_2
-L_FARM_3
+  - L_FARM_3
-etc
+  - etc.
 [[Visual3D:Documentation:Pipeline:General_Information:Pipeline_Commands_Reference|Back to Pipeline Commands Reference]]