Unified GFN2-xTB SCC result. More...

#include <xtb_result.h>

Public Attributes
double	scc_energy {0.0}
	SCC contribution (electronic + isotropic Coulomb + 3rd-order + AES + on-site polariz, where applicable).

double	repulsion_energy {0.0}
	Closed-form repulsion energy (Hartree).

double	dispersion_energy {0.0}
	D4 dispersion energy (Hartree). Zero if dispersion is disabled.

double	total_energy {0.0}
	scc_energy + repulsion_energy + dispersion_energy (Hartree).

Vec	shell_charges
	Per-shell partial charges q_shell = ref_occ − Mulliken_pop.

Vec	atomic_charges
	Per-atom partial charges q_atom = Σ q_shell over the atom's shells.

Vec	orbital_energies
	Orbital energies ε at Γ (Hartree). Length = N_basis.

Vec	orbital_occupations
	Orbital occupations n_i (0..2 for closed shell). Length = N_basis.

Mat	density_matrix
	Density matrix P at Γ (closed-shell, summed over both spins).

Mat	overlap_matrix
	Overlap matrix S at Γ (cached for downstream property analysis).

Mat	orbital_coefficients
	Orbital coefficients C at Γ (closed-shell).

int	n_iterations {0}
	Number of SCC iterations actually run.

bool	converged {false}
	True if the SCC converged within the iteration / threshold limits.

std::optional< SolvationSurfaces >	solvation_surfaces
	Per-element solvation surfaces (Phase 7D).

Detailed Description

Unified GFN2-xTB SCC result.

Used by both the molecular and periodic (Γ-only / k-point) drivers. For the periodic case, MO-related fields (orbital_energies, density_matrix, overlap_matrix, orbital_coefficients) are reported at the Γ point.

Member Data Documentation

◆ atomic_charges

Vec occ::xtb::XtbResult::atomic_charges

Per-atom partial charges q_atom = Σ q_shell over the atom's shells.

Length = N_atoms.

◆ converged

bool occ::xtb::XtbResult::converged {false}

True if the SCC converged within the iteration / threshold limits.

◆ density_matrix

Mat occ::xtb::XtbResult::density_matrix

Density matrix P at Γ (closed-shell, summed over both spins).

◆ dispersion_energy

double occ::xtb::XtbResult::dispersion_energy {0.0}

D4 dispersion energy (Hartree). Zero if dispersion is disabled.

◆ n_iterations

int occ::xtb::XtbResult::n_iterations {0}

Number of SCC iterations actually run.

◆ orbital_coefficients

Mat occ::xtb::XtbResult::orbital_coefficients

Orbital coefficients C at Γ (closed-shell).

◆ orbital_energies

Vec occ::xtb::XtbResult::orbital_energies

Orbital energies ε at Γ (Hartree). Length = N_basis.

◆ orbital_occupations

Vec occ::xtb::XtbResult::orbital_occupations

Orbital occupations n_i (0..2 for closed shell). Length = N_basis.

◆ overlap_matrix

Mat occ::xtb::XtbResult::overlap_matrix

Overlap matrix S at Γ (cached for downstream property analysis).

◆ repulsion_energy

double occ::xtb::XtbResult::repulsion_energy {0.0}

Closed-form repulsion energy (Hartree).

◆ scc_energy

double occ::xtb::XtbResult::scc_energy {0.0}

SCC contribution (electronic + isotropic Coulomb + 3rd-order + AES + on-site polariz, where applicable).

Hartree.

◆ shell_charges

Vec occ::xtb::XtbResult::shell_charges

Per-shell partial charges q_shell = ref_occ − Mulliken_pop.

Length = N_shells.

◆ solvation_surfaces

std::optional<SolvationSurfaces> occ::xtb::XtbResult::solvation_surfaces

Per-element solvation surfaces (Phase 7D).

Populated only when an XtbSolvationModel is attached that exposes surface data — CPCM-X fills coulomb; SMD fills both coulomb and cds; NullSolvationModel leaves this empty.

◆ total_energy

double occ::xtb::XtbResult::total_energy {0.0}

scc_energy + repulsion_energy + dispersion_energy (Hartree).

The documentation for this struct was generated from the following file:

/home/runner/work/occ/occ/include/occ/xtb/xtb_result.h

Public Attributes