HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » visual3d » documentation » reports » Scripting Report Templates
visual3d:documentation:reports:scripting_report_templates

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:reports:scripting_report_templates [2024/06/19 12:53] – sgrangervisual3d:documentation:reports:scripting_report_templates [2024/07/17 15:46] (current) – created sgranger
Line 1: Line 1:
-{{{{{{{{====== scripting report templates ======+====== Scripting Report Templates ======
  
-===== introduction =====+===== Scripting Report Templates =====
  
-report templates may also be created using the [[visual3d:documentation:pipeline:report_commands:make_line_graph|make_line_graph]] pipeline command. in conjunction with the make_line_graph command, [[visual3d:documentation:pipeline:pipeline_commands:for_each_and_end_for_each|for_each]] loops can be used to create a report template in a few steps. before creating a report template from a script, it is important to understand that the [[visual3d:documentation:pipeline:general_information:recalc_pipeline|recalc pipeline]] (which saves the [[visual3d:documentation:visual3d_signal_types:link_model_based_data_type|compute_model_based_data]] commands) is also saved in the .rgt file (the report template file).\\+==== Introduction ==== 
 + 
 +Report templates may also be created using the [[Visual3D:Documentation:Pipeline:Report_Commands:Make_Line_Graph|Make_Line_Graph]] pipeline command. In conjunction with the Make_Line_Graph command, [[Visual3D:Documentation:Pipeline:Pipeline_Commands:For_Each_and_End_For_Each|For_Each]] loops can be used to create a report template in a few steps. Before creating a Report Template from a script, it is important to understand that the [[Visual3D:Documentation:Pipeline:General_Information:RECALC_Pipeline|RECALC pipeline]] (which saves the [[Visual3D:Documentation:Visual3D_Signal_Types:LINK_MODEL_BASED_Data_Type|COMPUTE_MODEL_BASED_DATA]] commands) is also saved in the .rgt file (the report template file).\\
 \\ \\
-**note:** using this method requires a prior knowledge of writing pipeline scripts, and it is suggested to complete the pipeline tutorials prior to testing this method.\\+**NOTE:** Using this method requires a prior knowledge of writing pipeline scripts, and it is suggested to complete the pipeline tutorials prior to testing this method.\\
  
  
-===== download =====+==== Download ====
  
-**you may download the sample reporting script and sample data files [[https://www.has-motion.com/download/examples/scriptingreporttemplate/scriptingtemplate.zip|here]].**+**You may download the sample reporting script and sample data files [[https://www.has-motion.com/download/examples/ScriptingReportTemplate/ScriptingTemplate.zip|here]].**
  
-**the entire script may also be seen [[visual3d:documentation:reports:scripting_report_templates_example|here]].**+**The entire script may also be seen [[Visual3D:Documentation:Reports:Scripting_Report_Templates_Example|here]].**
  
-====== using the script ======+===== Using the Script =====
  
-===== naming convention =====+==== Naming Convention ====
  
-this example is meant to serve as a starting point for others to work off. the sample script will create a report template for signals following this naming convention:\\ +This example is meant to serve as a starting point for others to work off. The sample script will create a report template for signals following this naming convention:\\ 
-rankleangle + lankleangle + lanklemoment + ranklemoment\\ +RAnkleAngle + LAnkleAngle + LAnkleMoment + RAnkleMoment\\ 
-as with any scripting language, consistency is key. the following example works because r and l are used to indicate the right/left sides. there are several other parameters that are based on the letters r and l.+As with any scripting language, consistency is key. The following example works because R and L are used to indicate the right/left sides. There are several other parameters that are based on the letters R and L.
  
-the signal names are indicated based on r/l +The signal names are indicated based on R/L 
-the events are plotted based on the side (r/l) and the event hs (or on) +The events are plotted based on the side (R/L) and the event HS (or ON) 
-the graph colors are based on the side (r/l) +The graph colors are based on the side (R/L) 
-if the user would like to use right/left instead of r/l, these parameters will need to be changed throughout the entire script.\\+If the user would like to use Right/Left instead of R/L, these parameters will need to be changed throughout the entire script.\\
 \\ \\
-the benefit to using a script such as the following, is that the color may be changed by modifying the parameters "color_r" and "color_l". although since these are specified using a conditional statement, the color must be specified using hex and only the number values may be used (no letters). this is explained in more detail in the comment lines of the pipeline script.\\+The benefit to using a script such as the following, is that the color may be changed by modifying the parameters "COLOR_R" and "COLOR_L". Although since these are specified using a conditional statement, the color must be specified using HEX and only the number values may be used (no letters). This is explained in more detail in the comment lines of the pipeline script.\\
  
  
-===== example 1: kinematics =====+==== Example 1: Kinematics ====
  
-to plot kinematics, the signals lankleangle, rankleangle, lkneeangle, rkneeangle, lhipangle, and rhipangle will be plotted in the report template starting at page 1. each joint (ankle, knee and hip) will be graphed on a new page, and each side (l/r) will be plotted in separate columns using different colors. the signals will be normalized as a percent of the gait cycle (hs to hs).\\+To plot kinematics, the signals LAnkleAngle, RAnkleAngle, LKneeAngle, RKneeAngle, LHipAngle, and RHipAngle will be plotted in the report template starting at page 1. Each Joint (Ankle, Knee and Hip) will be graphed on a new page, and each side (L/R) will be plotted in separate columns using different colors. The signals will be normalized as a percent of the gait cycle (HS to HS).\\
 \\ \\
-parameters such as line color and event sequence must be specified in the first command of the script. for kinematic signals, generally the user would start at page 1 and plot between hs to hs. the user will then need to indicate kinematic signals are being plotted in the next prompt. the signals associated with the kinematic_segments parameter will be assigned to the data_name_list parameter and each signal in the list will be plotted.\\+Parameters such as line color and event sequence must be specified in the first command of the script. For kinematic signals, generally the user would start at page 1 and plot between HS to HS. The user will then need to indicate kinematic signals are being plotted in the next prompt. The signals associated with the KINEMATIC_SEGMENTS parameter will be assigned to the DATA_NAME_LIST parameter and each signal in the list will be plotted.\\
 \\ \\
-the following commands will prompt the user (images of prompt below):+The following commands will prompt the user (images of prompt below):
  
 <code> <code>
-prompt_for_multiple_pipeline_parameter_values +Prompt_For_Multiple_Pipeline_Parameter_Values 
-/pipeline_parameter_name=page_count+column+row+event_1+event_2 +/PIPELINE_PARAMETER_NAME=PAGE_COUNT+COLUMN+ROW+EVENT_1+EVENT_2 
- +signal_type+signal_folder+color_r+color_l + +SIGNAL_TYPE+SIGNAL_FOLDER+COLOR_R+COLOR_L 
- +graph_trial_style+graph_mean+graph_stddev + +GRAPH_TRIAL_STYLE+GRAPH_MEAN+GRAPH_STDDEV 
-/datatype=s+s+s+s+s+s+s+s+s+s+s+s +/DATATYPE=s+s+s+s+s+s+s+s+s+s+s+s 
-/default_value=1+1+1+hs+hs+link_model_based+original+990000+109900+null+true+true+/DEFAULT_VALUE=1+1+1+HS+HS+LINK_MODEL_BASED+ORIGINAL+990000+109900+NULL+TRUE+TRUE
 ; ;
  
-set_pipeline_parameter +Set_Pipeline_Parameter 
-! list of signals that will be graphed +! List of signals that will be graphed 
-!  the side parameter will specify whether the signal is l or r +!  The SIDE parameter will specify whether the signal is L or R 
-/parameter_name=data_name_list +/PARAMETER_NAME=DATA_NAME_LIST 
-/parameter_value=ankleangle+kneeangle+hipangle+/PARAMETER_VALUE=AnkleAngle+KneeAngle+HipAngle
 ; ;
    
-set_pipeline_parameter +Set_Pipeline_Parameter 
-! list of signals that will be graphed +! List of signals that will be graphed 
-!  the side parameter will specify whether the signal is l or r +!  The SIDE parameter will specify whether the signal is L or R 
-/parameter_name=data_name_list +/PARAMETER_NAME=DATA_NAME_LIST 
-/parameter_value=&:&:&::segment_type +/PARAMETER_VALUE=&:&:&::SEGMENT_TYPE 
-/multi_pass=true+/MULTI_PASS=TRUE
 ; ;
 </code> </code>
  
-the previous commands prompt the user for the graph parameters and the signals to be graphed:+The previous commands prompt the user for the graph parameters and the signals to be graphed:
  
-|  setpipelineparameter_kinematics_graphparameters.png\\   |  setpipelineparameter_kinematics.png\\   |+|  {{:SetPipelineParameter_Kinematics_GraphParameters.png}}\\   |  {{:SetPipelineParameter_Kinematics.png}}\\   |
  
-===== example 2: kinetics =====+==== Example 2: Kinetics ====
  
-to plot kinetics, the signals lanklemoment, ranklemoment, lkneemoment, rkneemoment, lhipmoment, rhipmoment, lanklepower, ranklepower, lkneepower, rkneepower, lhippower, and rhippower will be plotted in the report template starting at page 4. each joint (ankle, knee and hip) will be graphed on a new page, and each side (l/r) will be plotted in separate columns using different colors. the signals will be normalized as a percent of the gait cycle (on to hs).\\+To plot kinetics, the signals LAnkleMoment, RAnkleMoment, LKneeMoment, RKneeMoment, LHipMoment, RHipMoment, LAnklePower, RAnklePower, LKneePower, RKneePower, LHipPower, and RHipPower will be plotted in the report template starting at page 4. Each Joint (Ankle, Knee and Hip) will be graphed on a new page, and each side (L/R) will be plotted in separate columns using different colors. The signals will be normalized as a percent of the gait cycle (ON to HS).\\
 \\ \\
-parameters such as line color and event sequence must be specified in the first command of the script. for kinetic signals, generally the user would start after the last page of kinematics and plot between on to hs. the user will then need to indicate kinetic signals are being plotted in the next prompt. the signals associated with the kinematic_segments parameter will be assigned to the data_name_list parameter and each signal in the list will be plotted.\\+Parameters such as line color and event sequence must be specified in the first command of the script. For kinetic signals, generally the user would start after the last page of kinematics and plot between ON to HS. The user will then need to indicate kinetic signals are being plotted in the next prompt. The signals associated with the KINEMATIC_SEGMENTS parameter will be assigned to the DATA_NAME_LIST parameter and each signal in the list will be plotted.\\
 \\ \\
-the following commands will prompt the user (images of prompt below):+The following commands will prompt the user (images of prompt below):
  
 <code> <code>
-prompt_for_multiple_pipeline_parameter_values +Prompt_For_Multiple_Pipeline_Parameter_Values 
-/pipeline_parameter_name=page_count+column+row+event_1+event_2 +/PIPELINE_PARAMETER_NAME=PAGE_COUNT+COLUMN+ROW+EVENT_1+EVENT_2 
- +signal_type+signal_folder+color_r+color_l + +SIGNAL_TYPE+SIGNAL_FOLDER+COLOR_R+COLOR_L 
- +graph_trial_style+graph_mean+graph_stddev + +GRAPH_TRIAL_STYLE+GRAPH_MEAN+GRAPH_STDDEV 
-/datatype=s+s+s+s+s+s+s+s+s+s+s+s +/DATATYPE=s+s+s+s+s+s+s+s+s+s+s+s 
-/default_value=4+1+1+on+hs+link_model_based+original+990000+109900+null+true+true+/DEFAULT_VALUE=4+1+1+ON+HS+LINK_MODEL_BASED+ORIGINAL+990000+109900+NULL+TRUE+TRUE
 ; ;
  
-set_pipeline_parameter +Set_Pipeline_Parameter 
-! list of signals that will be graphed +! List of signals that will be graphed 
-!  the side parameter will specify whether the signal is l or r +!  The SIDE parameter will specify whether the signal is L or R 
-/parameter_name=data_name_list +/PARAMETER_NAME=DATA_NAME_LIST 
-/parameter_value=anklemoment + kneemoment + hipmoment + anklepower + kneepower + hippower+/PARAMETER_VALUE=AnkleMoment + KneeMoment + HipMoment + AnklePower + KneePower + HipPower
 ; ;
  
-set_pipeline_parameter +Set_Pipeline_Parameter 
-! list of signals that will be graphed +! List of signals that will be graphed 
-!  the side parameter will specify whether the signal is l or r +!  The SIDE parameter will specify whether the signal is L or R 
-/parameter_name=data_name_list +/PARAMETER_NAME=DATA_NAME_LIST 
-/parameter_value=&:&:&::segment_type +/PARAMETER_VALUE=&:&:&::SEGMENT_TYPE 
-/multi_pass=true+/MULTI_PASS=TRUE
 ; ;
 </code> </code>
  
-the previous commands prompt the user for the graph parameters and the signals to be graphed:+The previous commands prompt the user for the graph parameters and the signals to be graphed: 
 + 
 +|  {{:SetPipelineParameter_Kinetics_GraphParameters.png}}\\   |  {{:SetPipelineParameter_Kinetics.png}}\\   |
  
-|  setpipelineparameter_kinetics_graphparameters.png\\   |  setpipelineparameter_kinetics.png\\   | 
  
  
-}}}}}}}} 
visual3d/documentation/reports/scripting_report_templates.1718801620.txt.gz · Last modified: 2024/06/19 12:53 by sgranger