caltester:documentation:reports
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
caltester:documentation:reports [2024/07/12 13:54] – created sgranger | caltester:documentation:reports [2024/07/17 15:44] (current) – created sgranger | ||
---|---|---|---|
Line 11: | Line 11: | ||
This simple test takes only a few minutes, could be performed prior to any data collection, and provides reassurance that your data collection is sound. | This simple test takes only a few minutes, could be performed prior to any data collection, and provides reassurance that your data collection is sound. | ||
- | |{{CalTesterFigureSmall.jpg}}| | + | |{{:CalTesterFigureSmall.jpg}}| |
CalTester is an essential tool for laboratories that: | CalTester is an essential tool for laboratories that: | ||
Line 26: | Line 26: | ||
==== Tool Bar ==== | ==== Tool Bar ==== | ||
- | {{V3DCalTesterToolBar.png}} | + | {{:V3DCalTesterToolBar.png}} |
- | {{V3DCalTesterPage1.png}} **View CalTester Report Summary Page 1** - This button helps to control the right side of the screen. When selected, the right side of the screen displays page 1 of the CalTester report, which contains a summary of the full report. | + | {{:V3DCalTesterPage1.png}} **View CalTester Report Summary Page 1** - This button helps to control the right side of the screen. When selected, the right side of the screen displays page 1 of the CalTester report, which contains a summary of the full report. |
- | {{V3DCalTesterPage2.png}} **View CalTester Report Graphs Page 2** - This button helps to control the right side of the screen. When selected, the right side of the screen displays page 2 of the CalTester report, which contains graphs for the Ground Reaction Force Magnitude, the CoP Error (X, Y & Z), and the CalTester Rod Orientation Error. | + | {{:V3DCalTesterPage2.png}} **View CalTester Report Graphs Page 2** - This button helps to control the right side of the screen. When selected, the right side of the screen displays page 2 of the CalTester report, which contains graphs for the Ground Reaction Force Magnitude, the CoP Error (X, Y & Z), and the CalTester Rod Orientation Error. |
- | {{V3DCalTesterPage3.png}} **View CalTester Report Graphs Page 3** - This button helps to control the right side of the screen. When selected, the right side of the screen displays page 3 of the CalTester report, which contains graphs for the CalTester Segment Residual, and Marker Residuals (Top Left, Top Right, Middle Left, Bottom Left, and Bottom Right). | + | {{:V3DCalTesterPage3.png}} **View CalTester Report Graphs Page 3** - This button helps to control the right side of the screen. When selected, the right side of the screen displays page 3 of the CalTester report, which contains graphs for the CalTester Segment Residual, and Marker Residuals (Top Left, Top Right, Middle Left, Bottom Left, and Bottom Right). |
- | {{V3DCalTesterZoomIn.png}} **Zoom in on the report** - This button allows the user to zoom in on the page of the report that is shown on the right side of the screen. | + | {{:V3DCalTesterZoomIn.png}} **Zoom in on the report** - This button allows the user to zoom in on the page of the report that is shown on the right side of the screen. |
- | {{V3DCalTesterZoomOut.png}} **Zoom out of the report** - This button allows the user to zoom out on the page of the report that is shown on the right side of the screen. | + | {{:V3DCalTesterZoomOut.png}} **Zoom out of the report** - This button allows the user to zoom out on the page of the report that is shown on the right side of the screen. |
- | {{V3DCalTesterRodDimensions.png}} **Modify CalTester Rod Dimensions** - This button opens the Rod Dimensions dialogue box. Further details on the function of the dialogue box can be found [[CalTester: | + | {{:V3DCalTesterRodDimensions.png}} **Modify CalTester Rod Dimensions** - This button opens the Rod Dimensions dialogue box. Further details on the function of the dialogue box can be found [[CalTester: |
- | {{V3DCalTesterPlatformParameters.png}} **Modify Force Platform Parameters** - This button opens the Modify Force Platform Parameters dialogue box. Further details on the function of the dialogue box can be found [[CalTester: | + | {{:V3DCalTesterPlatformParameters.png}} **Modify Force Platform Parameters** - This button opens the Modify Force Platform Parameters dialogue box. Further details on the function of the dialogue box can be found [[CalTester: |
- | {{V3DCalTesterForceStructure.png}} **Modify Force Structures** - This button opens the Modify Force Structure Parameters dialogue box. Further details on the function of the dialogue box can be found [[CalTester: | + | {{:V3DCalTesterForceStructure.png}} **Modify Force Structures** - This button opens the Modify Force Structure Parameters dialogue box. Further details on the function of the dialogue box can be found [[CalTester: |
- | {{V3DCalTesterPlatformLocator.png}} **Force Platform Locator** - This button opens the Force Plate Location dialogue box. Further details on the function of the dialogue box can be found [[CalTester: | + | {{:V3DCalTesterPlatformLocator.png}} **Force Platform Locator** - This button opens the Force Plate Location dialogue box. Further details on the function of the dialogue box can be found [[CalTester: |
==== Controller ==== | ==== Controller ==== | ||
- | {{V3DCalTesterController.png}} | + | {{:V3DCalTesterController.png}} |
The controller allows the user to run through the 3D animation. On the left hand side of the controller there are five blue buttons which allow the user to play/pause, jump to the beginning/ | The controller allows the user to run through the 3D animation. On the left hand side of the controller there are five blue buttons which allow the user to play/pause, jump to the beginning/ | ||
Line 62: | Line 62: | ||
**(1) The background on the file:** the top of the report contains the summary of the c3d file being used. This includes the number of frames used, the minimum force settings (for CalTester and Visual3D), and the dates the c3d file was collected and when the report was created. | **(1) The background on the file:** the top of the report contains the summary of the c3d file being used. This includes the number of frames used, the minimum force settings (for CalTester and Visual3D), and the dates the c3d file was collected and when the report was created. | ||
- | {{V3DCalTesterReportPage1Part1.png}} | + | {{:V3DCalTesterReportPage1Part1.png}} |
**(2) The report format:** the second section of the report provides an overview of how the information on the rest of the page will be organized. | **(2) The report format:** the second section of the report provides an overview of how the information on the rest of the page will be organized. | ||
Line 72: | Line 72: | ||
**Note:** The force orientation variable is calculated from the dot product of this predicted unit vector and the vector along the axis of the rod as determined with the motion capture system. | **Note:** The force orientation variable is calculated from the dot product of this predicted unit vector and the vector along the axis of the rod as determined with the motion capture system. | ||
- | {{V3DCalTesterReportPage1Part3.png}} | + | {{:V3DCalTesterReportPage1Part3.png}} |
**(4) The differences in CoP (for x, y, and z):** these are the components of the displacement vector between the CoP location measured by the force platform and the endpoint of the calibration-testing rod (adjusted for the specified vertical height above the force platform). | **(4) The differences in CoP (for x, y, and z):** these are the components of the displacement vector between the CoP location measured by the force platform and the endpoint of the calibration-testing rod (adjusted for the specified vertical height above the force platform). | ||
- | {{V3DCalTesterReportPage1Part4.png}} | + | {{:V3DCalTesterReportPage1Part4.png}} |
Differences can be due to many different factors, including errors in the force platform configuration (analog scale factors, force platform origin specification), | Differences can be due to many different factors, including errors in the force platform configuration (analog scale factors, force platform origin specification), | ||
Line 90: | Line 90: | ||
The magnitude of the force vector and the error signals are displayed in the Graphs tab of the Report. | The magnitude of the force vector and the error signals are displayed in the Graphs tab of the Report. | ||
- | {{V3DCalTesterGraphGRF_Magnitude.png}} | + | {{:V3DCalTesterGraphGRF_Magnitude.png}} |
The CalTester Center of Pressure error is measured and graphed for the X, Y and Z directions for each of the frames of data. | The CalTester Center of Pressure error is measured and graphed for the X, Y and Z directions for each of the frames of data. | ||
- | {{V3DCalTesterGraphCoP.png}} | + | {{:V3DCalTesterGraphCoP.png}} |
The orientation of the rod with regards to the vertical is graphed as well as the error of the orientation. | The orientation of the rod with regards to the vertical is graphed as well as the error of the orientation. | ||
- | {{V3DCalTesterGraphRodOrientation.png}} | + | {{:V3DCalTesterGraphRodOrientation.png}} |
From this view the user can select the range of data to be processed. This will allow the user to eliminate anomalous data from the calibration calculations. To select the range, left click and drag the mouse on the Ground Reaction Force Magnitude graph. A green highlighted section will appear on the graph and all of the graphs will be limited to this range. To return to the original range, left click on the Ground Reaction Force Magnitude graph and the full range will return to all of the graphs.\\ | From this view the user can select the range of data to be processed. This will allow the user to eliminate anomalous data from the calibration calculations. To select the range, left click and drag the mouse on the Ground Reaction Force Magnitude graph. A green highlighted section will appear on the graph and all of the graphs will be limited to this range. To return to the original range, left click on the Ground Reaction Force Magnitude graph and the full range will return to all of the graphs.\\ | ||
Line 107: | Line 107: | ||
The third page of the report has six graphs. The first graph is the CalTester Segment Residual Graph. This graph shows the residual of the whole CalTester Segment during the trials that were used. | The third page of the report has six graphs. The first graph is the CalTester Segment Residual Graph. This graph shows the residual of the whole CalTester Segment during the trials that were used. | ||
- | {{V3DCalTesterSegmentResidualGraph.png}} | + | {{:V3DCalTesterSegmentResidualGraph.png}} |
The final five graphs show the residuals for the individual markers. For the sample shown below the markers that are used are: C1, C2, C5, C3, and C4. | The final five graphs show the residuals for the individual markers. For the sample shown below the markers that are used are: C1, C2, C5, C3, and C4. | ||
- | {{V3DCalTesterGraphsC1_2_5.png}} | + | {{:V3DCalTesterGraphsC1_2_5.png}} |
- | {{V3DCalTesterGraphsC3_4.png}} | + | {{:V3DCalTesterGraphsC3_4.png}} |
===== Tutorials ===== | ===== Tutorials ===== | ||
Line 137: | Line 137: | ||
**Creating a Report** (click to expand) | **Creating a Report** (click to expand) | ||
- | |The report capabilities of the CalTester tab creates an error report based on collection trials.\\ \\ **1. Add C3D files**\\ \\ In order to open a C3d file for use in the CalTester tab you must first navigate to the CalTester tab and leave it active. The C3D files are then opened by clicking on the open button. {{V3DOpenButton.png}} This will open a standard file navigation window which you can use to select the files you wish to include in the report.\\ \\ **2. Check Report**\\ \\ Once the files are loaded the right side of the CalTester tab will show the first page of the CalTester report. You can navigate between the three report pages by using the page buttons in the tool bar. {{V3DCalTester3PageButtons.png}}\\ \\ **3. Print Report**\\ \\ The report that has been generated on the right side of the screen can be saved as a pdf document by using the file drop down menu and selecting Print or by using the Ctrl + P short cut.\\ \\ **4. Understanding the Report**\\ \\ A detailed explanation of how to understand the report that CalTester produces can be found [[index.php? | + | |The report capabilities of the CalTester tab creates an error report based on collection trials.\\ \\ **1. Add C3D files**\\ \\ In order to open a C3d file for use in the CalTester tab you must first navigate to the CalTester tab and leave it active. The C3D files are then opened by clicking on the open button. {{:V3DOpenButton.png}} This will open a standard file navigation window which you can use to select the files you wish to include in the report.\\ \\ **2. Check Report**\\ \\ Once the files are loaded the right side of the CalTester tab will show the first page of the CalTester report. You can navigate between the three report pages by using the page buttons in the tool bar. {{:V3DCalTester3PageButtons.png}}\\ \\ **3. Print Report**\\ \\ The report that has been generated on the right side of the screen can be saved as a pdf document by using the file drop down menu and selecting Print or by using the Ctrl + P short cut.\\ \\ **4. Understanding the Report**\\ \\ A detailed explanation of how to understand the report that CalTester produces can be found [[index.php? |
Line 145: | Line 145: | ||
**Determining the Force Plate Location** (click to expand) | **Determining the Force Plate Location** (click to expand) | ||
- | |The CalTester tab can be used to determine the location of a force plate relative to the cameras and the coordinate system if a jig is also present in the file. It will produce a written report detailing the force platform' | + | |The CalTester tab can be used to determine the location of a force plate relative to the cameras and the coordinate system if a jig is also present in the file. It will produce a written report detailing the force platform' |
Line 153: | Line 153: | ||
**Defining a Jig** (click to expand) | **Defining a Jig** (click to expand) | ||
- | |By creating a jig the user can identify the location of a force plate without having to repeating the entire CalTesterPlus platform protocol each time. In order to use this function you need to have a set of permanent markers (i.e. a template or a jig) which have a consistent position relative to the force platform.\\ \\ - Load the files into Visual3D while the CalTester tab is active.\\ - Click on the Force Platform Locator button {{V3DCalTesterPlatformLocator.png}} in order to open the Force Platform Locator dialogue box.\\ - Make sure that the Define Jig tab is selected.\\ - In the Select Jig section, click the Add New Jig button.\\ - In the Define Jig Targets section, use the drop down menu at the left of the section to select the targets that are included in the jig and click Add Targets. Do this until all of the targets that are in the jig are listed in the Target list to the right of the section.\\ - In the Force Platform section, select from the FP drop down menu that you wish to locate with the Jig.\\ - In the Define Force Platform Dimension section, check that the FP Length and FP Width are correct. If they are, make sure that the Use Current Dimension radio box is selected. If they are not, select Use New Dimension radio box and change the FP Length and FP Width to the correct values.\\ - In the file list at the bottom of the box, select the C3D files that have both the force plate and the jig. A minimum of 3 C3D files must be used to create the Jig File.\\ - Click on the Calculate Results button in order to produce the CalTester Results window. This window can be exported by using the Export to text button in the bottom left of the screen.\\ \\ A sample of the output that should be created is provided below:\\ \\ ==== Fixed marker locations in force platform space (MKS units) ====\\ \\ /JIG_NAME = Jig_1\\ \\ /FP_TESTED = 1\\ \\ / | + | |By creating a jig the user can identify the location of a force plate without having to repeating the entire CalTesterPlus platform protocol each time. In order to use this function you need to have a set of permanent markers (i.e. a template or a jig) which have a consistent position relative to the force platform.\\ \\ - Load the files into Visual3D while the CalTester tab is active.\\ - Click on the Force Platform Locator button {{:V3DCalTesterPlatformLocator.png}} in order to open the Force Platform Locator dialogue box.\\ - Make sure that the Define Jig tab is selected.\\ - In the Select Jig section, click the Add New Jig button.\\ - In the Define Jig Targets section, use the drop down menu at the left of the section to select the targets that are included in the jig and click Add Targets. Do this until all of the targets that are in the jig are listed in the Target list to the right of the section.\\ - In the Force Platform section, select from the FP drop down menu that you wish to locate with the Jig.\\ - In the Define Force Platform Dimension section, check that the FP Length and FP Width are correct. If they are, make sure that the Use Current Dimension radio box is selected. If they are not, select Use New Dimension radio box and change the FP Length and FP Width to the correct values.\\ - In the file list at the bottom of the box, select the C3D files that have both the force plate and the jig. A minimum of 3 C3D files must be used to create the Jig File.\\ - Click on the Calculate Results button in order to produce the CalTester Results window. This window can be exported by using the Export to text button in the bottom left of the screen.\\ \\ A sample of the output that should be created is provided below:\\ \\ ==== Fixed marker locations in force platform space (MKS units) ====\\ \\ /JIG_NAME = Jig_1\\ \\ /FP_TESTED = 1\\ \\ / |
Line 161: | Line 161: | ||
**Locating the Force Plate with a Jig** (click to expand) | **Locating the Force Plate with a Jig** (click to expand) | ||
- | |The CalTester tab can define the location of the Force Plates in lab coordinate system based on the location of the Jig (how to define the location of the Jig is described above).\\ \\ - Load the files into Visual3D while the CalTester tab is active.\\ - Click on the Force Platform Locator button {{V3DCalTesterPlatformLocator.png}} in order to open the Force Platform Locator dialogue box.\\ - Make sure that the FP Loc (Jig) tab is selected.\\ - In the Select Jig section, if the Jig you wish to use is already listed in the text box, select it, otherwise click on the Load Jig File button and select the Jig File that you created using the Defining a Jig tutorial above.\\ - At the bottom of the dialogue box, select the C3D files that should be updated using the selected jig.\\ - Click on the Calculate Results button. | + | |The CalTester tab can define the location of the Force Plates in lab coordinate system based on the location of the Jig (how to define the location of the Jig is described above).\\ \\ - Load the files into Visual3D while the CalTester tab is active.\\ - Click on the Force Platform Locator button {{:V3DCalTesterPlatformLocator.png}} in order to open the Force Platform Locator dialogue box.\\ - Make sure that the FP Loc (Jig) tab is selected.\\ - In the Select Jig section, if the Jig you wish to use is already listed in the text box, select it, otherwise click on the Load Jig File button and select the Jig File that you created using the Defining a Jig tutorial above.\\ - At the bottom of the dialogue box, select the C3D files that should be updated using the selected jig.\\ - Click on the Calculate Results button. |
caltester/documentation/reports.1720792487.txt.gz · Last modified: 2024/07/12 13:54 by sgranger