Differences

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

--- caltester:caltesterplus:tutorials:jig_location [2024/06/18 20:19] – sgranger
+++ caltester:caltesterplus:tutorials:jig_location [2024/11/01 18:22] (current) – wikisysop
@@ Line 1: / Line 1: @@
-{{{{{{{{{{{{====== purpose ======
+====== Jig Location ======
-using a template allows you to determine where your force platforms are in relation to your camera system without 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) which have a consistent position relative to the force platform.
+===== Purpose =====
-the first step required when using caltesterplus to identify a template is to locate the template targets in the force platform coordinate system. for this reason both the caltester rod and the template must exist in these trials. the caltester rod will be used to identify the center of pressure and the template will be used to locate the targets.
+Using a Template allows you to determine where your force platforms are in relation to your camera system without 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) which have a consistent position relative to the force platform.
-====== collecting ======
+The first step required when using CalTesterPlus to identify a Template is to locate the Template targets in the force platform coordinate system. For this reason both the CalTester rod and the Template must exist in these trials. The CalTester rod will be used to identify the center of pressure and the Template will be used to locate the targets.
-in order to use the caltesterplus program you need a set of trials that meet certain requirements.
+===== Collecting =====
-trials to create the template must have:
+In order to use the CalTesterPlus program you need a set of trials that meet certain requirements.
-  * a minimum of 3 stationary targets and a maximum of 6 (often mounted on a metal frame)
+Trials to create the Template must have:
-  * the caltester rod
-during each trial:
+  * A minimum of 3 stationary targets and a maximum of 6 (often mounted on a metal frame)
+  * The CalTester Rod
-  * the caltester rod should be used to apply pressure to various positions on the force platform
+During each trial:
-  * pressure should be applied to a different location on force platform. the more surface area covered between all trials the more accurate the optimization
-each example motion trial found that is downloaded with the caltesterplus program found in the tutorialfiles folder meet the above criteria.
+  * The CalTester Rod should be used to apply pressure to various positions on the force platform
+  * Pressure should be applied to a different location on force platform. The more surface area covered between all trials the more accurate the optimization
-the sample files can be found on your c drive: c:\program files\c-motion\caltesterplus\samples\tutorialfiles
+Each example motion trial found that is downloaded with the CalTesterPlus program found in the TutorialFiles folder meet the above criteria.
-trialback1 through 11 correspond to trials for force platform 1 (fp1) trial1 through 11 correspond to trials for force platform 2 (fp2)
+The sample files can be found on your C drive: C:\Program Files\C-Motion\CalTesterPlus\Samples\TutorialFiles
+TrialBack1 through 11 correspond to trials for force platform 1 (FP1) Trial1 through 11 correspond to trials for force platform 2 (FP2)
 \\
-===== template trials =====
+==== Template Trials ====
+Both the CalTester Rod and Template must be in each trial:
-both the caltester rod and template must be in each trial:
+  - 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.
+  - Make sure that a Template with at least 3 markers (maximum of 6 markers) is correctly positioned relative to the force platforms.
+  - The trial needs to be at least 1 second long.
+  - For each trial, the CalTester Rod will be placed in various locations on the force platform. The average center of pressure applied by the CalTester Rod will be used to identify the location of the force platform in reference to the Template. The more spread out along the force platform, the more accurate the optimization will be.
-  - 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.
+==== Template ====
-  - make sure that a template with at least 3 markers (maximum of 6 markers) is correctly positioned relative to the force platforms.
-  - the trial needs to be at least 1 second long.
-  - for each trial, the caltester rod will be placed in various locations on the force platform. the average center of pressure applied by the caltester rod will be used to identify the location of the force platform in reference to the template. the more spread out along the force platform, the more accurate the optimization will be.
-===== template =====
+A Template will need to be created for each force platform (regardless of whether one Template is used to identify both platforms, or one for each platform)
-a template will need to be created for each force platform (regardless of whether one template is used to identify both platforms, or one for each platform)
+===== Create Template For FP1 =====
-====== create template for fp1 ======
+==== Load Files ====
-===== load files =====
+|**Load FP1 trials:**\\ \\ - Click **"Add"**\\ \\   - The initial **"C3D files"** list box will be empty\\   - Open trials **"TrialBack1.c3d"** through **"TrialBack11.c3d"**\\ - **Select relevant trials.** Selected trials will be highlighted in blue (see right)\\ \\   - Clicking **"Select All"** will select all trials in the "C3D files" list box\\   - To select specific trials, select the files in the list box by **left clicking** and holding down the **CTRL key**  |  {{:CalTester_SelectAllFiles.png}}|
-|**load fp1 trials:**\\ \\ - click **"add"**\\ \\   - the initial **"c3d files"** list box will be empty\\   - open trials **"trialback1.c3d"** through **"trialback11.c3d"**\\ - **select relevant trials.** selected trials will be highlighted in blue (see right)\\ \\   - clicking **"select all"** will select all trials in the "c3d files" list box\\   - to select specific trials, select the files in the list box by **left clicking** and holding down the **ctrl key**  |  caltester_selectallfiles.png|
+==== Create Template ====
-===== create template =====
+**In the "Platform" tab specify that a Template file will be created:**
-**in the "platform" tab specify that a template file will be created:**
+|- Go to the **"Platform" tab**\\ - Check **"Update Selected Template Instead of Updating Corners:"**\\ \\   - This setting indicates that you would like to create a Template\\ - Click **"Options"**  |  {{:CalTester_JigLocationMode.png}}|
-|- go to the **"platform" tab**\\ - check **"update selected template instead of updating corners:"**\\ \\   - this setting indicates that you would like to create a template\\ - click **"options"**  |  caltester_jiglocationmode.png|
+**NOTE:** The Selected Force Platform defaults to FP1 based on the C3D files that were loaded into the workspace. This is one of several reasons that a template must be created for FP1 and FP2 separately.
-**note:** the selected force platform defaults to fp1 based on the c3d files that were loaded into the workspace. this is one of several reasons that a template must be created for fp1 and fp2 separately.
+=== Identify Marker Labels ===
-==== identify marker labels ====
+**Identify marker IDs on the CalTester Rod:**
-**identify marker ids on the caltester rod:**
+|- Click **"Guess Combination"**\\ \\   - The target IDs should become populated (see image right)\\   - If the target IDs were **not populated**, select the correct IDs from the drop down menus  |  {{:MarkerLabels_identified.png}}|
-|- click **"guess combination"**\\ \\   - the target ids should become populated (see image right)\\   - if the target ids were **not populated**, select the correct ids from the drop down menus  |  markerlabels_identified.png|
+=== Identify Dimension Settings ===
-==== identify dimension settings ====
+The default values in the Dimensions tab represent the size of the CalTester Rod sold by [[http://www.motion-labs.com/|Motion Lab Systems]]. If you are using the sample data or the CalTester Rod manufactured by [[http://www.motion-labs.com/|Motion Lab Systems]] you will **not** need to modify these measurements.
-the default values in the dimensions tab represent the size of the caltester rod sold by c-motion. if you are using the sample data or the caltester rod manufactured by [[http://www.motion-labs.com/|motion lab systems]] you will **not** need to modify these measurements.
+|\\ If necessary (in most cases it will not be), enter the correct measurements for the CalTester Rod.  |  {{:CalTester_Dimensions.png}}|
-|\\ if necessary (in most cases it will not be), enter the correct measurements for the caltester rod.  |  caltester_dimensions.png|
+=== Identify Template Settings ===
-==== identify template settings ====
+**Identify marker IDs on the Template:**
-**identify marker ids on the template:**
+|Identify the Template relative to FP1:\\ \\ - Click **"Add New Template"**\\ - Double click on **"unknown"** and rename **"FP1"**\\ - **Select targets** used to identify the Template\\ \\   - Origin, X, and Y\\ - Click **"Main"**  |  {{:CalTester_JigTemplate_FP1.png}}|
-|identify the template relative to fp1:\\ \\ - click **"add new template"**\\ - double click on **"unknown"** and rename **"fp1"**\\ - **select targets** used to identify the template\\ \\   - origin, x, and y\\ - click **"main"**  |  caltester_jigtemplate_fp1.png|
+**NOTE:** The **"Save as Default"** button can be used to save the template settings in CalTester Plus so that the program will default to this template name and target IDs.
-**note:** the **"save as default"** button can be used to save the template settings in caltester plus so that the program will default to this template name and target ids.
+=== Create Output File ===
-==== create output file ====
+**Create the template on the main page of the Platforms tab:**
-**create the template on the main page of the platforms tab:**
+|- Ensure the relevant trials from the "C3D Files" list box are still highlighted\\ - **Select the relevant template** from the drop down list ("FP1")\\ - Click **"Go"**\\ \\   - Enter the **output file name** (for example: "FP1_Template.txt")\\   - Click **"Save"**\\   - If the template was saved correctly a message will appear, "Conversion Complete. Results written to output file", click **"OK"**  |  {{:CalTester_JigTemplate_ClickGo.png}}|
-|- ensure the relevant trials from the "c3d files" list box are still highlighted\\ - **select the relevant template** from the drop down list ("fp1")\\ - click **"go"**\\ \\   - enter the **output file name** (for example: "fp1_template.txt")\\   - click **"save"**\\   - if the template was saved correctly a message will appear, "conversion complete. results written to output file", click **"ok"**  |  caltester_jigtemplate_clickgo.png|
+==== Output File ====
-===== output file =====
+**If the output text file is opened the values should be:**
-**if the output text file is opened the values should be:**
+==== Fixed marker locations in force platform space (MKS units) ====
+-0.313196 -0.267576 -0.025997 ORIGIN
+.236526 0.247737 -0.804424 X
+.186790 -0.264106 -0.027245 Y
-==== fixed marker locations in force platform space (mks units) ====
--0.313196 -0.267576 -0.025997 origin
-.236526 0.247737 -0.804424 x
-.186790 -0.264106 -0.027245 y
-}}}}}}}}}}}}