Differences

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

--- visual3d:documentation:pipeline:force_commands:fp_origin [2024/06/19 12:50] – sgranger
+++ visual3d:documentation:pipeline:force_commands:fp_origin [2025/10/06 12:38] (current) – wikisysop
@@ Line 1: / Line 1: @@
-c3d parameter force_platform:origin
+====== FP ORIGIN ======
-===== amti force platforms =====
+C3D Parameter FORCE_PLATFORM:ORIGIN
-the origin is the vector from the sensor coordinate system to the top center of the force platform surface. it is expressed in the force platform coordinate system, so the z-value is defined to be negative.
+==== The ORIGIN Vector ====
-===== kistler force platforms =====
+As described in the [[visual3d:documentation:c3d_signal_types:c3d_format|C3D file format]], the purpose of the ORIGIN vector is to provide a method for transforming the force vectors (as measured by the force platform's transducers) into the [[visual3d:documentation:definitions:laboratory_coordinate_system|laboratory coordinate system]].
-the origin is a vector comprised of the following components.
+The specific interpretation of the ORIGIN vector varies according to the force platform's [[visual3d:documentation:pipeline:force_commands:fp_type|type]] and manufacturer. The C3D File Format's [[https://www.c3d.org/docs/C3D_User_Guide.pdf|Technical User Guide]] provides some guidance and we have collected useful notes that we are aware of below. When in doubt, the best source of information is your force platform's manufacturer.
-  - x= half the distance between the sensors along the force platform x-axis
+==== Manufacturer Notes ====
-  - y= half the distance between the sensors along the force platform y-axis
-  - z= distance from the sensor coordinate system to the top surface of the force platform surface. this value should be negative
-===== bertec force platforms =====
+=== AMTI force platforms ===
-contact the manufacturer because the origin value varies with the type of bertec force platform. for recent force platforms bertec has elected to calibrate their force platforms differently from the other manufacturers.
+The ORIGIN is the vector from the sensor coordinate system to the top center of the force platform surface. It is expressed in the force platform coordinate system, so the z-value is defined to be negative.
-for older platforms (identified by a calmatrix that contains only diagonal elements), the origin is a constant value of (0, 0, -40.9)
+=== KISTLER force platforms ===
-for newer digital platforms, the calmatrix has been computed assuming an origin value of (0, 0, 0)
+The ORIGIN is a vector comprised of the following components.
+  - x= half the distance between the sensors along the force platform x-axis
+  - y= half the distance between the sensors along the force platform y-axis
+  - z= distance from the sensor coordinate system to the top surface of the force platform surface. This value should be negative
-===== bertec treadmills =====
+=== BERTEC force platforms ===
-bertec uses an origin of (236,813,0) and (-236,813,0), which is a nuisance for vicon users because vicon stores the origin parameter incorrectly.
+The origin value varies with the type of BERTEC force platform. For recent Force Platforms, Bertec has elected to calibrate their force platforms differently from the other manufacturers.
-for all other platforms, visual3d can guess that the origin was stored incorrectly by checking the sign of the z-component of the origin.
+  * **NOTE 1**: For older platforms (identified by a CalMatrix that contains only diagonal elements), the ORIGIN is a constant value of (0, 0, -40.9)
+  * **NOTE 2**: For newer digital platforms, the CalMatrix has been computed assuming an ORIGIN value of (0, 0, 0)
-the c3d format requires the z-parameter to be negative. if the origin is stored with a positive value, visual3d multiplies all 3 components of the origin by -1
+=== BERTEC treadmills ===
-if the z-component is negative, visual3d cannot make a decision.
+Bertec uses an ORIGIN of (236,813,0) and (-236,813,0) for its instrumented treadmills.
-vicon users with bertec treadmills, should use a very small z-component 0.0001 so that visual3d knows to multiply by -1.
+  * **NOTE 3**: This is a nuisance for Vicon users because Vicon stores the ORIGIN parameter incorrectly. For all other platforms, Visual3D can guess that the ORIGIN was stored incorrectly by checking the sign of the z-component of the ORIGIN. The c3d format requires the z-parameter to be negative and if the ORIGIN is stored with a positive value, then Visual3D multiplies all 3 components of the ORIGIN by -1. If the z-component is 0, then Visual3D cannot make a decision.
-===== guessing the correct force_platform::origin =====
+Vicon users with Bertec treadmills, should use a very small z-component 0.0001 so that Visual3D knows to multiply by -1.
-the c3d file format is a public document (http://www.c3d.org) that most hardware vendors currently export. we are only aware of one implementation of the format that has an inconsistency that visual3d must handle explicitly.
+==== Correcting FORCE_PLATFORM::ORIGIN parameters ====
-the force_platform:origin parameter (within the parameter section of the c3d file) describes the location of the working surface of the force platform relative to the force platform coordinate system. for amti force platforms the z-value of the origin should be a negative value. visual3d can correct this value automatically should it read a positive value.
+The C3D file format is a public document that most hardware vendors currently export. We are only aware of one implementation of the format that has an inconsistency that Visual3D must handle explicitly.
-should the user not want to have the program correct this value automatically, a dialog is available under the properties menu item labeled "use correct force_platform:origin vector". in this dialog the user can select the check box "perform automatic correction"(the default).
+The FORCE_PLATFORM:ORIGIN parameter (within the PARAMETER SECTION of the C3D file) describes the location of the working surface of the force platform relative to the force platform coordinate system. For AMTI force platforms the z-value of the origin should be a negative value. Visual3D can correct this value automatically should it read a positive value.
+Should the user not want to have the program correct this value automatically, a dialog is available under the Force dropdown menu, Force > Use correct FORCE_PLATFORM:ORIGIN vector. This dialog allows users to choose whether or not Visual3D will automatically correct positive z-values for FP_ORIGIN z-values. The default selection is that these positive z-values are corrected.
+==== References ====
+  * The C3D File Format (http://www.c3d.org)