HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » visual3d » documentation » reports » Reports Overview
visual3d:documentation:reports:reports_overview

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:reports_overview [2024/07/17 15:11] – sgrangervisual3d:documentation:reports:reports_overview [2025/02/06 20:21] (current) – [Report Examples] wikisysop
Line 1: Line 1:
-====== Reports_Overview ======+====== Reports Overview ======
  
 Visual3D creates a Workspace into which all data is stored, models are integrated, and reports are produced. The entire workspace can be saved and shared as a digital report in which all the underlying analysis, data, and models can be accessed. Visual3D creates a Workspace into which all data is stored, models are integrated, and reports are produced. The entire workspace can be saved and shared as a digital report in which all the underlying analysis, data, and models can be accessed.
Line 9: Line 9:
 ==== Report Template ==== ==== Report Template ====
  
-After you have created a report, you may choose to save a report template file, which saves not only the formal structure of the printed report, but actually the entire structure of the workspace, i.e., everything but the data. Provided you are consistent in using TAGS for the movement trials, you can re-use such templates for many experiments of the same type (e.g., same experimental protocol, multiple subjects).+After you have created a report, you may choose to save a report template file, which saves not only the formal structure of the printed report, but actually the entire structure of the workspace (i.e. everything but the data). Provided you are consistent in using TAGS for the movement trials, you can re-use such templates for many experiments of the same type (e.g., same experimental protocol, multiple subjects).
  
-Note that the Report Template contains the [[Visual3D:Documentation:Pipeline:General_Information:RECALC_Pipeline|Recalc Pipeline]].+**NOTE**: The Report Template contains the [[Visual3D:Documentation:Pipeline:General_Information:RECALC_Pipeline|Recalc Pipeline]].
  
 ==== Generating Reports from a Pipeline ==== ==== Generating Reports from a Pipeline ====
  
-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).\\ +Report templates may also be created using the [[Visual3D:Documentation:Pipeline:Report_Commands:Make_Line_Graph|Make_Line_Graph]] pipeline command. In conjunction with this 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.  
-\\ + 
-An example of how to create a simple report template using a pipeline can be found [[Visual3D:Documentation:Reports:Scripting_Report_Templates|here]].\\ +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). An example of how to create a simple report template using a pipeline can be found [[Visual3D:Documentation:Reports:Scripting_Report_Templates|here]]. 
-\\+
 **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.
  
Line 29: Line 29:
 Visual3D reports are laid out according to a row/column structure. Each report page can have up to a maximum of 5 rows and 5 columns, and you can specify that certain items span multiple rows or columns. Items which can be included in reports include graphs, tables, graphical representations of metrics (e.g. gait analysis metrics such as step length and cycle time), subject and laboratory information, and bitmap images imported from other programs. Visual3D reports are laid out according to a row/column structure. Each report page can have up to a maximum of 5 rows and 5 columns, and you can specify that certain items span multiple rows or columns. Items which can be included in reports include graphs, tables, graphical representations of metrics (e.g. gait analysis metrics such as step length and cycle time), subject and laboratory information, and bitmap images imported from other programs.
  
-{{:ReportPP.jpg}}+{{:visual3d:documentation:reports:reports_tab_update.png?450|}}
  
-==== Edit Page Title ==== 
- 
-{{:ReportPageTitle.jpg}} 
- 
-In the Page Title Edit Box you can enter a Text String that will be displayed as the Title. 
- 
-If "Evaluate title as an expression before display" is checked, Visual3D searches for a [[Visual3D:Documentation:Visual3D_Signal_Types:TEXT_Data_Type|TEXT_DATA]] item in the Global Workspace and displays the text data. 
- 
-For example, create a TEXT_DATA item. 
- 
-**Create_Text_Data** 
-/SIGNAL_FOLDER=TEST 
-SIGNAL_NAMES=GLOBAL::TITLE_TEXT 
-/TEXT_DATA=Hello World 
-**;** 
-{{:ReportPageTitle2.jpg}} 
  
 ==== Search and Replace ==== ==== Search and Replace ====
  
