Feel++ 0.91.0

Getting started

Building Feel

Getting the source via an archive

Feel is distributed as a tarball once in a while. The tarballs are available at the Feel web site.

Download the latest tarball. Then follow the steps and replace {x},{y},{z} with the corresponding numbers

  tar xzf feel-x.y.z.tar.gz
  cd feel-x.y.z

Getting the source via Subversion

CreationRSAKey Creating RSA keys

In order to download the sources of Feel, you have to go in "LJKForge website" and create an account. After the administrator approval, you have to demand the rights to see the project tree.

Then, you will have to create RSA keys to be able to connect to the server using ssh. To do that you have to type the commands : ssh-keygen -t dsa and ssh-keygen -t rsa to create the keys. After that, you have to copy the id_dsa.pub and id_rsa.pub files in the My Page > Account Maintenance > Edit SSH Keys section of the LJKForge website. Those files are located in the ~/.ssh/ folder of your computer. You will be able to connect to the server within an hour.

Note:
If you don't have the same login on your computer as on LJKForge, you must add the commands
host ljkforge.imag.fr
  user <your_login_ljkforge>
in the ~/.ssh/config file.

Downloading the sources

To be able to download the Feel sources, you need subversion and SSH > 1.xxx installed on your computer. In a command prompt, go where you want Feel to be downloaded and type the following command.

svn co svn+ssh://login@ljkforge.imag.fr/svn/feel/feel/trunk feel

where login is your login name in the LJKForge plateform. Then, if you want to download the feel-test sources type :

  cd feel/benchmarks
  svn co svn+ssh://login@ljkforge.imag.fr/svn/feel-test/feel-test/trunk validation

Dealing with software dependencies

In order to install Feel, you have to install many dependencies before. Those libraries and programs are necessary for the compilation and installation of the Feel librairies.

This is the list of all the librairies you must have installed on your computer, and the |*-dev| packages for some of them.

Here is the list of required packages:

Here is the list of optional packages:

Note that all these packages are available under Debian/GNU/Linux and Ubuntu. They should be available

Compiling Feel with the CMake

Feel build system supports CMake{cmake}{{http://www.cmake.org}}. This should become the preferred way to build Feel as it is much simpler and more powerful in many ways than the autotools.

Feel, using CMake, can be built either in source and out of source and different build type:

CMake In Source Build

This is not advised, yoiu should consider out source builds, see next paragraph.

Enter the source tree and type

  cmake .
  make

To customize or change some build setting one can use the CMake curse interface

  ccmake . # configure and generate
  make
CMake Out Source Build

Create a build directory

  mkdir feel.opt
  cd feel.opt
  cmake <directory where the feel source are>
  # e.g cmake ../feel if feel.opt is at the same
  # directory level as feel
  make

you can customize the build type:

  # Debug build type (-g...)
  cmake -D CMAKE_BUILD_TYPE=Debug
  # Release build type (-O3...)
  cmake -D CMAKE_BUILD_TYPE=Release
  ...

Compiling the Feel tutorial

If the command make check has been run before the tutorial should be already compiled and ready. The steps are as follows to build the Feel tutorial

  cd opt/doc/tutorial
  make check

Here is what the directory should look like

  cd opt/doc/tutorial
  ls

  laplacian     Makefile      myintegrals   mymesh       pngs/
  tutorial.blg  tutorial.out  tutorial.toc  laplacian.o  myapp
  myintegrals.o mymesh.o      stokes.assert tutorial.aux pdfs/ styles/
  stokes        stokes.o      tutorial.bbl  tutorial.log tutorial.pdf

Namepaces and Libraries

Here is the list of namespaces

Here is the list of libraries