en:dev:installation
Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
en:dev:installation [2015/01/28 17:12] Antonello Lobianco [Getting the source code] |
— (current) | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== Installing and running FFSM++ ====== | ||
| - | ===== Installing the compiled software ===== | ||
| - | |||
| - | FFSM, as any model developed in C++, must be firstly compiled for the specific environment in use. For windows users a pre-compiled version of the model is provided in a self-installation package that take care of installing the dependencies.\\ | ||
| - | Just run the installer, choose the components to install (next Figure) and the FFSM program will be available within the installed programs.\\ | ||
| - | For Linux users pre-compiled packages can be released at user's request.\\ | ||
| - | {{ : | ||
| - | |||
| - | |||
| - | ===== Running the model ===== | ||
| - | |||
| - | ==== Gui mode ==== | ||
| - | |||
| - | Clicking on the FFSM icon allows the software to open in GUI mode (next Figure). From here we can load a new data input file (or leave the default one at '' | ||
| - | We will then be presented with a pop-up to choose between the available scenarios in the loaded input file and continue.\\ | ||
| - | During the proceeding of the simulation we can observe its status loading any of the layers using the drop-down menu, analyse the live logs or retrieve any pixel detail right clicking on it.\\ | ||
| - | At any time we can either pause the simulation or abort it. | ||
| - | |||
| - | At the end of the simulation, provided that we have a compatible spreadsheet application with macro enabled, we can click on the results button to analyse the results directly on it. | ||
| - | |||
| - | {{ : | ||
| - | |||
| - | |||
| - | ==== Command line options ==== | ||
| - | |||
| - | FFSM has also a command line mode that is activable using the DOS or unix prompt.\\ | ||
| - | It accepts the following options: | ||
| - | ^ Short option version | ||
| - | | '' | ||
| - | | '' | ||
| - | | '' | ||
| - | | '' | ||
| - | |||
| - | Command line mode is very useful for unattended simulations of the model, e.g. when working on sensitivity analysis that requires the run of many similar scenarios.\\ | ||
| - | In such case it is advisable to prepare the desired scenarios in the input file and then run the model sequentially in a batch mode changing only the -s switch. | ||
| - | |||
| - | While the program use a single process, in Linux you can use the following scripts to run several scenarios in parallel, hence benefitting of modern multi-core processes: | ||
| - | |||
| - | <file bash run_single_scenario.sh> | ||
| - | #!/bin/bash | ||
| - | |||
| - | # | ||
| - | # Shell script to run a single ffsm scenario, where the scenario name is the first argument. | ||
| - | # | ||
| - | |||
| - | ./ffsm -c -s $1 > logs/ | ||
| - | echo "Ended running scenario " $1 | ||
| - | </ | ||
| - | |||
| - | <file bash runscenarios.sh> | ||
| - | #!/bin/bash | ||
| - | |||
| - | # | ||
| - | # Shell script to run ffsm scenarios | ||
| - | # | ||
| - | |||
| - | # Safe parallel.. | ||
| - | ./ffsm -c -s scenarioName1 > logs/ | ||
| - | ./ffsm -c -s scenarioName2 > logs/ | ||
| - | |||
| - | |||
| - | # Running the same scenario (e.g. for repetitions) in parallel is safe as long as newRandomSeed | ||
| - | # is set to true and outputSingleFile is set to false.. | ||
| - | for i in {1..30} | ||
| - | do | ||
| - | | ||
| - | done | ||
| - | |||
| - | # A better approach to run scenarios in parallel is using GNU parallel: you can set the maximum | ||
| - | # number of processes and then the jobs are put in a queue. | ||
| - | # In that case run this script as: | ||
| - | # parallel --jobs <n of jobs> -a runscenarios.sh | ||
| - | # and put something like this in the script | ||
| - | |||
| - | ./ | ||
| - | ./ | ||
| - | </ | ||
| - | |||
| - | ===== FFSM++ development instructions ===== | ||
| - | |||
| - | The overall FFSM++ development environment requires a little bit of efforts in its start-up, due to the many tools used, but on the other hand once all these tools has been set-up it results in a very powerful one. | ||
| - | |||
| - | ==== Setting up the Development Environment ==== | ||
| - | |||
| - | The FFSM development itself is done using Qt Creator, a multi-platform Integrated Development Environment (IDE) based on the popular Qt libraries.\\ | ||
| - | This section contains detailed instructions on how to get and install the IDE and all the necessary prerequisites, | ||
| - | |||
| - | === Linux (Ubuntu 14.04) === | ||
| - | |||
| - | The following packages and their prerequisites should be installed: libqt5-*, qtcreator, qmake, libatlas-base-dev, | ||
| - | |||
| - | == Ipopt == | ||
| - | * Downolad Ipopt (Ipopt-3.XX.X.tgz) from http:// | ||
| - | * In the extracted directory move to ThirdParty and for {Metis|Mumps} go in their subfolder and run " | ||
| - | * For using the HSL linear solver (optional, as it requires a free academic licence, but way faster than MUMS) download ma27-1.0.0.tar.gz, | ||
| - | * Create a build directory, move there and from there type:< | ||
| - | ../ | ||
| - | make | ||
| - | sudo make install | ||
| - | # New 2013/11/19: on ubuntu 13.10 64bit and ipopt 3.11.6 run the configure as: | ||
| - | ../ | ||
| - | </ | ||
| - | |||
| - | == ColPack == | ||
| - | * Download ColPack >= 1.0.8 (ColPack-1.X.X.tar.gz) from http:// | ||
| - | * Type:< | ||
| - | ./configure –prefix=/ | ||
| - | make | ||
| - | sudo make install | ||
| - | </ | ||
| - | //Notes: if you get an error about libtool version mismatch run " | ||
| - | (http:// | ||
| - | |||
| - | == ADOL-C == | ||
| - | |||
| - | * Download ADOL-C (ADOL-C-2.X.X.tgz) from http:// | ||
| - | * Type:< | ||
| - | ./configure --enable-docexa --enable-addexa --enable-sparse –prefix=/ | ||
| - | make | ||
| - | sudo make install | ||
| - | </ | ||
| - | //New 2013/11/19: On 64 bits Linux, symlink all libadoc.* libraries from /usr/lib64 to /usr/lib, e.g. ln -s ../ | ||
| - | Notes: If you have an error about libtool version mismatch run " | ||
| - | |||
| - | === Windows (XP or 7) === | ||
| - | |||
| - | === MinGW === | ||
| - | |||
| - | MinGW is the windows version of the g++ compiler, together with a minimal unix-style environment that allow to compile unix programs natively in windows.\\ | ||
| - | Please follow the instructions below: | ||
| - | * Download the MinGW environment installer (http:// | ||
| - | * Launch the installer | ||
| - | * Select " | ||
| - | * Select C:\MinGW as folder. Do not change this setting !! | ||
| - | * Select the following components: | ||
| - | * C compiler; | ||
| - | * C++ Compiler; | ||
| - | * Fortran Compiler; | ||
| - | * MinGW Developer Toolkit | ||
| - | * Open a MinGW shell: START-> | ||
| - | * Type " | ||
| - | * From the MinGW shell you'll find the hard disk content under /c | ||
| - | == Qt and Qt Creator == | ||
| - | |||
| - | - From " | ||
| - | * Qt libraries 5.X.X for Windows (MinGW 4.X) | ||
| - | * Qt Creator 2.X.0 for Windows | ||
| - | - Install the software | ||
| - | * Install the Qt libraries with default options (leave C:\MinGW when asked where to look for it) | ||
| - | * Install the Qt Creator with default options | ||
| - | - Install the python-enabled debugger (in order to watch STL containers) | ||
| - | * Download the GDB for your environment from http:// | ||
| - | * Point qtcreator to use it from the options-> | ||
| - | - Configure the software | ||
| - | * On Qt Creator, go to " | ||
| - | * On the tab "Tool chain" click " | ||
| - | * On the tab "Qt Version" | ||
| - | |||
| - | Alternative version for installing the Qt libraries from source | ||
| - | * Install first MinGW as directed | ||
| - | * Download qt-everywhere-opensource-src-5.X.X.tar.gz and unzip it to C:\Qt\5.X.X | ||
| - | * Add C: | ||
| - | * Run the following script from the MinGW shell< | ||
| - | cd /c/Qt/5.x.x | ||
| - | configure.exe -qt-zlib -opensource -release -platform win32-g++ | ||
| - | mingw32-make | ||
| - | </ | ||
| - | //Notes: These instructions were written for the now obsolete Qt4. We didn't tested them with the newer Qt5 that are required by the model, but we think the procedure should be similar. Qt 4.8.3 had a know bug that required adding QMAKE_RCC = $$[QT_INSTALL_BINS]$${DIR_SEPARATOR}rcc.exe after the QMAKE_IDC line in C: | ||
| - | |||
| - | == Ipopt (optional) == | ||
| - | This step is not required, as a windows 32 version of IPOPT is already shipped with FFSM, but if you want to build your own version of ipopt, e.g. because a new version is available or you want to use a faster linear solver (and you have an academic licence) you can follow these instructions. | ||
| - | * Downolad Ipopt Ipopt-3.XX.X.tgz from http:// | ||
| - | * In the Ipopt extracted folder create a " | ||
| - | * Open the MinGW shell and type "cd / | ||
| - | * For each of {Blas|Lapack|Metis|Mumps} go in their sub-folder and run from there " | ||
| - | * For using the HSL linear solver (optional, as it requires a free academic licence, but way faster than MUMS) download ma27-1.0.0.tar.gz, | ||
| - | * Type, in the sequence:< | ||
| - | cd /c/ipopt/ | ||
| - | mkdir build | ||
| - | cd build | ||
| - | ../ | ||
| - | make | ||
| - | make install | ||
| - | </ | ||
| - | * Replace the dll and header files coming with git in win32 ([FFSM_FOLDER]\src\ThirdParty\ win32) from the equivalent ones in C: | ||
| - | |||
| - | == COLPACK (optional) == | ||
| - | * Download ColPack >= 1.0.8 (ColPack-1.X.X.tar.gz) from http:// | ||
| - | * You can choose to have it statically compiled to ADOL-C (better I guess) or dynamically compiled. Performances are actually very similar, with a little improvement for the static linking. | ||
| - | * METHOD 1 - STATIC LINKING (DEFAULT) | ||
| - | * Type: <code bash> | ||
| - | ./configure –prefix=/ | ||
| - | make | ||
| - | g++ -shared -Wl, | ||
| - | </ | ||
| - | * METHOD 2 - DYNAMIC LINKING | ||
| - | * From the MinGw prompt, follow the method suggested here to compile and install ColPack, adding --prefix=/ | ||
| - | * Copy libColPack-0.dll to the root of ffsm and to [FFSM_ROOT]\src\ThirdParty\win32\lib\ | ||
| - | |||
| - | //Notes: If linking problems arise with method 2, copy also all the other libColPack.* libraries to [FFSM_ROOT]\src\ThirdParty\win32\lib\. ColPack compile but doesn' | ||
| - | |||
| - | == ADOL-C (optional) == | ||
| - | * Download ADOL-C (ADOL-C-2.X.X.tgz) from http:// | ||
| - | * Comment lines 71 to74 and 500 to 510 in file [ADOL-C]\ADOL-C\src\adouble.h and [ADOL-C]\ADOL-C\adouble.h (these lines refer to a local definition of fmix() and fmax() that conflicts with that defined by MinGw). | ||
| - | * Open the MinGW shell and type the following commands: <code bash> | ||
| - | cd /c/ADOL-C | ||
| - | cd ADOL-C | ||
| - | ln -s src adolc | ||
| - | cd .. | ||
| - | </ | ||
| - | * IF YOU FOLLOWED METHOD 1 IN COLPACK (STATIC LINKING): | ||
| - | * Replace all the configure scripts from ADOL-C 2.3.0 with those of ADOL-C 2.2.1. Static linking will not work with the configure system provided in adol-c 2.3.0. | ||
| - | * Create the following directories under the ADOL-C root: | ||
| - | * [ADOL-C ROOT]\ThirdParty\ColPack\build\include | ||
| - | * [ADOL-C ROOT]\ThirdParty\ColPack\build\include\ColPack --> | ||
| - | * [ADOL-C ROOT]\ThirdParty\ColPack\build\lib | ||
| - | * Copy there the libs and includes obtained from the ColPack compilation. The exact position (e.g. the includes under \include\ColPack or directly under \include) depends on the adol-c versions. Copying them in several positions doesn' | ||
| - | * Type:< | ||
| - | ./configure --enable-docexa --enable-addexa --enable-sparse –prefix=/ | ||
| - | make | ||
| - | </ | ||
| - | * IF YOU FOLLOWED METHOD 2 IN COLPACK (DYNAMIC LINKING): | ||
| - | * Type:< | ||
| - | ./configure --enable-docexa --enable-addexa --enable-sparse --prefix=/ | ||
| - | make | ||
| - | </ | ||
| - | * Replace the dll and header files coming with git in win32 from the equivalent ones from C: | ||
| - | * Copy libadolc-1.dll also to the root of Ffsm. | ||
| - | //Notes: If you have an error about libtool version mismatch run " | ||
| - | |||
| - | ==== Getting the source code ==== | ||
| - | * Type:< | ||
| - | git clone https:// | ||
| - | </ | ||
| - | //Note: Git repository is currently set private untill we remove from it input data for which we do not have the copyright and hence we can't publicily release.// | ||
| - | ==== Developing FFSM ==== | ||
| - | |||
| - | Once the development environment has been set up it is possible to inspect and change the source code of FFSM using the Qt Creator IDE: | ||
| - | {{ : | ||
| - | |||
| - | A guide to Qt Creator is out of this paper scope, as abundant documentation can be retrieved from either official and unofficial sources. Hence, we describe here just the very basic operations required to modify and compile the code.\\ | ||
| - | To start the IDE click on the file ffsm.pro. The first time Qt Creator will ask the version of Qt to be used for the project, where the default choices can be accepted.\\ | ||
| - | The icons on the bottom of the left panel allow to perform the main actions at the project level: to compile it (//hammer icon//), debug it (//bug icon//) and run it (//play icon//). | ||
| - | |||
| - | The overlying switch allows to select the current mode between release and debug: the release mode produces a smaller and optimized program that run faster but doesn' | ||
| - | In the debug mode (to which the screenshot refers) the modeller can also inspect the whole stack leading to that specific point, that is, the list of function calls made up to the point, and can decide where to set the next breakpoint: to the next manually set breakpoint, | ||
| - | While the application is debugged it runs as a normal program on its own windows if in GUI mode or under the panel “Application Output” if in console mode. | ||
| - | |||
| - | ==== Deploying FFSM ==== | ||
| - | |||
| - | Optionally FFSM can be packaged in an easy to be used self-installer for Windows. \\ | ||
| - | It is enough to download and install the //Nullsoft Install System// and, from the windows explorer, right click on the provided '' | ||
en/dev/installation.1422461553.txt.gz · Last modified: 2018/06/18 16:44 (external edit)
Page Tools
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International
