This file is indexed.

/usr/share/doc/libchemps2/html/interfaces.html is in chemps2-doc 1.6-3.

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
<!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>10. Interfaces to psi4 and pyscf &mdash; CheMPS2 1.6 documentation</title>
    
    <link rel="stylesheet" href="_static/classic.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
    
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    './',
        VERSION:     '1.6',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
      };
    </script>
    <script type="text/javascript" src="/usr/share/javascript/jquery/jquery.js"></script>
    <script type="text/javascript" src="/usr/share/javascript/underscore/underscore.js"></script>
    <script type="text/javascript" src="_static/doctools.js"></script>
    <script type="text/javascript" src="/usr/share/javascript/mathjax/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>
    <link rel="top" title="CheMPS2 1.6 documentation" href="index.html" />
    <link rel="prev" title="9. DMRG-SCF calculations" href="dmrgscfcalcs.html" /> 
  </head>
  <body role="document">
    <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="dmrgscfcalcs.html" title="9. DMRG-SCF calculations"
             accesskey="P">previous</a> |</li>
        <li class="nav-item nav-item-0"><a href="index.html">CheMPS2 1.6 documentation</a> &raquo;</li> 
      </ul>
    </div>  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body" role="main">
            
  <span class="target" id="index-0"></span><span class="target" id="index-1"></span><div class="section" id="interfaces-to-psi4-and-pyscf">
<span id="index-2"></span><h1>10. Interfaces to psi4 and pyscf<a class="headerlink" href="#interfaces-to-psi4-and-pyscf" title="Permalink to this headline"></a></h1>
<p>CheMPS2 is currently interfaced with two ab initio quantum chemistry packages:</p>
<ol class="arabic simple">
<li>The <code class="docutils literal"><span class="pre">dmrgscf</span></code> plugin to <a class="reference external" href="http://www.psicode.org/">psi4</a> allows to perform DMRG-CI and DMRG-SCF calculations with CheMPS2, by using <a class="reference external" href="http://www.psicode.org/">psi4</a> input files. Since April 2015, CheMPS2 is also an integral part of psi4.</li>
<li>There are also DMRG-CI and DMRG-SCF interfaces between <a class="reference external" href="http://sunqm.github.io/pyscf/">pyscf</a> and CheMPS2.</li>
</ol>
<div class="section" id="psi4-dmrgscf-plugin">
<h2>10.1. psi4 <code class="docutils literal"><span class="pre">dmrgscf</span></code> plugin<a class="headerlink" href="#psi4-dmrgscf-plugin" title="Permalink to this headline"></a></h2>
<p>DMRG-CI and DMRG-SCF calculations can be performed directly with <a class="reference external" href="http://www.psicode.org/">psi4</a>. The plugin has been tested on commit <code class="docutils literal"><span class="pre">14c78eabdca86f8e094576890518d93d300d2500</span></code> (February 27, 2015) on <a class="reference external" href="https://github.com/psi4/psi4public">https://github.com/psi4/psi4public</a>, and should work on later versions as well.</p>
<p>To perform DMRG-CI and DMRG-SCF calculations, build <a class="reference external" href="http://www.psicode.org/">psi4</a> with the plugin option, and then run:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span><span class="nb">cd</span> /mypsi4plugins
<span class="nv">$ </span>psi4 --new-plugin dmrgscf
<span class="nv">$ </span><span class="nb">cd </span>dmrgscf
</pre></div>
</div>
<p>Now, replace the file <code class="docutils literal"><span class="pre">dmrgscf.cc</span></code> with <code class="docutils literal"><span class="pre">/sourcefolder/chemps2/integrals/psi4plugins/dmrgscf.cc</span></code>. To compile the plugin, the Makefile should be adjusted. Change the line</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">PSIPLUGIN</span> <span class="o">=</span> -L<span class="k">$(</span>OBJDIR<span class="k">)</span>/lib -lplugin
</pre></div>
</div>
<p>to</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">PSIPLUGIN</span> <span class="o">=</span> -L<span class="k">$(</span>OBJDIR<span class="k">)</span>/lib -lplugin -lchemps2
</pre></div>
</div>
<p>Remember to add the library and include paths to the Makefile as well, if <code class="docutils literal"><span class="pre">libchemps2</span></code> is not installed in a standard location.
To compile the plugin, run:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span>make
</pre></div>
</div>
<p>An example input file to perform a DMRG-SCF calculation with the <code class="docutils literal"><span class="pre">dmrgscf</span></code> plugin:</p>
<div class="highlight-python"><div class="highlight"><pre>molecule O2 {
  O       0.0   0.0   0.0
  O       0.0   0.0   3.0 
units au
}

