PSI4 API: Linking C++ and Python¶
psi4.core Module¶
C++ Innards of Psi4: Open-Source Quantum Chemistry
Functions¶
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
Returns copy of the Matrix QCVariable key (case-insensitive); prefer |
Returns dictionary of all Matrix QCVariables; prefer |
|
|
Redirects output to |
|
Perform benchmark traverse of BLAS 1 routines. |
|
Perform benchmark traverse of BLAS 2 routines. |
|
Perform benchmark traverse of BLAS 3 routines. |
|
Perform benchmark of PSIO disk performance. |
|
Perform benchmark of psi integrals (of libmints type). |
|
Perform benchmark of common double floating point operations including most of cmath. |
|
Runs the code to compute coupled cluster density matrices. |
|
Runs the coupled cluster energy code. |
|
Runs the equation of motion coupled cluster code for excited states. |
|
Runs the code to generate the similarity transformed Hamiltonian. |
|
Runs the coupled cluster lambda equations code. |
|
Runs the coupled cluster response theory code. |
|
Runs cctransort that transforms and reorders integrals for use in the coupled cluster codes. |
|
Runs the coupled cluster (T) energy code. |
|
Remove scratch files. |
Reset options to clean state. |
|
Reinitialize timers for independent |
|
Empties all double and Matrix QCVariables that have been set in global memory. |
|
Closes the output file. |
|
|
Runs the density cumulant (functional) theory code. |
|
Removes the Matrix QCVariable key (case-insensitive); prefer |
|
Removes the double QCVariable key (case-insensitive); prefer |
|
Removes scalar or array QCVariable key from global memory if present. |
|
Runs the determinant-based configuration interaction code. |
|
Runs the DF-MP2 code. |
|
Runs the density-fitted orbital optimized CC codes. |
|
Runs the DLPNO codes. |
|
Runs the CheMPS2 interface DMRG code. |
|
Returns the multiplication of two matrices A and B, with options to transpose each beforehand |
|
Write integrals to file in FCIDUMP format |
|
Called upon psi4 module exit to closes timers and I/O. |
Flushes the output file. |
|
|
Runs the FNO-CCSD(T)/QCISD(T)/MP4/CEPA energy code |
Returns the currently active molecule object. |
|
|
Deprecated since version 1.4. |
Deprecated since version 1.4. |
|
Returns the path to shared text resources, |
|
|
Return keyword key value at global (all-module) scope. |
Returns a list of all global options. |
|
|
Return keyword key value at module scope. |
Returns the amount of memory available to Psi (in bytes). |
|
Returns the number of threads to use in SMP parallel computations. |
|
|
Return keyword key value used by module. |
Get options |
|
Returns output file name (stem + suffix, no directory). |
|
|
Deprecated since version 1.4. |
Deprecated since version 1.4. |
|
|
Returns the prefix to use for writing files for external programs. |
Deprecated since version 1.4. |
|
|
Is the Matrix QCVariable key (case-insensitive) set? Prefer |
Whether keyword key value has been touched at global (all-module) scope. |
|
|
Whether keyword key value has been touched at module scope. |
|
Whether keyword key value has been touched or is default. |
|
Is the double QCVariable key (case-insensitive) set? Prefer |
|
Whether scalar or array QCVariable key has been set in global memory. |
Called upon psi4 module import to initialize timers, singletons, and I/O. |
|
|
Runs the MCSCF code, (N.B. |
|
Generates an input for Kallay's MRCC code. |
|
Reads in the density matrices from Kallay's MRCC code. |
|
Runs the orbital optimized CC codes. |
|
Whether keyword key is a valid keyword for module. |
|
Get dictionary of whether options of module have changed. |
Returns the name of the output file. |
|
|
Call the plugin of name arg0. |
|
Close the plugin of name arg0. |
Close all open plugins. |
|
|
Load the plugin of name arg0. |
Sets up the options library to return options pertaining to the module or plugin name (e.g. SCF). |
|
Prints the currently set global (all modules) options to the output file. |
|
Prints the currently set options (to the output file) for the current module. |
|
|
Prints a string (using sprintf-like notation) to the output file. |
Prints to output file all QCVariables that have been set in global memory. |
|
Returns the location of the source code. |
|
|
Runs the multireference coupled cluster code. |
Reopens the output file. |
|
Clear the touched status for keyword key at global (all-module) scope. |
|
|
Clear the touched status for keyword key at module scope. |
|
Runs the GDMA interface code. |
|
Runs the symmetry adapted perturbation theory code. |
|
Returns the double QCVariable key (case-insensitive); prefer |
Returns dictionary of all double QCVariables; prefer |
|
|
New Scatter function. |
|
Run scfgrad, which is a specialized DF-SCF gradient program. |
|
Run scfhess, which is a specialized DF-SCF hessian program. |
|
Activates a previously defined molecule in global memory so next computations use it. |
|
Sets the requested (case-insensitive) Matrix QCVariable; prefer |
|
Sets the path to shared text resources, |
|
Overloaded function. |
|
This is a fairly hacky way to get around EXTERN issues. |
|
Overloaded function. |
|
Sets value to Python keyword key scoped only to a single module. |
|
Sets the memory available to Psi (in bytes); prefer |
|
Sets the number of threads to use in SMP parallel computations. |
|
Overloaded function. |
Deprecated since version 1.4. |
|
|
Sets the double QCVariable key (case-insensitive); prefer |
|
Sets scalar or array QCVariable key to val in global memory. |
|
Stop timer with label. |
|
Start timer with label. |
|
Returns the multiplication of three matrices, with options to transpose each beforehand. |
|
Start module-level timer. |
|
Stop module-level timer. |
|
Return copy of scalar or array QCVariable key from global memory. |
|
Return all scalar or array QCVariables from global memory. |
|
Deprecated since version 1.4. |
Classes¶
Computes angular momentum integrals |
|
docstring |
|
docstring |
|
Contains basis set information |
|
docstring |
|
Performs Boys orbital localization |
|
Specialized Wavefunction used by the ccenergy, cceom, ccgradient, etc. |
|
docstring |
|
docstring |
|
docstring |
|
Cartesian displacement SALC |
|
Class for generating symmetry adapted linear combinations of Cartesian displacements |
|
Contains the character table of the point group |
|
docstring |
|
docstring |
|
Provides a correlation table between two point groups |
|
docstring |
|
A density-fitted second-order Electron Propagator Wavefunction. |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
Computes gradients of wavefunctions |
|
Members: |
|
Defines ordering of eigenvalues after diagonalization |
|
Initializes and defines Dimension Objects |
|
Computes dipole integrals |
|
docstring |
|
docstring |
|
docstring |
|
Computes normal two electron repulsion integrals |
|
docstring |
|
ESPPropCalc gives access to routines calculating the ESP on a grid |
|
Computes electric field integrals |
|
Computes electrostatic integrals |
|
Stores external potential field, computes external potential matrix |
|
Extracts information from a wavefunction object, and writes it to an FCHK file |
|
docstring |
|
A Fragment-SAPT Wavefunction |
|
docstring |
|
docstring |
|
Fragment activation status |
|
docstring |
|
Class containing information about basis functions |
|
0 if Cartesian, 1 if Pure |
|
The units used to define the geometry |
|
docstring |
|
docstring |
|
PSIOManager is a class designed to be used as a static object to track all PSIO operations in a given PSI4 computation |
|
Class handling vectors with integer values |
|
Computes integrals |
|
IntegralTransform transforms one- and two-electron integrals within general spaces |
|
An irreducible representation of the point group |
|
docstring |
|
Computes kinetic integrals |
|
Computer class for a Laplace factorization of the four-index energy denominator in MP2 and coupled-cluster |
|
docstring |
|
Class containing orbital localization procedures |
|
Defines orbital spaces in which to transform integrals |
|
Writes the MOs |
|
Class for creating and manipulating matrices |
|
Creates Matrix objects |
|
docstring |
|
Computes integrals |
|
Writes wavefunction information in molden format |
|
docstring |
|
Class to store the elements, coordinates, fragmentation pattern, basis sets, charge, multiplicity, etc. |
|
Computes arbitrary-order multipole integrals |
|
docstring |
|
Computes nabla integrals |
|
Computes numerical integrals using a DFT grid. |
|
docstring |
|
Basis class for all one-electron integrals |
|
docstring |
|
Contains information about the orbitals |
|
Computes overlap integrals |
|
Performs Pipek-Mezey orbital localization |
|
Handles symmetry transformations |
|
docstring |
|
Contains information about the point group |
|
Computes potential integrals |
|
May be Normalized or Unnormalized |
|
docstring |
|
Return status. |
|
Computes quadrupole integrals |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
|
An SOBasis object describes the transformation from an atomic orbital basis to a symmetry orbital basis. |
|
docstring |
|
Component of a Cartesian displacement SALC in the basis of atomic displacements. |
|
The layout of the matrix for saving |
|
Slicing for Matrix and Vector objects |
|
docstring |
|
Class to provide a 3 by 3 matrix representation of a symmetry operation, such as a rotation or reflection. |
|
Computer class for a Laplace factorization of the six-index energy denominator in coupled-cluster theory |
|
Three center overlap integrals |
|
Computes traceless quadrupole integrals |
|
Two body integral base class |
|
Computes two-electron repulsion integrals |
|
docstring |
|
docstring |
|
docstring |
|
Class for creating and manipulating vectors |
|
Class for vectors of length three, often Cartesian coordinate vectors, and their common operations |
|
docstring |
|
docstring |
|
docstring |
|
docstring |
Class Inheritance Diagram¶
![Inheritance diagram of psi4.core.AOShellCombinationsIterator, psi4.core.AngularMomentumInt, psi4.core.BSVec, psi4.core.BasisExtents, psi4.core.BasisFunctions, psi4.core.BasisSet, psi4.core.BlockOPoints, psi4.core.BoysLocalizer, psi4.core.CCWavefunction, psi4.core.CIVector, psi4.core.CIWavefunction, psi4.core.CUHF, psi4.core.CdSalc, psi4.core.CdSalcList, psi4.core.CharacterTable, psi4.core.CompositeJK, psi4.core.CorrelationFactor, psi4.core.CorrelationTable, psi4.core.CubeProperties, psi4.core.DFEP2Wavefunction, psi4.core.DFHelper, psi4.core.DFSOMCSCF, psi4.core.DFTGrid, psi4.core.DFTensor, psi4.core.Deriv, psi4.core.DerivCalcType, psi4.core.DiagonalizeOrder, psi4.core.Dimension, psi4.core.DipoleInt, psi4.core.DirectJK, psi4.core.DiskSOMCSCF, psi4.core.Dispersion, psi4.core.ERI, psi4.core.ERISieve, psi4.core.ESPPropCalc, psi4.core.ElectricFieldInt, psi4.core.ElectrostaticInt, psi4.core.ExternalPotential, psi4.core.FCHKWriter, psi4.core.FDDS_Dispersion, psi4.core.FISAPT, psi4.core.FittedSlaterCorrelationFactor, psi4.core.FittingMetric, psi4.core.FragmentType, psi4.core.Functional, psi4.core.GaussianShell, psi4.core.GaussianType, psi4.core.GeometryUnits, psi4.core.HF, psi4.core.IO, psi4.core.IOManager, psi4.core.IntVector, psi4.core.IntegralFactory, psi4.core.IntegralTransform, psi4.core.IrreducibleRepresentation, psi4.core.JK, psi4.core.KineticInt, psi4.core.LaplaceDenominator, psi4.core.LibXCFunctional, psi4.core.Localizer, psi4.core.MOSpace, psi4.core.MOWriter, psi4.core.Matrix, psi4.core.MatrixFactory, psi4.core.MemDFJK, psi4.core.MintsHelper, psi4.core.MoldenWriter, psi4.core.MolecularGrid, psi4.core.Molecule, psi4.core.MultipoleInt, psi4.core.MultipoleSymmetry, psi4.core.NablaInt, psi4.core.NumIntHelper, psi4.core.OEProp, psi4.core.OneBodyAOInt, psi4.core.OneBodySOInt, psi4.core.Options, psi4.core.OrbitalSpace, psi4.core.OverlapInt, psi4.core.PMLocalizer, psi4.core.PetiteList, psi4.core.PointFunctions, psi4.core.PointGroup, psi4.core.PotentialInt, psi4.core.PrimitiveType, psi4.core.Prop, psi4.core.ProtoIntVector, psi4.core.ProtoVector, psi4.core.PsiReturnType, psi4.core.QuadrupoleInt, psi4.core.RHF, psi4.core.RKSFunctions, psi4.core.ROHF, psi4.core.SADGuess, psi4.core.SOBasisSet, psi4.core.SOMCSCF, psi4.core.SalcComponent, psi4.core.SaveType, psi4.core.ShellInfo, psi4.core.Slice, psi4.core.SuperFunctional, psi4.core.SymmetryOperation, psi4.core.TLaplaceDenominator, psi4.core.ThreeCenterOverlapInt, psi4.core.TracelessQuadrupoleInt, psi4.core.TwoBodyAOInt, psi4.core.TwoElectronInt, psi4.core.UHF, psi4.core.UKSFunctions, psi4.core.VBase, psi4.core.Vector, psi4.core.Vector3, psi4.core.Wavefunction, psi4.core.dpdbuf4, psi4.core.dpdfile2, psi4.core.psio_entry](_images/inheritance-f370fb86e53a357d4904859be418c36813bea2df.png)
psi4.driver Package¶
Functions¶
|
Function to set molecule object mol as the current active molecule. |
|
Format text into a banner style and print or return it. |
|
Helper to specify a custom basis set in PsiAPI mode. |
|
Function to define a multistage energy method from combinations of basis set extrapolations and delta corrections and condense the components into a minimum number of calculations. |
|
Comparison function for output data in FCHK (formatted checkpoint) file format. |
|
Comparison function for FCIDUMP files. |
|
Comparison function for output data in Molden file format. |
|
Move a file out of scratch following the naming convention. |
|
Move a file into scratch following the naming convention. |
|
|
|
Evaluate properties on a grid and generate cube files. |
|
Compose a link to mode documentation table. |
Function to dynamically add extra members to the core.Molecule class. |
|
|
From integrals dictionary generated from |
|
Function to compute the single-point electronic energy. |
|
Function to write wavefunction information in wfn to filename in Gaussian FCHK format. |
|
Save integrals to file in FCIDUMP format as defined in Comp. |
|
Function to read in a FCIDUMP file. |
|
Find list of approximate (within max_distance) matches to string seq1 among options. |
|
Function to compute harmonic vibrational frequencies. |
|
Function to compute harmonic vibrational frequencies. |
|
Function to compute harmonic vibrational frequencies. |
|
Function to use wavefunction information in wfn and, if specified, additional commands in filename to run GDMA analysis. |
|
Function to create a molecule object of name name from the geometry in string geom. |
Return the total memory allocation in bytes. |
|
|
Function complementary to |
|
Function complementary to |
|
Runs |
|
Compute the Levenshtein distance between two strings. |
Returns information on integral classes, derivatives, and AM from currently linked Libint2. |
|
|
|
|
Begin functioning as an MDI (MolSSI driver interface) engine |
|
Put a message string into a box for extra attention. |
|
Function to write wavefunction information in wfn to filename in molden format. |
|
Function to redefine __getattr__ method of molecule class. |
|
Function to redefine __setattr__ method of molecule class. |
|
Evaluate one-electron properties. |
|
Function to perform a geometry optimization. |
|
Function to perform a geometry optimization. |
|
|
|
Helper to specify the multiline PCMSolver syntax for PCM. |
|
Function to preprocess raw input, the text of the input file, then parse it, validate it for format, and convert it into legitimate Python. |
|
Function to compute various properties. |
|
Function to compute various properties. |
|
Replace characters in method name so that suitable for function name or Sphinx table anchor (both as-is) or HTML table link (replace underscore in returned string by dash). |
|
Function to return name in coded form, stripped of characters that confuse filenames, characters into lowercase, |
|
Function serving as helper to SCF, choosing whether to cast up or just run SCF with a standard guess. |
|
Builds the correct (R/U/RO/CU HF/KS) wavefunction from the provided information, sets relevant auxiliary basis sets on it, and prepares any empirical dispersion. |
|
Reset the total memory allocation. |
|
Sets Psi4 module options from a module specification and input dictionary. |
|
Sets Psi4 options from an input dictionary. |
|
|
|
Function to perform analysis of a hessian or hessian block, specifically. |
Classes¶
Computer for analytic single-geometry computations. |
|
|
Error called for problems with converging an iterative method. |
|
Lightweight unification of empirical dispersion calculation modes. |
|
Error called when a requested level of theory and derivative level are nominally available but not for the particular conditions (e.g., reference, algorithm, active orbitals, QC module, etc.) requested. |
|
Error called when requested level or theory or derivative level are not available. |
Error called for problems with geometry optimizer. |
|
|
Error called for problems parsing a text file. |
|
Error called when the specified value of option requires some module(s) from Psi4Pasture, but could not be imported. |
Error class for PSI4. |
|
|
Hold charges and |
|
Hold charges and |
|
Error called for problems with SCF iterations. |
|
Error called for problems with TDSCF iterations. |
|
Error called when a |
|
Error called on previously valid syntax that now isn't and a simple syntax transition is possible. |
|
Input specification has problems. |
Class Inheritance Diagram¶
![Inheritance diagram of psi4.driver.task_base.AtomicComputer, psi4.driver.p4util.exceptions.ConvergenceError, psi4.driver.procrouting.empirical_dispersion.EmpiricalDispersion, psi4.driver.p4util.exceptions.ManagedMethodError, psi4.driver.p4util.exceptions.MissingMethodError, psi4.driver.p4util.exceptions.OptimizationConvergenceError, psi4.driver.p4util.exceptions.ParsingError, psi4.driver.p4util.exceptions.PastureRequiredError, psi4.driver.p4util.exceptions.PsiException, psi4.driver.qmmm.QMMM, psi4.driver.qmmm.QMMMbohr, psi4.driver.p4util.exceptions.SCFConvergenceError, psi4.driver.p4util.exceptions.TDSCFConvergenceError, psi4.driver.p4util.exceptions.TestComparisonError, psi4.driver.p4util.exceptions.UpgradeHelper, psi4.driver.p4util.exceptions.ValidationError](_images/inheritance-f0ce8b47b23b51991ad667caa3f6ba5c7c8e62c1.png)
psi4.driver.p4util Package¶
Miscellaneous tools for driver and users.
Functions¶
|
Return a context manager that will collect the state (value and changed status) of a list of keywords osd that can initialize |
|
Return a generator of all lettercase permutations of input_string. |
|
Converts a NumPy array or list of NumPy arrays into a PSI4 |
|
Format text into a banner style and print or return it. |
|
Helper to specify a custom basis set in PsiAPI mode. |
|
Convert square NumPy array to a single block diagonal array. |
|
Solves the |
|
Comparison function for output data in FCHK (formatted checkpoint) file format. |
|
Comparison function for FCIDUMP files. |
|
Comparison function for output data in Molden file format. |
|
Move a file out of scratch following the naming convention. |
|
Move a file into scratch following the naming convention. |
|
Evaluate properties on a grid and generate cube files. |
|
Solves for the lowest few eigenvalues and eigenvectors of a large problem emulated through an engine. |
|
Compose a link to mode documentation table. |
|
Return a copy of collection seq without any duplicate entries. |
|
From integrals dictionary generated from |
|
From rules on building QCVariables from others, set new variables to P::e if all the contributors are available. |
|
Save integrals to file in FCIDUMP format as defined in Comp. |
|
Function to read in a FCIDUMP file. |
|
Find list of approximate (within max_distance) matches to string seq1 among options. |
|
Function to return a string of the output of |
|
Function to return a string of commands to replicate the current state of user-modified options. |
|
Computes free-atom volumes using MBIS density partitioning. |
Return the total memory allocation in bytes. |
|
|
Form full path and filename for psi scratch file. |
|
Extract attribute attr from module if attr is available in any possible lettercase permutation. |
|
Finds the smallest eigenvalues and associated right and left hand eigenvectors of a large real Hamiltonian eigenvalue problem emulated through an engine. |
Return a context manager that will collect the current state of |
|
|
Import loader for module in any possible lettercase permutation. |
|
Function to rebuild and return kwargs dictionary sanitized. |
|
Compute the Levenshtein distance between two strings. |
Returns information on integral classes, derivatives, and AM from currently linked Libint2. |
|
|
|
|
Convert Matrix to List. |
|
Put a message string into a box for extra attention. |
|
Evaluate one-electron properties. |
|
Helper to specify the multiline PCMSolver syntax for PCM. |
|
Prepare serialized QCVariables for QCSchema AtomicResult.extras["qcvars"] by converting flat arrays into numpy, shaped ones and floating strings. |
Prefactor for converting microscopic observable to decadic molar extinction coefficient in electronic circular dichroism. |
|
Prefactor for converting microscopic observable to decadic molar extinction coefficient in one-photon absorption. |
|
|
Capture current state of |
Collect current state of |
|
|
Prepare QCSchema Provenance with PSI4 credentials. |
|
Replace characters in method name so that suitable for function name or Sphinx table anchor (both as-is) or HTML table link (replace underscore in returned string by dash). |
|
Reset the total memory allocation. |
|
Sets Psi4 module options from a module specification and input dictionary. |
|
Sets Psi4 options from an input dictionary. |
|
One-photon absorption (OPA) or electronic circular dichroism (ECD) spectra with phenomenological line broadening. |
|
Form a QCSchema for job input from the current state of PSI4 settings. |
Classes¶
|
An object to assist in the DIIS extrpolation procedure. |
|
Gaussian function on domain, centered at x_0 with broadening gamma. |
|
POV-Ray visualization. |
|
Lineshape ABC |
|
Lorentzian function on domain, centered at x_0 with broadening gamma. |
|
Store the state (value and changed status) of a single option. |
|
Store multiple |
Abstract Base Class defining the API for a matrix-vector product object required by solvers. |
Class Inheritance Diagram¶
![Inheritance diagram of psi4.driver.p4util.solvers.DIIS, psi4.driver.p4util.spectrum.Gaussian, psi4.driver.p4util.inpsight.InPsight, psi4.driver.p4util.spectrum.Lineshape, psi4.driver.p4util.spectrum.Lorentzian, psi4.driver.p4util.optproc.OptionState, psi4.driver.p4util.optproc.OptionsState, psi4.driver.p4util.solvers.SolverEngine](_images/inheritance-88de7a842b7851ce59b6337a714418048cda197e.png)