Repository navigation
Expand file tree
/
Copy pathINSTALL.html
More file actions
566 lines (543 loc) · 48.6 KB
/
Copy pathINSTALL.html
File metadata and controls
566 lines (543 loc) · 48.6 KB
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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
<!DOCTYPE html>
<html class="writer-html5" lang="en" data-content_root="./">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Installation — VOTCA 2026-dev documentation</title>
<link rel="stylesheet" type="text/css" href="_static/pygments.css?v=b86133f3" />
<link rel="stylesheet" type="text/css" href="_static/css/theme.css?v=9edc463e" />
<link rel="stylesheet" type="text/css" href="_static/css/custom.css?v=73cce014" />
<script src="_static/documentation_options.js?v=4019ed8d"></script>
<script src="_static/doctools.js?v=9bcbadda"></script>
<script src="_static/sphinx_highlight.js?v=dc90522c"></script>
<script crossorigin="anonymous" integrity="sha256-Ae2Vz/4ePdIu6ZyI/5ZGsYnb+m0JlOmKPjt6XZ9JJkA=" src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.4/require.min.js"></script>
<script src="_static/js/theme.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="CSG Manual" href="csg/index.html" />
<link rel="prev" title="Welcome to VOTCA’s documentation!" href="index.html" />
</head>
<body class="wy-body-for-nav">
<div class="wy-grid-for-nav">
<nav data-toggle="wy-nav-shift" class="wy-nav-side">
<div class="wy-side-scroll">
<div class="wy-side-nav-search" >
<a href="index.html">
<img src="_static/customLogo.png" class="logo" alt="Logo"/>
</a>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
<input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
</div>
</div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
<ul class="current">
<li class="toctree-l1 current"><a class="current reference internal" href="#">Installation</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#general-source-installation-instructions">General (Source) Installation Instructions</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#requirements">Requirements</a></li>
<li class="toctree-l3"><a class="reference internal" href="#dependency-installation">Dependency Installation</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#libint">libint</a></li>
<li class="toctree-l4"><a class="reference internal" href="#macos-homebrew">macOS (Homebrew)</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#testing-your-build">Testing your build</a></li>
<li class="toctree-l3"><a class="reference internal" href="#resolving-the-not-found-dependency-errors">Resolving the ‘not found’ dependency errors</a></li>
<li class="toctree-l3"><a class="reference internal" href="#common-cmake-flags">Common CMake Flags</a></li>
<li class="toctree-l3"><a class="reference internal" href="#other-cmake-flags">Other CMake Flags</a></li>
<li class="toctree-l3"><a class="reference internal" href="#performance-advice">Performance advice</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#intel-processors">Intel Processors</a></li>
<li class="toctree-l4"><a class="reference internal" href="#amd-processors">AMD Processors</a></li>
<li class="toctree-l4"><a class="reference internal" href="#apple-silicon">Apple Silicon</a></li>
</ul>
</li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#packages-for-various-linux-distributions">Packages for various Linux Distributions</a><ul>
<li class="toctree-l3"><a class="reference internal" href="#id1">Fedora</a></li>
<li class="toctree-l3"><a class="reference internal" href="#opensuse">openSUSE</a></li>
<li class="toctree-l3"><a class="reference internal" href="#debian-ubuntu">Debian / Ubuntu</a></li>
<li class="toctree-l3"><a class="reference internal" href="#gentoo">Gentoo</a></li>
<li class="toctree-l3"><a class="reference internal" href="#spack">Spack</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#development-version">Development version</a></li>
<li class="toctree-l4"><a class="reference internal" href="#other-build-options">Other build options</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#conda-forge">Conda-forge</a></li>
<li class="toctree-l3"><a class="reference internal" href="#docker">Docker</a><ul>
<li class="toctree-l4"><a class="reference internal" href="#release-version">Release version</a></li>
</ul>
</li>
<li class="toctree-l3"><a class="reference internal" href="#freebsd">FreeBSD</a></li>
</ul>
</li>
<li class="toctree-l2"><a class="reference internal" href="#linking-error-undefined-reference-to">Linking Error: Undefined reference to</a></li>
<li class="toctree-l2"><a class="reference internal" href="#mkl-and-openmp-thread-pinning">MKL and OpenMP thread pinning</a></li>
<li class="toctree-l2"><a class="reference internal" href="#gcc-and-mkl-undefined-symbol">GCC and MKL : undefined symbol:</a></li>
</ul>
</li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Manuals</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="csg/index.html">CSG Manual</a></li>
<li class="toctree-l1"><a class="reference internal" href="xtp/XTP-MANUAL.html">XTP Manual</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Tutorials</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="xtp-tutorials/XTP-TUTORIAL.html">XTP Tutorials</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Development</span></p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="DEVELOPERS_GUIDE.html">Developer and Contributor Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="VOTCA_LANGUAGE_GUIDE.html">VOTCA Internal Contributor Language Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="Architecture.html">The architecture of VOTCA</a></li>
<li class="toctree-l1"><a class="reference internal" href="xtp/Architecture.html">Architecture of votca-xtp</a></li>
<li class="toctree-l1"><a class="reference internal" href="CODE_OF_CONDUCT.html">Code of Conduct</a></li>
<li class="toctree-l1"><a class="reference internal" href="websiteAndDocumentation.html">Website and Documentation</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Community</span></p>
<ul>
<li class="toctree-l1"><a class="reference external" href="https://github.com/votca">GitHub</a></li>
<li class="toctree-l1"><a class="reference external" href="https://twitter.com/votca_software">Twitter</a></li>
<li class="toctree-l1"><a class="reference external" href="https://groups.google.com/g/votca">Forum</a></li>
</ul>
</div>
</div>
</nav>
<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
<a href="index.html">VOTCA</a>
</nav>
<div class="wy-nav-content">
<div class="rst-content">
<div role="navigation" aria-label="Page navigation">
<ul class="wy-breadcrumbs">
<li><a href="index.html" class="icon icon-home" aria-label="Home"></a></li>
<li class="breadcrumb-item active">Installation</li>
<li class="wy-breadcrumbs-aside">
<a href="_sources/INSTALL.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
<hr/>
</div>
<div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
<div itemprop="articleBody">
<section id="installation">
<span id="install"></span><h1>Installation<a class="headerlink" href="#installation" title="Link to this heading">¶</a></h1>
<section id="general-source-installation-instructions">
<h2>General (Source) Installation Instructions<a class="headerlink" href="#general-source-installation-instructions" title="Link to this heading">¶</a></h2>
<p>To install the full package:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>prefix=WHERE/TO/INSTALL/VOTCA
version=master # or 'v2026'
git clone -b ${version} https://github.com/votca/votca.git
cmake -B builddir -S votca -DBUILD_XTP=ON -DCMAKE_INSTALL_PREFIX=${prefix}
cmake --build builddir --parallel <number of cores>
ctest --test-dir builddir
cmake --build builddir --target install
</pre></div>
</div>
<section id="requirements">
<h3>Requirements<a class="headerlink" href="#requirements" title="Link to this heading">¶</a></h3>
<ul class="simple">
<li><p>CMake 3.16 or newer (<code class="docutils literal notranslate"><span class="pre">ctest</span> <span class="pre">--test-dir</span></code> as used above needs CMake 3.20; with
older versions run <code class="docutils literal notranslate"><span class="pre">ctest</span></code> inside the build directory)</p></li>
<li><p>A C++17 compiler (GCC, Clang, Apple Clang or Intel <code class="docutils literal notranslate"><span class="pre">icpx</span></code>) with OpenMP</p></li>
<li><p>Eigen 3.4 or newer, Boost 1.71 or newer, Python 3.5 or newer</p></li>
<li><p>GROMACS 2021 or newer (optional; needed for reading GROMACS files)</p></li>
<li><p>HDF5 (optional for CSG, where it enables h5md trajectories; required for XTP)</p></li>
<li><p>For XTP (<code class="docutils literal notranslate"><span class="pre">-DBUILD_XTP=ON</span></code>) additionally: libint 2.6 or newer, libecpint,
libxc, HDF5 with C++ bindings and Open Babel 3. Analytic DFT forces need a
libint with derivative integrals; see <a class="reference internal" href="#libint">libint</a> below.</p></li>
</ul>
</section>
<section id="dependency-installation">
<h3>Dependency Installation<a class="headerlink" href="#dependency-installation" title="Link to this heading">¶</a></h3>
<p><a class="reference external" href="https://github.com/votca/buildenv/blob/master/ubuntu#L10-L13">Ubuntu</a></p>
<p><a class="reference external" href="https://github.com/votca/buildenv/blob/master/fedora#L10-L15">Fedora</a></p>
<p>If your distribution has no libecpint package, build it from <a class="reference external" href="https://github.com/robashaw/libecpint">source</a>.</p>
<section id="libint">
<h4>libint<a class="headerlink" href="#libint" title="Link to this heading">¶</a></h4>
<p>XTP’s analytic DFT forces (<code class="docutils literal notranslate"><span class="pre">dftpackage.xtpdft.compute_forces</span></code>, used for
geometry optimizations) need libint with first derivatives of the one-body,
two-centre and three-centre integrals. The libint packages of most
distributions and of Homebrew, and the official libint release tarballs, do
not have them; XTP then builds and runs, but without analytic forces. The
configure step reports which libint it uses and what it supports:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="o">--</span> <span class="n">libint2</span> <span class="n">derivative</span> <span class="n">integrals</span><span class="p">:</span> <span class="n">ONEBODY</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="n">ERI2</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="n">ERI3</span><span class="o">=</span><span class="mi">1</span> <span class="p">(</span><span class="o">.../</span><span class="n">libint2</span><span class="o">/</span><span class="n">config</span><span class="o">.</span><span class="n">h</span><span class="p">)</span> <span class="o">-></span> <span class="n">analytic</span> <span class="n">DFT</span> <span class="n">forces</span> <span class="n">ON</span>
</pre></div>
</div>
<p>With <code class="docutils literal notranslate"><span class="pre">-DBUILD_OWN_LIBINT=ON</span></code>, VOTCA uses a libint with these derivatives
instead (libint 2.13.1, generated for VOTCA and hosted at
<a class="reference external" href="https://github.com/votca/libint-export/releases">votca/libint-export</a>). It
is built once per machine and compiler into a cache outside the build
directory (<code class="docutils literal notranslate"><span class="pre">~/.cache/votca</span></code>, on macOS <code class="docutils literal notranslate"><span class="pre">~/Library/Caches/votca</span></code>), which
other build directories and branches reuse:</p>
<ul class="simple">
<li><p>configure downloads the libint export (about 130 MB, checksum-verified)
and unpacks it into the cache;</p></li>
<li><p>the first <code class="docutils literal notranslate"><span class="pre">cmake</span> <span class="pre">--build</span></code> compiles libint before the rest of VOTCA
(once; about 15–30 min on a few cores) and installs it into the cache;</p></li>
<li><p>later configures use the installed libint and add no build step.</p></li>
</ul>
<p>With <code class="docutils literal notranslate"><span class="pre">BUILD_OWN_LIBINT</span></code> the derivatives are always required: the configure
step fails if the export lacks them (only possible with a different
<code class="docutils literal notranslate"><span class="pre">VOTCA_LIBINT_EXPORT_URL</span></code>). Delete the cache directory to rebuild libint.</p>
<p>Without <code class="docutils literal notranslate"><span class="pre">BUILD_OWN_LIBINT</span></code>, the libint found on the system is used whether
or not it has derivatives, and XTP is built without analytic forces if it
does not. <code class="docutils literal notranslate"><span class="pre">-DREQUIRE_LIBINT_FORCES=ON</span></code> makes that a configure error
instead, e.g. for builds that must support geometry optimizations
(<code class="docutils literal notranslate"><span class="pre">-DCMAKE_PREFIX_PATH</span></code> pointing to a libint with derivatives, or CI).</p>
<p>If another libint is installed where the compiler finds it first (for
example Homebrew’s libint in <code class="docutils literal notranslate"><span class="pre">/opt/homebrew/include</span></code>), compilation stops
with an error naming the conflict; uninstall it, or <code class="docutils literal notranslate"><span class="pre">brew</span> <span class="pre">unlink</span> <span class="pre">libint</span></code>.</p>
</section>
<section id="macos-homebrew">
<h4>macOS (Homebrew)<a class="headerlink" href="#macos-homebrew" title="Link to this heading">¶</a></h4>
<p>On macOS (Apple silicon, macOS 13.3 or newer) use Apple’s <code class="docutils literal notranslate"><span class="pre">clang</span></code> from the
Xcode command line tools and the dependencies from <a class="reference external" href="https://brew.sh">Homebrew</a>:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>xcode-select --install
brew install cmake eigen boost libecpint libxc hdf5 fftw libomp gromacs open-babel pybind11
cmake -B builddir -S votca -DBUILD_XTP=ON -DCMAKE_INSTALL_PREFIX=${prefix} \
-DBUILD_OWN_LIBINT=ON
cmake --build builddir --parallel $(sysctl -n hw.ncpu)
</pre></div>
</div>
<p>Notes:</p>
<ul class="simple">
<li><p>Homebrew’s <code class="docutils literal notranslate"><span class="pre">libint</span></code> has no derivative integrals and is not needed with
<code class="docutils literal notranslate"><span class="pre">-DBUILD_OWN_LIBINT=ON</span></code>; if it is installed, <code class="docutils literal notranslate"><span class="pre">brew</span> <span class="pre">unlink</span> <span class="pre">libint</span></code>
keeps its headers out of the way (see <a class="reference internal" href="#libint">libint</a>).</p></li>
<li><p>Linear algebra uses Apple’s Accelerate framework, which <code class="docutils literal notranslate"><span class="pre">CMake</span></code> finds
by itself (<code class="docutils literal notranslate"><span class="pre">--</span> <span class="pre">Found</span> <span class="pre">APPLE_ACCELERATE</span></code>). Do <strong>not</strong> install Homebrew’s
<code class="docutils literal notranslate"><span class="pre">lapack</span></code> or <code class="docutils literal notranslate"><span class="pre">lapacke</span></code> for VOTCA: they are not needed.</p></li>
<li><p>Apple’s <code class="docutils literal notranslate"><span class="pre">clang</span></code> has no OpenMP runtime of its own. <code class="docutils literal notranslate"><span class="pre">CMake</span></code> takes
Homebrew’s <code class="docutils literal notranslate"><span class="pre">libomp</span></code> automatically (<code class="docutils literal notranslate"><span class="pre">--</span> <span class="pre">Using</span> <span class="pre">Homebrew</span> <span class="pre">libomp:</span> <span class="pre">...</span></code>),
so <code class="docutils literal notranslate"><span class="pre">OpenMP_ROOT</span></code> does not need to be set. To use another OpenMP
runtime, set <code class="docutils literal notranslate"><span class="pre">OpenMP_ROOT</span></code> (as a CMake or environment variable) to its
prefix. Without any OpenMP runtime VOTCA builds, but runs single-threaded.</p></li>
<li><p>Python packages used by some tests and tools (<code class="docutils literal notranslate"><span class="pre">lxml</span> <span class="pre">h5py</span> <span class="pre">rdkit</span> <span class="pre">scipy</span>
<span class="pre">pytest</span> <span class="pre">ase</span> <span class="pre">xmltodict</span></code>) are best installed in a virtual environment made
with Homebrew’s <code class="docutils literal notranslate"><span class="pre">python3</span></code>.</p></li>
</ul>
<p>See <a class="reference internal" href="#apple-silicon">Apple Silicon</a> below for how to check that Accelerate is used.</p>
</section>
</section>
<section id="testing-your-build">
<h3>Testing your build<a class="headerlink" href="#testing-your-build" title="Link to this heading">¶</a></h3>
<p>To test if your build actually works, you can run the VOTCA testsuite:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">ctest</span> <span class="o">--</span><span class="n">test</span><span class="o">-</span><span class="nb">dir</span> <span class="o"><</span><span class="n">path</span><span class="o">-</span><span class="n">to</span><span class="o">-</span><span class="n">build</span><span class="o">></span>
</pre></div>
</div>
</section>
<section id="resolving-the-not-found-dependency-errors">
<h3>Resolving the ‘not found’ dependency errors<a class="headerlink" href="#resolving-the-not-found-dependency-errors" title="Link to this heading">¶</a></h3>
<p>Assuming all the <a class="reference internal" href="#dependency-installation"><span class="std std-ref">dependencies</span></a> have been
correctly installed, one or more might still appear with the ‘not found’ status upon
configuring with the <code class="docutils literal notranslate"><span class="pre">cmake</span></code> command (see above). In this case, you will
need to find the ‘non-standard’ location for each missing dependency
(most often a shared or dynamically loaded library, e.g.
<code class="docutils literal notranslate"><span class="pre">libgromacs.so.*</span></code>, <code class="docutils literal notranslate"><span class="pre">libhdf5.so.*</span></code> etc).</p>
<p>Error messages produced by CMake usually provide instructive suggestions
for resolving dependency issues. In particular, an appropriate extra
<code class="docutils literal notranslate"><span class="pre">-D</span></code> flag is necessary to specify the path to a missed package. You
will have to rerun the <code class="docutils literal notranslate"><span class="pre">cmake</span></code> command with the relevant flag(s)
added. For example, in the case of a locally installed version of
GROMACS:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>cmake -B builddir -S votca -DCMAKE_INSTALL_PREFIX=${prefix} -DCMAKE_PREFIX_PATH=$HOME/gromacs
</pre></div>
</div>
<p>Please also ensure GROMACS was build with <code class="docutils literal notranslate"><span class="pre">-DGMX_INSTALL_LEGACY_API=ON</span></code>.</p>
<p>Be careful to use exactly the option suggested in the error message! You
can also add <code class="docutils literal notranslate"><span class="pre">-LH</span></code> or <code class="docutils literal notranslate"><span class="pre">-LAH</span></code> options to the <code class="docutils literal notranslate"><span class="pre">cmake</span></code> command in
order to see the available options with brief explanations (note that
<em>changing some of the variables may result in more variables being
created</em>; run <code class="docutils literal notranslate"><span class="pre">man</span> <span class="pre">cmake</span></code> for more info).</p>
<p><em>Only for Linux</em>: For each dependency package not found by CMake
initially, it might be necessary to add the location of its <code class="docutils literal notranslate"><span class="pre">lib</span></code>
directory to the environment variable <code class="docutils literal notranslate"><span class="pre">LD_LIBRARY_PATH</span></code>, <strong>before</strong>
building and installing VOTCA, i.e. before running any <code class="docutils literal notranslate"><span class="pre">make</span></code> command.
For example:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span>export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$HOME/gromacs/lib:$HOME/anaconda/lib
</pre></div>
</div>
<p>Note that <code class="docutils literal notranslate"><span class="pre">LD_LIBRARY_PATH</span></code> also needs to be set every time when
running an executable from the VOTCA installation afterwards (which can
be automated via the user’s login profile, e.g. in .bashrc). Alternatively,
CMake has options to <em>remember</em> where libraries came from at link time,
which can be enabled by setting <code class="docutils literal notranslate"><span class="pre">CMAKE_INSTALL_RPATH_USE_LINK_PATH</span></code> to
<code class="docutils literal notranslate"><span class="pre">ON</span></code>. VOTCA has enabled this option and a couple of other rpath
related tweaks when setting <code class="docutils literal notranslate"><span class="pre">ENABLE_RPATH_INJECT</span></code> to <code class="docutils literal notranslate"><span class="pre">ON</span></code>.</p>
</section>
<section id="common-cmake-flags">
<h3>Common CMake Flags<a class="headerlink" href="#common-cmake-flags" title="Link to this heading">¶</a></h3>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">INSTALL_CSGAPPS</span></code> - Install the extra csg applications in <code class="docutils literal notranslate"><span class="pre">csg/src/csgapps</span></code>
(ON/OFF, Default OFF)</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">BUILD_XTP</span></code> - Build xtp (ON/OFF, Default OFF)</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">CMAKE_INSTALL_PREFIX</span></code> - where to install VOTCA (Default is /usr/local)</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">BUILD_TESTING</span></code> - compile tests (ON/OFF, Default ON)</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">INJECT_MARCH_NATIVE</span></code> - add <code class="docutils literal notranslate"><span class="pre">-march=native</span></code> to the compiler flags if
supported (ON/OFF, Default ON)</p></li>
</ul>
</section>
<section id="other-cmake-flags">
<h3>Other CMake Flags<a class="headerlink" href="#other-cmake-flags" title="Link to this heading">¶</a></h3>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">CMAKE_DISABLE_FIND_PACKAGE_<name></span></code> - Disable using an optional
package called <code class="docutils literal notranslate"><span class="pre"><name></span></code> (ON/OFF)</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">CMAKE_DISABLE_FIND_PACKAGE_HDF5</span></code> - Disable using <code class="docutils literal notranslate"><span class="pre">HDF5</span></code> in CSG
(h5md support; ON/OFF, Default OFF; not possible with <code class="docutils literal notranslate"><span class="pre">BUILD_XTP=ON</span></code>)</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">BUILD_OWN_LIBINT</span></code> - use a libint with derivative integrals, built once
per machine into a cache (ON/OFF, Default OFF; see <a class="reference internal" href="#libint">libint</a>)</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">REQUIRE_LIBINT_FORCES</span></code> - fail if the system libint has no derivative
integrals for analytic DFT forces (ON/OFF, Default OFF; always on with
<code class="docutils literal notranslate"><span class="pre">BUILD_OWN_LIBINT</span></code>)</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">VOTCA_LIBINT_CACHE_DIR</span></code> - cache directory of <code class="docutils literal notranslate"><span class="pre">BUILD_OWN_LIBINT</span></code>
(also read from the environment; Default <code class="docutils literal notranslate"><span class="pre">~/.cache/votca</span></code>, on macOS
<code class="docutils literal notranslate"><span class="pre">~/Library/Caches/votca</span></code>)</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">VOTCA_LIBINT_BUILD_JOBS</span></code> - parallel jobs of the one-time libint build
(Default: all cores)</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">VOTCA_LIBINT_EXPORT_URL</span></code>, <code class="docutils literal notranslate"><span class="pre">VOTCA_LIBINT_EXPORT_SHA256</span></code> - another libint
export (URL or local file) for <code class="docutils literal notranslate"><span class="pre">BUILD_OWN_LIBINT</span></code>; generate one with
<code class="docutils literal notranslate"><span class="pre">CMakeModules/make_libint_export.sh</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">REQUIRE_MKL</span></code> - fail if Intel’s MKL is not found (ON/OFF, Default OFF)</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">MKL_THREADING</span></code> - MKL threading layer (<code class="docutils literal notranslate"><span class="pre">sequential</span></code>, <code class="docutils literal notranslate"><span class="pre">intel_thread</span></code>,
<code class="docutils literal notranslate"><span class="pre">gnu_thread</span></code> or <code class="docutils literal notranslate"><span class="pre">tbb_thread</span></code>; Default <code class="docutils literal notranslate"><span class="pre">gnu_thread</span></code> with <code class="docutils literal notranslate"><span class="pre">g++</span></code>)</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">ENABLE_RPATH_INJECT</span></code> - inject the link and install library directories
into the executables (ON/OFF, Default OFF)</p></li>
</ul>
</section>
<section id="performance-advice">
<h3>Performance advice<a class="headerlink" href="#performance-advice" title="Link to this heading">¶</a></h3>
<p>VOTCA-XTP relies on the Eigen library for vector-matrix operations, and a lot of
performance can be gained by enabling vectorization and/or use of Intel’s <code class="docutils literal notranslate"><span class="pre">MKL</span></code>
as backend, which is automatically detected by <code class="docutils literal notranslate"><span class="pre">CMake</span></code>. Below are some recommendations
for different architectures:</p>
<section id="intel-processors">
<h4>Intel Processors<a class="headerlink" href="#intel-processors" title="Link to this heading">¶</a></h4>
<p><code class="docutils literal notranslate"><span class="pre">g++</span></code>, <code class="docutils literal notranslate"><span class="pre">clang</span></code>, and <code class="docutils literal notranslate"><span class="pre">icpx</span></code> from the Intel OneAPI basekit give similar performance
when used with the MKL. No special flags have to be supplied to <code class="docutils literal notranslate"><span class="pre">CMake</span></code>.</p>
<p>If <code class="docutils literal notranslate"><span class="pre">g++</span></code> or <code class="docutils literal notranslate"><span class="pre">clang</span></code> are used, the compiler option <code class="docutils literal notranslate"><span class="pre">-march=native</span></code> is automatically injected
into the build. If you compile VOTCA on a heterogeneous cluster with different instruction sets,
this may cause the executables to not run. Switch it off with <code class="docutils literal notranslate"><span class="pre">-DINJECT_MARCH_NATIVE=OFF</span></code>
(optionally adding <code class="docutils literal notranslate"><span class="pre">-DCMAKE_CXX_FLAGS=-mtune=native</span></code>, at probably lower performance), or perform
node-type specific builds.</p>
<p>As a rough estimate, runtimes with vectorization and <code class="docutils literal notranslate"><span class="pre">gcc/clang</span></code> are 30% shorter than without
vectorization. Use of <code class="docutils literal notranslate"><span class="pre">MKL</span></code> reduces them by another 50%.</p>
</section>
<section id="amd-processors">
<h4>AMD Processors<a class="headerlink" href="#amd-processors" title="Link to this heading">¶</a></h4>
<p>We recommend using <code class="docutils literal notranslate"><span class="pre">g++</span></code> or <code class="docutils literal notranslate"><span class="pre">clang</span></code> rather than an Intel compiler on AMD. Vectorization
in <code class="docutils literal notranslate"><span class="pre">Eigen</span></code> is automatically enabled by injection of <code class="docutils literal notranslate"><span class="pre">-march=native</span></code>. See above comment
about heterogeneous environments.</p>
<p>Intel’s MKL also works on AMD processors and is found by <code class="docutils literal notranslate"><span class="pre">CMake</span></code> in the same way. Every DFT
and GW-BSE log names the backend; a build with MKL prints</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">Using</span> <span class="n">MKL</span> <span class="n">overload</span> <span class="k">for</span> <span class="n">Eigen</span> <span class="p">(</span><span class="n">BLAS</span> <span class="ow">and</span> <span class="n">LAPACK</span><span class="p">)</span>
</pre></div>
</div>
<p>The largest gain is in the symmetric eigensolvers and the multithreaded rank-k updates, which
Eigen’s own implementation runs on a single core. On an 8-core AMD EPYC 7262 (Zen 2) with
oneMKL 2026.2, MKL’s <code class="docutils literal notranslate"><span class="pre">dsyevd</span></code> diagonalized a 3000 x 3000 matrix in 1.1 s, against 25 s for
Eigen’s own solver.</p>
<p>At runtime, MKL checks whether it runs on an Intel processor and otherwise takes slower code
paths. This check can be overridden by preloading a small library. Save as <code class="docutils literal notranslate"><span class="pre">mkl_cpu_trick.c</span></code></p>
<div class="highlight-c notranslate"><div class="highlight"><pre><span></span><span class="kt">int</span><span class="w"> </span><span class="nf">mkl_serv_intel_cpu_true</span><span class="p">(</span><span class="kt">void</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span><span class="w"> </span><span class="p">}</span>
<span class="cm">/* MKL 2025.0 and later call this function instead */</span>
<span class="k">typedef</span><span class="w"> </span><span class="kt">int</span><span class="w"> </span><span class="p">(</span><span class="o">*</span><span class="n">fakeintel_fptr</span><span class="p">)(</span><span class="kt">void</span><span class="p">);</span>
<span class="n">fakeintel_fptr</span><span class="w"> </span><span class="nf">mkl_serv_get_cpu_true</span><span class="p">(</span><span class="kt">void</span><span class="p">)</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="k">return</span><span class="w"> </span><span class="o">&</span><span class="n">mkl_serv_intel_cpu_true</span><span class="p">;</span><span class="w"> </span><span class="p">}</span>
</pre></div>
</div>
<p>then compile it and preload it when running VOTCA:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">gcc</span> <span class="o">-</span><span class="n">O2</span> <span class="o">-</span><span class="n">shared</span> <span class="o">-</span><span class="n">fPIC</span> <span class="o">-</span><span class="n">o</span> <span class="n">libmkl_cpu_trick</span><span class="o">.</span><span class="n">so</span> <span class="n">mkl_cpu_trick</span><span class="o">.</span><span class="n">c</span>
<span class="n">LD_PRELOAD</span><span class="o">=/</span><span class="n">path</span><span class="o">/</span><span class="n">to</span><span class="o">/</span><span class="n">libmkl_cpu_trick</span><span class="o">.</span><span class="n">so</span> <span class="n">xtp_tools</span> <span class="o">...</span>
</pre></div>
</div>
<p>On the system above, this made MKL’s matrix products 18-48% faster and its eigensolvers
1.5 times faster. A naphthalene def2-TZVP evGW-BSE calculation took 5% less time
(DFT 11%, BSE 20%, GW 2%) with unchanged results. Older recipes that define only
<code class="docutils literal notranslate"><span class="pre">mkl_serv_intel_cpu_true</span></code>, or that set <code class="docutils literal notranslate"><span class="pre">MKL_DEBUG_CPU_TYPE=5</span></code>, have no effect with current
MKL versions. The override relies on MKL internals that Intel does not document or support,
so it may stop working with a future release; check the MKL license terms before using it.
Background: <a class="reference external" href="https://danieldk.eu/software/misc/intel-mkl-on-amd-zen">Intel MKL on AMD Zen</a>
and <a class="reference external" href="https://documentation.sigma2.no/jobs/mkl.html#using-mkl-efficiently">Using MKL efficiently</a>.
We have only measured Zen 2, so we advise that you test this on your specific architecture.</p>
<p>AMD’s own AOCL libraries are currently not supported as a backend by VOTCA. In the same
benchmark, they matched the patched MKL for matrix products but were 4-11 times slower in the
eigensolvers.</p>
</section>
<section id="apple-silicon">
<h4>Apple Silicon<a class="headerlink" href="#apple-silicon" title="Link to this heading">¶</a></h4>
<p>On macOS, Eigen’s matrix products go to Apple’s Accelerate framework, and the
symmetric eigensolvers and Cholesky factorizations call Accelerate’s LAPACK
directly. Accelerate reaches the CPU’s matrix unit, which Eigen’s own kernels
(NEON, two doubles wide) cannot use. No flags are needed; <code class="docutils literal notranslate"><span class="pre">-march=native</span></code>
(or <code class="docutils literal notranslate"><span class="pre">-mcpu=native</span></code> if the compiler rejects it) is injected as on Linux.</p>
<p>Every DFT and GW-BSE log names the backend. A correct build prints</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">Using</span> <span class="n">Apple</span> <span class="n">Accelerate</span> <span class="n">BLAS</span> <span class="n">overload</span> <span class="k">for</span> <span class="n">Eigen</span><span class="p">,</span> <span class="n">Accelerate</span> <span class="n">LAPACK</span> <span class="k">for</span> <span class="n">eigensolvers</span> <span class="ow">and</span> <span class="n">Cholesky</span>
</pre></div>
</div>
<p>If the log says <code class="docutils literal notranslate"><span class="pre">Using</span> <span class="pre">native</span> <span class="pre">Eigen</span> <span class="pre">implementation,</span> <span class="pre">no</span> <span class="pre">BLAS</span> <span class="pre">overload</span></code>,
Accelerate was not found, and large GW-BSE runs are several times slower:
delete the build directory and configure again.</p>
<p>Use all cores (the default, or <code class="docutils literal notranslate"><span class="pre">-t</span></code> equal to <code class="docutils literal notranslate"><span class="pre">sysctl</span> <span class="pre">-n</span> <span class="pre">hw.ncpu</span></code>).
Limiting <code class="docutils literal notranslate"><span class="pre">xtp</span></code> to the performance cores did not make it faster on M1 and
M1 Pro machines: the efficiency cores still add to the threaded loops, and
Accelerate’s speed does not depend on the thread count. Do not set
<code class="docutils literal notranslate"><span class="pre">VECLIB_MAXIMUM_THREADS</span></code>.</p>
<p>Apple GPUs cannot be used: they have no double-precision arithmetic.</p>
</section>
</section>
</section>
<section id="packages-for-various-linux-distributions">
<h2>Packages for various Linux Distributions<a class="headerlink" href="#packages-for-various-linux-distributions" title="Link to this heading">¶</a></h2>
<section id="id1">
<h3>Fedora<a class="headerlink" href="#id1" title="Link to this heading">¶</a></h3>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">dnf</span> <span class="n">install</span> <span class="n">votca</span>
</pre></div>
</div>
<p>Or in older versions of Fedora:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">dnf</span> <span class="n">install</span> <span class="n">votca</span><span class="o">-</span><span class="n">csg</span> <span class="n">votca</span><span class="o">-</span><span class="n">xtp</span>
</pre></div>
</div>
</section>
<section id="opensuse">
<h3>openSUSE<a class="headerlink" href="#opensuse" title="Link to this heading">¶</a></h3>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">zypper</span> <span class="n">install</span> <span class="n">votca</span>
</pre></div>
</div>
<p>Or in older versions of openSUSE:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">zypper</span> <span class="n">install</span> <span class="n">votca</span><span class="o">-</span><span class="n">csg</span> <span class="n">votca</span><span class="o">-</span><span class="n">xtp</span>
</pre></div>
</div>
</section>
<section id="debian-ubuntu">
<h3>Debian / Ubuntu<a class="headerlink" href="#debian-ubuntu" title="Link to this heading">¶</a></h3>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">apt</span><span class="o">-</span><span class="n">get</span> <span class="n">install</span> <span class="n">votca</span>
</pre></div>
</div>
</section>
<section id="gentoo">
<h3>Gentoo<a class="headerlink" href="#gentoo" title="Link to this heading">¶</a></h3>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">emerge</span> <span class="n">votca</span>
</pre></div>
</div>
</section>
<section id="spack">
<h3>Spack<a class="headerlink" href="#spack" title="Link to this heading">¶</a></h3>
<p><a class="reference external" href="https://spack.io/">Spack</a> is a package manager, which has
the capability of building VOTCA and all its dependencies:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">git</span> <span class="n">clone</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">github</span><span class="o">.</span><span class="n">com</span><span class="o">/</span><span class="n">spack</span><span class="o">/</span><span class="n">spack</span><span class="o">.</span><span class="n">git</span> <span class="n">spack</span>
<span class="n">source</span> <span class="n">spack</span><span class="o">/</span><span class="n">share</span><span class="o">/</span><span class="n">spack</span><span class="o">/</span><span class="n">setup</span><span class="o">-</span><span class="n">env</span><span class="o">.</span><span class="n">sh</span>
<span class="n">spack</span> <span class="n">install</span> <span class="n">votca</span>
</pre></div>
</div>
<section id="development-version">
<h4>Development version<a class="headerlink" href="#development-version" title="Link to this heading">¶</a></h4>
<p>Spack can also install the latest development version from git using:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">spack</span> <span class="n">install</span> <span class="n">votca</span><span class="nd">@master</span>
</pre></div>
</div>
</section>
<section id="other-build-options">
<h4>Other build options<a class="headerlink" href="#other-build-options" title="Link to this heading">¶</a></h4>
<p>Spack has other options:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">spack</span> <span class="n">info</span> <span class="n">votca</span>
</pre></div>
</div>
<p>One useful option is to build votca without xtp:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">spack</span> <span class="n">install</span> <span class="n">votca</span><span class="o">~</span><span class="n">xtp</span>
</pre></div>
</div>
</section>
</section>
<section id="conda-forge">
<h3>Conda-forge<a class="headerlink" href="#conda-forge" title="Link to this heading">¶</a></h3>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">conda</span> <span class="n">install</span> <span class="o">-</span><span class="n">c</span> <span class="n">conda</span><span class="o">-</span><span class="n">forge</span> <span class="n">votca</span>
</pre></div>
</div>
</section>
<section id="docker">
<h3>Docker<a class="headerlink" href="#docker" title="Link to this heading">¶</a></h3>
<p>VOTCA is also available through docker and can be accessed and run with
the following docker commands:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">docker</span> <span class="n">pull</span> <span class="n">votca</span><span class="o">/</span><span class="n">votca</span>
<span class="n">docker</span> <span class="n">run</span> <span class="o">-</span><span class="n">it</span> <span class="n">votca</span><span class="o">/</span><span class="n">votca</span> <span class="o">/</span><span class="nb">bin</span><span class="o">/</span><span class="n">bash</span>
</pre></div>
</div>
<section id="release-version">
<h4>Release version<a class="headerlink" href="#release-version" title="Link to this heading">¶</a></h4>
<p>Docker can also install the latest released version, e.g.:</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">docker</span> <span class="n">run</span> <span class="o">-</span><span class="n">it</span> <span class="n">votca</span><span class="o">/</span><span class="n">votca</span><span class="p">:</span><span class="n">v2026</span> <span class="o">/</span><span class="nb">bin</span><span class="o">/</span><span class="n">bash</span>
</pre></div>
</div>
</section>
</section>
<section id="freebsd">
<h3>FreeBSD<a class="headerlink" href="#freebsd" title="Link to this heading">¶</a></h3>
<p>On FreeBSD VOTCA can be installed from a binary package (recommended):</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">pkg</span> <span class="n">install</span> <span class="n">votca</span>
</pre></div>
</div>
<p>or it can be rebuilt and installed from the sources (slow):</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">cd</span> <span class="o">/</span><span class="n">usr</span><span class="o">/</span><span class="n">ports</span><span class="o">/</span><span class="n">science</span><span class="o">/</span><span class="n">votca</span> <span class="o">&&</span> <span class="n">make</span> <span class="n">install</span> <span class="n">clean</span>
</pre></div>
</div>
</section>
</section>
<section id="linking-error-undefined-reference-to">
<h2>Linking Error: Undefined reference to<a class="headerlink" href="#linking-error-undefined-reference-to" title="Link to this heading">¶</a></h2>
<p>This error can occur for a multitude of reasons. You may have
forgotten to add paths to the <code class="docutils literal notranslate"><span class="pre">LD_LIBRARY_PATH</span></code> or forgotten to import
an environment module. In these cases, deleting the <code class="docutils literal notranslate"><span class="pre">CMakeCache.txt</span></code> in
your <code class="docutils literal notranslate"><span class="pre">build</span></code> folder and rerunning <code class="docutils literal notranslate"><span class="pre">cmake</span></code> will help. Unfortunately,
another cause might be ABI incompability between libraries due to
different libraries being compiled with different compilers or compiler
versions. Click <a class="reference external" href="https://github.com/ICRAR/shark/issues/1">here</a> for
an example.</p>
</section>
<section id="mkl-and-openmp-thread-pinning">
<h2>MKL and OpenMP thread pinning<a class="headerlink" href="#mkl-and-openmp-thread-pinning" title="Link to this heading">¶</a></h2>
<p>With <code class="docutils literal notranslate"><span class="pre">g++</span></code>, VOTCA links MKL’s GNU threading layer (<code class="docutils literal notranslate"><span class="pre">MKL_THREADING=gnu_thread</span></code>), so only
GCC’s OpenMP runtime <code class="docutils literal notranslate"><span class="pre">libgomp</span></code> is loaded. If MKL’s Intel threading layer is used with <code class="docutils literal notranslate"><span class="pre">g++</span></code>
instead (<code class="docutils literal notranslate"><span class="pre">-DMKL_THREADING=intel_thread</span></code>, or a build directory configured with an older VOTCA
version), Intel’s OpenMP runtime <code class="docutils literal notranslate"><span class="pre">libiomp5</span></code> is loaded next to <code class="docutils literal notranslate"><span class="pre">libgomp</span></code>. This works, but do
not set <code class="docutils literal notranslate"><span class="pre">OMP_PROC_BIND</span></code> or <code class="docutils literal notranslate"><span class="pre">OMP_PLACES</span></code> with such a build: <code class="docutils literal notranslate"><span class="pre">libgomp</span></code> then pins the main
thread to one core, and all of MKL’s threads end up on that core (visible in <code class="docutils literal notranslate"><span class="pre">htop</span></code> as one
core at 100% and the rest idle). <code class="docutils literal notranslate"><span class="pre">ldd</span> <span class="pre">$(which</span> <span class="pre">xtp_tools)</span> <span class="pre">|</span> <span class="pre">grep</span> <span class="pre">iomp5</span></code> shows whether
<code class="docutils literal notranslate"><span class="pre">libiomp5</span></code> is linked; configure a new build directory to switch.</p>
</section>
<section id="gcc-and-mkl-undefined-symbol">
<h2>GCC and MKL : undefined symbol:<a class="headerlink" href="#gcc-and-mkl-undefined-symbol" title="Link to this heading">¶</a></h2>
<p>This can happen with some GCC versions. Adding the
<code class="docutils literal notranslate"><span class="pre">-Wl,--no-as-needed</span></code> to <code class="docutils literal notranslate"><span class="pre">CMAKE_EXE_LINKER_FLAGS:STRING=</span></code> to the
<code class="docutils literal notranslate"><span class="pre">CMakeCache.txt</span></code> in the <code class="docutils literal notranslate"><span class="pre">build</span></code> directory can fix this. For more
information look
<a class="reference external" href="https://software.intel.com/en-us/articles/symbol-lookup-error-when-linking-intel-mkl-with-gcc-on-ubuntu">here</a></p>
</section>
</section>
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="index.html" class="btn btn-neutral float-left" title="Welcome to VOTCA’s documentation!" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="csg/index.html" class="btn btn-neutral float-right" title="CSG Manual" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
<div role="contentinfo">
<p>© Copyright 2009-2026, VOTCA Development Team.</p>
</div>
Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
<a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
</div>
</div>
</section>
</div>
<script>
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
</script>
</body>
</html>