====== Pipeline Example Assigning Tags ======

This example assigns TAGS to files based on a specific naming convention for the files.

Consider files that have been named as follows and stored in the same disk folder:

c:\Visual3D\Data\subject#LMH_max.c3d
c:\Visual3D\Data\subject#RMH_max.c3d
c:\Visual3D\Data\subject#LVL_max.c3d
c:\Visual3D\Data\subject#RVL_max.c3d
c:\Visual3D\Data\subject#LTA_max.c3d
c:\Visual3D\Data\subject#RTA_max.c3d
where the capitalized 3 letter acronyms refer to a muscle EMG. The following TAGS should be assigned to the files:

LMH, RMH, LVL, RVL, LTA, RTA
\\
The following pipeline will open the files and assign the appropriate TAGS.

<code>
! -------------------------------------------------------------------------------------------------- 
! Open the EMG files and Assign the TAGS 
! -------------------------------------------------------------------------------------------------- 

! -------------------------------------------------------------- 
! Prompt the user for the folder containing the data files 
! -------------------------------------------------------------- 

Set_Pipeline_Parameter_To_Folder_Path 
/PARAMETER_NAME=EMG_MAX_FOLDER_PATH
/PARAMETER_VALUE= 
! /PARAMETER_VALUE_SEARCH_FOR= 
! /PARAMETER_VALUE_REPLACE_WITH= 
! /PARAMETER_VALUE_APPEND= 
/SET_PROMPT=Select folder containing Max EMG signals
; 

! ------------------------------------------------------------ 
! Create a pipeline parameter identifying the EMG files and open the files 
! ------------------------------------------------------------ 

Set_Pipeline_Parameter 
/PARAMETER_NAME=EMG_MAX_FILES
/PARAMETER_VALUE=::EMG_MAX_FOLDER_PATH&*max*.c3d 
;

Open_File 
/FILE_NAME=::EMG_MAX_FILES
; 

! -------------------------------------------------------------------------- 
! For convenience switch to the Event Processing Mode in Visual3D 
! -------------------------------------------------------------------------- 

Switch_to_Event_Processing_Mode 
; 

! ------------------------------------------------- 
! Create a For_Each loop for the tag assignments 
! -------------------------------------------------  

For_Each 
/ITERATION_PARAMETER_NAME=INDEX 
/ITEMS=LMH+RMH+LVL+RVL+LTA+RTA+LGAS 
;

   Assign_Tags_To_Files 
   /MOTION_FILE_NAMES=*&::INDEX&*.c3d 
   ! /QUERY= 
   /TAGS=::INDEX 
   ; 

End_For_Each 
/ITERATION_PARAMETER_NAME=INDEX 
;
</code>