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
  70 #ifndef _LS_GENERIC_H
  71 #define _LS_GENERIC_H
  72
  73
  74 typedef struct {
  75
  76 /*================== Mass properties and geometry values ==================*/
  77
  78     DATA    mass, i_xx, i_yy, i_zz, i_xz;       /* Inertias */
  79 #define Mass                    generic_.mass
  80 #define I_xx                    generic_.i_xx
  81 #define I_yy                    generic_.i_yy
  82 #define I_zz                    generic_.i_zz
  83 #define I_xz                    generic_.i_xz
  84
  85     VECTOR_3    d_pilot_rp_body_v;      /* Pilot location rel to ref pt */
  86 #define D_pilot_rp_body_v       generic_.d_pilot_rp_body_v
  87 #define Dx_pilot                generic_.d_pilot_rp_body_v[0]
  88 #define Dy_pilot                generic_.d_pilot_rp_body_v[1]
  89 #define Dz_pilot                generic_.d_pilot_rp_body_v[2]
  90
  91     VECTOR_3    d_cg_rp_body_v; /* CG position w.r.t. ref. point */
  92 #define D_cg_rp_body_v          generic_.d_cg_rp_body_v
  93 #define Dx_cg                   generic_.d_cg_rp_body_v[0]
  94 #define Dy_cg                   generic_.d_cg_rp_body_v[1]
  95 #define Dz_cg                   generic_.d_cg_rp_body_v[2]
  96
  97 /*================================ Forces =================================*/
  98
  99     VECTOR_3    f_body_total_v;
 100 #define F_body_total_v          generic_.f_body_total_v
 101 #define F_X                     generic_.f_body_total_v[0]
 102 #define F_Y                     generic_.f_body_total_v[1]
 103 #define F_Z                     generic_.f_body_total_v[2]
 104
 105     VECTOR_3    f_local_total_v;
 106 #define F_local_total_v         generic_.f_local_total_v
 107 #define F_north                 generic_.f_local_total_v[0]
 108 #define F_east                  generic_.f_local_total_v[1]
 109 #define F_down                  generic_.f_local_total_v[2]
 110
 111     VECTOR_3    f_aero_v;
 112 #define F_aero_v                generic_.f_aero_v
 113 #define F_X_aero                generic_.f_aero_v[0]
 114 #define F_Y_aero                generic_.f_aero_v[1]
 115 #define F_Z_aero                generic_.f_aero_v[2]
 116
 117     VECTOR_3    f_engine_v;
 118 #define F_engine_v              generic_.f_engine_v
 119 #define F_X_engine              generic_.f_engine_v[0]
 120 #define F_Y_engine              generic_.f_engine_v[1]
 121 #define F_Z_engine              generic_.f_engine_v[2]
 122
 123     VECTOR_3    f_gear_v;
 124 #define F_gear_v                generic_.f_gear_v
 125 #define F_X_gear                generic_.f_gear_v[0]
 126 #define F_Y_gear                generic_.f_gear_v[1]
 127 #define F_Z_gear                generic_.f_gear_v[2]
 128
 129 /*================================ Moments ================================*/
 130
 131     VECTOR_3    m_total_rp_v;
 132 #define M_total_rp_v            generic_.m_total_rp_v
 133 #define M_l_rp                  generic_.m_total_rp_v[0]
 134 #define M_m_rp                  generic_.m_total_rp_v[1]
 135 #define M_n_rp                  generic_.m_total_rp_v[2]
 136
 137     VECTOR_3    m_total_cg_v;
 138 #define M_total_cg_v            generic_.m_total_cg_v
 139 #define M_l_cg                  generic_.m_total_cg_v[0]
 140 #define M_m_cg                  generic_.m_total_cg_v[1]
 141 #define M_n_cg                  generic_.m_total_cg_v[2]
 142
 143     VECTOR_3    m_aero_v;
 144 #define M_aero_v                generic_.m_aero_v
 145 #define M_l_aero                generic_.m_aero_v[0]
 146 #define M_m_aero                generic_.m_aero_v[1]
 147 #define M_n_aero                generic_.m_aero_v[2]
 148
 149     VECTOR_3    m_engine_v;
 150 #define M_engine_v              generic_.m_engine_v
 151 #define M_l_engine              generic_.m_engine_v[0]
 152 #define M_m_engine              generic_.m_engine_v[1]
 153 #define M_n_engine              generic_.m_engine_v[2]
 154
 155     VECTOR_3    m_gear_v;
 156 #define M_gear_v                generic_.m_gear_v
 157 #define M_l_gear                generic_.m_gear_v[0]
 158 #define M_m_gear                generic_.m_gear_v[1]
 159 #define M_n_gear                generic_.m_gear_v[2]
 160
 161 /*============================== Accelerations ============================*/
 162
 163     VECTOR_3    v_dot_local_v;
 164 #define V_dot_local_v           generic_.v_dot_local_v
 165 #define V_dot_north             generic_.v_dot_local_v[0]
 166 #define V_dot_east              generic_.v_dot_local_v[1]
 167 #define V_dot_down              generic_.v_dot_local_v[2]
 168
 169     VECTOR_3    v_dot_body_v;
 170 #define V_dot_body_v            generic_.v_dot_body_v
 171 #define U_dot_body              generic_.v_dot_body_v[0]
 172 #define V_dot_body              generic_.v_dot_body_v[1]
 173 #define W_dot_body              generic_.v_dot_body_v[2]
 174
 175     VECTOR_3    a_cg_body_v;
 176 #define A_cg_body_v             generic_.a_cg_body_v
 177 #define A_X_cg                  generic_.a_cg_body_v[0]
 178 #define A_Y_cg                  generic_.a_cg_body_v[1]
 179 #define A_Z_cg                  generic_.a_cg_body_v[2]
 180
 181     VECTOR_3    a_pilot_body_v;
 182 #define A_pilot_body_v          generic_.a_pilot_body_v
 183 #define A_X_pilot               generic_.a_pilot_body_v[0]
 184 #define A_Y_pilot               generic_.a_pilot_body_v[1]
 185 #define A_Z_pilot               generic_.a_pilot_body_v[2]
 186
 187     VECTOR_3    n_cg_body_v;
 188 #define N_cg_body_v             generic_.n_cg_body_v
 189 #define N_X_cg                  generic_.n_cg_body_v[0]
 190 #define N_Y_cg                  generic_.n_cg_body_v[1]
 191 #define N_Z_cg                  generic_.n_cg_body_v[2]
 192
 193     VECTOR_3    n_pilot_body_v;
 194 #define N_pilot_body_v          generic_.n_pilot_body_v
 195 #define N_X_pilot               generic_.n_pilot_body_v[0]
 196 #define N_Y_pilot               generic_.n_pilot_body_v[1]
 197 #define N_Z_pilot               generic_.n_pilot_body_v[2]
 198
 199     VECTOR_3    omega_dot_body_v;
 200 #define Omega_dot_body_v        generic_.omega_dot_body_v
 201 #define P_dot_body              generic_.omega_dot_body_v[0]
 202 #define Q_dot_body              generic_.omega_dot_body_v[1]
 203 #define R_dot_body              generic_.omega_dot_body_v[2]
 204
 205
 206 /*============================== Velocities ===============================*/
 207
 208     VECTOR_3    v_local_v;
 209 #define V_local_v               generic_.v_local_v
 210 #define V_north                 generic_.v_local_v[0]
 211 #define V_east                  generic_.v_local_v[1]
 212 #define V_down                  generic_.v_local_v[2]
 213
 214     VECTOR_3    v_local_rel_ground_v;   /* V rel w.r.t. earth surface   */
 215 #define V_local_rel_ground_v    generic_.v_local_rel_ground_v
 216 #define V_north_rel_ground      generic_.v_local_rel_ground_v[0]
 217 #define V_east_rel_ground       generic_.v_local_rel_ground_v[1]
 218 #define V_down_rel_ground       generic_.v_local_rel_ground_v[2]
 219
 220     VECTOR_3    v_local_airmass_v;      /* velocity of airmass (steady winds)   */
 221 #define V_local_airmass_v       generic_.v_local_airmass_v
 222 #define V_north_airmass         generic_.v_local_airmass_v[0]
 223 #define V_east_airmass          generic_.v_local_airmass_v[1]
 224 #define V_down_airmass          generic_.v_local_airmass_v[2]
 225
 226     VECTOR_3    v_local_rel_airmass_v;  /* velocity of veh. relative to airmass */
 227 #define V_local_rel_airmass_v   generic_.v_local_rel_airmass_v
 228 #define V_north_rel_airmass     generic_.v_local_rel_airmass_v[0]
 229 #define V_east_rel_airmass      generic_.v_local_rel_airmass_v[1]
 230 #define V_down_rel_airmass      generic_.v_local_rel_airmass_v[2]
 231
 232     VECTOR_3    v_local_gust_v; /* linear turbulence components, L frame */
 233 #define V_local_gust_v          generic_.v_local_gust_v
 234 #define U_gust                  generic_.v_local_gust_v[0]
 235 #define V_gust                  generic_.v_local_gust_v[1]
 236 #define W_gust                  generic_.v_local_gust_v[2]
 237
 238     VECTOR_3    v_wind_body_v;  /* Wind-relative velocities in body axis        */
 239 #define V_wind_body_v           generic_.v_wind_body_v
 240 #define U_body                  generic_.v_wind_body_v[0]
 241 #define V_body                  generic_.v_wind_body_v[1]
 242 #define W_body                  generic_.v_wind_body_v[2]
 243
 244     DATA    v_rel_wind, v_true_kts, v_rel_ground, v_inertial;
 245     DATA    v_ground_speed, v_equiv, v_equiv_kts;
 246     DATA    v_calibrated, v_calibrated_kts;
 247 #define V_rel_wind              generic_.v_rel_wind
 248 #define V_true_kts              generic_.v_true_kts
 249 #define V_rel_ground            generic_.v_rel_ground
 250 #define V_inertial              generic_.v_inertial
 251 #define V_ground_speed          generic_.v_ground_speed
 252 #define V_equiv                 generic_.v_equiv
 253 #define V_equiv_kts             generic_.v_equiv_kts
 254 #define V_calibrated            generic_.v_calibrated
 255 #define V_calibrated_kts        generic_.v_calibrated_kts
 256
 257     VECTOR_3    omega_body_v;   /* Angular B rates      */
 258 #define Omega_body_v            generic_.omega_body_v
 259 #define P_body                  generic_.omega_body_v[0]
 260 #define Q_body                  generic_.omega_body_v[1]
 261 #define R_body                  generic_.omega_body_v[2]
 262
 263     VECTOR_3    omega_local_v;  /* Angular L rates      */
 264 #define Omega_local_v           generic_.omega_local_v
 265 #define P_local                 generic_.omega_local_v[0]
 266 #define Q_local                 generic_.omega_local_v[1]
 267 #define R_local                 generic_.omega_local_v[2]
 268
 269     VECTOR_3    omega_total_v;  /* Diff btw B & L       */
 270 #define Omega_total_v           generic_.omega_total_v
 271 #define P_total                 generic_.omega_total_v[0]
 272 #define Q_total                 generic_.omega_total_v[1]
 273 #define R_total                 generic_.omega_total_v[2]
 274
 275     VECTOR_3    euler_rates_v;
 276 #define Euler_rates_v           generic_.euler_rates_v
 277 #define Phi_dot                 generic_.euler_rates_v[0]
 278 #define Theta_dot               generic_.euler_rates_v[1]
 279 #define Psi_dot                 generic_.euler_rates_v[2]
 280
 281     VECTOR_3    geocentric_rates_v;     /* Geocentric linear velocities */
 282 #define Geocentric_rates_v      generic_.geocentric_rates_v
 283 #define Latitude_dot            generic_.geocentric_rates_v[0]
 284 #define Longitude_dot           generic_.geocentric_rates_v[1]
 285 #define Radius_dot              generic_.geocentric_rates_v[2]
 286
 287 /*=============================== Positions ===============================*/
 288
 289     VECTOR_3    geocentric_position_v;
 290 #define Geocentric_position_v   generic_.geocentric_position_v
 291 #define Lat_geocentric          generic_.geocentric_position_v[0]
 292 #define Lon_geocentric          generic_.geocentric_position_v[1]
 293 #define Radius_to_vehicle       generic_.geocentric_position_v[2]
 294
 295     VECTOR_3    geodetic_position_v;
 296 #define Geodetic_position_v     generic_.geodetic_position_v
 297 #define Latitude                generic_.geodetic_position_v[0]
 298 #define Longitude               generic_.geodetic_position_v[1]
 299 #define Altitude                generic_.geodetic_position_v[2]
 300
 301     VECTOR_3    euler_angles_v;
 302 #define Euler_angles_v          generic_.euler_angles_v
 303 #define Phi                     generic_.euler_angles_v[0]
 304 #define Theta                   generic_.euler_angles_v[1]
 305 #define Psi                     generic_.euler_angles_v[2]
 306
 307 /*======================= Miscellaneous quantities ========================*/
 308
 309     DATA    t_local_to_body_m[3][3];    /* Transformation matrix L to B */
 310 #define T_local_to_body_m       generic_.t_local_to_body_m
 311 #define T_local_to_body_11      generic_.t_local_to_body_m[0][0]
 312 #define T_local_to_body_12      generic_.t_local_to_body_m[0][1]
 313 #define T_local_to_body_13      generic_.t_local_to_body_m[0][2]
 314 #define T_local_to_body_21      generic_.t_local_to_body_m[1][0]
 315 #define T_local_to_body_22      generic_.t_local_to_body_m[1][1]
 316 #define T_local_to_body_23      generic_.t_local_to_body_m[1][2]
 317 #define T_local_to_body_31      generic_.t_local_to_body_m[2][0]
 318 #define T_local_to_body_32      generic_.t_local_to_body_m[2][1]
 319 #define T_local_to_body_33      generic_.t_local_to_body_m[2][2]
 320
 321     DATA    gravity;            /* Local acceleration due to G  */
 322 #define Gravity                 generic_.gravity
 323
 324     DATA    centrifugal_relief; /* load factor reduction due to speed */
 325 #define Centrifugal_relief      generic_.centrifugal_relief
 326
 327     DATA    alpha, beta, alpha_dot, beta_dot;   /* in radians   */
 328 #define Alpha                   generic_.alpha
 329 #define Beta                    generic_.beta
 330 #define Alpha_dot               generic_.alpha_dot
 331 #define Beta_dot                generic_.beta_dot
 332
 333     DATA    cos_alpha, sin_alpha, cos_beta, sin_beta;
 334 #define Cos_alpha               generic_.cos_alpha
 335 #define Sin_alpha               generic_.sin_alpha
 336 #define Cos_beta                generic_.cos_beta
 337 #define Sin_beta                generic_.sin_beta
 338
 339     DATA    cos_phi, sin_phi, cos_theta, sin_theta, cos_psi, sin_psi;
 340 #define Cos_phi                 generic_.cos_phi
 341 #define Sin_phi                 generic_.sin_phi
 342 #define Cos_theta               generic_.cos_theta
 343 #define Sin_theta               generic_.sin_theta
 344 #define Cos_psi                 generic_.cos_psi
 345 #define Sin_psi                 generic_.sin_psi
 346
 347     DATA    gamma_vert_rad, gamma_horiz_rad;    /* Flight path angles   */
 348 #define Gamma_vert_rad          generic_.gamma_vert_rad
 349 #define Gamma_horiz_rad         generic_.gamma_horiz_rad
 350
 351     DATA    sigma, density, v_sound, mach_number;
 352 #define Sigma                   generic_.sigma
 353 #define Density                 generic_.density
 354 #define V_sound                 generic_.v_sound
 355 #define Mach_number             generic_.mach_number
 356
 357     DATA    static_pressure, total_pressure, impact_pressure, dynamic_pressure;
 358 #define Static_pressure         generic_.static_pressure
 359 #define Total_pressure          generic_.total_pressure
 360 #define Impact_pressure         generic_.impact_pressure
 361 #define Dynamic_pressure        generic_.dynamic_pressure
 362
 363     DATA    static_temperature, total_temperature;
 364 #define Static_temperature      generic_.static_temperature
 365 #define Total_temperature       generic_.total_temperature
 366
 367     DATA    sea_level_radius, earth_position_angle;
 368 #define Sea_level_radius        generic_.sea_level_radius
 369 #define Earth_position_angle    generic_.earth_position_angle
 370
 371     DATA    runway_altitude, runway_latitude, runway_longitude, runway_heading;
 372 #define Runway_altitude         generic_.runway_altitude
 373 #define Runway_latitude         generic_.runway_latitude
 374 #define Runway_longitude        generic_.runway_longitude
 375 #define Runway_heading          generic_.runway_heading
 376
 377     DATA    radius_to_rwy;
 378 #define Radius_to_rwy           generic_.radius_to_rwy
 379
 380     VECTOR_3    d_cg_rwy_local_v;       /* CG rel. to rwy in local coords */
 381 #define D_cg_rwy_local_v        generic_.d_cg_rwy_local_v
 382 #define D_cg_north_of_rwy       generic_.d_cg_rwy_local_v[0]
 383 #define D_cg_east_of_rwy        generic_.d_cg_rwy_local_v[1]
 384 #define D_cg_above_rwy          generic_.d_cg_rwy_local_v[2]
 385
 386     VECTOR_3    d_cg_rwy_rwy_v; /* CG relative to runway, in rwy coordinates */
 387 #define D_cg_rwy_rwy_v          generic_.d_cg_rwy_rwy_v
 388 #define X_cg_rwy                generic_.d_cg_rwy_rwy_v[0]
 389 #define Y_cg_rwy                generic_.d_cg_rwy_rwy_v[1]
 390 #define H_cg_rwy                generic_.d_cg_rwy_rwy_v[2]
 391
 392     VECTOR_3    d_pilot_rwy_local_v;    /* pilot rel. to rwy in local coords */
 393 #define D_pilot_rwy_local_v     generic_.d_pilot_rwy_local_v
 394 #define D_pilot_north_of_rwy    generic_.d_pilot_rwy_local_v[0]
 395 #define D_pilot_east_of_rwy     generic_.d_pilot_rwy_local_v[1]
 396 #define D_pilot_above_rwy       generic_.d_pilot_rwy_local_v[2]
 397
 398     VECTOR_3   d_pilot_rwy_rwy_v;       /* pilot rel. to rwy, in rwy coords. */
 399 #define D_pilot_rwy_rwy_v       generic_.d_pilot_rwy_rwy_v
 400 #define X_pilot_rwy             generic_.d_pilot_rwy_rwy_v[0]
 401 #define Y_pilot_rwy             generic_.d_pilot_rwy_rwy_v[1]
 402 #define H_pilot_rwy             generic_.d_pilot_rwy_rwy_v[2]
 403
 404
 405 } GENERIC;
 406
 407 extern GENERIC generic_;        /* usually defined in ls_main.c */
 408
 409
 410 #endif /* _LS_GENERIC_H */
 411
 412
 413 /*---------------------------  end of ls_generic.h  ------------------------*/