-
Notifications
You must be signed in to change notification settings - Fork 3
/
README.txt
99 lines (65 loc) · 3.32 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
This is Gmsh, an automatic three-dimensional finite element mesh generator with
built-in pre- and post-processing facilities.
Gmsh is copyright (C) 1997-2019 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 LICENSE.txt and 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://gmsh.info for additional examples.
Building Gmsh from source code requires a C++ compiler and CMake
(http://cmake.org). Building the graphical user interface requires FLTK 1.3.2 or
higher (FLTK-dev 1.4 is required on macOS Mojave; http://fltk.org), configured
with OpenGL support. Support for boolean operations, constructive solid geometry
features and STEP file import requires OpenCASCADE 6.9 or higher (version 7.2 or
higher is highly recommended; http://www.opencascade.com).
Build Gmsh from the command line
--------------------------------
* Create a build directory, for example as a subdirectory of Gmsh's source
directory:
mkdir build
* To build the monolithic Gmsh app with the default build options, run cmake
from within the build directory, pointing to Gmsh's source directory, then run
"make"
cd build
cmake ..
make
Optionally running
make install
will install the Gmsh app in the standard system location (controlled by
CMAKE_INSTALL_PREFIX - see below).
* To build the Gmsh app dynamically linked to the shared Gmsh library, which can
then also be used by external codes through the C++, C, Python and Julia Gmsh
API, run
cd build
cmake -DENABLE_BUILD_DYNAMIC=1 ..
make
make install
This will install the Gmsh app and the shared Gmsh library, as well as the C++
and C include files and the Python and Julia modules.
* 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 could 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.
* 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.