# Nimue platform

### Webseiten-Werkzeuge

modellingcomponents:elements:angles:projectionangles

## Projection Angles

### Configuration

A <ProjectionAngle>-element defines the angle between two vectors, after a projection of these vectors into a plane, defined by its normal vector.

There are two possiblities to define the two vectors.

In the old (deprectated) version, the two vectors are defined by a common point laying in the projection plane (JointCenter) and two other points given in absolute coordinates, which were projected into the plane before the angle is calculated.

In the new/current version the two vectors are given directly by „directed“ vectors, also given in the global coordinate system.

The angle is defined from the second to the first vector with the left hand rule (thumb in direction of the normal vector of the projection plane, the hand shows the direction around the thumb).

It is assumed that the vectors are given in coordinates in a right-handed coordinate system. If this is not the case you can determine the expected values by pi minus the result.

If all vectors are defined in a left-handed coordinate system than you can switch the signs of all z-components of the „input“-vectors to get the expected result directly.

### Attributes

Attribute Description Default Required
name name of the element Yes
unsigned true: Values are [0;360deg], else [-180;180] true No
forceContinuousValues If set to true 2pi periondic jumps are automatically eliminated. Its experimentelly. false No
ProjectionAxis
(oder der alte name Axis)
normal vector defining the plane in which in the angle is calculated. No
JointCenter
(deprecated)
A point defining together with the Axis the plane in which the angle is calculated. This point is also the start point of the two vectors between the angle is calculated. No, but if these three arguments are not used, FirstVector and SecondVector must be used instead. No
LeverArmPoint1
(deprecated)
This point defines the end point of a first vector which starts at the position of the JointCenter. The vector is projected into the plane before the angle is calculated.
LeverArmPoint2
(deprecated)
This point defines the end point of second vector which starts at the position of the JointCenter. The vector is projected into the plane before the angle is calculated.
FirstVector The two vectors between the angle is calculated after its projection to the plane with ProjectionAxis as normal vector. No, but if these three arguments are not used, JointCenter, LeverArmPoint1 and LeverArmPoint2 must be used instead.
SecondVector
useOffset Die Implementierung scheint auskommentiert zu sein!!! true, than the value of the attribut Offset is added to the resulting projection angle. No
Offset angle offset value which is added to the resulting projection angle, if the attribute flag useOffset is set to true. unsigned, if set to „true“ the angle is calculated in the range from 0 to 360 degrees. If this attribute is set to „false“ the angle is calculated in the range from -180 to +180 degrees. No
noiseAmplitude No
forceContinuousValues If set to „true“ jumps in the values based on the circular behavoir of angles are eliminated by adding an offset value of 180 or 360 degree depending on the unsigned flag after leaving the cycle ranges. false
debug false No
visible No
includes comma seperated list of switches No
excludes No
calibrateIncludes No
calibrateExcludes No
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 No
unit „deg“ oder „rad“ (not implemented yet) deg No

### Created trajectories

Name Type Description
<name>FirstVector Vector3d The first direction vector.
<name>SecondVector Vector3d The second direction vector.
<name>Axis Vector3d The projection axis vector.
<name>Angle double The projection angle values.

### Created parameters

Name Type Description
<name>AngleAverage double The average of the angle timeserie.
<name>AngleMeanStd double The standard deviation corresponding to the average angle.
<name>IntervalsMinAverage double Created only if the attribute intervalsExtremeValues=true.
<name>IntervalsMaxAverage double Created only if the attribute intervalsExtremeValues=true.
<name>IntervalsAverage double Created only if the attribute intervalsExtremeValues=true.
<name>IntervalsUnsignedROMAverage double Created only if the attribute intervalsUnsignedROM=true.

Example:

```  <CoordinateSystem name="A"
Position="vec(0,0,0)
FirstAxis="vec(-1,0,0)"
DefiningVector="vec(0,0,-1)"
orientation="xyz"/>

<ProjectionAngle name="Ax"
FirstVector="y(A)"
SecondVector="test"
ProjectionAxis="x(A)"/>```
modellingcomponents/elements/angles/projectionangles.txt · Zuletzt geändert: 2022/02/09 12:55 von oliver