-At the bottom of the screen are the list of report pages.+As you can see from the image above in the Reports Layout section, there is a sidebar with multiple buttons used to change the report. The **Search/Replace** button allows you to replace event labels and TAGS in the report graphs. You are given the option of replacing for the selected page OR the entire report.
  
-{{:ReportPages.jpg}} +{{:visual3d:documentation:reports:search_and_replace_dialog.png?400|}}
- +
-Selecting the Search/Replace button allows you to replace event labels and TAGS in the report graphs. +
- +
-{{:ReportSearchReplace.jpg}}+
  
 ==== Report Items ==== ==== Report Items ====
  
-There are several types of graphs. The graphs are specified by selecting the graph type from the combo box +There are several items which can be added into the report. On the bottom right corner of the reports tab working space, a combo box is available that displays these items for you to choose from.
- +
-{{:ReportItems.jpg}} +
- +
-\\+
  
 +{{:visual3d:documentation:reports:reportitems_dropdown.png?500|}}
  
 === Report 2D Graph === === Report 2D Graph ===
 +Adds 2D Graph to selected page of the report, the dialog box displays the settings which can be changed by the user.
  
-Create a line graph+{{:visual3d:documentation:reports:add_new_2d_graphdialog.png?400|}}
  
-{{:ReprotGraph1.jpg}}+=== Staggered 2D Graph ===
  
-=== Staggered Graph Item ===+{{:visual3d:documentation:reports:staggered2dgraph_dialog.png?400|}}
  
-{{:StaggeredGraphItem.jpg}}+=== Balloon Text ===
  
-=== Subject Information Item ===+{{:visual3d:documentation:reports:balloontext_dialog.png?400|}}
  
-{{:SubjectInformationItem.jpg}} 
  
-=== Laboratory Information Item ===+=== Text/Metric Table ===
  
-{{:LabInformationItem.jpg}}+{{:visual3d:documentation:reports:text_metric_table_dialog.png?400|}}
  
 === Temporal Distance Calculations === === Temporal Distance Calculations ===
  
-Create a table containing the temporal distance metrics +Create a chart containing the temporal distance metrics.
- +
-{{:TemporalDistanceItem.jpg}} +
- +
-===  Text/Metric Table === +
- +
-create a table containing metrics +
- +
-{{:Report5_1.jpg}} +
- +
-=== Report Image Item === +
- +
-{{:ReportImageItem.jpg}} +
- +
-==== Report Examples ==== +
- +
-=== Changing the colors of lines in graphs === +
- +
-Changing the colors of lines in graphs. For example, plot both left and right knee flexion on the same graph but both sets of data should be different colors. +
-=== Explicit Settings for Report Graphs ===+
  
-Explicit Settings for Report Graphs +{{:visual3d:documentation:reports:temporal_distance_dialog.png?400|}}
-=== Graph mean and standard deviation from a p2d file ===+
  
-How do I graph the mean and standard deviation from a p2d file? +=== Subject Information ===
-=== Adding an annotation at 60% along the x-axis ===+
  
-Adding an annotation at 60% along the x-axis +{{:visual3d:documentation:reports:subjectinform_dialog.png?400|}}
-=== Adding text to a text/metric table ===+
  
-Adding text to a text/metric table in the report +=== Image ===
-=== Create a mean signal that contains data from both the left and right sides ===+
  
-Create a mean signal that contains data from both the left and right sides of the body. +{{:visual3d:documentation:reports:image_dialog.png?400|}}
-=== Find the signal that is most representative of a set of signals ===+
  
-Find the signal that is most representative of a set of signals. This implementation is based on the following article: +=== Laboratory Information ===
-Shadmehr R and Mussa-Ivaldi FA (1994) Adaptive Representation of Dynamics during Learning of a Motor Task. J. Neuroscience 14(5), pp 3208-3224. +
-=== Add an Image to a Report ===+
  
-A pipeline example of how to add images to a Visual3d report. The example adds an image from each of three sequential numbered trials with the images position on the page based on the number in the name of the c3d file+Laboratory Information is filled out automatically based on what is listed in your dataset.
  
  
visual3d/documentation/reports/reports_overview.1721229097.txt.gz · Last modified: 2024/07/17 15:11 by sgranger