Point

A point element defines es spatial 3d point defined by coordinates of the laboratory global system or by coordinates in a given local coordinate system.

The element creates a trajectory with the name of the element and the type of a 3d-Vector of double values.

Attributes

Attribute Description Required 
name
 name of the element Yes
 
localPoint
 Instead of defining the point by coordinates in the laborytory global system, it is possible to define the point by arbitrary local coordinates. The global coordinates of the point are then calculated by transforming with the given coordinate system.
Note: This attribute needs the use of the attribute coordinateSystem.
 No 
coordinateSystem
(or the old name: coordSystem)
 Name of the coordinate system element which is used in two cases: 1. If the point is defined in local coordinates with the attribut "localPoint" it defines the corresponding coordinate system. 2. If calibration is used, than for static trial which is defined by switches given with the attributes calibrateIncludes/calibrateExcludes the point is transformed in local coordinates of the coordinate system which is given with this element. For all other trials the local coordinates are back transformed to the global coordinates using the current value of the coordinate system defined by this attribute. 
referencePoint
 In a static trial the distance to this point is calculated its trial mean. In no calibration trials this distance is used to translate the current position of the point to hold this fix distance.
Note: This feature is not available in combination with the use of localPoint.
 No 
expr
 Mathematical formula which defnines the point.
Note: Typically this attribut is not used. The formula is given as elements content instead.		 
x
 These attributes allows an alternative definition of the point by seperate mathematical formulas for each of the three components.
 No 
y
 
z
 
noise
 
noiseAmplitude
 
debug
 
visible
 
includes
 comma seperated list of switches 
excludes
 
calibrateIncludes
 
calibrateExcludes
 
average
 Additional calculation of the trial average. The value is saved as a parameter with the name of the element and "Average" as a suffix: <name of the element>Average

Examples

<Point name="A"
       coordinateSystem="Thorax"
       calibrateIncludes="static">B+C</Point>

In the calibration trial defined by the switch "static" A is calculated as B+C in coordinates of the global laboratory system. The absolute coordinates are transformed in the given local coordinate system "Thorax". In all of the following trials A is calculated by the fixed local coordinates by transforming to global coordinates by the current attitude of the "Thorax" coordinate system.

<Point name="A"
       average="true"
       excludes="static">B+C</Point>
Calculates the point always as B+C in coordinates of the global laboratory system. If the switch "static"  is set for a trial nothing is calculated. 
<Point name="A"
       localPoint="B+C"
       coordinateSystem="Thorax">B+C</Point>
The point A is calculated in local coordinates and the transformed by the coordinate system "Thorax" in global coordinates.