plugin_load(&quot;dmrgscf/dmrgscf.so&quot;)

set basis     cc-pVDZ
set reference rhf

set dmrgscf wfn_irrep            0
set dmrgscf wfn_multp            1
set dmrgscf frozen_docc          [ 1 , 0 , 0 , 0 , 0 , 1 , 0 , 0 ]
set dmrgscf active               [ 2 , 0 , 2 , 2 , 0 , 2 , 2 , 2 ]

set dmrgscf dmrg_states          [   500,  1000,  1000 ]
set dmrgscf dmrg_econv           [ 1e-10, 1e-10, 1e-10 ]
set dmrgscf dmrg_maxsweeps       [     5,     5,    10 ]
set dmrgscf dmrg_noiseprefactors [  0.05,  0.05,   0.0 ]
set dmrgscf dmrg_print_corr      false
set dmrgscf mps_chkpt            false

set dmrgscf dmrgscf_convergence  1e-6
set dmrgscf dmrgscf_store_unit   true
set dmrgscf dmrgscf_do_diis      true
set dmrgscf dmrgscf_diis_branch  1e-2
set dmrgscf dmrgscf_store_diis   true

set dmrgscf dmrgscf_max_iter     100
set dmrgscf dmrgscf_which_root   2   # First excited state
set dmrgscf dmrgscf_state_avg    true
set dmrgscf dmrgscf_active_space NO  # INPUT; NO; LOC
set dmrgscf dmrgscf_loc_random   false

scf()

plugin(&quot;dmrgscf.so&quot;)
</pre></div>
</div>
<p>This file (<code class="docutils literal"><span class="pre">O2.dmrgscf.in</span></code>) should be placed in the folder <code class="docutils literal"><span class="pre">/mypsi4plugins</span></code>. The DMRG-SCF calculation can then be started with:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span><span class="nb">cd</span> /mypsi4plugins
<span class="nv">$ </span>psi4 O2.dmrgscf.in O2.dmrgscf.out
</pre></div>
</div>
<p>An example input file to perform a DMRG-CI calculation with the <code class="docutils literal"><span class="pre">dmrgscf</span></code> plugin:</p>
<div class="highlight-python"><div class="highlight"><pre>molecule H2O {
 0 1
   O   0.000000000   0.00   0.000000000
   H   0.790689766   0.00   0.612217330
   H  -0.790689766   0.00   0.612217330
 units angstrom
}

plugin_load(&quot;dmrgscf/dmrgscf.so&quot;)

set basis          cc-pVDZ
set reference      rhf
set e_convergence  1e-13
set d_convergence  1e-13
set ints_tolerance 0.0

set dmrgscf wfn_irrep            0
set dmrgscf wfn_multp            1
set dmrgscf frozen_docc          [ 1 , 0 , 0 , 0 ]
set dmrgscf active               [ 5 , 0 , 4 , 2 ]

set dmrgscf dmrg_states          [  200,  500, 1000, 1000 ]
set dmrgscf dmrg_econv           [ 1e-8, 1e-8, 1e-8, 1e-8 ]
set dmrgscf dmrg_maxsweeps       [    5,    5,    5,  100 ]
set dmrgscf dmrg_noiseprefactors [ 0.03, 0.03, 0.03,  0.0 ]
set dmrgscf dmrg_print_corr      false
set dmrgscf mps_chkpt            false

set dmrgscf dmrgscf_max_iter     1

scf()

