forked from cycheung/gmsh
/
README.txt
102 lines (66 loc) · 3.17 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
This is Gmsh, an automatic three-dimensional finite element mesh generator with
built-in pre- and post-processing facilities.
Gmsh is copyright (C) 1997-2015 C. Geuzaine and J.-F. Remacle, and is
distributed under the terms of the GNU General Public License, Version 2 or
later, with an exception to allow for easier linking with external
libraries. See doc/LICENSE.txt and doc/CREDITS.txt for more information.
See the doc/ and tutorial/ directories for documentation. The reference manual
is located in doc/texinfo/. See the demos/ directory and the web site
http://geuz.org/gmsh for additional examples.
Building Gmsh from its source code requires a C++ compiler and CMake
(http://cmake.org). Building the graphical user interface requires FLTK 1.3.2
(http://fltk.org), configured with OpenGL support.
Build Gmsh from the command line
--------------------------------
* Create a build directory, for example as a subdirectory of Gmsh's source
directory:
mkdir build
* Run cmake from within the build directory, pointing to Gmsh's source
directory:
cd build
cmake ..
* To build and install Gmsh then simply type
make
make install
* To change build options you can use "ccmake" instead of "cmake", e.g.:
ccmake ..
or you can specify options directly on the command line. For example, you can
use
cmake -DCMAKE_PREFIX_PATH=/opt/local ..
to specify the location of external packages installed in non-standard
directories. You can use
cmake -DCMAKE_INSTALL_PREFIX=/opt
to change the installation directory. Or you can use
cmake -DENABLE_FLTK=0 ..
to build a version of Gmsh without the FLTK graphical interface. The list of
all available configuration options is given in the reference manual.
* You can keep multiple builds with different build options at the same
time. For example, you could configure a debug graphical build in a "bin"
subdirectory with
cd bin
cmake -DCMAKE_BUILD_TYPE=Debug ..
make
make install
and minimal static and dynamic libraries in a "lib" subdirectory with
cd lib
cmake -DDEFAULT=0 -DENABLE_BUILD_LIB=1 -DENABLE_BUILD_SHARED=1 ..
make lib
make shared
make install/fast
(Note that "make install/fast" allows you to install only the targets that you
just built--i.e. "lib" and "shared", and will not trigger the recompilation of
the default target "gmsh".)
* To see a detailed compilation log use
make VERBOSE=1
Build Gmsh using CMake's graphical user interface
-------------------------------------------------
* Launch CMake and fill-in the two top input fields (telling where the Gmsh
source directory is located and where you want the Gmsh binary to be created).
* Click on "Add entry" and define the variable CMAKE_PREFIX_PATH, of type
"PATH", pointing to the location(s) of any external package(s) (FLTK,
BLAS/LAPACK, etc.) installed in non-standard directories.
* Click on "Configure" and choose your compiler.
* Optionally change some configuration options (re-run "Configure" every time
you change some options).
* Once you are happy with all the configuration options, click on "Generate".
* Go to the build directory and build Gmsh using your chosen compiler.