χ-CCM / aiccm2026dev-b decisions and open questions¶
Last updated: 2026-08-26.
Decisions¶
ID |
Decision |
Reason |
|---|---|---|
D1 |
Define the method as a finite BvK torus constrained to primitive-translation-invariant RHF determinants. |
Gives a precise Hamiltonian, variational space, and finite-size problem. |
D2 |
Evaluate the cyclic Gamma-supercell problem through the full unreduced Gamma-centred character mesh. |
Exact finite-group Fourier equivalence; reuses the validated SCF/integral infrastructure. |
D3 |
Use Wigner–Seitz weights only to partition tied minimum-image representatives of one translation class. |
Weights sum to one and preserve one- and two-electron permutation symmetries. |
D4 |
Reject the historical pair-product four-centre weighting. |
Its displayed factors are not generally invariant under bra–ket interchange, so a conventional RHF scalar functional does not follow. |
D5 |
In 3D use the common neutral periodic Ewald/GDF gauge, remove the Hartree (G=0) mode, and apply the BvK-supercell exchange Madelung correction. |
Keeps electron–electron, electron–nuclear, nucleus–nucleus, and exchange finite-size conventions consistent in the 3D route. |
D6 |
Reject charged cells and smearing in Phase 1. |
Both require a different explicitly stated variational functional/background convention. |
D7 |
Keep the existing CCM untouched and expose |
Allows head-to-head comparison with no behaviour change to the peer implementation. |
D8 |
Reuse native GDF, Ewald, basis, lattice, canonical orthogonalisation, DIIS, and output infrastructure. |
These are not AICCM-specific; duplicating them would reduce comparability and correctness. |
D9 |
Accept only the pair-resolved RSGDF or MDF fit; reject the q-only |
The latter is not a consistent four-centre finite-torus Hamiltonian on tight cells and has known non-physical fixed points. |
D10 |
Initialise the existing periodic citation flag for non- |
The repo-wide gate exposed an unrelated unbound local in citation output. The false default restores the intended existing behaviour and does not alter any SCF result. |
D11 |
Refresh two stale k-point recommender assertions found by the repo-wide gate. |
They still expected the retired ungated-model error and Fermi–Dirac default, while the shipped implementation and changelog specify the environment gate and Methfessel–Paxton default. Production behaviour is unchanged. |
D12 |
Expose three independently selectable integral backends: |
They allow direct-versus-three-centre consistency tests when their dimensional Coulomb gauges are matched. |
D13 |
Reuse the corrected-gauge BIPOLE Fock engine for |
The former contains direct four-centre short-range J/K plus the reciprocal long-range and BvK exchange correction. The legacy path is documented upstream as missing the exchange correction. This identifies the intended corrected-gauge algebra; D82 separately records that the current short-range internal traversal is not yet basis-independently converged. |
D14 |
Permit production χ-CCM-B SCF only for 3D cells until a shared 1D/2D mixed-boundary Coulomb kernel is derived. |
The finite group is dimension independent, but the Coulomb kernel is not. The current lower-dimensional four-center path uses a direct-truncated BIPOLE fallback rather than a neutral finite-torus wire/slab gauge, and the shared neutral-RI/GDF mesh collapses transverse Fourier components to (G_\perp=0), giving a transverse-uniform sheet term rather than (1/r). Returning lower-dimensional absolute energies from either family would be silent scientific corruption. |
D15 |
Fail closed for RI/RIJCOSX RKS and RIJCOSX RHF at a one-cell mesh. |
The native Gamma-only RKS GDF path is not pair-resolved and the COSX bridge is multi-k only; silently falling back would mislabel the backend. |
D16 |
Audit the 2008 deMon2k KS-ADFT CCM separately from the 2014 four-center formula. |
Janetzko et al. use multiplicative occurrence weights, but their Eq. (20) explicitly averages both AO-center orderings. The same bra–ket diagnosis cannot be copied without checking that symmetrization; quotient-space adjoint consistency and long-range truncation remain open. |
D17 |
Superseded by D88. Transpose the repository’s row-lattice array when constructing the mathematical lattice generator. |
This historical decision incorrectly asserted that |
D18 |
Build χ-CCM MP2 from the χ-CCM RI-RHF character-mesh reference, not the existing toroidal Gamma-supercell HF helper. |
The two references differ by 4.6408868 mHa per cell on the two-cell 8 x 12 x 12 bohr H2 control, so substituting the latter changes the finite zeroth-order Hamiltonian. |
D19 |
Use a truncated metric inverse square root expressed in the original auxiliary-AO basis for post-HF momentum blocks. |
Compact eigenspace factors have arbitrary phases and rotations independently at (q) and (-q). The canonical matrix function removes that gauge from cross-block MP2 contractions. |
D20 |
Expose canonical RI-MP2 initially for 3D neutral closed-shell systems and fail closed for 1D/2D. |
The 3D two-point H2 result agrees with external KRHF/KMP2 below one nanohartree per cell. The lower-dimensional long-range convention remains O1 and cannot yet support a single reference Hamiltonian. |
D21 |
Transform the pair-resolved RI Hamiltonian to a real finite torus before local correlation. |
The derived (N_c^{-2}) inverse transform reproduces the momentum-space RI integral normalization exactly and preserves the χ-CCM reference instead of substituting the legacy Gamma-supercell Hamiltonian. |
D22 |
Count every occupied pair and ordered triples contribution on the finite torus, then divide the total correlation energy by (N_c). |
This is unambiguous and passes the exact-limit oracle. Translation-reduced pair/triple orbits require an orbit-stabilizer derivation and are not approximated by occurrence weights. |
D23 |
Use PBC-safe Pipek–Mezey occupied localization; reject molecular Foster–Boys localization. |
Mulliken populations do not require the ordinary position operator, which is discontinuous on the torus boundary. |
D24 |
Keep pair-distance screening, finite occupied-coupling radii, and local fitting disabled in the B local-correlation route. |
The existing molecular algorithms use Euclidean distances. Minimum-image Wannier and auxiliary domains are required before those approximations can preserve translation symmetry. PNO truncation itself remains available. |
D25 |
Localize one complete finite-torus occupied space, never independent k blocks. |
A single unitary rotation preserves the occupied projector, density, and SCF energy exactly and produces translationally related occupied orbitals for local correlation. |
D26 |
Label the present periodic spread as a projected circular AO-centre approximation, not an exact Marzari–Vanderbilt spread. |
Exact continuum localization needs cross-k exponential-position matrix elements that the integral API does not yet expose. |
D27 |
Construct B-specific PAOs with the metric projector and canonical Gram orthogonalization, and construct PNOs from a Hermitian positive-semidefinite pair density. |
The algebra removes occupied leakage and PAO redundancy and gives nested PNO ranks as the occupation threshold is tightened. MP2 energy errors are not variational and need numerical validation. |
D28 |
Enumerate occupied-pair orbits by closure under measured localization translation permutations, but do not skip representative pairs yet. |
Orbit multiplicities are exact only after translation covariance is proven. The current Wannier control passes, while finite-supercell IAO cross overlaps leave a residual near (10^{-5}). Representative-only amplitude scattering has no energy-parity gate yet. |
D29 |
Expose space-group symmetry as an off-by-default diagnostic and fail closed for integral reduction. |
The compatible finite-cluster subgroup, nonsymmorphic atom/cell maps, irreducible k orbits, and primitive shell-pair/quartet orbit partitions are derived. General-k AO sewing matrices and representative scatter are not yet proven in every backend convention. |
D30 |
Before the real local solver, construct and verify a full-rank real time-reversal gauge; at the complete-domain, zero-PNO-threshold MP2 limit, audit the result with an independent rotation-invariant full-space DF-MP2 contraction. |
The first integration exposed unsafe complex-to-real casts in a solver whose equations are real. Explicit realification preserves the occupied projector. The public result reports both the raw value and any full-space correction. No correction is applied to truncated calculations. |
D31 |
Make the real-space lattice extension the primary user parameter and derive the full Gamma-centered character net from it. |
The method is a finite BvK torus, not two independently converged real- and reciprocal-space approximations. A shell radius (s_i) means (N_i=2s_i+1); the old mesh tuple remains only an exact compatibility alias. |
D32 |
Extend UHF and UKS with independent alpha and beta idempotent projectors on the same declared finite Hamiltonian. |
Spin changes the variational ranks and exchange contractions, not the translation quotient, Wigner–Seitz partition, or finite-torus convention. Separate density, electron-count, and spin-contamination audits make this explicit. |
D33 |
Build unrestricted post-HF from the exact real transform of the χ-CCM RI-UHF Hamiltonian. |
Reusing a molecular or legacy Gamma reference would change the finite zeroth-order Hamiltonian. The supercell multiplicity is (N_c(M-1)+1), preserving the spin difference in every primitive cell. |
D34 |
Treat the present unrestricted DLPNO-UCCSD(T) engine as an O(N^6) correctness oracle. |
Full-domain projection proves the PNO exact limit, but translation-representative amplitude propagation and minimum-image domains are not implemented. Calling it production reduced scaling would be false. |
D35 |
Expose only gauge-invariant SCF properties derivable from the finite-net one-particle density. |
Electron/spin counts, Mulliken populations, finite-net gaps, idempotency, and ⟨S²⟩ are defined. Cell dipoles, Berry-phase polarization, analytic response, and correlated properties need additional theory and fail closed. |
D36 |
Move the B post-HF finite-torus setup kernels to native OpenMP code, but keep the equations and parity tests in Python-visible form. |
The inverse RI-factor transform and AO-to-MO contractions are performance and memory bottlenecks. The native RI transform streams directly to the final real tensor instead of materialising the former six-dimensional complex temporary. The public method semantics do not change. |
D37 |
Fail closed for 1D/2D four-center absolute energies rather than preserving the old vacuum-H2 molecular-limit shortcut. |
The shortcut geometry did not test the uniform h-chain/lih-chain/polyethylene F1 class. The benchmark wave confirmed a mesh-independent, (Z)-scaled Madelung-size over-binding in real chain inputs, so the lower-dimensional four-center route is disabled until its neutral Green function is derived and tested. |
D38 |
Surface SCF residuals and accelerator settings in every χ-CCM SCF diagnostic record. |
The c-diamond and si-diamond RKS/PBE/RI queue failures reached the iteration cap with clean density idempotency and electron count, but the old JSON did not preserve the final commutator norm, energy step, or effective accelerator controls. Without those residuals one cannot distinguish a physical/gauge error, a true two-cycle, or an accelerator that is simply outside its basin. This is diagnostic hardening only; it does not change the finite Hamiltonian or mark the failed jobs as acceptable. |
D39 |
Make the RSGDF reciprocal mesh respect the declared periodic dimensionality. |
Low-dimensional χ-CCM routes embed chains and slabs in large vacuum-padding axes. The previous RSGDF dense mesh treated those inactive axes as periodic and built a full 3D sphere, so h-chain/lih-chain RI jobs appeared to hang at the per-pair (L_{P\mu\nu}) cache. The fix freezes inactive reciprocal indices at zero for |
D40 |
Stream the canonical χ-CCM RI-MP2 energy contraction in native OpenMP code. |
The earlier Python loop materialised one (O(n_o^2 n_v^2)) |
D41 |
Build multi-k RKS XC from the full inverse-Bloch real-space density and Bloch-fold (V_\mathrm{xc}(R)) back to each k point. |
A local or semilocal XC functional is periodic in the primitive cell, but its AO matrix elements are lattice matrices. Collapsing the finite-torus density to one Gamma AO block and adding the same (V_\mathrm{xc}) to all k points is exact only in the molecular/vacuum limit and is not a variational KS map for tight crystals. |
D42 |
Attach an explicit finite-torus convention descriptor to χ-CCM SCF and post-HF results: |
Finite-N HF, MP2, CCSD(T), and DLPNO denominators depend on the exchange q=0 seam through the reference orbital energies. A strict-zero-mode reference is a different finite Hamiltonian with the same thermodynamic target, so it must not compare silently as the production χ-CCM Hamiltonian. The non-rank-1 Madelung remainder is finite-size physics of the same (v_E), not RI error or gauge freedom. |
D43 |
Carry the same finite-torus convention descriptor into χ-CCM SCF properties, band structures, and Mayer bond analyses. |
Electron counts, Mulliken charges, finite-net gaps, spin diagnostics, interpolated bands, and Mayer bond orders are one-particle analyses of the declared finite Hamiltonian. The formulas do not gain an extra convention factor, but the outputs must keep the Hamiltonian label so QVF, JSON, and manuscript comparisons cannot mix BvK-Ewald exchange with strict-zero-mode or low-dimensional kernels silently. |
D44 |
Treat ECP electron and background bookkeeping as part of the finite Hamiltonian descriptor, not as a backend detail. |
A periodic ECP removes core electrons from the variational space and replaces bare nuclear charges by (Z_\mathrm{eff}). χ-CCM now validates that |
D45 |
Contract χ-CCM Mayer bond orders from finite-torus residue blocks in native OpenMP code and fold the compact residue tensor directly. |
The dense reference formula first materialises full AO supercell density and overlap matrices, multiplies them, and then folds a full atom-supercell pair matrix. The block-circulant identity ((PS)(\Delta)=\sum_G P(G)S(\Delta-G)) gives the same residue-resolved atom-pair tensor (M_{AB}(\Delta)) while storing only (N_c n_\mathrm{AO}^2) intermediate data plus (N_c n_\mathrm{atom}^2) Mayer data. The full-matrix path remains only as a compatibility and regression oracle. |
D46 |
Build the χ-CCM post-HF momentum-conservation table in native OpenMP code. |
RI-MP2 and local-correlation setup need the finite-group map (k_b=k_i-k_a+k_j) modulo reciprocal lattice vectors. The mathematical object is unchanged, including duplicate-character and non-closed-mesh rejection, but the (O(N_k^3)) loop no longer runs in Python. |
D47 |
Reuse the native finite-character matrix transform for localization overlap and Fock matrices. |
Occupied localization needs real finite-torus overlap and Fock matrices before the unitary gauge search. The old Python einsum path is retained as a test oracle, but production now uses the same OpenMP transform as post-HF and fails closed if a non-negligible imaginary residue would otherwise be discarded. |
D48 |
Back-transform canonical χ-CCM occupied Bloch coefficients to Wannier coefficients in native OpenMP code. |
The formula (w_{Rn}=\frac{1}{N}\sum_k e^{ikT}C_{kn}e^{-ikR}) is unchanged, but the old Python einsum materialised a four-index temporary over target cell, AO, home cell, and band. The native route streams directly into the final real-torus coefficient matrix and keeps the einsum path as a regression oracle. |
D49 |
Expose the RSGDF kinetic-energy cutoff at the high-level periodic runner and print it in the χ-CCM log. |
RI and RIJCOSX finite-N energies depend on the declared fitting representation and reciprocal auxiliary mesh. The direct B APIs already had |
D50 |
Stream canonical χ-CCM RI-MP2 pair factors from AO-space |
Canonical character-space MP2 only needs (L_{Pia}(k_i,k_a)), not the full AO-space (L_{P\mu\nu}(k_i,k_a)) cache. The MP2 route now builds one pair-resolved |
D51 |
Release χ-CCM RI temporaries immediately after their last mathematical use. |
The AO-space pair cache is cleared as soon as the real-torus cderi tensor has been formed, and the canonical MP2 |
D52 |
Partition χ-CCM local-correlation occupied-pair orbits in a native finite-group kernel. |
The mathematical object is still the breadth-first closure of unordered occupied pairs under the supplied translation and optional point-group permutations. The implementation no longer builds that closure with Python sets on production paths; it returns representatives, offsets, and flattened members from a private native kernel while retaining the Python closure as the test oracle. |
D53 |
Stream the real-torus complete-domain MP2 audit contraction in native OpenMP code. |
Local-PNO exact-limit corrections need the full-domain MP2 energy on the real finite torus, but they do not need the full (ijab) tensor to be resident. The native kernel contracts (L_{Pia}L_{Pjb}) and (L_{Pib}L_{Pja}) directly inside the denominator loop and keeps the old tensor expression as a regression oracle. |
D54 |
Build finite-translation occupied-index permutations in the private native χ-CCM kernel layer. |
The permutations still represent simultaneous cyclic translations of all localized occupied orbitals, ordered by the same lexicographic finite-torus cell convention. Moving the table generator out of Python removes another setup loop before the native occupied-pair orbit closure, without changing the local-correlation approximation level. |
D55 |
Move the finite-character inverse Bloch transform for residue blocks to native OpenMP code. |
The transform (M(R)=\sum_k w_k\exp(-2\pi i k\cdot R)M(k)) defines density and property residue blocks throughout χ-CCM diagnostics. The native kernel streams over requested residues and matrix elements directly, preserving arbitrary normalized k weights and retaining the former einsum as a regression formula. |
D56 |
Expose χ-CCM analytic-gradient status as a B-owned fail-closed API. |
Γ-CCM now has an analytic gradient for its separately constructed union-and-weight energy, but χ-CCM production numbers declare the finite-character Hamiltonian with |
D57 |
Expose the 3-D Ewald nuclear-repulsion gradient as a χ-CCM-B component helper, not as a total force. |
|
D58 |
Expose the fixed-density 3-D Ewald electron-nuclear gradient as a χ-CCM-B component helper. |
|
D59 |
Bundle the fixed-density 3-D Ewald electrostatic gradient components without exposing a total force. |
|
D60 |
Expose χ-CCM-B SCF density folding for fixed-density gradient components. |
|
D61 |
Expose the SCF-density 3-D Ewald electrostatic component bundle without exposing a force. |
|
D62 |
Expose matching fixed-density 3-D Ewald electrostatic energy bundles for component finite-difference audits. |
|
D63 |
Require exact lattice-cell and AO-space support for explicit fixed-density Ewald electrostatic audits. |
The explicit |
D64 |
Validate unrestricted SCF-density spin metadata before folding stored density blocks. |
|
D65 |
Validate restricted SCF-density electron metadata before folding stored density blocks. |
|
D66 |
Validate stored SCF k-density AO dimensions before real-torus folding. |
|
D67 |
Stream the finite-cutoff multi-k Ewald Hartree J output-cell contraction used by BIPOLE comparisons. |
|
D68 |
Emit optional χ-CCM-B Wannier-centre overlays as a QVF vendor section. |
|
D69 |
Fold stored RI/RIJCOSX k-density blocks when emitting χ-CCM-B periodic QVF grids. |
Four-center B results can expose real-space lattice density aliases directly, but RI and RIJCOSX store the converged finite-character density per k point. The QVF path now inverse-Bloch folds those k-density blocks onto the cyclic residues before expanding the BvK supercell density grid, so multi-cell 3D RI/RIJCOSX B archives carry the same torus-spanning periodic-grid contract as four-center B archives. |
D70 |
Regression-test vibe-view’s χ-CCM-B QVF periodic contract on 3D controls. |
The QVF writer tests now include a 3D vacuum-padded H-chain RI control and a compact 3D periodic H2-pair RI control with |
D71 |
Cover unrestricted χ-CCM-B QVF output with spin-summed density and alpha/beta Wannier overlays. |
The UHF/RI H3 doublet regression validates the upstream odd-electron periodic-output multiplicity normalization against the B route: the archive keeps the declared 3D finite-torus convention, writes a torus-spanning alpha-plus-beta density grid, and emits two alpha plus one beta |
D72 |
Adopt the shared lower-dimensional neutral-RI/GDF fail-closed guard for χ-CCM-B RI and RIJCOSX. |
The upstream 2026-07-10 audit showed that the lower-dimensional neutral-RI mesh is not merely a different gauge: by pinning every vacuum-axis reciprocal component to zero, it removes transverse Coulomb structure and produces vacuum-padding artifacts. χ-CCM-B therefore now fails closed for 1D/2D RI and RIJCOSX just as it already did for 1D/2D four-center, until O1 supplies one shared wire/slab Hamiltonian with matched electron-electron, electron-nuclear, nuclear, and exchange-seam terms. Fleet and paper route generators must keep every lower-dimensional row as explicit unsupported coverage rather than submitting it as a runnable calculation. |
D73 |
Historically fail closed for every proposed Γ/χ energy delta unless both records carry one complete paired producer and numerical-input contract (superseded by D89’s empty approach map). |
Route names and the exchange-q=0 label identify an intended pairing but do not prove the same numerical realization or construction. A reportable control value requires finite converged energies, the same clean full source SHA, native-core SHA256, versioned successful host probe, canonical input SHA256, 3D boundary/kernel, two-electron operator, auxiliary basis, RSGDF method/cutoff, linear-dependence threshold, and auxiliary phase convention. Contract v1 is RSGDF-only because it does not fingerprint MDF’s active cutoff. Conflicting payload aliases or missing/mismatched fields leave the control undefined, including raw JSON. The historical map excluded pure-PBE RI, the research WSSC |
D74 |
Supersede v1 with the |
The previously mapped A RI and RIJCOSX routes call the same multi-k GDF SCF drivers as B, so their agreement is common-path regression evidence rather than a Γ/χ representation delta. Contract v2 requires each producer to embed |
D75 |
Make the two historical benchmark producers’ attestations symmetric before revising or emitting the numerical-input schema. |
Both benchmark producers now derive the source commit and cleanliness from the checkout providing imported |
D76 |
Serialize the resolved 3D direct electronic and nuclear lattice cutoffs in every χ-CCM-B four-center benchmark record. |
The shared BIPOLE fix in |
D77 |
Replace D75’s pre-run-only producer evidence with a composite producer-process attestation. |
The cached |
D78 |
Build each Bloch RSGDF factor on the physical shifted reciprocal sphere `0 < |
G+q |
D79 |
Expose the fixed-density kinetic scalar and AO-centre derivative as a separate 3D χ-CCM-B gradient component. |
|
D80 |
Expose a fixed energy-weighted overlap Lagrangian scalar and AO-centre derivative as a separate 3D χ-CCM-B gradient component. |
|
D81 |
Partly superseded by D88. Bind every χ-CCM-B gradient component audit and SCF-density fold to the recorded finite torus before adding another derivative term. |
The mesh, boundary, descriptor-agreement, and complete-character-net requirements remain valid. Its historical row-vector premise and |
D82 |
Treat two-electron numerical-support convergence as a separate reportability requirement for active 3D χ-CCM-B backends. |
The MgO split audit in |
D83 |
Record whether the declared exchange-q=0 convention is active in the actual operator. |
|
D84 |
Render an absent Γ/χ comparison as |
D89 retains the explicit |
D85 |
Bind the future stationary χ-CCM energy-weighted density to the final variational Fock, occupied space, and complete numerical realization before assembling D80 into a Pulay term. |
For each character and spin, construct |
D86 |
Define the existing χ-CCM-B Fock-mixing diagnostic as the executed effective previous-Fock weight, while |
Four-center RKS/UKS can resolve requested |
D87 |
Give every χ-CCM-B direct SCF runner one explicit Fock-mixing override rule, and fail closed where the selected route cannot execute the resolved request without changing operators. |
A non- |
D88 |
Repair χ-CCM-B lattice algebra and shared periodic fingerprints to the authoritative column-vector convention. |
|
D89 |
Supersede the premise that Γ-CCM and χ-CCM are merely representation labels or are globally unitarily equivalent by name; empty the reportable Γ/χ approach-comparison map. |
Γ-CCM and χ-CCM are distinct CCM approaches. Γ-CCM uses the union-and-weight/Wigner–Seitz integral-weighting construction; χ-CCM uses the finite-translation-group character construction. They are compared at a declared common exchange-q=0 convention. Their distinction is not a choice of Coulomb kernels, and equality for a specified operator/route is evidence to establish, not a naming premise. The current |
D90 |
Classify each route by an explicitly bound construction, not by namespace ownership, evaluation representation, or inherited solver ancestry. |
A-line ownership, real-Gamma evaluation, and reuse of an existing post-HF solver do not confer union-and-weight Γ-CCM identity. The mixed-boundary implementation in |
D91 |
Define the acceptance contract for a future immutable deployment-bundle attestation when clean-checkout identity is structurally unavailable. |
A reportable bundle-attested row would have to bind the immutable artifact bytes to a full source SHA proven resolvable on |
D92 |
Expose the fixed-density restricted active BvK exchange-q=0 seam scalar and AO-centre derivative as a separate χ-CCM-B gradient component. |
|
D93 |
Enforce D82 with a route-specific |
Successful and non-converged fleet records must carry an exact support payload. Current four-center RHF, PBE, and PBE0 rows qualify only when the producer preserves the executed low-level |
D94 |
Expose the fixed-density unrestricted active BvK exchange-q=0 seam scalar and AO-centre derivative as a separate χ-CCM-B gradient component. |
|
D95 |
Record the route-resolved exact-exchange assembly in a B-owned result descriptor. |
|
D96 |
Make the D95 exact-exchange assembly an independently validated fleet acceptance contract. |
|
D97 |
Fail closed on every nonzero unrestricted χ-CCM-B level-shift request until one spin-projector operator is implemented and parity-tested across all backends. |
For a restricted density (D=2P), the virtual-space shift is (F_b=F+bS-(b/2)SDS). For an unrestricted spin projector (P_\sigma), the matching operator is (F^\sigma_b=F^\sigma+bS-bSP_\sigma S). The current four-center UHF/UKS loop instead applies the restricted |
D98 |
Version the exact-exchange assembly descriptor and bind its screened-branch label to executed BIPOLE evidence. |
|
D99 |
Pin the shared 3D Ewald nuclear assembly and inherited fitted-support guards at the χ-CCM-B selector. |
Since shared commit |
D100 |
Evaluate χ-CCM-B localization projector diagnostics from native low-rank identities instead of materialized AO projectors. |
For canonical and localized occupied coefficient matrices |
D101 |
Add a dedicated D77-only high-level χ-CCM-B route-control producer for the pinned 1D/2D/3D campaign without admitting an RI absolute energy. |
|
D102 |
Historically quarantine the shared 3D Ewald nuclear scalar until the shifted-pair cutoff defect is repaired and rerun. |
Incoming |
D103 |
Bind corrected-gauge direct overlap-fold support independently of D93 and fail closed on unqualified fleet evidence. |
Shared commit |
D104 |
Bind the pair-complete shared 3D Ewald repair to exact per-record producer and numerical evidence. |
Shared repair |
D105 |
Pin every χ-CCM-B |
D93 attests the direct M5 image domain, not quartet activation, multipole order, penetration dispatch, or approximation error. Commit |
D106 |
Transport an explicit high-G RSGDF tail through every fitted χ-CCM-B SCF route without treating transport as D93 qualification. |
Shared commit |
D107 |
Fail closed when restricted Gamma-only RI level shifting would change or bypass the declared χ fitted operator. |
A |
D108 |
Fail closed on every nonempty restricted four-center options-level schedule until χ explicitly transports and verifies the BIPOLE schedule object. |
The restricted BIPOLE RHF/RKS drivers consume only their separate |
D109 |
Fail closed on every active χ-CCM-B quadratic-SCF fallback request until the selected backend executes and verifies it. |
|
D110 |
Lower the restricted four-center static level-shift warm-up into the existing BIPOLE schedule and record the resolved executed length. |
With an empty explicit schedule, the χ RHF/RKS wrapper formerly passed only |
D111 |
Retain only the home-auxiliary representative of the translation-covariant real-torus RI factor and reconstruct its logical auxiliary orbit during AO-to-MO transformation. |
With a complete cyclic translation group, its dual character mesh, and the common full primitive-auxiliary frame enforced by |
| D112 | Expose a fixed-input restricted energy-weighted-density algebra audit on the exact D80 overlap support, without calling it stationary SCF binding. | compute_aiccm2026dev_b_fixed_input_restricted_energy_weighted_density_lattice(...) accepts explicit character-resolved overlap blocks, occupied coefficients, and a candidate variational Fock. It requires a 3D restricted RHF/RKS χ result, the complete unreduced uniform dual character net with bounded exact-integer labels, agreement within consistency_tolerance between the supplied overlap and the Bloch sum of the caller’s lattice_options, finite Hermitian overlap and Fock blocks, common-rank occupied C_occ^H S C_occ = I, and time-reversal-consistent overlap, Fock, occupied projector, and output. It evaluates Lambda(q)=C_occ(q)^H F(q) C_occ(q) and W(q)=2 C_occ(q) Lambda(q) C_occ(q)^H, then applies W(g)=sum_q w_q exp(-2 pi i q.g) W(q) onto the requested overlap cell list with fail-closed nonfinite-algebra and imaginary-residue guards. The algebra is occupied-unitary invariant and, for D=2 C_occ C_occ^H, equals W=D F D/2. Even, odd, and multi-axis oracles pin the Fourier orientation; a nontrivial occupied rotation pins covariance; and the returned object feeds the D80 scalar and AO-centre derivative in a direct finite-difference test. The helper does not read stored orbital energies, infer occupations, rebuild or attest the final physical Fock, prove stationarity or backend variational closure, bind state or support digests beyond the explicit overlap list, or assemble a total gradient. D113 later supplies the matching fixed-input unrestricted algebra. The active seam composition, screened exchange, RI/RIJCOSX response, XC terms, post-HF response, stationary binding, and total gradients remain open. This changes no finite Hamiltonian, Coulomb convention, lower-dimensional fail-close, or numerical-support qualification. |
| D113 | Expose the fixed-input unrestricted energy-weighted-density algebra on the same exact D80 overlap support, with separate spin validation and no stationary-state claim. | compute_aiccm2026dev_b_fixed_input_unrestricted_energy_weighted_density_lattice(...) accepts one explicit overlap stack plus separate alpha/beta occupied coefficients and candidate variational Focks for a 3D UHF or nonempty UKS route. For each spin it evaluates Lambda_s=C_occ,s^H F_s C_occ,s and W_s=C_occ,s Lambda_s C_occ,s^H=D_s F_s D_s, with D_s=C_occ,s C_occ,s^H, then returns the inverse transform of W=W_alpha+W_beta. There is no factor of two in one spin and no cross-spin term. Spin ranks may differ but are independently constant over the character net; either one may be zero, both zero fail closed, and an explicit Fock for a zero-rank spin remains subject to finite, Hermitian, and sewing checks. Overlap orthonormality, occupied projectors, Focks, W_s, and each spin’s inverse-transform imaginary-residue guard are validated separately so defects cannot cancel in the sum. Independent occupied rotations leave each W_s invariant. When C_alpha=C_beta=C and F_alpha=F_beta=F, the result reduces exactly to D112: W=2 C Lambda C^H=D F D/2 for the spin-summed restricted density D. The complete bounded dual net, exact overlap-support match, finite-algebra, inverse-transform orientation, spin-summed imaginary-residue guard, and 3D guards remain those of D112, and the summed output composes directly with D80 at fixed numerical W. This helper does not infer occupations, bind its inputs to stored unrestricted densities or orbitals, rebuild or attest either final physical Fock, prove stationarity or backend variational closure, or assemble a force. D85 binding, explicit seam or screened-exchange derivatives, RI/RIJCOSX and XC derivatives, response, post-HF terms, and total gradients remain open. This changes no finite Hamiltonian, Coulomb convention, lower-dimensional fail-close, or numerical-support qualification. |
| D114 | Farm complete restricted four-center direct-ERI output tasks across MPI ranks without partitioning the internal translation sum. | The χ RHF four_center selector now opts into cyclic chi-direct-output-cell scheduling. Each task is one complete caller-declared real-space AO J/K output task, possibly restricted by a symmetry shell mask. The existing native domains kernel receives only that rank’s output indices but retains the identical full padded (c_lambda,c_sigma) domain, density support, masks, and erfc kernel. The surrounding driver leaves the replicated reciprocal long-range Hartree assembly, long-range exchange channels, and BvK q=0 correction unchanged. Complete output tasks are allgathered in canonical cell-key order before incremental-Fock state is updated, so no floating partial-block reduction changes arithmetic. Empty ranks skip the native call because its legacy empty subset means all cells. The scheduling parcel binds task count, strategy, source ownership, and an ordered-output-cell SHA-256 fingerprint; duplicate, missing, reordered, or malformed parcels fail closed. This is a scheduling fingerprint, not a digest of the full internal domain or operator. The automatically selected pair-resolved and symmetry-representative direct domains use the same scheduler with masks kept parallel to owned outputs. Results carry vibeqc.pbc-bipole.output-cell-farming-execution/v1 evidence with rank counts, task count, strategy, task kind, cell-order fingerprint, complete-internal-sum truth, and allgather mode. Serial execution is bit-identical to the unfarmed native traversal. D114 performs no representative/residue partition and assigns no physical Wigner weight. A direct-ERI radial output task is not a Γ-CCM union-and-weight WSC and is not automatically a χ finite-group residue; any future residue-level scheduler must aggregate tied Wigner representatives before interpreting one residue contribution. The milestone covers restricted 3D χ RHF four_center only. χ RKS/UHF/UKS, fitted backends, character/residue-level scheduling, post-HF representative-pair scaling, analytic gradients, and lower dimensions remain unchanged. No Coulomb interaction is truncated by distance, no finite Hamiltonian or q=0 convention changes, and no reduced-scaling DLPNO claim follows. |
| D115 | Gate MPI initialization and communicator binding on validated launch evidence, not on package availability. | The top-level package imports the shared MPI helpers, while importing mpi4py.MPI initializes MPI by default. An installed [mpi] extra must therefore not turn plain serial import vibeqc into an MPI participant. With neither recognized launcher-rank evidence nor an explicit required-size contract, mpi4py.MPI remains unloaded and every helper uses the exact serial identity world (comm=None, rank=0, size=1, active=False). Complete finite Open MPI, PMI/Intel/MPICH, MVAPICH, actual Slurm task-step, or PMIx rank evidence activates the native module; the D114 wrapper additionally sets VIBEQC_MPI_REQUIRED=1 with exact expected size two. Size-only allocation variables and Slurm allocation, batch, extern, interactive, or pending-step markers never activate MPI. An incomplete source with unambiguous task-rank evidence, a malformed complete source, contradictory complete launcher families, missing or broken mpi4py under a detected launch, inadequate MPI thread support, a finalized runtime, and communicator rank/size disagreement all fail closed instead of creating independent serial rank-zero calculations. Incomplete auxiliary-family markers are ignored only when another accepted launch signal already supplies evidence; its available rank/size values are then checked against COMM_WORLD. A valid one-rank launch binds COMM_WORLD but remains active=False; a multi-rank world activates as before. This changes shared process discovery only. D114 task ownership and arithmetic, the distinct Γ-CCM union-and-weight and χ finite-character constructions, the finite Hamiltonian, Coulomb and q=0 conventions, locality approximations, numerical-support status, lower-dimensional fail-close, and analytic-gradient status are unchanged. |
| D116 | Extend complete direct-output-cell farming to restricted four-center RKS only when one execution record covers the complete direct phase. | The χ RKS four_center selector now opts pure semilocal and full-range-hybrid routes into the same cyclic chi-direct-output-cell schedule as D114. Without symmetry-representative reduction, pure semilocal RKS farms its padded J-only traversal; a global hybrid farms the fused padded J/K traversal. When a symmetry plan requires representative masks, the shared fused domains builder may compute K beside J even for a pure functional, with K discarded from the RKS operator. The RKS driver transports the builder’s exact task census and ordered-cell fingerprint onto the result and χ diagnostics. XC grid construction and quadrature, reciprocal Hartree, long-range exchange, the BvK q=0 seam, character transforms, diagonalization, and output remain replicated. HSE-type screened hybrids deliberately stay serial at this layer: their base J and separate screened-K traversals cannot both be attested by the single-phase v1 execution record, so the generic driver rejects farming rather than letting the label outrun the operator. Serial PBE and PBE0 are bit-identical to their unfarmed drivers, and real two-rank PBE reproduces energy, XC energy, Fock, and density exactly in the one-thread regression. The source-controlled --d116-rks-mpi acceptance profile fixes c-diamond/STO-3G, the (2,2,2) mesh, 15-bohr cutoffs, one PBE SCF cycle, zero Fock mixing, and symmetry off. Its d116-rks-mpi-validation/v2 contract accepts absolute differences no greater than 1e-10 Ha for total, electronic, nuclear, and XC energies and no greater than 1e-12 elementwise for every Fock and density block. Array block shapes, convergence and iteration state, executed zero mixing, D83 exchange_q0_applicability="inactive", rank and task census, canonical order and fingerprint, launcher controls, and source/core process identity remain exact. The v1 parallel-execution schema is unchanged because scheduling and binding semantics did not change. exact_parity remains observational in v2; contract_parity is the normative verdict. Existing v1 receipts remain exact-contract evidence and are not reinterpreted. This is implementation parity, not an absolute-energy or whole-SCF scaling result. D116 still farms radial AO output blocks, not Γ-CCM union-and-weight WSCs or χ finite-group residues; it assigns no Wigner weight and does not truncate the Coulomb interaction. UHF, UKS, fitted backends, post-HF work, gradients, true residue/translation-class scheduling, numerical-support qualification, and lower dimensions remain unchanged. |
| D117 | Distribute the SCF density-diagnostic inverse transform over exact χ finite-group residues, after grouping its zero-offset Wigner–Seitz cell aliases. | The diagnostic scheduler validates the declared three-axis mesh, complete uniform dual character net, normalized weights, complete canonical residue coverage, and representative-translation congruences. Within the zero-offset cell representative set supplied by the density diagnostic, aliases tied to one residue are grouped before ownership; duplicates, nonpositive/nonfinite weights, unequal tied weights, or a sum different from one fail closed. This does not attest the offset-dependent representative sets required by AO pairs, quartets, or local domains. One cyclic task evaluates D(g)=sum_q w_q exp(-2 pi i q.g) D(q) with the complete character net. Representative weights certify the zero-offset real-space partition only and are not applied again to the residue block. Active ranks require an identical SHA-256 construction fingerprint over mesh, ordered characters and weights, representative scope, residues, translations, and weights. The existing native subset transform runs only for locally owned nonempty tasks; an oversubscribed empty rank contributes an explicit empty parcel because the native empty-subset convention means all outputs. The shared exact ordered gather separately validates the task count, strategy, source ownership, exact-once census, and ordered-residue fingerprint before every rank receives canonical residue order. Restricted diagnostics use one schedule; unrestricted alpha and beta densities are transformed separately and must produce identical execution records. Results expose vibeqc.aiccm2026dev-b.residue-inverse-transform-execution/v1, whose schema and truth fields are implementation constants and whose public construction rejects contradictory group, rank, ownership, census, and fingerprint fields. Evidence includes character mesh and labels, residue keys, representative scope, multiplicities and unit weight sums, local/per-rank ownership, both fingerprints, complete-character-sum truth, and explicit extra_wigner_weight_applied=false. Odd, even, skew, two-rank, three-rank, rank-drift, unrestricted-spin, and empty-rank controls reproduce the complete serial transform exactly. Unlike the construction-neutral D114/D116 radial output task, D117’s work unit is genuinely one χ residue, but it accelerates attached density diagnostics only. SCF J/K, XC, diagonalization, localization, QVF/property transforms, post-HF, gradients, and all scientific operators are unchanged. This is not Γ-CCM WSC farming, changes no Coulomb or q=0 convention, introduces no distance cutoff, and establishes no DLPNO scaling. |
| D118 | Treat χ population sidecars on a multi-character mesh as finite-torus properties rather than molecular Gamma proxies. | The dedicated χ population implementation contracts the complete character-resolved density and overlap blocks and already supplies Mulliken populations and primitive-cell Mayer data under the result’s finite-torus descriptor. The high-level capability gate must therefore admit aiccm2026dev-b for every supported character mesh and plan the χ-specific text and JSON formats. The single-Gamma restriction remains in force for routes that have only the molecular proxy. This changes output routing only; it does not change the SCF state, Hamiltonian, Coulomb or exchange-q=0 convention, or property equations. |
| D119 | Preserve the unrestricted spin polarization when constructing the visual BvK system for χ QVF output. | Repeating a primitive cell of multiplicity (M) over (N_c) finite-torus cells repeats (N_\alpha-N_\beta=M-1), so the archive system has multiplicity (N_c(M-1)+1), the same contract already used by D33 post-HF. The former hard-coded singlet label contradicted UHF provenance, electron parity, and alpha/beta Wannier counts even on a one-cell mesh. Root provenance describes that visual BvK system, while job.spec records the primitive requested charge and multiplicity explicitly rather than relying on singlet defaults. Charge still scales by (N_c), restricted singlets remain singlets, and the density and orbital payloads are unchanged. A synthetic charged helper control pins field scaling only and does not widen the neutral χ SCF production envelope. This is a QVF metadata correction only; it changes no SCF state, finite Hamiltonian, Coulomb or exchange-q=0 convention, or distinction between the Γ-CCM union-and-weight and χ finite-character constructions. |
| D120 | Exclude χ-CCM from the generic periodic QVF DOS and bonding-property rebuild, and reject an explicit χ COOP/COHP request before SCF. | The generic QVF path constructs a fixed-cutoff Ewald/HF-like lattice operator from the converged density. It neither reuses the executed finite-character J/K assembly nor includes the XC potential for KS jobs, so its finite DOS, PDOS, COOP, COHP, and Mayer arrays would describe a surrogate Hamiltonian under a χ label. Omitting that rebuild preserves the route-owned torus density/orbital grids, convention payload, population sidecar and Mayer analysis, Wannier overlay, and direct Python band/property APIs. COOP/COHP has no route-owned χ implementation or alternate sink, so an explicit request fails before SCF instead of finishing without a valid payload. This is a post-SCF routing guard and changes no SCF operator, density, energy, Coulomb kernel, exchange-q=0 convention, or distinction between the Γ-CCM union-and-weight and χ finite-character constructions. |
| D121 | Validate every χ post-HF numerical-support cutoff as a positive finite real value before reference SCF work. | Canonical MP2, restricted local MP2/CC, and unrestricted MP2/CC share three numerical-support controls: lattice_cutoff_bohr, rsgdf_ke_cutoff, and gdf_linear_dep_threshold. The former restricted guards used only <= 0 or min(...) <= 0, which let NaN and positive infinity pass, while the unrestricted gateways had no corresponding check. One field-specific validator now rejects booleans, non-real values, nonfinite values, zero, and negative values at the five shared restricted/unrestricted gateways before RHF/UHF reference or integral work begins. All public canonical and DLPNO MP2, CCSD, and CCSD(T) wrappers inherit this contract. Valid positive finite controls retain their previous values and execution. This is an input-domain repair only; it changes no finite-character Hamiltonian, post-HF equation, Coulomb kernel, exchange-q=0 convention, or Γ-CCM/χ-CCM construction distinction. |
| D122 | Reject an explicit auxiliary basis on every χ four-center SCF route before backend work. | The BIPOLE four_center backend evaluates the complete direct electron-repulsion operator and has no density-fitting auxiliary basis. The χ RHF/RKS/UHF/UKS selectors nevertheless accepted aux_basis, dropped it from the BIPOLE call, and could report a successful calculation under an unexecuted requested control. One shared guard now rejects every non-None value after the existing state, dimensionality, and SCF-control validations but before direct backend dispatch. Omitted auxiliary controls keep the direct path unchanged, while RI and RIJCOSX continue to forward the exact requested auxiliary basis. Historical χ four-center records carrying an explicit aux_basis did not execute that control and are provenance-invalid. This is an input and provenance repair only; it changes no finite-character Hamiltonian, SCF equation, Coulomb kernel, exchange-q=0 convention, or Γ-CCM/χ-CCM construction distinction. |
Acceptance supersession: D74 records the historical v2 scaffold, D78
supersedes its emission condition, D89 empties the approach route map, and D90
prevents namespace, representation, or solver ancestry from filling that map.
D91 leaves D77 authoritative until a separately versioned bundle schema and
its authoritative artifact manifest, source-SHA proof, producer, curator,
comparator, and tests actually land. D95 through D98 do not provide those
bundle identity layers. D98 supersedes D96’s unversioned four-field payload
with the independently validated exact v1 coefficient and screened-assembly
declaration, while D93 enforces D82 two-electron-domain qualification and D103
independently enforces corrected-gauge overlap-fold qualification before any B
absolute energy can enter an audit or comparison table.
D101 does not qualify fitted support or supersede D77, D89, D91, or D93; it
provides only a fail-closed, nonquantitative route-control record under those
decisions.
D102 supersedes D99’s former convergence and single-cause interpretation;
same-helper nuclear equality remains dispatch evidence only. D104 now admits
fresh exact-v2 records whose repair ancestry, same-process canary, and finalized
D77 identity all pass. Every old v1 record remains permanently quarantined.
D104 does not satisfy D93, D98, or D103, and it does not qualify the mapped
A-owned real-Gamma control.
aiccm2026-gamma-chi/v2 must not be emitted unchanged. Even a complete
neutral-torus representation-control contract would not by itself establish a
Γ-CCM/χ-CCM approach delta.
The q=0 support/order is byte-preserved. Pre-D78 exact-GDF-K RHF/UHF and
hybrid RI, neutral-torus fold, and RI post-HF/full-pair records built nonzero-q RSGDF
factors and are revision-bound. Semilocal RI and RIJCOSX SCF use only q=0
RSGDF factors for J and are numerically unaffected by D78.
Source disagreements recorded¶
The 2014 paper’s numerical convergence is evidence, not a proof of a variational energy. The independent formulation supplies the missing finite Hamiltonian and constrained variational statement.
The historical two-, three-, and four-centre pair-product boundary factors are not adopted.
aiccm2026dev-bweights translation equivalence classes, not arbitrary centre pairs.A converged, plausible energy is not accepted if the density is non-idempotent, the electron count is wrong, the Fock is non-Hermitian, or the finite-mesh/supercell identity fails.
A long-range correction added only to the final scalar energy is insufficient. Its functional derivative must be present in the SCF Fock.
The deMon2k two-center claim that the reference center is arbitrary requires equality of the two weighted representative sums, not only symmetry of the underlying free-space integral. Its explicitly symmetrized three-center Eq. (20), however, already addresses the simplest AO-pair interchange.
Open questions and queued work¶
ID |
Question / work |
Current position |
|---|---|---|
O1 |
One common long-range convention for 1D chains and 2D slabs. |
χ-CCM-B now fails closed for all 1D/2D SCF backends. Four-center is blocked because its direct-truncated lower-dimensional BIPOLE gauge is not the neutral finite-torus Hamiltonian and over-binds chain benchmarks by a Madelung-scale constant. RI and RIJCOSX are blocked because the shared lower-dimensional neutral-RI/GDF mesh collapses transverse reciprocal components to (G_\perp=0), producing a sheet-like non-Coulomb kernel and vacuum-padding artifacts. A future shared mixed-boundary kernel must derive the 1D/2D Green function, self-potential, electron-nuclear and nuclear terms, and exchange q=0 seam together before any lower-dimensional B absolute energy can be reported. |
O2 |
Global-minimum and stability analysis. |
RHF SCF gives a stationary determinant in the constrained space. Add orbital-Hessian/stability checks before production status. |
O3 |
Finite-size convergence law for exact exchange. |
Measure rather than assume monotonicity; fit insulating test ladders by geometry and basis. |
O4 |
Open-shell production validation. |
UHF/UKS now run through 3D four-center and 3D RI/RIJCOSX; 3D UMP2/UCCSD(T)/PNO pilots use the exact χ-CCM transform. Add external periodic open-shell references, stability analysis, and larger spin-contaminated controls. |
O5 |
KS-DFT production validation. |
Closed-shell RKS now runs through 3D direct, RI, and RIJCOSX backends. Multi-k GDF/RKS now Bloch-folds the lattice XC matrix from the full real-space density. The 2026-06-28 c-diamond and si-diamond STO-3G/PBE/RI local re-runs and the 2026-06-30 OpenBLAS-pinned Twin re-runs converged with the default accelerator after this fix. The 2026-07-01 Twin LiH/MgO/NaCl STO-3G/PBE/RIJCOSX runs also converged on the 2 x 2 x 2 B net; because pure PBE has zero exact-exchange weight, this primarily validates RIJCOSX route plumbing rather than COSX exchange physics. A separate STO-3G/PBE0/RI block converged for the same three systems, but it does not exercise COSX. PBE0/RIJCOSX validation remains open; when attempted, LiH/STO-3G should be treated only as route smoke because it is the known ultra-diffuse short-range-envelope warning case. Since |
O6 |
Coupled cluster and local correlation. |
Restricted and unrestricted real-torus PNO MP2/CCSD/(T) routes are implemented in 3D, including full-domain exact-limit oracles. The finite-torus setup transforms and canonical RI-MP2 energy contraction now use native OpenMP kernels, but the correlated CC solvers still evaluate all pairs/triples with full contractions. The explicit closed-shell |
O7 |
ECP benchmark validation. |
Basic effective-charge neutrality is now checked before χ-CCM SCF and recorded in diagnostics. Remaining work is numerical validation on ECP-bearing periodic benchmarks, including post-HF reference consistency and output citation/provenance audits for each ECP basis family. |
O8 |
3D ionic benchmark ladder. |
LiH, MgO, and NaCl have Twin STO-3G RKS/PBE/RI, RKS/PBE0/RI, and RKS/PBE/RIJCOSX records on the 2 x 2 x 2 B net with the declared |
O9 |
H4 four-centre versus RI discrepancy. |
At the two-cell, 40-bohr-vacuum H4 geometry, corrected-gauge four-centre RHF is -2.1870080428 Ha/cell while RI is -2.1648043358 Ha/cell, a -22.204 mHa difference. The compact H2 two-cell control agrees across all three backends within 44 microhartree. Treat the H4 difference as unresolved truncation/cell-embedding behaviour, not as evidence that either number is the dense-limit oracle. |
O10 |
Exact periodic IAO cross overlap. |
The current IAO target/reference overlap is evaluated in the explicit supercell and omits cross-boundary images. Periodize it before using IAO translations to reduce correlated pairs. |
O11 |
Space-group integral acceleration. |
Derive backend-specific general-k sewing matrices, real-solid-harmonic shell actions, quartet stabilizers, and petite-list scatter. Enable only after symmetry-on/off Fock and energy parity. Layer and rod groups and little-group irrep labels are also open. |
O12 |
3D diamond-family RKS/PBE/RI convergence. |
The queue reported non-convergence after 120 iterations for c-diamond and si-diamond at a 2 x 2 x 2 B net with STO-3G, def2-svp-jk auxiliary basis, and RSGDF KE 200, while the RHF-RI counterparts converged. After the multi-k RKS XC assembly fix, local 2026-06-28 re-runs of the same default PBE/RI inputs converged without damping, level shift, or accelerator-policy changes: c-diamond in 4 iterations and si-diamond in 6. Fresh Twin queue attempts on 2026-06-30 first exposed a broken system-MKL linkage and did not reach SCF. After an OpenBLAS-pinned Twin rebuild at |
O13 |
F1 1D four-center over-binding on benchmark chains. |
The lower-dimensional four-center route now fails closed, so no new 1D/2D four-center benchmark should be accepted. The archived h-chain value (E_\mathrm{RHF}^{4c}=-1.3841759702) Ha/cell at extension (8\times1\times1) remains the reproduced failure motivating the guard. Five curated pre-D72 H-chain, LiH-chain, and polyethylene B four-center records now carry |
O14 |
χ-CCM analytic gradients. |
Derive and gate the derivative of the declared finite-character Hamiltonian before exposing forces. The 3-D Ewald nuclear-repulsion and fixed-density electron-nuclear components are parity-tested as standalone helpers, explicit fixed-density electrostatic energy and gradient bundles have exact density/operator cell-list matching, and B-owned SCF density folding feeds SCF-density electrostatic bundles. The fixed-density kinetic scalar and AO-centre derivative are parity-tested on explicit caller-declared support, without an SCF wrapper until the resolved one-electron cutoff is attested. The fixed energy-weighted overlap Lagrangian scalar and AO-centre derivative prove the sign and Frobenius orientation of the native overlap skeleton on the same exact-support contract. D112 and D113 construct restricted and unrestricted candidate |
O8’s “then emit” means define and emit the superseding acceptance contract; it does not authorize emission of the incomplete v2 scaffold.
Current measured evidence¶
The committed benchmark was run on the alternating H4/STO-3G chain with a
40-bohr transverse simulation lattice. For cyclic lengths 1, 2, and 4, the
new energy per cell was respectively -2.0733777009, -2.1648043358, and
-2.1719609271 Ha. A direct call to the full Gamma-centred character mesh was
identical to all printed digits at every length. The historical union12
CCM gave -2.1615967328, -2.1618792916, and -2.1707034746 Ha/cell. The
separately developed symmetric aiccm2026dev-a weighting gave the same displayed
sequence in this 1D case. This is useful comparison evidence, not a
correctness proof. New-route wall times in the archived current-main run were
22.58, 20.61, and 97.23 seconds; the four-cell jump reflects all-k-pair
exact-exchange fitting.
That H4 ladder used the ri backend. The backend-crossing smoke benchmark
uses H2/STO-3G in an 8 x 12 x 12 bohr cell at a (2,1,1) cyclic mesh. RHF
energies are -1.1213506456 (four_center), -1.1213722182 (ri), and
-1.1213943367 Ha/cell (rijcosx). PBE0 energies are -1.1554208287,
-1.1554589526, and -1.1554644822 Ha/cell in the same order. These are actual
runs from 2026-06-21; the maximum spread is 43.7 microhartree for RHF and
43.7 microhartree for PBE0. They establish executable cross-backend
consistency on this compact control, not a universal error bound. The direct
four-center entries predate the shared 3D neutral-cell cutoff clamp in
6fed8620; the six-value table is therefore revision-bound and must be rerun
before quotation, with direct_lattice_cutoffs retained in the new record.
The pre-guard 1D/2D route matrix on H2/STO-3G at a (2,1,1) cyclic mesh is no longer accepted as a valid three-backend comparison. The archived 1D RHF energies were -1.5341898653, -2.2845855922, and -2.2846076938 Ha/cell for four-center, RI, and RIJCOSX, respectively; the 2D values were -3.4506478026, -5.2158679833, and -5.2158905993 Ha/cell. Those large gaps are the evidence behind O1, D37, and D72: the four-center column used the direct-truncated lower-dimensional gauge, while the RI/RIJCOSX columns used the now-blocked transverse-collapsed neutral-RI/GDF kernel. Current main blocks all 1D/2D χ-CCM-B SCF backends until a shared neutral wire/slab Coulomb convention is implemented.
The first 3D canonical RI-MP2 control uses an H2/STO-3G cell of
20 x 20 x 6 bohr and the (1,1,2) character mesh. B gives HF, correlation,
and total energies of -1.1182352381008094, -0.0130227001540294, and
-1.1312579382548390 Ha per cell. The out-of-process PySCF 2.13.1
KRHF/KMP2 reference gives -1.1182352386944080, -0.0130226999202183, and
-1.1312579386146264 Ha per cell. The corresponding absolute differences
are below 0.6 nanohartree. The archived record is
docs/manuscripts/aiccm_comparison/data/h2_mp2_2026-06-21.json.
The exact inverse transform was tested by running the existing local solvers
on the real finite torus. H2/STO-3G at the same (1,1,2) mesh gives a
no-truncation local-MP2 correlation energy identical to canonical χ-CCM RI-MP2
within 7e-18 Ha per cell. A LiH/STO-3G cell of 20 x 20 x 7 bohr at the same
mesh gives canonical finite-torus DF-CCSD and (T) totals of
-0.0302475329439885 and -0.0000934031163267 Ha. The no-truncation local
solver differs by 6.9e-12 and 1.4e-12 Ha, respectively. The nonzero-triples
record and inverse-transform residuals are archived in
docs/manuscripts/aiccm_comparison/data/lih_dlpno_ccsdt_2026-06-21.json.
This is an internal finite-Hamiltonian oracle, not an external
infinite-crystal CCSD(T) result.
The first unrestricted transform control is a neutral Li doublet in a 15 x 15 x 15 bohr cell with STO-3G and extension (1,1,1), run on 2026-06-22. RI-UHF is -7.32670108299121 Ha/cell, UMP2 correlation is -0.000243259672659 Ha/cell, and full-domain UCCSD correlation is -0.000257809105931 Ha/cell. The triples correction is numerically zero for this three-electron minimal-basis control. The transformed RI factor has a 2.31e-16 maximum imaginary residual and a 7.11e-15 permutation residual. Independent alpha/beta localization changes the density by 4.3e-34, and the zero-threshold localized UCCSD(T) total agrees with the canonical gauge within 5e-14 Ha. These values establish the finite-torus unrestricted transform and PNO exact limit only; a one-cell Li array is not a converged crystal benchmark.
The 2026-06-24 four-center low-dimensional guard uses H2/STO-3G with a
1.4 bohr bond, a 15 bohr repeat along the periodic direction, and 40 bohr
transverse padding. The molecular RHF anchor is -1.1167143251 Ha. Current
aiccm2026dev-b four-center RHF gives -1.1167140350, -1.1167140379, and
-1.1167140379 Ha/cell at extensions (1,1,1), (2,1,1), and (4,1,1). The
nuclear component is larger than the isolated molecule because direct
low-dimensional image point charges are present, but the total energy
cancels the neutral image terms to below 0.3 microhartree per cell. This
supersedes the untracked 2026-06-22 benchmark note that reported a stale
over-binding snapshot.