JSBSim Advanced Trimming Branch
C++ Objective-C PHP C Perl Python Shell
Latest commit 3905000 Dec 10, 2012 @jgoppert jgoppert Fixed auto build deps.
Permalink
Failed to load latest commit information.
admin Removed another executable flag Aug 20, 2011
aircraft Merge branch 'master' of git://gitorious.org/jsbsim/jsbsim Jul 10, 2012
check_cases Removed autotools, made depend on simgear package. Mar 22, 2012
cmake Added simgear find module. Mar 22, 2012
data_output Removed autotools, made depend on simgear package. Mar 22, 2012
data_plot Removed autotools, made depend on simgear package. Mar 22, 2012
doc Merge branch 'master' of git://gitorious.org/jsbsim/jsbsim May 20, 2012
engine Merge branch 'master' of git://gitorious.org/jsbsim/jsbsim Jul 10, 2012
examples Removed autotools, made depend on simgear package. Mar 22, 2012
gui Fix for mac. Jul 10, 2012
include/mipspro Add a short explanation of the reason why this directory exists Jul 22, 2008
scripts Merge branch 'master' of git://gitorious.org/jsbsim/jsbsim Jul 10, 2012
src Merge branch 'master' of git://gitorious.org/jsbsim/jsbsim Jul 10, 2012
systems Removed autotools, made depend on simgear package. Mar 22, 2012
xml Removed autotools, made depend on simgear package. Mar 22, 2012
.cvsignore Updated the cvs ignore file for the root directory Jun 4, 2009
.gitignore Added more compiler flags. Mar 21, 2012
AUTHORS Minor mod to AUTHORS. Again looking to test the CVS e-mail functional… Jun 8, 2011
CMakeLists.txt Fixed auto build deps. Dec 11, 2012
COPYING Removed the executable flag of non-executable files May 14, 2011
ChangeLog Update the autoconf system to reflect the usual layout, fix some cros… Jun 13, 2005
INSTALL Removed the executable flag of non-executable files May 14, 2011
JSBSimGlobeLogo.png Adding JSBSim logo (binary file) May 13, 2012
NEWS Update the autoconf system to reflect the usual layout, fix some cros… Jun 13, 2005
README Update README Mar 8, 2012
config.h.in Fixed config.h Mar 16, 2012
pc.in Working on gui threading. Jan 25, 2012

README

Contents
--------

1) Introduction
2) Building with autoconf/automake
3) Contact


1) Introduction
---------------

JSBSim is a multi-platform, general purpose object-oriented Flight
Dynamics Model (FDM) written in C++. Jon Berndt and Tony Peden began
about mid-1998 writing JSBSim. As of this writing it is the default
FDM for FlightGear. JSBSim can also be run in a standalone batch mode
for testing and study. More information on JSBSim can be found at the
JSBSim home page here:

http://www.jsbsim.org


2) Building with autoconf/automake
----------------------------------

Unpack the distribution tarball (if needed - CVS users will have
downloaded the code directly) using your preferred method, and change
to the working directory. For example :

$ tar xvfz JSBSim-0.1.2.tar.gz
$ cd JSBSim-0.1.2

NOTE for CVS users: If you are using JSBSim from a CVS checkout, or
snapshot, you will need to create the initial configure script. The
commands to do this have been included in the 'autogen.sh' script, so
just :

$ ./autogen.sh [--no-configure]

If you wish to customise your version of JSBSim, use the following to
determine any build-time options you may be interested in.

$ ./configure --help

Then :

$ ./configure

This will check your system platform, compiler and other local
configuration variables needed to build JSBSim, and generates the
necessary Makefiles. Next :

$ make

Will compile the various classes, and build the JSBSim application.


3) Building JSBSim libraries
----------------------------

By default, the JSBSim libraries are not built. To build and install
the libraries, use:

$ ./autogen --enable-libraries [--disable-static] [--enable-shared]

The configure options can be used to select what libraries to build.

$ make install

Unless specified otherwise (with --prefix configure option), this will
install JSBSim libraries into '/usr/local/lib' and JSBSim headers
into '/usr/local/include/JSBSim'.


4) Contact
----------

For more information on JSBSim contact Jon Berndt at jon@jsbsim.org.


5) Building with CMake
-----------------------

You need to install qt4, boost, and openscenegraph to build the gui. The build 
has been tested on debian, mac, and mingw cross compilation. CMake can also
generate MSVC and Eclipse project files. See the next section for building
using MSVC project files generated from CMake.

Using the cmake-gui:

    Start cmake and tell it where the source directory for JSBSim is and select
    a build directory.

The commands to build with cmake on the command line:

    (Starting in JSBSim root source directory)
    mkdir build     (This creates a directory to keep all built files)
    cd build        (Change to the newly created directory)
    cmake ..        (Tell cmake where the  source directory is)
    make            (Execute make in your build directory to create the project)

The following options exists:
    - WITH_GUI : build the gui
    - WITH_ARKOSG : use embedded openscengraph graphics
    - WITH_BUILD_DEPS : attempt to automatically download and build dependencies

    You can use these options with cmake -DWITH_GUI=y -DWITH_ARKOSG=n -DWITH_BUILD_DEPS=y

6) Building Trimming/ Linearization GUI with MSVC on Windows
-----------------------

Tested with Microsoft Visual C++ 2008.

1. Install Qt-Win-Opensource from http://get.qt.nokia.com/qt/source/qt-win-opensource-4.8.0-vs2008.exe.
    Add C:\Qt\4.8.0\bin to Windows Path environment.

2. If you have a full (i.e non-express) version of VC2008, also install the Qt add-in from 
   http://get.qt.nokia.com/vsaddin/qt-vs-addin-1.1.10.exe.

3. With git clone get arksog 
   from https://github.com/arktools/arkosg.git.
 
   Both and jsbsim and arkosg should be placed in the same directory.

4. Install recent versions of Boost and OpenScenegraph. Unlike Flightgear, a binary build of Boost is 
   required as the thread and system libraries are used. Pre-built 32 bit versions of Boot and
   OpenScengraph are available on the 'net.
   This build has been tested with both libraries installed in C:\Program Files.
   Openscengraph and Boost binary directories need to be in the Path environment.   
   Flightgear cmake also works well with this setup.

5. Run cmake gui on arkosg. Cmake may ask for qmake.exe. Use the one in C:\Qt\4.8.0\bin. 
   Set C:/directory where jsbsim and arkosg are/install as the cmake install directory.
   Configure, sort out any not-found errors, and Generate.

6. Open arkosg/build/arkog.sln and build and install arkog with MSVC.

8. Repeat 6 and 7 for jsbsim.

9. Run install/jsbsimgui.exe.

10. Please let me know of any bugs, and if possible send fixes. ;-)
    Alan Teeder ajteeder@v-twin.org.uk

7) Packaging with CMake
-----------------------
After you have built the project using cmake you can package it by running the cpack command in the build directory.

Linux: cpack -G DEB (Generated a Debian package)
Mac: cpack -G PackageMaker (Mac Installer)
Windows cpack -G NSIS (Windows Installer)