Skip to content

Latest commit

 

History

History
164 lines (117 loc) · 5.02 KB

Building.md

File metadata and controls

164 lines (117 loc) · 5.02 KB
Raw

Building I-Simpa

Minimal Hardware requirements

  • Processor 1.5 GHz Intel Pentium® or equivalent / higher
  • Graphic card with OpenGl® (1.4 or higher) with display resolution 1024 x 728 or more
  • Hard disk: 20 Go free space
  • RAM: 512 Mo minimum required

Software & Dependencies requirements

  • CMake
  • Boost 1.60
  • wxWidget 3.1.0
  • Swig
  • Python 2.7

⚠️ This project uses OpenGL, check if your graphic driver is up to date !

On Windows with Microsoft Visual Studio (64bits)

Last (free) version in date : Visual Studio Community 2015

Libraries installation

We recommend you to create a lib folder in C: and to use it when extracting extracting externals libraries source.

  • Boost

    • Download Boost 1.60

    • Extract the archive

    • To build Boost : from the Visual Studio shell (Menu > All Programs > Visual Studio Tools), in the Boost folder

        .\bootstrap.bat
  # build just what we need
  .\b2. toolset=msvc-14.0 --with-thread --with-random --with-python --with-date_time --with-test --with-filesystem --with-regex --build-type=complete stage
  # or everything
  .\b2. toolset=msvc-14.0 --build-type=complete stage

    • Move the lib/ folder (inside stage/) to the Boost folder root

    • Create/check environment variable

        BOOST_INCLUDEDIR		path\to\boost\
  BOOST_LIBRARYDIR		path\to\boost\lib\

  • Swig

    • Download Swig
    • Extract the archive
    • Add to Path the Swig folder path

  • wxWidgets

    • Download the wxWidget 3.1.0 Windows Installer

    • The installer extract the source in a folder

    • In the wxWidget folder, in build/msw, launch wx_vc14.sl

    • Choose the "debug" mode and generate the solution

    • Choose the "release" mode and generate the solution again

    • Quit Visual Studio

    • Create/check environment variable

        WXWIN		path\to\wxwidget

  • Python

    • Download Python 2.7

    • Install it (the installer has an option that can do the two next steps for you)

    • Add to Path the Python installation folder path

    • Create/check environment variable

        PYTHONPATH		path\to\python\Lib

Building I-Simpa

  1. Generate the Visual Studio project with CMake (GUI or command line), be careful to choose a different and empty build folder. Normally, all libraries will be found by CMake (if not, good luck).
  2. In the build folder, launch isimpa.sln
  3. Define i-simpa as the start project (right clic)
  4. Generate ALL_BUILD in debug mode and in release mode, then generate INSTALL
  5. You will find I-Simpa ready to launch in the bin folder of your build folder

On GNU/Linux (GCC or Clang)

Travis will tell you if our Linux build work : Build Status

The travis build commands under linux are here https://github.com/Ifsttar/I-Simpa/blob/master/.travis.yml

We have currently issues on OpenGL calls under linux. Display of particles and surface receivers are not working in Gnu/Linux. However all the other features appears to work.

Dependencies

In order to build under linux you have to download/install the following libraries:

  • gcc-4.8
  • g++-4.8
  • python 2.7
  • freeglut3-dev
  • libxmu-dev
  • libxi-dev
  • libpng-dev
  • libjpeg-dev
  • libxxf86vm1
  • libxxf86vm-dev
  • libxi-dev
  • libxrandr-dev
  • mesa-common-dev
  • mesa-utils
  • libgl1-mesa-dev
  • libglapi-mesa
  • libgtk-3-dev
  • byacc
  • gettext

Swig from here: https://github.com/swig/swig/archive/rel-3.0.10.tar.gz

Boost from here: https://sourceforge.net/projects/boost/files/boost/1.61.0/boost_1_61_0.tar.bz2

wxWidgets from here: https://github.com/wxWidgets/wxWidgets/releases/download/v3.1.0/wxWidgets-3.1.0.tar.bz2

Cmake from here https://cmake.org/files/v3.6/cmake-3.6.1-Linux-x86_64.tar.gz

Building instructions

Creating makefile using CMake program (from the I-Simpa source directory):

export CXX="g++-4.8"
export CC="gcc-4.8"

cmake --version
${CC} --version
${CXX} --version

mkdir build
cd build

CLANG_WARNINGS=""

# wxWidget path (only in script scope)
export PATH=$HOME/wxWidgets-install/bin/:$HOME/swig-install/bin/:$HOME/cmake-install/bin/:$PATH
export BOOST_LIBRARYDIR=$HOME/boost-install/lib/
export BOOST_INCLUDEDIR=$HOME/boost-install/include/
export BOOST_ROOT=$HOME/boost-install/

cmake ..

Then you can run the build:

make
make DESTDIR=/home/john/isimpabuild/ install

Then run isimpa program located in the specified destdir.

Other installation/configuration

Contributors can try other configurations, using more recent libraries (wxWidgets for example), other IDE (Code::Blocks for example) or a more recent version of Visual Studio... If you success in building and running I-Simpa, we will appreciate that you share your experience, adding it in this wiki. Please contact us by mail.

Need information

If you have some problem during the building procedure, please contact us by mail.