This file is indexed.

/usr/share/doc/psi4/html/conda.html is in psi4-data 1:0.3-5.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">


<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
    <title>Binary Distribution &mdash; Psi4 [] Docs</title>
    
    <link rel="stylesheet" href="_static/psi4.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
    <link rel="stylesheet" href="./" type="text/css" />
    
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    './',
        VERSION:     '',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
      };
    </script>
    <script type="text/javascript" src="_static/jquery.js"></script>
    <script type="text/javascript" src="_static/underscore.js"></script>
    <script type="text/javascript" src="_static/doctools.js"></script>
    <script type="text/javascript" src="_static/jquery.cookie.js"></script>
    <script type="text/javascript" src="_static/toggle_sections.js"></script>
    <script type="text/javascript" src="_static/toggle_sidebar.js"></script>
    <script type="text/javascript" src="_static/toggle_codeprompt.js"></script>
    <link rel="shortcut icon" href="_static/favicon-psi4.ico"/>
    <link rel="top" title="Psi4 [] Docs" href="index.html" />
    <link rel="up" title="Installation and Runtime Configuration" href="external.html" />
    <link rel="next" title="A Psi4 Tutorial" href="tutorial.html" />
    <link rel="prev" title="Installation and Runtime Configuration" href="external.html" /> 
  </head>
  <body role="document">
    <div class="relbar-top">
        
    <div class="related" role="navigation" aria-label="related navigation">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="genindex.html" title="General Index"
             accesskey="I">index</a></li>
        <li class="right" >
          <a href="py-modindex.html" title="Python Module Index"
             >modules</a> &nbsp; &nbsp;</li>
        <li class="right" >
          <a href="contents.html" title="Table Of Contents"
             accesskey="C">toc</a> &nbsp; &nbsp;</li>
        <li class="right" >
          <a href="tutorial.html" title="A Psi4 Tutorial"
             accesskey="N">next</a> &nbsp; &nbsp;</li>
        <li class="right" >
          <a href="external.html" title="Installation and Runtime Configuration"
             accesskey="P">previous</a> &nbsp; &nbsp;</li>
    <li><a href="index.html">Psi4 []</a> &raquo; </li>

          <li class="nav-item nav-item-1"><a href="external.html" accesskey="U">Installation and Runtime Configuration</a> &raquo;</li> 
      </ul>
    </div>
    </div>
  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body" role="main">
            
  <a class="reference internal image-reference" href="_images/psi4banner.png"><img alt="Psi4 Project Logo" src="_images/psi4banner.png" style="width: 100%;" /></a>
