HAS-Motion Software Documentation

User Tools

Site Tools

You are here: Main Page » caltester » documentation » Reports
caltester:documentation:reports

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
caltester:documentation:reports [2025/08/13 14:45] – sgrangercaltester:documentation:reports [2025/08/13 14:46] (current) – sgranger
Line 119: Line 119:
 ==== Collecting Static Trials ==== ==== Collecting Static Trials ====
  
-|In order to use the CalTesterPlus program you need a set of properly collected data for each force platform you wish to calibrate. To collect a useful static trial for CalTester follow the following process.\\ \\ - Set up your capture volume making sure that all force platforms and cameras are in the positions that they will remain in for following data collections.\\ - Place the [[CalTester:CalTesterPlus:Hardware#Base_Plate|CalTester base plate]] on the force platform before you begining the collecting the trial.\\ - Zero the force platform so that it will not record the force produced by the CalTester base.\\ - Begin the trial with the [[CalTester:CalTesterPlus:Hardware#Rod_and_Markers|CalTester Rod]] on the CalTester base plate OFF the force platform.\\ - Press down firmly on the Rod with a load of at least 200 N.\\ - Keep the Rod aligned vertically and motionless during the trial.\\ - The trial needs to be at least 1 second long.\\ - There should be a minimum of three trial collected per force platform. Ideally there should be 8 or more, with at least one near each corner of the force platform and one near the center of the force platform.  |+In order to use the CalTesterPlus program you need a set of properly collected data for each force platform you wish to calibrate. To collect a useful static trial for CalTester follow the following process.\\ \\ - Set up your capture volume making sure that all force platforms and cameras are in the positions that they will remain in for following data collections.\\ - Place the [[CalTester:CalTesterPlus:Hardware#Base_Plate|CalTester base plate]] on the force platform before you begining the collecting the trial.\\ - Zero the force platform so that it will not record the force produced by the CalTester base.\\ - Begin the trial with the [[CalTester:CalTesterPlus:Hardware#Rod_and_Markers|CalTester Rod]] on the CalTester base plate OFF the force platform.\\ - Press down firmly on the Rod with a load of at least 200 N.\\ - Keep the Rod aligned vertically and motionless during the trial.\\ - The trial needs to be at least 1 second long.\\ - There should be a minimum of three trial collected per force platform. Ideally there should be 8 or more, with at least one near each corner of the force platform and one near the center of the force platform.
  
  
Line 127: Line 127:
 ==== Collecting Dynamic Trials ==== ==== Collecting Dynamic Trials ====
  
-|In order to use the CalTesterPlus program you need a set of properly collected data for each force platform you wish to calibrate. To collect a useful motion trial for the report mode follow the following process.\\ \\ * Each example motion trial that is downloaded with the CalTesterPlus program meets these criteria.\\ \\ - Set up your capture volume making sure that all force platforms and cameras are in the positions that they will remain in for following data collections.\\ - Before you begin collecting the trial place the [[CalTester:CalTesterPlus:Hardware#Base_Plate|CalTester base plate]] on the force platform.\\ - Zero the force platform so that it will not record the force produced by the CalTester base.\\ - Begin the data capture with the [[CalTester:CalTesterPlus:Hardware#Rod_and_Markers|CalTester Rod]] not in contact with the force platform.\\ - After a second place the CalTester Rod in one of the CalTester base platform's divots, from this point on the CalTester should be the only thing that comes in contact with the force platform.\\ - Press down on the rod with a load of at least 200 N.\\ - Move the rod in either the frontal or sagittal direction:\\ - Keeping the end of the rod on the force platform stationary move the upper portion of the rod from vertical to 30 degrees from vertical, back to vertical and then 30 degrees in the opposite direction. This movement should take no less than 3 seconds and the force applied should be equal to or greater than 200 N.\\ - Each trial does not need to be more than 3 seconds long.\\ - There should be a minimum of three trials collected per force platform. Ideally there should be 5, one near each corner of the force platform and one near the center of the force platform.  |+In order to use the CalTesterPlus program you need a set of properly collected data for each force platform you wish to calibrate. To collect a useful motion trial for the report mode follow the following process.\\ \\ * Each example motion trial that is downloaded with the CalTesterPlus program meets these criteria.\\ \\ - Set up your capture volume making sure that all force platforms and cameras are in the positions that they will remain in for following data collections.\\ - Before you begin collecting the trial place the [[CalTester:CalTesterPlus:Hardware#Base_Plate|CalTester base plate]] on the force platform.\\ - Zero the force platform so that it will not record the force produced by the CalTester base.\\ - Begin the data capture with the [[CalTester:CalTesterPlus:Hardware#Rod_and_Markers|CalTester Rod]] not in contact with the force platform.\\ - After a second place the CalTester Rod in one of the CalTester base platform's divots, from this point on the CalTester should be the only thing that comes in contact with the force platform.\\ - Press down on the rod with a load of at least 200 N.\\ - Move the rod in either the frontal or sagittal direction:\\ - Keeping the end of the rod on the force platform stationary move the upper portion of the rod from vertical to 30 degrees from vertical, back to vertical and then 30 degrees in the opposite direction. This movement should take no less than 3 seconds and the force applied should be equal to or greater than 200 N.\\ - Each trial does not need to be more than 3 seconds long.\\ - There should be a minimum of three trials collected per force platform. Ideally there should be 5, one near each corner of the force platform and one near the center of the force platform.
  
  
Line 135: Line 135:
 ==== Creating a Report ==== ==== Creating a Report ====
  
-|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?title=CalTester_Reporting_Tab&action=edit&redlink=1|here]].\\ \\ **Note:**\\ \\ If there appears to be errors or discrepancies in the report or the 3D-view check that the markers have been identified correctly and that the rod dimensions are correct using the Modify CalTester Rod Dimensions button. {{:V3DCalTesterRodDimensions.png}}  |+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?title=CalTester_Reporting_Tab&action=edit&redlink=1|here]].\\ \\ **Note:**\\ \\ If there appears to be errors or discrepancies in the report or the 3D-view check that the markers have been identified correctly and that the rod dimensions are correct using the Modify CalTester Rod Dimensions button. {{:V3DCalTesterRodDimensions.png}}
  
  
Line 143: Line 143:
 ==== Determining the Force Plate Location ==== ==== Determining the Force Plate Location ====
  
