API reference¶
Note
Work in progress. Many function do not yet follow the numpy standard in their documentation!
This page contains a structured overview of the python API of adcc. See also the Index.
adcc module¶
Functions¶

Run an ADC calculation. 

Evaluate Einstein summation convention for the operands similar to numpy’s einsum function. 

Form a single, einsumlike contraction, that is contract tensor a and be to form out via a contraction defined by the first argument string, e.g. 

Return a copy of the input tensor. 

Form the scalar product between two tensors. 

Return an empty tensor of the same shape and symmetry as the input tensor. 

Force full evaluation of a tensor expression 

Form a linear combination from a list of tensors. 

Return tensor of the same shape, but without the symmetry setup of the input tensor. 

Return tensor of the same shape and symmetry as the input tensor, but initialised to 1, that is the canonical blocks are 1 and the other ones are symmetryequivalent (1 or 0) 

Return the transpose of a tensor as a copy. 



Return a zero tensor of the same shape and symmetry as the input tensor. 



Set the number of running worker threads used by adcc 

Get the number of running worker threads used by adcc. 

Obtain guesses for computing singlet states by inspecting the passed ADC matrix. 

Obtain guesses for computing triplet states by inspecting the passed ADC matrix. 

Obtain guesses by inspecting a block of the diagonal of the passed ADC matrix. 

Return guess symmetry objects (one for each AmplitudeVector block) such that the specified requirements on the guesses are satisfied. 

Obtain guesses for computing spinflip states by inspecting the passed ADC matrix. 

Return an AmplitudeVector object filled with zeros, but where the symmetry has been properly set up to meet the specified requirements on the guesses. 

Run an ADC calculation. 

Run an ADC calculation. 

Run an ADC calculation. 

Run an ADC calculation. 

Run an ADC calculation. 

Run an ADC calculation. 

Run an ADC calculation. 

Run an ADC calculation. 

Run an ADC calculation. 

Run an ADC calculation. 

Run an ADC calculation. 

Return a nice banner describing adcc and its components 
Classes¶
Exception thrown during the validation stage of the arguments passed to :py:`run_adc` to signal that an input is not valid. 






Class implementing minimal functionality of AdcMatrixlike objects. 








Abstract class defining the interface for passing data from the host program to adcc. 











This caching policy advises against caching any data, it does, however, keep track of the number of times the caching for a particular object has been requested and thus allows to gain some insight on the helpfulness of particular cachings. 


libadcc: Python bindings for adccore¶
The libadcc Python module contains the python bindings of adccore: C++ core library. They are generated directly from the C++ source code using pybind11 and the sources contained in the extension subfolder of the adcc github repository.
It is not recommended to call these functions directly, but instead resort to the higherlevel functionality from the adcc module.
Functions¶

Apply the spin symmetrisation required to make the doubles and higher parts of an amplitude vector consist of components for a particular spin kind only. 












Get the number of running worker threads used by adcc. 

Get the total number of threads (running and sleeping) used by adcc. 


Return a list of symmetry objects in order to construct the singles / doubles part of the AmplitudeVector. 

Return an AmplitudeVector object filled with zeros, but where the symmetry has been properly set up to meet the requirements of the AdcGuessKind object 

Obtain guesses by inspecting a block of the diagonal of the passed ADC matrix. 



Return the Symmetry object like it would be set up for the passed subspace of the electronrepulsion tensor. 

Return the Symmetry object for an orbital subspace block of a oneparticle operator 

Return the symmetry object for an operator in the AO basis. The object will represent a blockdiagonal matrix of the form ( M 0 ) ( 0 M ). where M is an n_bas x n_bas block and is indentical in upperleft and lowerright. 

Return the Symmetry object like it would be set up for the passed subspace of the orbital coefficients tensor. 

Return the Symmetry object like it would be set up for the passed subspace of the orbital energies tensor. 

Set the number of running worker threads used by adcc 

Set the total number of threads (running and sleeping) used by adcc. 

Overloaded function. 

Overloaded function. 
Classes¶
Class which collects information about the kind of guess vectors to be constructed. 

Class holding the computed ADC intermediates. 

Class representing the AdcMatrix in various variants. 

Class controlling the memory allocations for adcc ADC calculations. 

Class representing an AmplitudeVector. 

Should a particular tensor given by a label, its space string and the string of the spaces involved in the most expensive contraction be stored. 

Abstract class defining the interface for passing data from the host program to adcc. 

Interface class representing the data expected in adcc from an interfacing HF / SCF program. 

Class representing information about the Mo/llerPlesset results from ADCman. 

Helper object to extract information from indices into orbitals subspaces and to map them between different indexing conventions (full MO space, MO subspaces, indexing convention in the HF Provider / SCF host program, . 

Class setting up the molecular orbital index spaces and subspaces and exposing information about them. 

Class representing a oneparticle operator. 

Class representing information about the reference state for adcc. 

Container for Tensor symmetry information 

Class representing the Tensor objects used for computations in adcc 