<div class="section" id="binary-distribution">
<span id="sec-conda"></span><h1>Binary Distribution<a class="headerlink" href="#binary-distribution" title="Permalink to this headline"></a></h1>
<p><span class="sc">Psi4</span> is available as a pre-compiled binary for Linux architectures
(Mac coming soon) through <a class="reference external" href="https://store.continuum.io/cshop/anaconda/">Continuum Analytics</a>, the company that produces
<a class="reference external" href="http://docs.continuum.io/anaconda/index.html">Anaconda Python</a> (a
full-fledged scientific python environment with package manager <a class="reference external" href="http://conda.pydata.org/index.html">conda</a>) and, more particularly, <a class="reference external" href="http://conda.pydata.org/miniconda.html">Miniconda</a> (a lightweight python
distribution with same package manger <a class="reference external" href="http://conda.pydata.org/index.html">conda</a>). Some nice features for us:</p>
<ul class="simple">
<li>cross-platform (Linux only at present)</li>
<li>no root, administrator, or sudo access required</li>
<li>built with high-performance math libraries</li>
<li>lightweight software stack (&lt;100 MB w/o <span class="sc">Psi4</span>; &lt;500 MB including <span class="sc">Psi4</span>)</li>
<li>updated nightly so new features accessible</li>
<li>standardizes python distribution so no need to find/install libpython packages</li>
<li>add-ons (plugins, extra features requiring Fortran compiler, etc.) can be made available as conda packages</li>
</ul>
<p>The <span class="sc">Psi4</span> binary repository is at <a class="reference external" href="https://anaconda.org/psi4">Anaconda (formerly Binstar)</a>.</p>
<p>For commands to get a default installation, go to <a class="reference internal" href="#sec-quickconda"><span>Quick Installation</span></a>.
For more flexibility and a detailed explanation, go to
<a class="reference internal" href="#sec-slowconda"><span>Detailed Installation of Miniconda</span></a> and <a class="reference internal" href="#sec-slowpsi4"><span>Detailed Installation of Psi4</span></a>.</p>
<div class="section" id="quick-installation">
<span id="sec-quickconda"></span><h2>Quick Installation<a class="headerlink" href="#quick-installation" title="Permalink to this headline"></a></h2>
<p>Sequence of commands to get you to a working <span class="sc">Psi4</span> on Linux. Installs
Miniconda into <code class="docutils literal"><span class="pre">$HOME/miniconda</span></code> and the <span class="sc">Psi4</span> executable into the
main conda environment at <code class="docutils literal"><span class="pre">$HOME/miniconda/bin/psi4</span></code>.</p>
<div class="highlight-bash"><div class="highlight"><pre>&gt;&gt;&gt; bash
&gt;&gt;&gt; curl -O <span class="s2">&quot;http://repo.continuum.io/miniconda/Miniconda-latest-Linux-x86_64.sh&quot;</span>
&gt;&gt;&gt; bash Miniconda-latest-Linux-x86_64.sh -b -p <span class="nv">$HOME</span>/miniconda  <span class="c"># agrees to conda&#39;s license terms</span>
&gt;&gt;&gt; <span class="nb">echo</span> <span class="s2">&quot;export PATH=</span><span class="nv">$HOME</span><span class="s2">/miniconda/bin:\$PATH&quot;</span> &gt;&gt; ~/.bashrc
<span class="c"># log out, log back in so conda in path</span>
&gt;&gt;&gt; conda update --yes --all
&gt;&gt;&gt; conda config --add channels http://conda.anaconda.org/psi4
&gt;&gt;&gt; conda install --yes psi4
&gt;&gt;&gt; psi4 <span class="s2">&quot;</span><span class="k">$(</span>dirname <span class="k">$(</span>which psi4<span class="k">))</span><span class="s2">&quot;</span>/../share/psi/samples/scf1/input.dat -o stdout  <span class="c"># test installation. works b/c PSI_SCRATCH defaults to /tmp</span>
</pre></div>
</div>
<p>That last command tested that <code class="docutils literal"><span class="pre">psi4</span></code> is in your path, and it&#8217;s finding
all the libraries it needs. Now you need only specify a scratch directory
(see <a class="reference internal" href="external.html#sec-psirc"><span>Scratch Files and the ~/.psi4rc File</span></a>) by replacing the placeholder in the following:</p>
<div class="highlight-bash"><div class="highlight"><pre>&gt;&gt;&gt; <span class="nb">echo</span> <span class="s2">&quot;export PSI_SCRATCH=/path/to/existing/writable/local-not-network/directory/for/scratch/files&quot;</span> &gt;&gt; ~/.bashrc
<span class="c"># log out, log back in so variable takes effect</span>
</pre></div>
</div>
<p>All done!</p>
<div class="admonition note">
<p class="first admonition-title">Note</p>
<p class="last">Above commands use bash for installation and set up your environment for bash at runtime. To use csh at runtime, follow the on-screen directions at the end of the installation or consult step 7 below.</p>
</div>
</div>
<div class="section" id="detailed-installation-of-miniconda">
<span id="sec-slowconda"></span><h2>Detailed Installation of Miniconda<a class="headerlink" href="#detailed-installation-of-miniconda" title="Permalink to this headline"></a></h2>
<ol class="arabic simple" start="0">
<li>Sanity check. If you already have Miniconda or Anaconda, skip to step 5. The whole installation takes ~5 min; reading this page takes far longer.</li>
<li>Get <code class="docutils literal"><span class="pre">bzip2</span></code>. You&#8217;ll need this slightly exotic command so run <code class="docutils literal"><span class="pre">which</span></code> to test for availability, and install from <code class="docutils literal"><span class="pre">yum</span></code>, source, <em>etc.</em> if unavailable. You&#8217;ll also need an internet connection for downloading; computers behind a firewall or with restricted login domains are eligible. So long as you can ssh <em>into</em> the computer to an account with write permissions and can connect to the internet <em>from</em> the computer, all is well.</li>
</ol>
<div class="highlight-bash"><div class="highlight"><pre><span class="c"># check</span>
&gt;&gt;&gt; which bzip2
/usr/bin/bzip2
&gt;&gt;&gt; curl -O <span class="s2">&quot;http://psicode.org/psi4manual/master/introduction.html&quot;</span>
&gt;&gt;&gt; ls -1
introduction.html
</pre></div>
</div>
<ol class="arabic simple" start="2">
<li>Get Miniconda installer script. Either issue the command below or download from <a class="reference external" href="http://conda.pydata.org/miniconda.html">http://conda.pydata.org/miniconda.html</a> by clicking on the appropriate link for your OS. If you already have or would prefer to use Anaconda rather than Miniconda, that&#8217;s fine. Locate or install Anaconda, check that <code class="docutils literal"><span class="pre">conda</span></code> is in your path, and skip to step 4.</li>
</ol>
<div class="highlight-bash"><div class="highlight"><pre>&gt;&gt;&gt; curl -O <span class="s2">&quot;http://repo.continuum.io/miniconda/Miniconda-latest-Linux-x86_64.sh&quot;</span>
<span class="c"># check</span>
&gt;&gt;&gt; ls -1
Miniconda-latest-Linux-x86_64.sh
</pre></div>
</div>
<ol class="arabic simple" start="3">
<li>Install Miniconda. Execute the script and answer its questions, particularly your choice of installation location. You may need to replace the filename below with the correct filename for the OS/version of installer you downloaded. Execute with <code class="docutils literal"><span class="pre">bash</span></code> regardless of <code class="docutils literal"><span class="pre">csh</span></code>/<code class="docutils literal"><span class="pre">bash</span></code> shell. If you&#8217;re a <code class="docutils literal"><span class="pre">bash</span></code> user, it&#8217;s convenient to agree to its offer to prepend <code class="docutils literal"><span class="pre">conda</span></code> commands to your <span class="target" id="index-0"></span><a class="reference internal" href="external.html#envvar-PATH"><code class="xref std std-envvar docutils literal"><span class="pre">PATH</span></code></a> in <code class="docutils literal"><span class="pre">~/.bashrc</span></code>. If you&#8217;re a <code class="docutils literal"><span class="pre">csh</span></code>/<code class="docutils literal"><span class="pre">tcsh</span></code> user, it&#8217;s convenient to do the same by hand to your <code class="docutils literal"><span class="pre">~/.tcshrc</span></code>: <code class="docutils literal"><span class="pre">setenv</span> <span class="pre">PATH</span> <span class="pre">/path/to/miniconda/bin:${PATH}</span></code>. Further directions assume that the <code class="docutils literal"><span class="pre">conda</span></code> command is in your path; you may have to log out and log back in for <code class="docutils literal"><span class="pre">which</span> <span class="pre">conda</span></code> to return correctly.</li>
</ol>
<div class="highlight-bash"><div class="highlight"><pre>&gt;&gt;&gt; bash Miniconda-latest-Linux-x86_64.sh
<span class="c"># check</span>
&gt;&gt;&gt; which conda
/path/to/miniconda/bin/conda
</pre></div>
</div>
<ol class="arabic simple" start="4">
<li>Update conda. This updates the package manager itself.</li>
</ol>
<div class="highlight-bash"><div class="highlight"><pre>&gt;&gt;&gt; conda update conda
</pre></div>
</div>
</div>
<div class="section" id="detailed-installation-of-psifour">
<span id="sec-slowpsi4"></span><h2>Detailed Installation of <span class="sc">Psi4</span><a class="headerlink" href="#detailed-installation-of-psifour" title="Permalink to this headline"></a></h2>
<ol class="arabic simple" start="5">
<li>Subscribe to <span class="sc">Psi4</span>. Subscribe to our channel at <a class="reference external" href="http://anaconda.org/psi4">http://anaconda.org/psi4</a> that contains the <span class="sc">Psi4</span> package and several dependency packages. Make sure this shows up in your <code class="docutils literal"><span class="pre">~/.condarc</span></code> file.</li>
</ol>
<div class="highlight-bash"><div class="highlight"><pre>&gt;&gt;&gt; conda config --add channels http://conda.anaconda.org/psi4
<span class="c"># check</span>
&gt;&gt;&gt; cat ~/.condarc
channels:
  - http://conda.anaconda.org/psi4
  - defaults
