Welcome to Adams/Solver Subroutines - Kxcad.net
Welcome to Adams/Solver Subroutines - Kxcad.net
Welcome to Adams/Solver Subroutines - Kxcad.net
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
82<br />
<strong>Adams</strong>/<strong>Solver</strong><br />
Output Arguments<br />
coord2 An array containing the converted coordinates. Angles are output in radians.<br />
istat An integer variable indicating the unqualified success, the qualified success,<br />
or the reason for the failure of the call <strong>to</strong> RCNVRT. The values for istat are<br />
as follows:<br />
Extended Definition<br />
If: Then:<br />
istat= 0 The call <strong>to</strong> RCNVRT was successful without<br />
qualifications.<br />
istat> 0 The call <strong>to</strong> RCNVRT was successful, but there are<br />
nonfatal errors in the input supplied.<br />
istat= +1 The sum of the squares of the Euler parameters is<br />
close <strong>to</strong> (within 0.5), but not exactly, 1.0.<br />
istat= +2 The sum of the squares of a column of the direction<br />
cosines is close <strong>to</strong> (within 0.5), but not exactly, 1.0.<br />
istat< 0 The call <strong>to</strong> RCNVRT was not successful because<br />
there are fatal errors in the input supplied.<br />
istat= -1 The coordinate system for sys1 was not correctly<br />
specified.<br />
istat= -2 The coordinate system for sys2 was not correctly<br />
specified.<br />
istat= -3 The absolute value of an Euler parameter is greater<br />
than 1.5 (<strong>Adams</strong>/<strong>Solver</strong> gives 0.5 <strong>to</strong>lerance).<br />
istat= -4 The sum of the squares of the Euler parameters is not<br />
within 0.5 of 1.0.<br />
istat= -5 The sum of the squares of a column of the direction<br />
cosines is not within 0.5 of 1.0.<br />
istat= -6 The input direction cosine matrix is not orthogonal;<br />
that is, the dot product of any two columns is greater<br />
than 0.5.<br />
istat= -7 The input direction cosine matrix is for left-handed,<br />
In <strong>Adams</strong>/<strong>Solver</strong>, rotational coordinates are often used <strong>to</strong> specify the orientation of a coordinate system.<br />
For example, a DIFSUB, a REQSUB, or an SFOSUB can call RCNVRT <strong>to</strong> change Euler angles <strong>to</strong> Euler<br />
parameters.<br />
Euler parameters are P0, P1, P2, and P3. P0 is the cosine of one-half the angle of rotation of the rotated<br />
frame with respect <strong>to</strong> the reference frame. P1, P2, and P3 are the x, y, and z components, respectively, of<br />
the unit vec<strong>to</strong>r around which the rotation occurs, multiplied by the sine of one-half the angle.