forked from thelfer/tfel
-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL-cmake
136 lines (105 loc) · 9.33 KB
/
INSTALL-cmake
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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
Basic Installation
==================
These are generic installation instructions.
cmake attempts to guess correct values for various system-dependent
variables used during compilation. It uses those values to create
a `Makefile' in each directory of the package. It may also create one
or more `.h' files containing system-dependent definitions..
The simplest way to compile this package is:
1. `cd' to the directory containing the package's source code and type
`cmake' to configure the package for your system.
Running `cmake' takes awhile. While running, it prints some
messages telling which features it is checking for.
2. Type `make' to compile the package.
3. Optionally, type `make check' to run any self-tests that come with
the package.
4. Type `make install' to install the programs and any data files and
documentation.
5. You can remove the program binaries and object files from the
source code directory by typing `make clean'.
Options
=======
enable-static : compiles static libraries
enable-fortran : enables fortran support
enable-python : enables python support
enable-java : enables java support
enable-aster : enables aster support
enable-abaqus : enables abaqus support
enable-ansys : enables ansys support
enable-europlexus : enables europlexus support
enable-zmat : enables zmat support
enable-cyrano : enables cyrano support (cyrano is eDF fuel performance code)
enable-calculix : enables CalculiX support
enable-comsol : enables Combsol support
enable-diana-fea : enables Diana FEA support
enable-lsdyna : enables LS-DYNA support
enable-libcxx : enable libc++ on Linux and clang
enable-cxx-17 : enable c++-17 features (requires `gcc` >= 7.2)
enable-random-tests: enable tests based on a random choice of
enable-developer-warnings : enable additionnal compiler warnings
enable-advanced-developer-warnings : enable additionnal compiler warnings
enable-sanitize-options : additional compiler flags (gcc specific)
enable-portable-build : do not use processor specific flags. The generated binaries can be
used on other machines as long as the architecture and the compiler
version are the same
enable-doxygen-doc : generate doxygen documentation (disabled by default)
enable-reference-doc : enable the generation of the reference documentation
(requires a valid latex engine)
enable-website : generate the TFEL website
(enabled by default if pandoc is found)
enable-fast-math : use advance options to optimize code further.
Compiler can then ignore IEEE 754 compatibility
enable-broken-boost-python-module-visibility-handling : workaround a bug
in boost python which occurs on FreeBSD+clang.
See https://github.com/boostorg/python/issues/173
for details
enable-glibcxx-debug : use the debug version of the STL implemented by the GLIB
cmake usefull variables
=======================
- `CMAKE_BUILD_TYPE` : two values are supported 'Release' and 'Debug'
- `CASTEM_INSTALL_PATH` : specify where the castem has been installed
- `ZSET_INSTALL_PATH` : specify where the ZSET sofware has been
installed
- `CMAKE_TOOLCHAIN_FILE` : specify a tool chain file
- `TFEL_SVN_REVISION` : tfel-svn revision
- `Python_ADDITIONAL_VERSIONS` : select the `python` version to
use. Note that only the major and minor
version of python shall be passed, not
the revision version or the detection
fails.
- `TFEL_BROKEN_LIBMATH` : set to `true` to disable tests based on
changing the rounding mode. This is not
well supported by old version of the GNU
library for example (such as the one
delivered with debian wheezy).
- `TFEL_DL_LIBRARY` : set the path the `dl` library. This library
can sometimes not be found when using non
default compilers (eg. the PGI compiler).
cmake typical usage
===================
cmake ../trunk -DCMAKE_BUILD_TYPE=Release -Dlocal-castem-header=ON -Denable-fortran=ON -Denable-python=ON -Denable-python-bindings=ON -Denable-java=ON -Denable-aster=ON -Denable-abaqus=ON -Denable-calculix=ON -Denable-comsol=ON -Denable-diana-fea=ON -Denable-ansys=ON -Denable-europlexus=ON -Denable-zmat=ON -DZSET_INSTALL_PATH=/home/th202608/codes/ZeBuLoN/8.5/Z8.5 -Denable-cyrano=ON -Denable-lsdyna=ON -Denable-cadna=ON -DCADNA_INSTALL_PATH=/home/th202608/codes/cadna/3.0/install -Denable-reference-doc=ON -Denable-website=ON -DCMAKE_INSTALL_PREFIX=/home/th202608/codes/tfel/trunk/install
debug and valgrind
==================
cmake ../trunk -DCMAKE_BUILD_TYPE=Debug -DCTEST_MEMORYCHECK_COMMAND=valgrind -DCTEST_MEMORYCHECK_COMMAND_OPTIONS="--trace-children=yes --leak-check=full" -Dlocal-castem-header=ON -Denable-fortran=ON -Denable-python=ON -Denable-python-bindings=ON -Denable-java=ON -Denable-aster=ON -Denable-abaqus=ON -Denable-calculix=ON -Denable-comsol=ON -Denable-diana-fea=ON -Denable-ansys=ON -Denable-europlexus=ON -Denable-zmat=ON -DZSET_INSTALL_PATH=/home/th202608/codes/ZeBuLoN/8.5/Z8.5 -Denable-cyrano=ON -Denable-lsdyna=ON -Denable-cadna=ON -DCADNA_INSTALL_PATH=/home/th202608/codes/cadna/3.0/install -Denable-reference-doc=ON -Denable-website=ON -DCMAKE_INSTALL_PREFIX=/tmp/tfel-debug
profiling (gcc only)
===================
cmake ../trunk -DCMAKE_BUILD_TYPE=Profiling -Dlocal-castem-header=ON -Denable-fortran=ON -Denable-python=ON -Denable-python-bindings=ON -Denable-java=ON -Denable-aster=ON -Denable-abaqus=ON -Denable-calculix=ON -Denable-comsol=ON -Denable-diana-fea=ON -Denable-ansys=ON -Denable-europlexus=ON -Denable-zmat=ON -DZSET_INSTALL_PATH=/home/th202608/codes/ZeBuLoN/8.5/Z8.5 -Denable-cyrano=ON -Denable-lsdyna=ON -Denable-cadna=ON -DCADNA_INSTALL_PATH=/home/th202608/codes/cadna/3.0/install -Denable-reference-doc=ON -Denable-website=ON -DCMAKE_INSTALL_PREFIX=/tmp/tfel-profiling
coverage (gcc only)
===================
cmake ../trunk -DCMAKE_BUILD_TYPE=Coverage -Dlocal-castem-header=ON -Denable-fortran=ON -Denable-python=ON -Denable-python-bindings=ON -Denable-java=ON -Denable-aster=ON -Denable-abaqus=ON -Denable-calculix=ON -Denable-comsol=ON -Denable-diana-fea=ON -Denable-ansys=ON -Denable-europlexus=ON -Denable-zmat=ON -DZSET_INSTALL_PATH=/home/th202608/codes/ZeBuLoN/8.5/Z8.5 -Denable-cyrano=ON -Denable-lsdyna=ON -Denable-cadna=ON -DCADNA_INSTALL_PATH=/home/th202608/codes/cadna/3.0/install -Denable-reference-doc=ON -Denable-website=ON -DCMAKE_INSTALL_PREFIX=/tmp/tfel-coverage
cmake for PLEIADES users
========================
cmake ../trunk -DCMAKE_BUILD_TYPE=Release -DCASTEM_INSTALL_PATH=/home/th202608/codes/castem/2014/install/ -Denable-castem-pleiades=ON -Denable-fortran=ON -Denable-python=ON -Denable-python-bindings=ON -Denable-java=ON -Denable-aster=ON -Denable-abaqus=ON -Denable-calculix=ON -Denable-comsol=ON -Denable-diana-fea=ON -Denable-ansys=ON -Denable-europlexus=ON -Denable-zmat=ON -DZSET_INSTALL_PATH=/home/th202608/codes/ZeBuLoN/8.5/Z8.5 -Denable-cyrano=ON -Denable-lsdyna=ON -Denable-cadna=ON -DCADNA_INSTALL_PATH=/home/th202608/codes/cadna/3.0/install -Denable-reference-doc=ON -Denable-website=ON -DCMAKE_INSTALL_PREFIX=/home/th202608/codes/tfel/trunk/install
cmake for TFEL developers
=========================
cmake ../trunk -DCMAKE_BUILD_TYPE=Release -Denable-developer-warnings=ON -Denable-random-tests=ON -DCASTEM_INSTALL_PATH=/home/th202608/codes/castem/2014/install/ -Denable-castem-pleiades=ON -Denable-fortran=ON -Denable-python=ON -Denable-python-bindings=ON -Denable-java=ON -Denable-aster=ON -Denable-abaqus=ON -Denable-calculix=ON -Denable-comsol=ON -Denable-diana-fea=ON -Denable-ansys=ON -Denable-europlexus=ON -Denable-zmat=ON -DZSET_INSTALL_PATH=/home/th202608/codes/ZeBuLoN/8.5/Z8.5 -Denable-cyrano=ON -Denable-lsdyna=ON -Denable-cadna=ON -DCADNA_INSTALL_PATH=/home/th202608/codes/cadna/3.0/install -Denable-reference-doc=ON -Denable-website=ON -Denable-sanitize-options=ON -Denable-vera++=ON -DVERA_ROOT=/home/th202608/codes/vera++/1.3.0/install/ -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -DCMAKE_INSTALL_PREFIX=/home/th202608/codes/tfel/trunk/install
cmake ../trunk -DCMAKE_BUILD_TYPE=Release -Denable-developer-warnings=ON -Denable-random-tests=ON -DCASTEM_INSTALL_PATH=/home/th202608/codes/castem/2014/install/ -Denable-castem-pleiades=ON -Denable-fortran=ON -Denable-python=ON -Denable-python-bindings=ON -Denable-java=ON -Denable-aster=ON -Denable-abaqus=ON -Denable-calculix=ON -Denable-comsol=ON -Denable-diana-fea=ON -Denable-ansys=ON -Denable-europlexus=ON -Denable-zmat=ON -DZSET_INSTALL_PATH=/home/th202608/codes/ZeBuLoN/8.5/Z8.5 -Denable-cyrano=ON -Denable-lsdyna=ON -Denable-cadna=ON -DCADNA_INSTALL_PATH=/home/th202608/codes/cadna/3.0/install -Denable-reference-doc=ON -Denable-website=ON -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -DCMAKE_INSTALL_PREFIX=/home/th202608/codes/tfel/trunk/install-python-3.5
main targets:
=============
- all : build the libraries
- doc-html : generate the doxygen documentation
- doc-pdf : generate all the documentation in pdf
- website : generate the TFEL website
- doc : generate all the documentation
- check : build tests and execute them
- install : install the libraries