plugin(&quot;dmrgscf.so&quot;)
</pre></div>
</div>
<p>Note that the option <code class="docutils literal"><span class="pre">dmrgscf_max_iter</span></code> has been set to <code class="docutils literal"><span class="pre">1</span></code>, so that only one active space calculation is performed. This file (<code class="docutils literal"><span class="pre">H2O.dmrgci.in</span></code>) should be placed in the folder <code class="docutils literal"><span class="pre">/mypsi4plugins</span></code>. The DMRG-CI calculation can then be started with:</p>
<div class="highlight-bash"><div class="highlight"><pre><span class="nv">$ </span><span class="nb">cd</span> /mypsi4plugins
<span class="nv">$ </span>psi4 H2O.dmrgci.in H2O.dmrgci.out
</pre></div>
</div>
<p>Since April 2015, CheMPS2 is also an integral part of <a class="reference external" href="http://www.psicode.org/">psi4</a>. Please consult <a class="reference external" href="http://www.psicode.org/">psi4</a>&#8216;s documentation on how to run DMRG-SCF calculations with <a class="reference external" href="http://www.psicode.org/">psi4</a>.</p>
</div>
<div class="section" id="id7">
<h2>10.2. pyscf<a class="headerlink" href="#id7" title="Permalink to this headline"></a></h2>
<p><a class="reference external" href="http://sunqm.github.io/pyscf/">pyscf</a> is a new quantum chemistry package, in which all layers are written or interfaced in python. In the future, the package will be able to perform DMRG-CI and DMRG-SCF calculations using PyCheMPS2: <a class="reference external" href="https://github.com/sunqm/pyscf/blob/master/future/dmrgscf/chemps2.py">chemps2.py</a>.</p>
<p>Examples of how to extract MO integrals from <a class="reference external" href="http://sunqm.github.io/pyscf/">pyscf</a> to perform DMRG-CI calculations with PyCheMPS2 can be found in:</p>
<ol class="arabic simple">
<li><code class="docutils literal"><span class="pre">/sourcefolder/chemps2/integrals/pyscf/example.py</span></code></li>
<li><code class="docutils literal"><span class="pre">/sourcefolder/chemps2/integrals/pyscf/example2.py</span></code></li>
<li><code class="docutils literal"><span class="pre">/sourcefolder/chemps2/integrals/pyscf/example3.py</span></code></li>
<li><code class="docutils literal"><span class="pre">/sourcefolder/chemps2/integrals/pyscf/dmrgci.py</span></code></li>
<li><code class="docutils literal"><span class="pre">/sourcefolder/chemps2/integrals/pyscf/call_chemps2.py</span></code></li>
</ol>
<p>Please remember to append the correct pyscf and PyCheMPS2 directories to <code class="docutils literal"><span class="pre">sys.path</span></code> at the top of these files.</p>
</div>
</div>


          </div>
        </div>
      </div>
      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
        <div class="sphinxsidebarwrapper">
            <p class="logo"><a href="index.html">
              <img class="logo" src="_static/CheMPS2logo.png" alt="Logo"/>
            </a></p>
  <h3><a href="index.html">Table Of Contents</a></h3>
  <ul>
<li><a class="reference internal" href="#">10. Interfaces to psi4 and pyscf</a><ul>
<li><a class="reference internal" href="#psi4-dmrgscf-plugin">10.1. psi4 <code class="docutils literal"><span class="pre">dmrgscf</span></code> plugin</a></li>
<li><a class="reference internal" href="#id7">10.2. pyscf</a></li>
</ul>
</li>
</ul>

  <h4>Previous topic</h4>
  <p class="topless"><a href="dmrgscfcalcs.html"
                        title="previous chapter">9. DMRG-SCF calculations</a></p>
  <div role="note" aria-label="source link">
    <h3>This Page</h3>
    <ul class="this-page-menu">
      <li><a href="_sources/interfaces.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="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="dmrgscfcalcs.html" title="9. DMRG-SCF calculations"
             >previous</a> |</li>
        <li class="nav-item nav-item-0"><a href="index.html">CheMPS2 1.6 documentation</a> &raquo;</li> 
      </ul>
    </div>
    <div class="footer" role="contentinfo">
        &copy; Copyright 2013-2015, Sebastian Wouters.
      Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.3.3.
    </div>
  </body>
</html>