FEniCS MeshBuilder v0.2
------------------------

Contents:

  1. Installation
  2. Usability
  3. License
  4. Known bugs

-------------------------------------------------------------------------------
1. Installation

The program is devloped on Ubuntu Linux 10.10 using the
Ubuntu repository libraries (except for DOLFIN itself).

Some sort of OpenGL driver should be enabled to make it work properly.

To build you will need to install

- OpenScenegraph (version >= 2.2). Use the libopenscenegraph-dev package on Ubuntu.

- Qt (version >= 4.4). On Ubuntu, just install the qt4-dev-tools and libqt4-opengl-dev
  packages and it should (hopefully) take care of the rest.
  Note: if you compiler 

- DOLFIN, (version >= 0.9.11). A recent version. Make sure you install the
  dolfin-dev package if you use DOLFIN from the FEniCS Debian/Ubuntu
  repository (see http://www.fenics.org/wiki/Download).

- A C++ compiler. Use the build-essential package on Ubuntu.

Meshbuilder uses CMake (http://www.cmake.org) to generate Makefiles. To do 
a standard type

  mkdir build
  cd build
  cmake ..

to generate the Makefiles.

NOTE:
-----
If you get "Found potensial symbol conflict" warnings from Qmake, you are 
probably using Qt version 3. Make sure you installed the packages mentioned above. Then do
   sudo update-alternatives --config moc
   sudo update-alternatives --config qmake 
   sudo update-alternatives --config uic 
and choose the Qt4 options. Finally check the qt version with the commands
   qmake -v
   moc -v
   uic -v
They should now report that they are using Qt4. Redo the "cmake .." command.
-----

Finally compile Meshbuilder with the command:

   make

To install Meshbuilder system wide, do
   sudo make install

-------------------------------------------------------------------------------
2. Usability

- You can use the app to set integer meshfunctions on dolfin meshes,
  on vertices, edges and faces. These can be saved and loaded.
  Don't mix up the meshfunction files with regards to the entities
  as there is no check when loading what kind of entity the values
  are for.

- You can create a screenshot.

- You can look at the boundary mesh of a mesh (or a 2D mesh directly).

-------------------------------------------------------------------------------
3. License

MeshBuilder is copyright of Simula Research Laboratory and is licensed
under the GNU LESSER GENERAL PUBLIC LICENSE (LGPL) version 2.1.

-------------------------------------------------------------------------------
4. Known bugs

- The application will crash if you import a mesh after another.

-------------------------------------------------------------------------------

Ola Røer Thorsen
Yvon Halbwachs
Kalkulo AS
