.. #
.. # @BEGIN LICENSE
.. #
.. # Psi4: an open-source quantum chemistry software package
.. #
.. # Copyright (c) 2007-2019 The Psi4 Developers.
.. #
.. # The copyrights for code used from other parties are included in
.. # the corresponding files.
.. #
.. # This file is part of Psi4.
.. #
.. # Psi4 is free software; you can redistribute it and/or modify
.. # it under the terms of the GNU Lesser General Public License as published by
.. # the Free Software Foundation, version 3.
.. #
.. # Psi4 is distributed in the hope that it will be useful,
.. # but WITHOUT ANY WARRANTY; without even the implied warranty of
.. # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.. # GNU Lesser General Public License for more details.
.. #
.. # You should have received a copy of the GNU Lesser General Public License along
.. # with Psi4; if not, write to the Free Software Foundation, Inc.,
.. # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
.. #
.. # @END LICENSE
.. #

.. _`sec:buildrunfaq`:

===============
Build & Run FAQ
===============

Obtaining and Updating |PSIfour|
--------------------------------

#. :ref:`faq:obtainpsi4`
#. :ref:`faq:quiz`
#. :ref:`faq:binary`
#. :ref:`faq:clonepsi4public`
#. :ref:`faq:forkpsi4public`
#. :ref:`faq:tarballpsi4public`
#. :ref:`faq:psi3sourceforge`
#. :ref:`faq:recompile`

Configuring and Installing |PSIfour| via Binary
-----------------------------------------------

#. :ref:`faq:psicodedownload`
#. :ref:`sec:psi4conda`
#. :ref:`faq:psi4pkg`
#. :ref:`faq:updatepsi4`
#. :ref:`faq:psi4deps`
#. :ref:`sec:condadetails`
#. :ref:`faq:condamaxameri`

Configuring, Building, and Installing |PSIfour| via Source
----------------------------------------------------------

#. :ref:`faq:cmakeviasetup`
#. :ref:`faq:buildquick`
#. :ref:`faq:builddetailed`

#. :ref:`faq:setuphelp`
#. :ref:`faq:chooseobjdir`
#. :ref:`faq:setupprefix`
#. :ref:`faq:setupmaxameri`
#. :ref:`faq:cmakeverbose`
#. :ref:`faq:doconfigure`
#. :ref:`faq:cray`

Non-QC Dependencies
-------------------

#. :ref:`faq:coredepend`
#. :ref:`cmake:python`
#. :ref:`faq:libmwcondapy`
#. :ref:`cmake:lapack`
#. :ref:`cmake:cxx`
#. :ref:`faq:approvedcxx`
#. :ref:`faq:modgcc`
#. :ref:`faq:macxcode`
#. :ref:`cmake:fortran`
#. :ref:`faq:approvedfc`
#. :ref:`faq:macgfortran`

QC Dependencies and Extensions
------------------------------

#. :ref:`faq:addondepend`
#. :ref:`faq:localaddon`
#. :ref:`cmake:chemps2`
#. :ref:`faq:chemps2gccflto`
#. :ref:`cmake:dkh`
#. :ref:`cmake:libefp`
#. :ref:`cmake:erd`
#. :ref:`cmake:gdma`
#. :ref:`cmake:libint`
#. :ref:`cmake:pcmsolver`

Testing 
-------

#. :ref:`faq:testsoutput`
#. :ref:`faq:subsettests`
#. :ref:`faq:minutetests`
#. :ref:`faq:pytest`

Runtime Setup
-------------

#. :ref:`faq:runordinaryexe`
#. :ref:`faq:runordinarymodule`
#. :ref:`faq:runfrombinary`
#. :ref:`faq:inplace`
#. :ref:`faq:psi4scratch`
#. :ref:`faq:psidatadir`
#. :ref:`faq:psi4psiapipath`
#. :ref:`faq:modulenotfounderror`

Running |PSIfour|
-----------------

#. :ref:`What command line options does Psi4 have <sec:commandLineOptions>`
#. :ref:`What environment variables affect Psi4 <sec:environmentVariables>`
#. :ref:`faq:runtimepython`
#. :ref:`faq:psi4version`
#. :ref:`faq:psi4PBS`
#. :ref:`faq:psi4fileretention`

Runtime Errors and Debugging
----------------------------

#. :ref:`faq:gdblldb`
#. :ref:`faq:setuptype`
#. :ref:`faq:wrongpyfalse`
#. :ref:`faq:erroreriam`

Managing Code
-------------

#. :ref:`faq:dirlayoutinstall`
#. :ref:`faq:githubworkflow`
#. :ref:`faq:vigitmerge`

Miscellaneous
-------------

#. :ref:`faq:writepsi4`
#. :ref:`faq:psi4logos`


.. #. :ref:`faq:getversion`
.. #. :ref:`faq:binarypackage`
.. #. :ref:`faq:getting-and-using-the-psi4dependencies-package`

