1 /***************************************************************************
5 ----------------------------------------------------------------------------
7 FUNCTION: Sums forces and moments and calculates accelerations
9 ----------------------------------------------------------------------------
11 MODULE STATUS: developmental
13 ----------------------------------------------------------------------------
15 GENEALOGY: Written 920731 by Bruce Jackson. Based upon equations
16 given in reference [1] and a Matrix-X/System Build block
17 diagram model of equations of motion coded by David Raney
18 at NASA-Langley in June of 1992.
20 ----------------------------------------------------------------------------
22 DESIGNED BY: Bruce Jackson
24 CODED BY: Bruce Jackson
28 ----------------------------------------------------------------------------
34 931007 Moved calculations of auxiliary accelerations here from ls_aux.c BY
35 and corrected minus sign in front of A_Y_Pilot
36 contribution from Q_body*P_body*D_X_pilot term.
37 940111 Changed DATA to SCALAR; updated header files
41 Revision 1.1 1997/05/29 00:09:53 curt
42 Initial Flight Gear revision.
44 * Revision 1.5 1994/01/11 18:42:16 bjax
45 * Oops! Changed data types from DATA to SCALAR for precision control.
47 * Revision 1.4 1994/01/11 18:36:58 bjax
48 * Removed ls_eom.h include directive; replaced with ls_types, ls_constants,
49 * and ls_generic.h includes.
51 * Revision 1.3 1993/10/07 18:45:24 bjax
52 * Added local defn of d[xyz]_pilot_from_cg to support previous mod. EBJ
54 * Revision 1.2 1993/10/07 18:41:31 bjax
55 * Moved calculations of auxiliary accelerations here from ls_aux, and
56 * corrected sign on Q_body*P_body*d_x_pilot term of A_Y_pilot calc. EBJ
58 * Revision 1.1 1992/12/30 13:17:02 bjax
62 ----------------------------------------------------------------------------
66 [ 1] McFarland, Richard E.: "A Standard Kinematic Model
67 for Flight Simulation at NASA-Ames", NASA CR-2497,
70 ----------------------------------------------------------------------------
74 ----------------------------------------------------------------------------
78 ----------------------------------------------------------------------------
80 INPUTS: Aero, engine, gear forces & moments
82 ----------------------------------------------------------------------------
84 OUTPUTS: State derivatives
86 -------------------------------------------------------------------------*/
88 #include "ls_generic.h"
89 #include "ls_constants.h"
95 SCALAR inv_Mass, inv_Radius;
96 SCALAR ixz2, c0, c1, c2, c3, c4, c5, c6, c7, c8, c9, c10;
97 SCALAR dx_pilot_from_cg, dy_pilot_from_cg, dz_pilot_from_cg;
100 /* Sum forces and moments at reference point */
103 F_X = F_X_aero + F_X_engine + F_X_gear;
104 F_Y = F_Y_aero + F_Y_engine + F_Y_gear;
105 F_Z = F_Z_aero + F_Z_engine + F_Z_gear;
107 M_l_rp = M_l_aero + M_l_engine + M_l_gear;
108 M_m_rp = M_m_aero + M_m_engine + M_m_gear;
109 M_n_rp = M_n_aero + M_n_engine + M_n_gear;
111 /* Transfer moments to center of gravity */
113 M_l_cg = M_l_rp + F_Y*Dz_cg - F_Z*Dy_cg;
114 M_m_cg = M_m_rp + F_Z*Dx_cg - F_X*Dz_cg;
115 M_n_cg = M_n_rp + F_X*Dy_cg - F_Y*Dx_cg;
117 /* Transform from body to local frame */
119 F_north = T_local_to_body_11*F_X + T_local_to_body_21*F_Y
120 + T_local_to_body_31*F_Z;
121 F_east = T_local_to_body_12*F_X + T_local_to_body_22*F_Y
122 + T_local_to_body_32*F_Z;
123 F_down = T_local_to_body_13*F_X + T_local_to_body_23*F_Y
124 + T_local_to_body_33*F_Z;
126 /* Calculate linear accelerations */
129 inv_Radius = 1/Radius_to_vehicle;
130 V_dot_north = inv_Mass*F_north +
131 inv_Radius*(V_north*V_down - V_east*V_east*tan(Lat_geocentric));
132 V_dot_east = inv_Mass*F_east +
133 inv_Radius*(V_east*V_down + V_north*V_east*tan(Lat_geocentric));
134 V_dot_down = inv_Mass*(F_down) + Gravity -
135 inv_Radius*(V_north*V_north + V_east*V_east);
137 /* Invert the symmetric inertia matrix */
140 c0 = 1/(I_xx*I_zz - ixz2);
141 c1 = c0*((I_yy-I_zz)*I_zz - ixz2);
142 c2 = c0*I_xz*(I_xx - I_yy + I_zz);
146 c5 = c7*(I_zz - I_xx);
148 c8 = c0*((I_xx - I_yy)*I_xx + ixz2);
149 c9 = c0*I_xz*(I_yy - I_zz - I_xx);
152 /* Calculate the rotational body axis accelerations */
154 P_dot_body = (c1*R_body + c2*P_body)*Q_body + c3*M_l_cg + c4*M_n_cg;
155 Q_dot_body = c5*R_body*P_body + c6*(R_body*R_body - P_body*P_body) + c7*M_m_cg;
156 R_dot_body = (c8*P_body + c9*R_body)*Q_body + c4*M_l_cg + c10*M_n_cg;
158 /* Calculate body axis accelerations (move to ls_accel?) */
162 A_X_cg = F_X * inv_Mass;
163 A_Y_cg = F_Y * inv_Mass;
164 A_Z_cg = F_Z * inv_Mass;
166 dx_pilot_from_cg = Dx_pilot - Dx_cg;
167 dy_pilot_from_cg = Dy_pilot - Dy_cg;
168 dz_pilot_from_cg = Dz_pilot - Dz_cg;
170 A_X_pilot = A_X_cg + (-R_body*R_body - Q_body*Q_body)*dx_pilot_from_cg
171 + ( P_body*Q_body - R_dot_body )*dy_pilot_from_cg
172 + ( P_body*R_body + Q_dot_body )*dz_pilot_from_cg;
173 A_Y_pilot = A_Y_cg + ( P_body*Q_body + R_dot_body )*dx_pilot_from_cg
174 + (-P_body*P_body - R_body*R_body)*dy_pilot_from_cg
175 + ( Q_body*R_body - P_dot_body )*dz_pilot_from_cg;
176 A_Z_pilot = A_Z_cg + ( P_body*R_body - Q_dot_body )*dx_pilot_from_cg
177 + ( Q_body*R_body + P_dot_body )*dy_pilot_from_cg
178 + (-Q_body*Q_body - P_body*P_body)*dz_pilot_from_cg;
180 N_X_cg = INVG*A_X_cg;
181 N_Y_cg = INVG*A_Y_cg;
182 N_Z_cg = INVG*A_Z_cg;
184 N_X_pilot = INVG*A_X_pilot;
185 N_Y_pilot = INVG*A_Y_pilot;
186 N_Z_pilot = INVG*A_Z_pilot;
189 U_dot_body = T_local_to_body_11*V_dot_north + T_local_to_body_12*V_dot_east
190 + T_local_to_body_13*V_dot_down - Q_total*W_body + R_total*V_body;
191 V_dot_body = T_local_to_body_21*V_dot_north + T_local_to_body_22*V_dot_east
192 + T_local_to_body_23*V_dot_down - R_total*U_body + P_total*W_body;
193 W_dot_body = T_local_to_body_31*V_dot_north + T_local_to_body_32*V_dot_east
194 + T_local_to_body_33*V_dot_down - P_total*V_body + Q_total*U_body;
195 /* End of ls_accel */
198 /**************************************************************************/