LaRCsim/ls_generic.h

   1 /***************************************************************************
   2
   3         TITLE:  ls_generic.h
   4
   5 ----------------------------------------------------------------------------
   6
   7         FUNCTION:       LaRCSim generic parameters header file
   8
   9 ----------------------------------------------------------------------------
  10
  11         MODULE STATUS:  developmental
  12
  13 ----------------------------------------------------------------------------
  14
  15         GENEALOGY:      Created 15 DEC 1993 by Bruce Jackson;
  16                         was part of old ls_eom.h header
  17
  18 ----------------------------------------------------------------------------
  19
  20         DESIGNED BY:    B. Jackson
  21
  22         CODED BY:       B. Jackson
  23
  24         MAINTAINED BY:  guess who
  25
  26 ----------------------------------------------------------------------------
  27
  28         MODIFICATION HISTORY:
  29
  30         DATE    PURPOSE                                         BY
  31
  32
  33 ----------------------------------------------------------------------------
  34
  35         REFERENCES:
  36
  37                 [ 1]    McFarland, Richard E.: "A Standard Kinematic Model
  38                         for Flight Simulation at NASA-Ames", NASA CR-2497,
  39                         January 1975
  40
  41                 [ 2]    ANSI/AIAA R-004-1992 "Recommended Practice: Atmos-
  42                         pheric and Space Flight Vehicle Coordinate Systems",
  43                         February 1992
  44
  45                 [ 3]    Beyer, William H., editor: "CRC Standard Mathematical
  46                         Tables, 28th edition", CRC Press, Boca Raton, FL, 1987,
  47                         ISBN 0-8493-0628-0
  48
  49                 [ 4]    Dowdy, M. C.; Jackson, E. B.; and Nichols, J. H.:
  50                         "Controls Analysis and Simulation Test Loop Environ-
  51                         ment (CASTLE) Programmer's Guide, Version 1.3",
  52                         NATC TM 89-11, 30 March 1989.
  53
  54                 [ 5]    Halliday, David; and Resnick, Robert: "Fundamentals
  55                         of Physics, Revised Printing", Wiley and Sons, 1974.
  56                         ISBN 0-471-34431-1
  57
  58                 [ 6]    Anon: "U. S. Standard Atmosphere, 1962"
  59
  60                 [ 7]    Anon: "Aeronautical Vest Pocket Handbook, 17th edition",
  61                         Pratt & Whitney Aircraft Group, Dec. 1977
  62
  63                 [ 8]    Stevens, Brian L.; and Lewis, Frank L.: "Aircraft
  64                         Control and Simulation", Wiley and Sons, 1992.
  65                         ISBN 0-471-61397-5
  66
  67 --------------------------------------------------------------------------*/
  68
  69 typedef struct {
  70
  71 /*================== Mass properties and geometry values ==================*/
  72
  73     DATA    mass, i_xx, i_yy, i_zz, i_xz;       /* Inertias */
  74 #define Mass                    generic_.mass
  75 #define I_xx                    generic_.i_xx
  76 #define I_yy                    generic_.i_yy
  77 #define I_zz                    generic_.i_zz
  78 #define I_xz                    generic_.i_xz
  79
  80     VECTOR_3    d_pilot_rp_body_v;      /* Pilot location rel to ref pt */
  81 #define D_pilot_rp_body_v       generic_.d_pilot_rp_body_v
  82 #define Dx_pilot                generic_.d_pilot_rp_body_v[0]
  83 #define Dy_pilot                generic_.d_pilot_rp_body_v[1]
  84 #define Dz_pilot                generic_.d_pilot_rp_body_v[2]
  85
  86     VECTOR_3    d_cg_rp_body_v; /* CG position w.r.t. ref. point */
  87 #define D_cg_rp_body_v          generic_.d_cg_rp_body_v
  88 #define Dx_cg                   generic_.d_cg_rp_body_v[0]
  89 #define Dy_cg                   generic_.d_cg_rp_body_v[1]
  90 #define Dz_cg                   generic_.d_cg_rp_body_v[2]
  91
  92 /*================================ Forces =================================*/
  93
  94     VECTOR_3    f_body_total_v;
  95 #define F_body_total_v          generic_.f_body_total_v
  96 #define F_X                     generic_.f_body_total_v[0]
  97 #define F_Y                     generic_.f_body_total_v[1]
  98 #define F_Z                     generic_.f_body_total_v[2]
  99
 100     VECTOR_3    f_local_total_v;
 101 #define F_local_total_v         generic_.f_local_total_v
 102 #define F_north                 generic_.f_local_total_v[0]
 103 #define F_east                  generic_.f_local_total_v[1]
 104 #define F_down                  generic_.f_local_total_v[2]
 105
 106     VECTOR_3    f_aero_v;
 107 #define F_aero_v                generic_.f_aero_v
 108 #define F_X_aero                generic_.f_aero_v[0]
 109 #define F_Y_aero                generic_.f_aero_v[1]
 110 #define F_Z_aero                generic_.f_aero_v[2]
 111
 112     VECTOR_3    f_engine_v;
 113 #define F_engine_v              generic_.f_engine_v
 114 #define F_X_engine              generic_.f_engine_v[0]
 115 #define F_Y_engine              generic_.f_engine_v[1]
 116 #define F_Z_engine              generic_.f_engine_v[2]
 117
 118     VECTOR_3    f_gear_v;
 119 #define F_gear_v                generic_.f_gear_v
 120 #define F_X_gear                generic_.f_gear_v[0]
 121 #define F_Y_gear                generic_.f_gear_v[1]
 122 #define F_Z_gear                generic_.f_gear_v[2]
 123
 124 /*================================ Moments ================================*/
 125
 126     VECTOR_3    m_total_rp_v;
 127 #define M_total_rp_v            generic_.m_total_rp_v
 128 #define M_l_rp                  generic_.m_total_rp_v[0]
 129 #define M_m_rp                  generic_.m_total_rp_v[1]
 130 #define M_n_rp                  generic_.m_total_rp_v[2]
 131
 132     VECTOR_3    m_total_cg_v;
 133 #define M_total_cg_v            generic_.m_total_cg_v
 134 #define M_l_cg                  generic_.m_total_cg_v[0]
 135 #define M_m_cg                  generic_.m_total_cg_v[1]
 136 #define M_n_cg                  generic_.m_total_cg_v[2]
 137
 138     VECTOR_3    m_aero_v;
 139 #define M_aero_v                generic_.m_aero_v
 140 #define M_l_aero                generic_.m_aero_v[0]
 141 #define M_m_aero                generic_.m_aero_v[1]
 142 #define M_n_aero                generic_.m_aero_v[2]
 143
 144     VECTOR_3    m_engine_v;
 145 #define M_engine_v              generic_.m_engine_v
 146 #define M_l_engine              generic_.m_engine_v[0]
 147 #define M_m_engine              generic_.m_engine_v[1]
 148 #define M_n_engine              generic_.m_engine_v[2]
 149
 150     VECTOR_3    m_gear_v;
 151 #define M_gear_v                generic_.m_gear_v
 152 #define M_l_gear                generic_.m_gear_v[0]
 153 #define M_m_gear                generic_.m_gear_v[1]
 154 #define M_n_gear                generic_.m_gear_v[2]
 155
 156 /*============================== Accelerations ============================*/
 157
 158     VECTOR_3    v_dot_local_v;
 159 #define V_dot_local_v           generic_.v_dot_local_v
 160 #define V_dot_north             generic_.v_dot_local_v[0]
 161 #define V_dot_east              generic_.v_dot_local_v[1]
 162 #define V_dot_down              generic_.v_dot_local_v[2]
 163
 164     VECTOR_3    v_dot_body_v;
 165 #define V_dot_body_v            generic_.v_dot_body_v
 166 #define U_dot_body              generic_.v_dot_body_v[0]
 167 #define V_dot_body              generic_.v_dot_body_v[1]
 168 #define W_dot_body              generic_.v_dot_body_v[2]
 169
 170     VECTOR_3    a_cg_body_v;
 171 #define A_cg_body_v             generic_.a_cg_body_v
 172 #define A_X_cg                  generic_.a_cg_body_v[0]
 173 #define A_Y_cg                  generic_.a_cg_body_v[1]
 174 #define A_Z_cg                  generic_.a_cg_body_v[2]
 175
 176     VECTOR_3    a_pilot_body_v;
 177 #define A_pilot_body_v          generic_.a_pilot_body_v
 178 #define A_X_pilot               generic_.a_pilot_body_v[0]
 179 #define A_Y_pilot               generic_.a_pilot_body_v[1]
 180 #define A_Z_pilot               generic_.a_pilot_body_v[2]
 181
 182     VECTOR_3    n_cg_body_v;
 183 #define N_cg_body_v             generic_.n_cg_body_v
 184 #define N_X_cg                  generic_.n_cg_body_v[0]
 185 #define N_Y_cg                  generic_.n_cg_body_v[1]
 186 #define N_Z_cg                  generic_.n_cg_body_v[2]
 187
 188     VECTOR_3    n_pilot_body_v;
 189 #define N_pilot_body_v          generic_.n_pilot_body_v
 190 #define N_X_pilot               generic_.n_pilot_body_v[0]
 191 #define N_Y_pilot               generic_.n_pilot_body_v[1]
 192 #define N_Z_pilot               generic_.n_pilot_body_v[2]
 193
 194     VECTOR_3    omega_dot_body_v;
 195 #define Omega_dot_body_v        generic_.omega_dot_body_v
 196 #define P_dot_body              generic_.omega_dot_body_v[0]
 197 #define Q_dot_body              generic_.omega_dot_body_v[1]
 198 #define R_dot_body              generic_.omega_dot_body_v[2]
 199
 200
 201 /*============================== Velocities ===============================*/
 202
 203     VECTOR_3    v_local_v;
 204 #define V_local_v               generic_.v_local_v
 205 #define V_north                 generic_.v_local_v[0]
 206 #define V_east                  generic_.v_local_v[1]
 207 #define V_down                  generic_.v_local_v[2]
 208
 209     VECTOR_3    v_local_rel_ground_v;   /* V rel w.r.t. earth surface   */
 210 #define V_local_rel_ground_v    generic_.v_local_rel_ground_v
 211 #define V_north_rel_ground      generic_.v_local_rel_ground_v[0]
 212 #define V_east_rel_ground       generic_.v_local_rel_ground_v[1]
 213 #define V_down_rel_ground       generic_.v_local_rel_ground_v[2]
 214
 215     VECTOR_3    v_local_airmass_v;      /* velocity of airmass (steady winds)   */
 216 #define V_local_airmass_v       generic_.v_local_airmass_v
 217 #define V_north_airmass         generic_.v_local_airmass_v[0]
 218 #define V_east_airmass          generic_.v_local_airmass_v[1]
 219 #define V_down_airmass          generic_.v_local_airmass_v[2]
 220
 221     VECTOR_3    v_local_rel_airmass_v;  /* velocity of veh. relative to airmass */
 222 #define V_local_rel_airmass_v   generic_.v_local_rel_airmass_v
 223 #define V_north_rel_airmass     generic_.v_local_rel_airmass_v[0]
 224 #define V_east_rel_airmass      generic_.v_local_rel_airmass_v[1]
 225 #define V_down_rel_airmass      generic_.v_local_rel_airmass_v[2]
 226
 227     VECTOR_3    v_local_gust_v; /* linear turbulence components, L frame */
 228 #define V_local_gust_v          generic_.v_local_gust_v
 229 #define U_gust                  generic_.v_local_gust_v[0]
 230 #define V_gust                  generic_.v_local_gust_v[1]
 231 #define W_gust                  generic_.v_local_gust_v[2]
 232
 233     VECTOR_3    v_wind_body_v;  /* Wind-relative velocities in body axis        */
 234 #define V_wind_body_v           generic_.v_wind_body_v
 235 #define U_body                  generic_.v_wind_body_v[0]
 236 #define V_body                  generic_.v_wind_body_v[1]
 237 #define W_body                  generic_.v_wind_body_v[2]
 238
 239     DATA    v_rel_wind, v_true_kts, v_rel_ground, v_inertial;
 240     DATA    v_ground_speed, v_equiv, v_equiv_kts;
 241     DATA    v_calibrated, v_calibrated_kts;
 242 #define V_rel_wind              generic_.v_rel_wind
 243 #define V_true_kts              generic_.v_true_kts
 244 #define V_rel_ground            generic_.v_rel_ground
 245 #define V_inertial              generic_.v_inertial
 246 #define V_ground_speed          generic_.v_ground_speed
 247 #define V_equiv                 generic_.v_equiv
 248 #define V_equiv_kts             generic_.v_equiv_kts
 249 #define V_calibrated            generic_.v_calibrated
 250 #define V_calibrated_kts        generic_.v_calibrated_kts
 251
 252     VECTOR_3    omega_body_v;   /* Angular B rates      */
 253 #define Omega_body_v            generic_.omega_body_v
 254 #define P_body                  generic_.omega_body_v[0]
 255 #define Q_body                  generic_.omega_body_v[1]
 256 #define R_body                  generic_.omega_body_v[2]
 257
 258     VECTOR_3    omega_local_v;  /* Angular L rates      */
 259 #define Omega_local_v           generic_.omega_local_v
 260 #define P_local                 generic_.omega_local_v[0]
 261 #define Q_local                 generic_.omega_local_v[1]
 262 #define R_local                 generic_.omega_local_v[2]
 263
 264     VECTOR_3    omega_total_v;  /* Diff btw B & L       */
 265 #define Omega_total_v           generic_.omega_total_v
 266 #define P_total                 generic_.omega_total_v[0]
 267 #define Q_total                 generic_.omega_total_v[1]
 268 #define R_total                 generic_.omega_total_v[2]
 269
 270     VECTOR_3    euler_rates_v;
 271 #define Euler_rates_v           generic_.euler_rates_v
 272 #define Phi_dot                 generic_.euler_rates_v[0]
 273 #define Theta_dot               generic_.euler_rates_v[1]
 274 #define Psi_dot                 generic_.euler_rates_v[2]
 275
 276     VECTOR_3    geocentric_rates_v;     /* Geocentric linear velocities */
 277 #define Geocentric_rates_v      generic_.geocentric_rates_v
 278 #define Latitude_dot            generic_.geocentric_rates_v[0]
 279 #define Longitude_dot           generic_.geocentric_rates_v[1]
 280 #define Radius_dot              generic_.geocentric_rates_v[2]
 281
 282 /*=============================== Positions ===============================*/
 283
 284     VECTOR_3    geocentric_position_v;
 285 #define Geocentric_position_v   generic_.geocentric_position_v
 286 #define Lat_geocentric          generic_.geocentric_position_v[0]
 287 #define Lon_geocentric          generic_.geocentric_position_v[1]
 288 #define Radius_to_vehicle       generic_.geocentric_position_v[2]
 289
 290     VECTOR_3    geodetic_position_v;
 291 #define Geodetic_position_v     generic_.geodetic_position_v
 292 #define Latitude                generic_.geodetic_position_v[0]
 293 #define Longitude               generic_.geodetic_position_v[1]
 294 #define Altitude                generic_.geodetic_position_v[2]
 295
 296     VECTOR_3    euler_angles_v;
 297 #define Euler_angles_v          generic_.euler_angles_v
 298 #define Phi                     generic_.euler_angles_v[0]
 299 #define Theta                   generic_.euler_angles_v[1]
 300 #define Psi                     generic_.euler_angles_v[2]
 301
 302 /*======================= Miscellaneous quantities ========================*/
 303
 304     DATA    t_local_to_body_m[3][3];    /* Transformation matrix L to B */
 305 #define T_local_to_body_m       generic_.t_local_to_body_m
 306 #define T_local_to_body_11      generic_.t_local_to_body_m[0][0]
 307 #define T_local_to_body_12      generic_.t_local_to_body_m[0][1]
 308 #define T_local_to_body_13      generic_.t_local_to_body_m[0][2]
 309 #define T_local_to_body_21      generic_.t_local_to_body_m[1][0]
 310 #define T_local_to_body_22      generic_.t_local_to_body_m[1][1]
 311 #define T_local_to_body_23      generic_.t_local_to_body_m[1][2]
 312 #define T_local_to_body_31      generic_.t_local_to_body_m[2][0]
 313 #define T_local_to_body_32      generic_.t_local_to_body_m[2][1]
 314 #define T_local_to_body_33      generic_.t_local_to_body_m[2][2]
 315
 316     DATA    gravity;            /* Local acceleration due to G  */
 317 #define Gravity                 generic_.gravity
 318
 319     DATA    centrifugal_relief; /* load factor reduction due to speed */
 320 #define Centrifugal_relief      generic_.centrifugal_relief
 321
 322     DATA    alpha, beta, alpha_dot, beta_dot;   /* in radians   */
 323 #define Alpha                   generic_.alpha
 324 #define Beta                    generic_.beta
 325 #define Alpha_dot               generic_.alpha_dot
 326 #define Beta_dot                generic_.beta_dot
 327
 328     DATA    cos_alpha, sin_alpha, cos_beta, sin_beta;
 329 #define Cos_alpha               generic_.cos_alpha
 330 #define Sin_alpha               generic_.sin_alpha
 331 #define Cos_beta                generic_.cos_beta
 332 #define Sin_beta                generic_.sin_beta
 333
 334     DATA    cos_phi, sin_phi, cos_theta, sin_theta, cos_psi, sin_psi;
 335 #define Cos_phi                 generic_.cos_phi
 336 #define Sin_phi                 generic_.sin_phi
 337 #define Cos_theta               generic_.cos_theta
 338 #define Sin_theta               generic_.sin_theta
 339 #define Cos_psi                 generic_.cos_psi
 340 #define Sin_psi                 generic_.sin_psi
 341
 342     DATA    gamma_vert_rad, gamma_horiz_rad;    /* Flight path angles   */
 343 #define Gamma_vert_rad          generic_.gamma_vert_rad
 344 #define Gamma_horiz_rad         generic_.gamma_horiz_rad
 345
 346     DATA    sigma, density, v_sound, mach_number;
 347 #define Sigma                   generic_.sigma
 348 #define Density                 generic_.density
 349 #define V_sound                 generic_.v_sound
 350 #define Mach_number             generic_.mach_number
 351
 352     DATA    static_pressure, total_pressure, impact_pressure, dynamic_pressure;
 353 #define Static_pressure         generic_.static_pressure
 354 #define Total_pressure          generic_.total_pressure
 355 #define Impact_pressure         generic_.impact_pressure
 356 #define Dynamic_pressure        generic_.dynamic_pressure
 357
 358     DATA    static_temperature, total_temperature;
 359 #define Static_temperature      generic_.static_temperature
 360 #define Total_temperature       generic_.total_temperature
 361
 362     DATA    sea_level_radius, earth_position_angle;
 363 #define Sea_level_radius        generic_.sea_level_radius
 364 #define Earth_position_angle    generic_.earth_position_angle
 365
 366     DATA    runway_altitude, runway_latitude, runway_longitude, runway_heading;
 367 #define Runway_altitude         generic_.runway_altitude
 368 #define Runway_latitude         generic_.runway_latitude
 369 #define Runway_longitude        generic_.runway_longitude
 370 #define Runway_heading          generic_.runway_heading
 371
 372     DATA    radius_to_rwy;
 373 #define Radius_to_rwy           generic_.radius_to_rwy
 374
 375     VECTOR_3    d_cg_rwy_local_v;       /* CG rel. to rwy in local coords */
 376 #define D_cg_rwy_local_v        generic_.d_cg_rwy_local_v
 377 #define D_cg_north_of_rwy       generic_.d_cg_rwy_local_v[0]
 378 #define D_cg_east_of_rwy        generic_.d_cg_rwy_local_v[1]
 379 #define D_cg_above_rwy          generic_.d_cg_rwy_local_v[2]
 380
 381     VECTOR_3    d_cg_rwy_rwy_v; /* CG relative to runway, in rwy coordinates */
 382 #define D_cg_rwy_rwy_v          generic_.d_cg_rwy_rwy_v
 383 #define X_cg_rwy                generic_.d_cg_rwy_rwy_v[0]
 384 #define Y_cg_rwy                generic_.d_cg_rwy_rwy_v[1]
 385 #define H_cg_rwy                generic_.d_cg_rwy_rwy_v[2]
 386
 387     VECTOR_3    d_pilot_rwy_local_v;    /* pilot rel. to rwy in local coords */
 388 #define D_pilot_rwy_local_v     generic_.d_pilot_rwy_local_v
 389 #define D_pilot_north_of_rwy    generic_.d_pilot_rwy_local_v[0]
 390 #define D_pilot_east_of_rwy     generic_.d_pilot_rwy_local_v[1]
 391 #define D_pilot_above_rwy       generic_.d_pilot_rwy_local_v[2]
 392
 393     VECTOR_3   d_pilot_rwy_rwy_v;       /* pilot rel. to rwy, in rwy coords. */
 394 #define D_pilot_rwy_rwy_v       generic_.d_pilot_rwy_rwy_v
 395 #define X_pilot_rwy             generic_.d_pilot_rwy_rwy_v[0]
 396 #define Y_pilot_rwy             generic_.d_pilot_rwy_rwy_v[1]
 397 #define H_pilot_rwy             generic_.d_pilot_rwy_rwy_v[2]
 398
 399
 400 } GENERIC;
 401
 402 extern GENERIC generic_;        /* usually defined in ls_main.c */
 403
 404 /*---------------------------  end of ls_generic.h  ------------------------*/