************************************************
*                                              * 
*  FGFS Reconfigurable Aircraft Flight Model   *
*  Sample Input Files                          * 
*  Version 0.64, March 28, 2000                *
*                                              *
*  Authors:                                    *
*  Jeff Scott (jscott@mail.com)                *
*  Bipin Sehgal (bsehgal@uiuc.edu)             *
*  Michael Selig (m-selig@uiuc.edu)            *
*  Dept of Aero and Astro Engineering          *
*  University of Illinois at Urbana-Champaign  *
*  Urbana, IL                                  *
*  http://amber.aae.uiuc.edu/~m-selig          *
*                                              *
************************************************ 

The simulator executable, fgfs.exe, uses the aircraft.dat files
located in Aircraft-uiuc to fly the desired aircraft.  This file
should either be in the same directory as fgfs.exe or should be called
from the command line.  To do the latter, open a DOS or Cygwin shell
and go to the directory containing fgfs.exe.  Type the following:

> fgfs.exe --aircraft-dir=Aircraft-uiuc/Cessna172-TD

The same procedure can be accomplished using a batch file.  A sample
batch file (runfgfs.bat) is provided in the top level directory.  To
run the desired aircraft, simply delete the "REM" command from the
beginning of the line.  Make sure that all the other model lines still
begin with "REM" or you may not actually be flying the plane you want.
There is also a record feature that generates a file called
uiuc_record.dat.  The desired variables can be recorded in this file
using the proper record lines.  The syntax of these lines and the
aircraft.dat files in general is provided in the documentation file 
README.uiucDoc.

Notes:
------

- All aircraft use the C172 gear model, and this gets overloaded for
  the heavier aircraft.  Adding throttle will eventually lead to
  enough airspeed to fly.  For aircraft much lighter than the C172,
  the aircraft will jitter around on a sloping ground until throttle
  is applied.

- For each aircraft, the thrust was set to give more or less
  "reasonable" performance characteristics.  Users are encouraged to
  vary the thrust.  See line
     > engine simpleSingle <simpleSingleMaxThrust>
  and change the value to improve performance.

- Most aircraft are modeled using cruise condition data only.  Takeoff
  and landing configurations and associated changes in aerodynamic
  characteristics are not currently modeled.

- Some files use "record" lines to produce flight-data recorder
  output.  These data are written to the file uiuc_record.dat.  Beware
  that when flying for an extended period of time this file (if
  written by using record lines) can become very large.

To fly, use one of the following aircraft directories:

Beech99:
  - Beech 99, small commercial commuter aircraft
  - Very smooth characteristics

Boeing747:
  - Boeing 747, large commercial jetliner
  - Too heavy for gear so noses down into ground at 70 degree angle,
    but this can be fixed by going to max throttle until plane rotates
    and becomes airborne; sluggish as expected, but flies well

Cessna172:
  - Cessna 172, small general aviation aircraft
  - Based on Tony Peden's model, but uses stability derivatives only
  - Flies very well

Cessna172-TD:
  - Cessna 172, small general aviation aircraft
  - Uses lift curve data from Peden model
  - Also flies well

Cessna310:
  - Cessna 310, twin engine general aviation aircraft
  - Elevator seems too effective
  - Slight instability in roll

Cessna620:
  - Cessna 620, four engine business aircraft
  - Sluggish and underpowered

Convair880:
  - Convair 880, medium commercial jetliner
  - Major problem on ground (overloads the default Cessna 172 gear)
  - Flies well once airborne; just throttle up and nose up until in
    the air. Use the controls to obtain the proper orientation

F104:
  - Lockheed F-104, small supersonic fighter
  - Flies pretty smoothly and very responsive

F4:
  - McDonnell F-4 Phantom, fighter/attack plane
  - Major problems on ground (overloads the default Cessna 172 gear)
  - Pretty difficult to fly once airborne

Learjet24:
  - Learjet 24, business jet
  - Flies very well

Marchetti:
  - SIAI-Marchetti S-211 military jet trainer
  - Flies very well

Pioneer:
  - IAI Pioneer UAV, small reconnaissance unmanned aerial vehicle
    version uses stability derivatives only
  - Yaws to right or left at startup due to Cessna 172 gear.  Throttle
    up to correct this; slight roll instability, but very responsive

Pioneer-TD:
  - IAI Pioneer UAV, small reconnaissance unmanned aerial vehicle
  - This version uses lookup tables for lift and drag and most control
    surface deflections
  - Yaws to right or left at startup due to Cessna 172 gear.  Throttle
    up to correct this; slight roll instability, but very responsive

T37:
  - Cessna T-37 twin jet engine military trainer
  - Flies well

TwinOtter:
  - DeHavilland Canada DHC-6 Twin otter, small commuter aircraft
  - NASA Glenn Twin Otter for icing research
  - Clean version (no ice), flies well

TwinOtterIce:
  - DeHavilland Canada DHC-6 Twin otter, small commuter aircraft
  - NASA Glenn Twin Otter for icing research
  - Note the degradation in performance after ice accretion begins.
    Icing begins 2 minutes into flight; transition from clean to iced
    aerodynamics lasts 5 seconds--this is not very realistic, but you
    can vary these times and the icing severity factor 'eta' [0=no ice,
    1=max ice], to see the impact on performance
