Wiki Documentation Site

User Tools

Site Tools

You are here: Main Page » visual3d » documentation » pipeline » file_commands » Remove Prefix From Point Labels
visual3d:documentation:pipeline:file_commands:remove_prefix_from_point_labels

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:remove_prefix_from_point_labels [2024/07/12 14:03] – created sgrangervisual3d:documentation:pipeline:file_commands:remove_prefix_from_point_labels [2026/03/08 08:56] (current) – Revised into Pipeline command template. wikisysop
Line 1: Line 1:
-====== Remove_Prefix_From_Point_Labels ======+====== Remove Prefix From Point Labels ======
  
-Remove the prefix from marker names.+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. This pipeline command allows users to remove the specified prefix(es) from [[visual3d:documentation:c3d_signal_types:target_data_type|TARGET]] (marker) names within the active files.
  
-==== Command ====+===== Pipeline Command =====
  
-**Remove_Prefix_From_Point_Labels**+<code> 
 +Remove_Prefix_From_Point_Labels
 ! /PREFIX= ! /PREFIX=
 ! /INCLUDE_CAL_FILE=TRUE ! /INCLUDE_CAL_FILE=TRUE
 ! /OVERWRITE_C3D_FILE=FALSE ! /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.+===== Command Parameters =====
  
-==== /Prefix Parameter ====+^ Parameter ^ Description ^ 
 +| **Prefix** | If specified, only this prefix will be removed from the signal names. If 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 signal names containing these prefixes and the prefix is removed from the name. | 
 +| **Include Cal File** | If TRUE, the model files will be modified as well. | 
 +| **Overwrite C3D File** | If TRUE, the modified C3D file will be saved over the current file on disk. **Use with caution**. It is recommended that the parameter be set to FALSE in most cases so that the new names can be verified. The files can then be exported in an independent command.|
  
-If the PREFIX parameter is specified, only this prefix will be removed from the signal names. +===== Example =====
- +
-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. +
- +
-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. +
- +
-==== /Include_Cal_File ==== +
- +
-If TRUE, the model files will be modified as well. +
- +
-==== /Overwrite_C3D_File ==== +
- +
-If TRUE, the modified c3d file will be exported. +
- +
-Use this parameter with caution. It is recommended that the parameter be set to FALSE in most cases so that the new names can be verified. The files can then be exported in an independent command. +
- +
-==== Example ====+
  
 Given a file with marker names 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_. As with all commands, Remove_Prefix_From_Point_Labels acts on all [visual3d:documentation:definitions:active_files|active files], so ensure that you have selected the files you want modified.
-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_ +<code> 
-The command acts on all [Active_Files|active files], so ensure that you have selected the files you want modified. +Remove_Prefix_From_Point_Labels
- +
-The command parameters are: +
- +
-**Remove_Prefix_From_Point_Labels**+
 /PREFIX=MarkerSet_ /PREFIX=MarkerSet_
 ! /INCLUDE_CAL_FILE=TRUE ! /INCLUDE_CAL_FILE=TRUE
 ! /OVERWRITE_C3D_FILE=FALSE ! /OVERWRITE_C3D_FILE=FALSE
-**;**+; 
 +</code> 
 + 
 +The resulting TARGET names are: 
 +  - C7 
 +  - L_ACR 
 +  - L_CLAV 
 +  - L_FARM_1 
 +  - L_FARM_2 
 +  - L_FARM_3 
 +  - etc.
  
-The result is:+===== See Also =====
  
-C7 
-L_ACR 
-L_CLAV 
-L_FARM_1 
-L_FARM_2 
-L_FARM_3 
-etc 
 [[Visual3D:Documentation:Pipeline:General_Information:Pipeline_Commands_Reference|Back to Pipeline Commands Reference]] [[Visual3D:Documentation:Pipeline:General_Information:Pipeline_Commands_Reference|Back to Pipeline Commands Reference]]
  
  
  
visual3d/documentation/pipeline/file_commands/remove_prefix_from_point_labels.1720793028.txt.gz · Last modified: by sgranger