</pre></div>
</div>
<ol class="arabic simple" start="6">
<li>Install <span class="sc">Psi4</span>. You can install into the main conda environment so that whenever commands <code class="docutils literal"><span class="pre">conda</span></code> or (Ana/Miniconda&#8217;s) <code class="docutils literal"><span class="pre">python</span></code> are available, then <code class="docutils literal"><span class="pre">psi4</span></code> is available, too.</li>
</ol>
<div class="highlight-bash"><div class="highlight"><pre>&gt;&gt;&gt; conda install psi4
<span class="c"># check</span>
&gt;&gt;&gt; which psi4
/path/to/miniconda/bin/psi4
</pre></div>
</div>
<p>Or, you can install into a <a class="reference external" href="http://conda.pydata.org/docs/faq.html#environments">conda environment</a> that places <span class="sc">Psi4</span> and its dependencies (including python) into a sandbox unaffected by any other software installed in Ana/Miniconda. This is recommended for developers to avoid interference between multiple versions (including github/conda versions) or to test python versions, <em>etc.</em>. If your main conda is not python=2.7, then <span class="sc">Psi4</span> <em>must</em> be installed into a conda environment. In practical terms, installing into a conda environment means you can turn <span class="sc">Psi4</span>&#8216;s availability on/off by switching conda environments without turning on/off the whole Ana/Miniconda installation. Below, <span class="sc">Psi4</span> is installed into an environment called <code class="docutils literal"><span class="pre">p4env</span></code>. Then the environment is activated, removing the main Ana/Miniconda <code class="docutils literal"><span class="pre">bin</span></code> and adding <code class="docutils literal"><span class="pre">envs/p4env/bin</span></code> to <span class="target" id="index-1"></span><a class="reference internal" href="external.html#envvar-PATH"><code class="xref std std-envvar docutils literal"><span class="pre">PATH</span></code></a>. The activate command only works in <code class="docutils literal"><span class="pre">bash</span></code>, so <code class="docutils literal"><span class="pre">csh</span></code>/<code class="docutils literal"><span class="pre">tcsh</span></code> will need corresponding adjustments.</p>
<div class="highlight-bash"><div class="highlight"><pre>&gt;&gt;&gt; conda create -n p4env psi4
&gt;&gt;&gt; <span class="nb">source </span>activate p4env
<span class="c"># check</span>
&gt;&gt;&gt; which psi4
/path/to/miniconda/envs/p4env/bin/psi4
</pre></div>
</div>
<p>The output for either of the installation commands above looks like the following. It checks what packages are needed, gets your approval for downloading them, fetches and installs them, prints out some useful information, and runs a <span class="sc">Psi4</span> test case to check that all&#8217;s well.</p>
<div class="highlight-bash"><div class="highlight"><pre>&gt;&gt;&gt; conda install psi4
Fetching package metadata: ......
Solving package specifications: .
Package plan <span class="k">for</span> installation in environment /path/to/miniconda:

The following packages will be downloaded:

    package                    <span class="p">|</span>            build
    ---------------------------<span class="p">|</span>-----------------
    psi4-0.1.12                <span class="p">|</span>    py27_g60a9afd        31.4 MB

The following NEW packages will be INSTALLED:

    psi4: 0.1.12-py27_g60a9afd

Fetching packages ...
psi4-0.1.12-py 100% <span class="p">|</span><span class="c">################################################################################| Time: 0:00:01  32.49 MB/s</span>
Extracting packages ...
<span class="o">[</span>      COMPLETE      <span class="o">]</span> <span class="p">|</span><span class="c">##################################################################################################| 100%</span>
Linking packages ...


  Thank you <span class="k">for</span> installing psi4. Additional resources:
    Website: www.psicode.org
    Inputs:  /path/to/miniconda/share/psi/samples
    Manual:  bit.ly/psi4manual
    GitHub:  https://github.com/psi4/psi4public/wiki
    Binstar: https://binstar.org/psi4
    Runtime Environment Diagnostic: /path/to/miniconda/share/psi/scripts/setenv.py

  For csh/tcsh <span class="nb">command</span>-line use, add to shell or ~/.tcshrc file:
    setenv PATH /path/to/miniconda/bin:<span class="nv">$PATH</span>
    setenv PSI_SCRATCH /path/to/existing/writable/local-not-network/disk/for/scratch/files

  For sh/bash <span class="nb">command</span>-line use, add to shell or ~/.bashrc file:
    <span class="nb">export </span><span class="nv">PATH</span><span class="o">=</span>/path/to/miniconda/bin:<span class="nv">$PATH</span>
    <span class="nb">export </span><span class="nv">PSI_SCRATCH</span><span class="o">=</span>/path/to/existing/writable/local-not-network/disk/for/scratch/files

Nuclear Repulsion Energy..........................................PASSED SAPT0 Eelst.......................................................PASSED SAPT0 Eexch.......................................................PASSED SAPT0 Eind........................................................PASSED SAPT0 Edisp.......................................................PASSED SAPT0 Etotal......................................................PASSED

<span class="o">[</span>      COMPLETE      <span class="o">]</span> <span class="p">|</span><span class="c">##################################################################################################| 100%</span>
</pre></div>
</div>
<ol class="arabic simple" start="7">
<li>Configure environment. Preceeding steps have placed <code class="docutils literal"><span class="pre">conda</span></code> and <code class="docutils literal"><span class="pre">psi4</span></code> in your <span class="target" id="index-2"></span><a class="reference internal" href="external.html#envvar-PATH"><code class="xref std std-envvar docutils literal"><span class="pre">PATH</span></code></a>, either permanently through rc-files or temporarily in this terminal session. You can keep or undo these changes. For general psi4 use, you must enable the <code class="docutils literal"><span class="pre">psi4</span></code> executable to be found through any of:</li>
</ol>
<blockquote>
<div><ol class="arabic simple">
<li>prepending to <span class="target" id="index-3"></span><a class="reference internal" href="external.html#envvar-PATH"><code class="xref std std-envvar docutils literal"><span class="pre">PATH</span></code></a> in shell, <code class="docutils literal"><span class="pre">~/.bashrc</span></code>, <code class="docutils literal"><span class="pre">~/.tcshrc</span></code>, or PBS <code class="docutils literal"><span class="pre">cmd</span></code> file</li>
<li>activating the conda environment (p4env above) in shell, <code class="docutils literal"><span class="pre">~/.bashrc</span></code>, or PBS <code class="docutils literal"><span class="pre">cmd</span></code> file</li>
<li>supplying full path to executable (shell or PBS <code class="docutils literal"><span class="pre">cmd</span></code> file)</li>
</ol>
</div></blockquote>
<p>Similarly, the scratch directory (see <a class="reference internal" href="external.html#sec-psirc"><span>Scratch Files and the ~/.psi4rc File</span></a>) must be specified through:</p>
<blockquote>
<div><ol class="arabic simple">
<li>defining <span class="target" id="index-4"></span><a class="reference internal" href="external.html#envvar-PSI_SCRATCH"><code class="xref std std-envvar docutils literal"><span class="pre">PSI_SCRATCH</span></code></a> in shell, <code class="docutils literal"><span class="pre">~/.bashrc</span></code>, <code class="docutils literal"><span class="pre">~/.tcshrc</span></code>, or PBS <code class="docutils literal"><span class="pre">cmd</span></code> file</li>
</ol>
</div></blockquote>
<p>Suitable values for these variables have been printed to screen during installation (see last codeblock in step 6).</p>
</div>
<div class="section" id="useful-commands">
<h2>Useful Commands<a class="headerlink" href="#useful-commands" title="Permalink to this headline"></a></h2>
<ul>
<li><p class="first">Update to latest <span class="sc">Psi4</span> version</p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">&gt;&gt;&gt; </span><span class="n">conda</span> <span class="n">update</span> <span class="n">psi4</span>
</pre></div>
</div>
</li>
<li><p class="first">Install into a conda environment &#8220;p4env&#8221; instead of &#8220;root&#8221;. Second command only works on bash; for csh/tsch, <code class="docutils literal"><span class="pre">setenv</span> <span class="pre">PATH</span> <span class="pre">/path/to/miniconda/envs/p4env/bin:$PATH</span></code> instead. This creates a sandbox with just <span class="sc">Psi4</span> and python (loaded as dependency).</p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">&gt;&gt;&gt; </span><span class="n">conda</span> <span class="n">create</span> <span class="o">-</span><span class="n">y</span> <span class="o">-</span><span class="n">n</span> <span class="n">p4env</span> <span class="n">psi4</span>
<span class="gp">&gt;&gt;&gt; </span><span class="n">source</span> <span class="n">activate</span> <span class="n">p4env</span>
</pre></div>
</div>
</li>
<li><p class="first">Install a particular <span class="sc">Psi4</span> version</p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">&gt;&gt;&gt; </span><span class="n">conda</span> <span class="n">install</span> <span class="n">psi4</span><span class="o">=</span><span class="mf">0.1</span><span class="o">.</span><span class="mi">12</span>
</pre></div>
</div>
</li>
<li><p class="first">Uninstall <span class="sc">Psi4</span> from current environment</p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">&gt;&gt;&gt; </span><span class="n">conda</span> <span class="n">remove</span> <span class="n">psi4</span>
</pre></div>
</div>
</li>
</ul>
</div>
<div class="section" id="troubleshooting">
<h2>Troubleshooting<a class="headerlink" href="#troubleshooting" title="Permalink to this headline"></a></h2>
<ul>
<li><p class="first">If the target computer doesn&#8217;t have libc &gt;= 2.7 (released c.2007; for reference, 2.10 is newer than 2.7; unlike most libraries, libc generally not available in multiple versions on a computer), the <span class="sc">Psi4</span> conda package won’t work.</p>
<div class="highlight-python"><div class="highlight"><pre># unsuitable computer
&gt;&gt;&gt; ldd --version
ldd (GNU libc) 2.5
# suitable computer
&gt;&gt;&gt; ldd --version
ldd (GNU libc) 2.17
</pre></div>
</div>
</li>
<li><p class="first">It is of greatest importance that the <span class="sc">Psi4</span> executable be linked against conda libpython.so <em>not</em> against any system libpython.so. This is arranged by setting <code class="docutils literal"><span class="pre">RPATH</span></code> to seek libraries relative to executable (thanks, conda binary relocation routine!). The conda <span class="sc">Psi4</span> executable is not vulnerable to interference from your <code class="docutils literal"><span class="pre">LD_LIBRARY_PATH</span></code> settings. Below shows a well-linked executable.</p>
<blockquote>
<div><ul class="simple">
<li>no libraries &#8220;not found&#8221;</li>
<li>fundamental libraries like libc, ld-linux, pthreads found system libraries to link against</li>
<li>libpython linked against conda python <em>not</em> system python</li>
<li>libm is linked against conda <em>or</em> system</li>
<li>blas, c++, and gcc libraries are absent because statically linked</li>
</ul>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">&gt;&gt;&gt; </span><span class="n">conda</span> <span class="n">install</span> <span class="n">conda</span><span class="o">-</span><span class="n">build</span>  <span class="c"># needed for next command</span>
<span class="gp">&gt;&gt;&gt; </span><span class="n">conda</span> <span class="n">inspect</span> <span class="n">linkages</span> <span class="n">psi4</span>
<span class="go">python-2.7.9-2:</span>
<span class="go">    libpython2.7.so.1.0 (lib/libpython2.7.so.1.0)</span>
<span class="go">system-5.8-1:</span>
<span class="go">    libm.so.6 (lib/libm.so.6)</span>
<span class="go">system:</span>
<span class="go">    libc.so.6 (/lib64/libc.so.6)</span>
<span class="go">    libdl.so.2 (/lib64/libdl.so.2)</span>
<span class="go">    libpthread.so.0 (/lib64/libpthread.so.0)</span>
<span class="go">    librt.so.1 (/lib64/librt.so.1)</span>
<span class="go">    libutil.so.1 (/lib64/libutil.so.1)</span>
<span class="go">    linux-vdso.so.1 ()</span>
<span class="go">not found:</span>
</pre></div>
</div>
</div></blockquote>
</li>
</ul>
<style type="text/css"><!--
 .green {color: red;}
 .sc {font-variant: small-caps;}
 --></style></div>
</div>


          </div>
        </div>
      </div>
      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
        <div class="sphinxsidebarwrapper">
  <h3><a href="index.html">Table Of Contents</a></h3>
  <ul>
<li><a class="reference internal" href="#">Binary Distribution</a><ul>
<li><a class="reference internal" href="#quick-installation">Quick Installation</a></li>
<li><a class="reference internal" href="#detailed-installation-of-miniconda">Detailed Installation of Miniconda</a></li>
<li><a class="reference internal" href="#detailed-installation-of-psifour">Detailed Installation of <span class="sc">Psi4</span></a></li>
<li><a class="reference internal" href="#useful-commands">Useful Commands</a></li>
<li><a class="reference internal" href="#troubleshooting">Troubleshooting</a></li>
</ul>
</li>
</ul>

  <h4>Previous topic</h4>
  <p class="topless"><a href="external.html"
                        title="previous chapter">Installation and Runtime Configuration</a></p>
  <h4>Next topic</h4>
  <p class="topless"><a href="tutorial.html"
                        title="next chapter">A <span class="sc">Psi4</span> Tutorial</a></p>
  <div role="note" aria-label="source link">
    <h3>This Page</h3>
    <ul class="this-page-menu">
      <li><a href="_sources/conda.txt"
            rel="nofollow">Show Source</a></li>
    </ul>
   </div>
<div id="searchbox" style="display: none" role="search">
  <h3>Quick search</h3>
    <form class="search" action="search.html" method="get">
      <input type="text" name="q" />
      <input type="submit" value="Go" />
      <input type="hidden" name="check_keywords" value="yes" />
      <input type="hidden" name="area" value="default" />
    </form>
    <p class="searchtip" style="font-size: 90%">
    Enter search terms or a module, class or function name.
    </p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
        </div>
      </div>
      <div class="clearer"></div>
    </div>
    <div class="relbar-bottom">
        
    <div class="related" role="navigation" aria-label="related navigation">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="genindex.html" title="General Index"
             >index</a></li>
        <li class="right" >
          <a href="py-modindex.html" title="Python Module Index"
             >modules</a> &nbsp; &nbsp;</li>
        <li class="right" >
          <a href="contents.html" title="Table Of Contents"
             >toc</a> &nbsp; &nbsp;</li>
        <li class="right" >
          <a href="tutorial.html" title="A Psi4 Tutorial"
             >next</a> &nbsp; &nbsp;</li>
        <li class="right" >
          <a href="external.html" title="Installation and Runtime Configuration"
             >previous</a> &nbsp; &nbsp;</li>
    <li><a href="index.html">Psi4 []</a> &raquo; </li>

          <li class="nav-item nav-item-1"><a href="external.html" >Installation and Runtime Configuration</a> &raquo;</li> 
      </ul>
    </div>
    </div>

    <div class="footer" role="contentinfo">
        &copy; Copyright 2015, The Psi4 Project.
      Last updated on Tuesday, 12 January 2016 03:10PM.
      Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.3.3.
    </div>
    <!-- cloud_sptheme 1.3 -->
  </body>
</html>