Differences

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

--- visual3d:documentation:definitions:tag [2024/07/17 15:42] – removed sgranger
+++ visual3d:documentation:definitions:tag [2024/07/17 15:45] (current) – created sgranger
@@ Line 1: / Line 1: @@
+====== Tag ======
+The file tagging mechanism allows you to define specific subsets of your C3D files, to facilitate processing these as a group. Tags can be made Active in the same fashion that individual files can be made active. Tags are a general way to set files as active since filenames are usually unique across workspaces because they are associated with the [[#Filenames|full pathname]]. A tag can be any string of characters, for example "PRE" or "POST", "Subject1" or "Subject2", "Walk" or "Run", etc.
+Files and tags have a many-to-many relationship: a file can have multiple tags associated with it and a tag can have multiple files associated with it.
+{{:Tags.png}}\\
+===== Using Tags =====
+Setting a Tag as the Active File ensures that all files associated with that tag will be processed. Tags can be used in a pipeline using the [[Visual3D:Documentation:Pipeline:File_Commands:Select_Active_File|Select_Active_File]] command. And tags can be used in a [[Visual3D:Tutorials:Reports:Creating_a_Report|Report Template]] to display only data associated with that tag.
+===== Creating Tags =====
+Tags can be created in Visual3D via the Workspace Tab, through the Add/Modify File Tags menu item, or by executing a pipeline.
+==== Workspace Tab ====
+Using the workspace tab to create tags is a great way to create tags manually when you are interactively working with a file.
+|**1.** In the Workspace tab, click "Add New File Tag"  |  {{:AddNewFileTag.png}}|
+|**2.** In the popup dialog, enter the new file tag name\\ \\ **3.** Click "Continue"  |  {{:EnterNewFileTagName.png}}  |
+|**4.** Check files that should be associated with file tag  |  {{:FileTagCheckBoxes.png}}  |
+==== File -> Add/Modify File Tags ====
+The benefit of going to File -> Add/Modify File Tags is that the dialog will allow you to select multiple files at once by clicking and dragging - instead of individually checking the check boxes as you do in the Workspace tab.
+|**1.** Go to File -> Add/Modify File Tags  |  {{:FileAssignTagToFiles.png}}  |
+|**2.** Specify the file tag name\\ \\ **3.** Click "Create New Tag"  |  {{:FileCreateNewTagName.png}}  |
+|**4.** Specify the files that should be associated with file tag\\ \\ **5.** Click "OK"  |  {{:FileAssociateFileswithTag.png}}  |
+==== Pipeline ====
+You can [[Visual3D:Documentation:Pipeline:File_Commands:Assign_Tags_To_File|assign tags to files]] using the pipeline, as well as [[Visual3D:Documentation:Pipeline:File_Commands:Combine_Tags|combine]] and [[Visual3D:Documentation:Pipeline:File_Commands:Remove_Tags|remove]] tags.
+Using the Pipeline to create tags will be the most useful when automating your processing.
+===== Removing Tags =====
+You can use the [[Visual3D:Documentation:Pipeline:File_Commands:Remove_Tags|Remove_Tags]] pipeline command.\\
+**OR**\\
+Uncheck all files associated with a tag in the Workspace tab. Once a tag has no files associated with it, it will be deleted.