docs-mini/README.JSBsim

   1 JSBSim
   2
   3 JSBSim is an ongoing attempt at producing an OO Flight Dynamics Model (FDM)
   4 to replace LaRCsim as the default FDM for FlightGear. It can also be used
   5 standalone.
   6
   7 JSBSim uses config files to represent aircraft and engines. Also, the flight
   8 control system is described in the config file. Normally, for use with
   9 FlightGear, the config files are named this way:
  10 <FG_ROOT>/Aircraft/<aircraft name>/<aircraft name>.cfg . Engines are named
  11 like this: <FG_ROOT>/Engines/<engine name>.dat .
  12
  13 Aircraft and engine config files are present in the FGFS-Base package which
  14 must be downloaded from the FlightGear web site at www.flightgear.org or one
  15 of the mirror sites listed there.
  16
  17 How to run FGFS using JSBSim
  18
  19 All the various FDMs are currently compiled into FGFS. You can specify which
  20 FDM you want at run time. You can also specify which aircraft you want.
  21 Currently, for JSBSim only the X-15 is available, and possibly the C-172.
  22 Here is an example command line used to start up FlightGear using JSBSim as
  23 the FDM:
  24
  25 fgfs --fdm=jsb --aircraft=X15 --units-feet --altitude=60000 --uBody=2000 --wBody=120
  26
  27 [Note: uBody is the forward velocity of the aircraft, wBody is the downward
  28 velocity - from the aircraft point of view. This essentially means that the
  29 aircraft is going forward fast and has an angle of attack of about 4 degrees
  30 or so]
  31
  32  The above command line sets up the initial velocity and altitude to allow
  33 the X15 to glide down. Note that if you fire up the engine, it will burn for
  34 only about two minutes and then run out of fuel - but you will go very, very
  35 fast!
  36
  37 Check out the JSBSim home page at www.hal-pc.org/~jsb/flightsim.html. Please
  38 report any bugs to jsb@hal-pc.org, or apeden@earthlink.net, or post them to
  39 the fgfs-devel mailing list.
  40
  41 JSBSim is written by Jon S. Berndt and Tony Peden with contributions by
  42 other FlightGear programmers, as well.