-|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's exact location in your lab. This report can be saved as a text file and the values can be inputted into the data collection software that you use.\\ \\ - 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 FPLoc tab is selected.\\ - In the Select Force Platform section, select the Force Plate you whish to locate using the drop down box.\\ - 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 in the same location. At least 3 files must be used, but it is recommended that at least 8 be used.\\ - Click on the Compute Optimal Configuration button.\\ - Wait for Visual3D to calculate the configuration. This may take a few seconds.\\ - The CalTester Results window will open and present the following: the output for the force platform, the corrected location (in mm), the force platform center, the rotation matrix (into lab space), the cardan angles to rotate from lab to force platform, the cardan angles to rotate from force platform to lab space, the nexus orientation parameters, and the Visual3D command.\\ - If you wish to save the output you can click on the Export to text button at the bottom left of the results dialogue box.\\ \\ A sample of the output that should be created is provided below:\\ \\ Output for force platform 1 :\\ \\ ======== Corrected Locations (in mm): ========\\ \\ Corner 1: -624.8758, 685.1889, 1.5064\\ \\ Corner 2: -17.5759, 687.8662, 1.6895\\ \\ Corner 3: -14.8988, 80.5641, 2.1519\\ \\ Corner 4: -622.1987, 77.8868, 1.9688\\ \\ Force platform Center:\\ \\ -319.8873, 382.8765, 1.8292\\ \\ ===============================================\\ \\ Rotation Matrix (into lab space):\\ \\ -0.999990 -0.004408 0.000305\\ \\ -0.004408 0.999990 -0.000760\\ \\ -0.000302 -0.000761 -1.000000\\ \\ Cardan angles to rotate from lab to force platform\\ \\ Angle 1 (x): 179.956451\\ \\ Angle 2 (y): 0.017473\\ \\ Angle 3 (z): 179.747421\\ \\ \\ \\ \\ Cardan angles to rotate from force platform to lab space\\ \\ Angle 1 (x): 179.956375\\ \\ Angle 2 (y): -0.017281\\ \\ Angle 3 (z): 179.747406\\ \\ \\ \\ \\ Nexus orientation parameters:\\ \\ -0.043584\\ \\ -0.017377\\ \\ 0.252580\\ \\ Visual3D Command\\ \\ Modify_One_Force_Platform\\ \\ /FP_SELECTED= 1\\ \\ /FP_CORNER1= -624.8758 + 685.1889 + 1.5064\\ \\ /FP_CORNER2= -17.5759 + 687.8662 + 1.6895\\ \\ /FP_CORNER3= -14.8988 + 80.5641 + 2.1519\\ \\ /FP_CORNER4= -622.1987 + 77.8868 + 1.9688  |+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's exact location in your lab. This report can be saved as a text file and the values can be inputted into the data collection software that you use.\\ \\ - 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 FPLoc tab is selected.\\ - In the Select Force Platform section, select the Force Plate you whish to locate using the drop down box.\\ - 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 in the same location. At least 3 files must be used, but it is recommended that at least 8 be used.\\ - Click on the Compute Optimal Configuration button.\\ - Wait for Visual3D to calculate the configuration. This may take a few seconds.\\ - The CalTester Results window will open and present the following: the output for the force platform, the corrected location (in mm), the force platform center, the rotation matrix (into lab space), the cardan angles to rotate from lab to force platform, the cardan angles to rotate from force platform to lab space, the nexus orientation parameters, and the Visual3D command.\\ - If you wish to save the output you can click on the Export to text button at the bottom left of the results dialogue box.\\ \\ A sample of the output that should be created is provided below:\\ \\ Output for force platform 1 :\\ \\ ======== Corrected Locations (in mm): ========\\ \\ Corner 1: -624.8758, 685.1889, 1.5064\\ \\ Corner 2: -17.5759, 687.8662, 1.6895\\ \\ Corner 3: -14.8988, 80.5641, 2.1519\\ \\ Corner 4: -622.1987, 77.8868, 1.9688\\ \\ Force platform Center:\\ \\ -319.8873, 382.8765, 1.8292\\ \\ ===============================================\\ \\ Rotation Matrix (into lab space):\\ \\ -0.999990 -0.004408 0.000305\\ \\ -0.004408 0.999990 -0.000760\\ \\ -0.000302 -0.000761 -1.000000\\ \\ Cardan angles to rotate from lab to force platform\\ \\ Angle 1 (x): 179.956451\\ \\ Angle 2 (y): 0.017473\\ \\ Angle 3 (z): 179.747421\\ \\ \\ \\ \\ Cardan angles to rotate from force platform to lab space\\ \\ Angle 1 (x): 179.956375\\ \\ Angle 2 (y): -0.017281\\ \\ Angle 3 (z): 179.747406\\ \\ \\ \\ \\ Nexus orientation parameters:\\ \\ -0.043584\\ \\ -0.017377\\ \\ 0.252580\\ \\ Visual3D Command\\ \\ Modify_One_Force_Platform\\ \\ /FP_SELECTED= 1\\ \\ /FP_CORNER1= -624.8758 + 685.1889 + 1.5064\\ \\ /FP_CORNER2= -17.5759 + 687.8662 + 1.6895\\ \\ /FP_CORNER3= -14.8988 + 80.5641 + 2.1519\\ \\ /FP_CORNER4= -622.1987 + 77.8868 + 1.9688
  
  
Line 151: Line 151:
 ==== Defining a Jig ==== ==== Defining a Jig ====
  
-|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\\ \\ /USE_FP_DIMENSIONS = FALSE  |+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\\ \\ /USE_FP_DIMENSIONS = FALSE
  
  
Line 159: Line 159:
 ==== Locating the Force Plate with a Jig ==== ==== Locating the Force Plate with a Jig ====
  
-|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.txt · Last modified: 2025/08/13 14:46 by sgranger