HAS-Motion Software Documentation

This is an old revision of the document!

---

active_files]] <code> select_active_file ! /file_name= ! /query= ! /subject_tags=no_subject ; </code> ==== file_name ==== the parameter **/file_name=** can be a single file, a tag referring to all files with that tag, or the keyword all_files, which makes all of the files in the visual3d workspace active. **note:** visual3d defines files by their full pathname. for example, the following command will not be recognized <code> select_active_file /file_name= file1.c3d ; </code> to fix the example above, you define the full pathname: <code> select_active_file /file_name= c:\data\session1\file1.c3d ; </code> or you can use a wildcard: <code> select_active_file /file_name= *file1.c3d ; </code> or you can specify a tag: <code> select_active_file /file_name= tag1 ; </code> ==== query ==== the query option (**visual3d professional only**) allows you to select a subset of the files referred by to file_name. you can query using [[visual3d:documentation:pipeline:expressions:overview|expressions]]: /query=metric::processed::mass > 75 ==== subject_tags ==== set the active subject tag - for multisubject only! ===== example 1: global_workspace ===== this example shows how to make the [[visual3d:documentation:definitions:global_workspace|global workspace]] active <code> select_active_file /file_name=global ! /query= ; </code> ===== example 2 - all_files and or query ===== from all_files select files that are tagged tag1 or tag2. note there are multiple syntaxes for the "or". two are shown below: using the "+" as the "or" operator <code> select_active_file /file_name=all_files /query=tag1 + tag2 ; </code> using "|" as the "or" operator <code> select_active_file /file_name=all_files /query=tag1 | tag2 ; </code> ===== example 3 - all_files and and not query ===== from all_files select files that are tag1 and not tag2 using the operators "&" and "not" <code> select_active_file /file_name=all_files /query=tag1 & not(tag2) ; </code> ===== example 4 - all_files and a wildcard ===== from all_files select files that do not contain the wildcard *run*.c3d this cannot be done in one step. command will be used to tag the files prior to using the select_active command. <code> ! assign tag run to files with "run" in the pathname assign_tags_to_files /motion_file_names=*run*.c3d ! /query= /tags=run ; ! assign tag not_run to files that are not tagged run assign_tags_to_files /motion_file_names=all_files /query=not(run) /tags=not_run ; ! select not_run as the active files select_active_file /file_name=not_run ! /query= ; </code> [[visual3d:documentation:pipeline:general_information:pipeline_commands_reference|back to pipeline commands reference]]