Needed Modules ============== .. Do not edit this section It was auto-generated .. by the `update_README.py` script. .. image:: tree_dependency.png * `Integrals_Monoelec `_ * `Integrals_Bielec `_ Documentation ============= .. Do not edit this section It was auto-generated .. by the `update_README.py` script. `a_operator `_ Needed for diag_H_mat_elem `abs_psi_coef_max `_ Max and min values of the coefficients `abs_psi_coef_min `_ Max and min values of the coefficients `ac_operator `_ Needed for diag_H_mat_elem `apply_mono `_ Undocumented `bi_elec_ref_bitmask_energy `_ Energy of the reference bitmask used in Slater rules `bitstring_to_list_ab `_ Gives the inidices(+1) of the bits set to 1 in the bit string For alpha/beta determinants `bitstring_to_list_ab_old `_ Gives the inidices(+1) of the bits set to 1 in the bit string For alpha/beta determinants `build_fock_tmp `_ Build the diagonal of the Fock matrix corresponding to a generator determinant. F_00 is = E0. `ci_eigenvectors `_ Eigenvectors/values of the CI matrix `ci_eigenvectors_mono `_ Eigenvectors/values of the CI matrix `ci_eigenvectors_s2 `_ Eigenvectors/values of the CI matrix `ci_eigenvectors_s2_mono `_ Eigenvectors/values of the CI matrix `ci_electronic_energy `_ Eigenvectors/values of the CI matrix `ci_electronic_energy_mono `_ Eigenvectors/values of the CI matrix `ci_energy `_ N_states lowest eigenvalues of the CI matrix `ci_sc2_eigenvectors `_ Eigenvectors/values of the CI matrix `ci_sc2_electronic_energy `_ Eigenvectors/values of the CI matrix `ci_sc2_energy `_ N_states_diag lowest eigenvalues of the CI matrix `cisd `_ Undocumented `cisd_sc2 `_ CISD+SC2 method :: take off all the disconnected terms of a CISD (selected or not) .br dets_in : bitmasks corresponding to determinants .br u_in : guess coefficients on the various states. Overwritten on exit .br dim_in : leftmost dimension of u_in .br sze : Number of determinants .br N_st : Number of eigenstates .br Initial guess vectors are not necessarily orthonormal `connected_to_ref `_ Undocumented `connected_to_ref_by_mono `_ Undocumented `copy_h_apply_buffer_to_wf `_ Copies the H_apply buffer to psi_coef. After calling this subroutine, N_det, psi_det and psi_coef need to be touched `create_minilist `_ Undocumented `create_minilist_find_previous `_ Undocumented `create_wf_of_psi_bilinear_matrix `_ Generate a wave function containing all possible products of alpha and beta determinants `davidson_converged `_ True if the Davidson algorithm is converged `davidson_criterion `_ Can be : [ energy | residual | both | wall_time | cpu_time | iterations ] `davidson_diag `_ Davidson diagonalization. .br dets_in : bitmasks corresponding to determinants .br u_in : guess coefficients on the various states. Overwritten on exit .br dim_in : leftmost dimension of u_in .br sze : Number of determinants .br N_st : Number of eigenstates .br iunit : Unit number for the I/O .br Initial guess vectors are not necessarily orthonormal `davidson_diag_hjj `_ Davidson diagonalization with specific diagonal elements of the H matrix .br H_jj : specific diagonal H matrix elements to diagonalize de Davidson .br dets_in : bitmasks corresponding to determinants .br u_in : guess coefficients on the various states. Overwritten on exit .br dim_in : leftmost dimension of u_in .br sze : Number of determinants .br N_st : Number of eigenstates .br iunit : Unit for the I/O .br Initial guess vectors are not necessarily orthonormal `davidson_iter_max `_ Max number of Davidson iterations `davidson_sze_max `_ Max number of Davidson sizes `decode_exc `_ Decodes the exc arrays returned by get_excitation. h1,h2 : Holes p1,p2 : Particles s1,s2 : Spins (1:alpha, 2:beta) degree : Degree of excitation `det_alpha_norm `_ Norm of the alpha and beta spin determinants in the wave function: .br ||Da||_i \sum_j C_{ij}**2 `det_beta_norm `_ Norm of the alpha and beta spin determinants in the wave function: .br ||Da||_i \sum_j C_{ij}**2 `det_coef `_ det_coef `det_inf `_ Undocumented `det_occ `_ det_occ `det_search_key `_ Return an integer*8 corresponding to a determinant index for searching `det_to_occ_pattern `_ Transform a determinant to an occupation pattern `diag_algorithm `_ Diagonalization algorithm (Davidson or Lapack) `diag_h_mat_elem `_ Computes `diag_h_mat_elem_fock `_ Computes when i is at most a double excitation from a reference. `diagonalize_ci `_ Replace the coefficients of the CI states by the coefficients of the eigenstates of the CI matrix `diagonalize_ci_mono `_ Replace the coefficients of the CI states by the coefficients of the eigenstates of the CI matrix `diagonalize_ci_sc2 `_ Replace the coefficients of the CI states_diag by the coefficients of the eigenstates of the CI matrix `do_mono_excitation `_ Apply the mono excitation operator : a^{dager}_(i_particle) a_(i_hole) of spin = ispin on key_in ispin = 1 == alpha ispin = 2 == beta i_ok = 1 == the excitation is possible i_ok = -1 == the excitation is not possible `double_exc_bitmask `_ double_exc_bitmask(:,1,i) is the bitmask for holes of excitation 1 double_exc_bitmask(:,2,i) is the bitmask for particles of excitation 1 double_exc_bitmask(:,3,i) is the bitmask for holes of excitation 2 double_exc_bitmask(:,4,i) is the bitmask for particles of excitation 2 for a given couple of hole/particle excitations i. `expected_s2 `_ Expected value of S2 : S*(S+1) `fill_h_apply_buffer_no_selection `_ Fill the H_apply buffer with determiants for CISD `filter_3_highest_electrons `_ Returns a determinant with only the 3 highest electrons `filter_connected `_ Filters out the determinants that are not connected by H .br returns the array idx which contains the index of the .br determinants in the array key1 that interact .br via the H operator with key2. .br idx(0) is the number of determinants that interact with key1 `filter_connected_i_h_psi0 `_ returns the array idx which contains the index of the .br determinants in the array key1 that interact .br via the H operator with key2. .br idx(0) is the number of determinants that interact with key1 `filter_connected_i_h_psi0_sc2 `_ standard filter_connected_i_H_psi but returns in addition .br the array of the index of the non connected determinants to key1 .br in order to know what double excitation can be repeated on key1 .br idx_repeat(0) is the number of determinants that can be used .br to repeat the excitations `first_guess `_ Select all the determinants with the lowest energy as a starting point. `generate_all_alpha_beta_det_products `_ Create a wave function from all possible alpha x beta determinants `get_double_excitation `_ Returns the two excitation operators between two doubly excited determinants and the phase `get_excitation `_ Returns the excitation operators between two determinants and the phase `get_excitation_degree `_ Returns the excitation degree between two determinants `get_excitation_degree_vector `_ Applies get_excitation_degree to an array of determinants `get_index_in_psi_det_alpha_unique `_ Returns the index of the determinant in the ``psi_det_alpha_unique`` array `get_index_in_psi_det_beta_unique `_ Returns the index of the determinant in the ``psi_det_beta_unique`` array `get_index_in_psi_det_sorted_bit `_ Returns the index of the determinant in the ``psi_det_sorted_bit`` array `get_mono_excitation `_ Returns the excitation operator between two singly excited determinants and the phase `get_occ_from_key `_ Returns a list of occupation numbers from a bitstring `get_s2 `_ Returns `get_s2_u0 `_ Undocumented `get_s2_u0_old `_ Undocumented `h_apply_buffer_allocated `_ Buffer of determinants/coefficients/perturbative energy for H_apply. Uninitialized. Filled by H_apply subroutines. `h_apply_buffer_lock `_ Buffer of determinants/coefficients/perturbative energy for H_apply. Uninitialized. Filled by H_apply subroutines. `h_matrix_all_dets `_ H matrix on the basis of the slater determinants defined by psi_det `h_matrix_cas `_ Undocumented `h_u_0 `_ Computes v_0 = H|u_0> .br n : number of determinants .br H_jj : array of `i_h_j `_ Returns where i and j are determinants `i_h_j_phase_out `_ Returns where i and j are determinants `i_h_j_verbose `_ Returns where i and j are determinants `i_h_psi `_ Computes = \sum_J c_J . .br Uses filter_connected_i_H_psi0 to get all the |J> to which |i> is connected. The i_H_psi_minilist is much faster but requires to build the minilists `i_h_psi_minilist `_ Computes = \sum_J c_J . .br Uses filter_connected_i_H_psi0 to get all the |J> to which |i> is connected. The |J> are searched in short pre-computed lists. `i_h_psi_sc2 `_ for the various Nstate .br returns in addition .br the array of the index of the non connected determinants to key1 .br in order to know what double excitation can be repeated on key1 .br idx_repeat(0) is the number of determinants that can be used .br to repeat the excitations `i_h_psi_sc2_verbose `_ for the various Nstate .br returns in addition .br the array of the index of the non connected determinants to key1 .br in order to know what double excitation can be repeated on key1 .br idx_repeat(0) is the number of determinants that can be used .br to repeat the excitations `i_h_psi_sec_ord `_ for the various Nstates `idx_cas `_ CAS wave function, defined from the application of the CAS bitmask on the determinants. idx_cas gives the indice of the CAS determinant in psi_det. `idx_non_cas `_ Set of determinants which are not part of the CAS, defined from the application of the CAS bitmask on the determinants. idx_non_cas gives the indice of the determinant in psi_det. `int_of_3_highest_electrons `_ Returns an integer*8 as : .br |_<--- 21 bits ---><--- 21 bits ---><--- 21 bits --->| .br |0<--- i1 ---><--- i2 ---><--- i3 --->| .br It encodes the value of the indices of the 3 highest MOs in descending order .br `is_connected_to `_ Undocumented `is_in_wavefunction `_ True if the determinant ``det`` is in the wave function `kinetic_ref_bitmask_energy `_ Energy of the reference bitmask used in Slater rules `make_s2_eigenfunction `_ Undocumented `max_degree_exc `_ Maximum degree of excitation in the wf `mono_elec_ref_bitmask_energy `_ Energy of the reference bitmask used in Slater rules `n_det `_ Number of determinants in the wave function `n_det_alpha_unique `_ Unique alpha determinants `n_det_beta_unique `_ Unique beta determinants `n_det_cas `_ CAS wave function, defined from the application of the CAS bitmask on the determinants. idx_cas gives the indice of the CAS determinant in psi_det. `n_det_max `_ Max number of determinants in the wave function `n_det_max_jacobi `_ Maximum number of determinants diagonalized by Jacobi `n_det_max_property `_ Max number of determinants in the wave function when you select for a given property `n_det_non_cas `_ Set of determinants which are not part of the CAS, defined from the application of the CAS bitmask on the determinants. idx_non_cas gives the indice of the determinant in psi_det. `n_double_exc_bitmasks `_ Number of double excitation bitmasks `n_occ_pattern `_ array of the occ_pattern present in the wf psi_occ_pattern(:,1,j) = jth occ_pattern of the wave function : represent all the single occupation psi_occ_pattern(:,2,j) = jth occ_pattern of the wave function : represent all the double occupation `n_single_exc_bitmasks `_ Number of single excitation bitmasks `n_states `_ Number of states to consider `n_states_diag `_ Number of states to consider for the diagonalization `nucl_elec_ref_bitmask_energy `_ Energy of the reference bitmask used in Slater rules `occ_pattern_search_key `_ Return an integer*8 corresponding to a determinant index for searching `occ_pattern_to_dets `_ Generate all possible determinants for a give occ_pattern `occ_pattern_to_dets_size `_ Number of possible determinants for a given occ_pattern `one_body_dm_mo `_ One-body density matrix `one_body_dm_mo_alpha `_ Alpha and beta one-body density matrix for each state `one_body_dm_mo_beta `_ Alpha and beta one-body density matrix for each state `one_body_single_double_dm_mo_alpha `_ Alpha and beta one-body density matrix for each state `one_body_single_double_dm_mo_beta `_ Alpha and beta one-body density matrix for each state `one_body_spin_density_mo `_ rho(alpha) - rho(beta) `only_single_double_dm `_ If true, The One body DM is calculated with ignoring the Double<->Doubles extra diag elements `psi_average_norm_contrib `_ Contribution of determinants to the state-averaged density `psi_average_norm_contrib_sorted `_ Wave function sorted by determinants contribution to the norm (state-averaged) `psi_bilinear_matrix `_ Coefficient matrix if the wave function is expressed in a bilinear form : D_a^t C D_b `psi_bilinear_matrix_columns `_ Sparse coefficient matrix if the wave function is expressed in a bilinear form : D_a^t C D_b `psi_bilinear_matrix_rows `_ Sparse coefficient matrix if the wave function is expressed in a bilinear form : D_a^t C D_b `psi_bilinear_matrix_values `_ Sparse coefficient matrix if the wave function is expressed in a bilinear form : D_a^t C D_b `psi_cas `_ CAS wave function, defined from the application of the CAS bitmask on the determinants. idx_cas gives the indice of the CAS determinant in psi_det. `psi_cas_coef `_ CAS wave function, defined from the application of the CAS bitmask on the determinants. idx_cas gives the indice of the CAS determinant in psi_det. `psi_cas_coef_sorted_bit `_ CAS determinants sorted to accelerate the search of a random determinant in the wave function. `psi_cas_energy `_ Undocumented `psi_cas_energy_diagonalized `_ Undocumented `psi_cas_sorted_bit `_ CAS determinants sorted to accelerate the search of a random determinant in the wave function. `psi_coef `_ The wave function coefficients. Initialized with Hartree-Fock if the EZFIO file is empty `psi_coef_cas_diagonalized `_ Undocumented `psi_coef_max `_ Max and min values of the coefficients `psi_coef_min `_ Max and min values of the coefficients `psi_coef_sorted `_ Wave function sorted by determinants contribution to the norm (state-averaged) `psi_coef_sorted_ab `_ Determinants on which we apply . They are sorted by the 3 highest electrons in the alpha part, then by the 3 highest electrons in the beta part to accelerate the research of connected determinants. `psi_coef_sorted_bit `_ Determinants on which we apply for perturbation. They are sorted by determinants interpreted as integers. Useful to accelerate the search of a random determinant in the wave function. `psi_det `_ The wave function determinants. Initialized with Hartree-Fock if the EZFIO file is empty `psi_det_alpha `_ List of alpha determinants of psi_det `psi_det_alpha_unique `_ Unique alpha determinants `psi_det_beta `_ List of beta determinants of psi_det `psi_det_beta_unique `_ Unique beta determinants `psi_det_size `_ Size of the psi_det/psi_coef arrays `psi_det_sorted `_ Wave function sorted by determinants contribution to the norm (state-averaged) `psi_det_sorted_ab `_ Determinants on which we apply . They are sorted by the 3 highest electrons in the alpha part, then by the 3 highest electrons in the beta part to accelerate the research of connected determinants. `psi_det_sorted_bit `_ Determinants on which we apply for perturbation. They are sorted by determinants interpreted as integers. Useful to accelerate the search of a random determinant in the wave function. `psi_det_sorted_next_ab `_ Determinants on which we apply . They are sorted by the 3 highest electrons in the alpha part, then by the 3 highest electrons in the beta part to accelerate the research of connected determinants. `psi_non_cas `_ Set of determinants which are not part of the CAS, defined from the application of the CAS bitmask on the determinants. idx_non_cas gives the indice of the determinant in psi_det. `psi_non_cas_coef `_ Set of determinants which are not part of the CAS, defined from the application of the CAS bitmask on the determinants. idx_non_cas gives the indice of the determinant in psi_det. `psi_non_cas_coef_sorted_bit `_ CAS determinants sorted to accelerate the search of a random determinant in the wave function. `psi_non_cas_sorted_bit `_ CAS determinants sorted to accelerate the search of a random determinant in the wave function. `psi_occ_pattern `_ array of the occ_pattern present in the wf psi_occ_pattern(:,1,j) = jth occ_pattern of the wave function : represent all the single occupation psi_occ_pattern(:,2,j) = jth occ_pattern of the wave function : represent all the double occupation `put_gess `_ Undocumented `read_dets `_ Reads the determinants from the EZFIO file `read_wf `_ If true, read the wave function from the EZFIO file `rec_occ_pattern_to_dets `_ Undocumented `ref_bitmask_energy `_ Energy of the reference bitmask used in Slater rules `remove_duplicates_in_psi_det `_ Removes duplicate determinants in the wave function. `resize_h_apply_buffer `_ Resizes the H_apply buffer of proc iproc. The buffer lock should be set before calling this function. `s2_eig `_ Force the wave function to be an eigenfunction of S^2 `s2_values `_ array of the averaged values of the S^2 operator on the various states `s_z `_ z component of the Spin `s_z2_sz `_ z component of the Spin `save_natorb `_ Undocumented `save_natural_mos `_ Save natural orbitals, obtained by diagonalization of the one-body density matrix in the MO basis `save_wavefunction `_ Save the wave function into the EZFIO file `save_wavefunction_general `_ Save the wave function into the EZFIO file `save_wavefunction_specified `_ Save the wave function into the EZFIO file `save_wavefunction_unsorted `_ Save the wave function into the EZFIO file `set_bit_to_integer `_ Undocumented `set_natural_mos `_ Set natural orbitals, obtained by diagonalization of the one-body density matrix in the MO basis `single_exc_bitmask `_ single_exc_bitmask(:,1,i) is the bitmask for holes single_exc_bitmask(:,2,i) is the bitmask for particles for a given couple of hole/particle excitations i. `sort_dets_ab `_ Uncodumented : TODO `sort_dets_ab_v `_ Uncodumented : TODO `sort_dets_ba_v `_ Uncodumented : TODO `sort_dets_by_3_highest_electrons `_ Determinants on which we apply . They are sorted by the 3 highest electrons in the alpha part, then by the 3 highest electrons in the beta part to accelerate the research of connected determinants. `sort_dets_by_det_search_key `_ Determinants are sorted are sorted according to their det_search_key. Useful to accelerate the search of a random determinant in the wave function. `spin_det_search_key `_ Return an integer*8 corresponding to a determinant index for searching `state_average_weight `_ Weights in the state-average calculation of the density matrix `tamiser `_ Uncodumented : TODO `target_energy `_ Energy that should be obtained when truncating the wave function (optional) `threshold_convergence_sc2 `_ convergence of the correlation energy of SC2 iterations `threshold_davidson `_ Thresholds of Davidson's algorithm `threshold_generators `_ Thresholds on generators (fraction of the norm) `threshold_selectors `_ Thresholds on selectors (fraction of the norm) `write_spindeterminants `_ Undocumented