Skip to main content

A formal validation toolkit calculating Many-Body Dispersion bounds connecting geometric theorems derived in Lean.

Project description

Many-Body Dispersion (MBD) Formalization and Validation

This repository seamlessly unites interactive theorem proving in Lean 4 with first-principles quantum chemistry computations. It formalizes the fundamental parameterizations governing Many-Body Dispersion (MBD) and the Tkatchenko-Scheffler (TS) screening equations, bridging rigorous geometric mathematics bounding down to operational Python computation models targeting realistic Molecular Crystals.

1. Project Organization

The repository has been structured for academic publication:

  • lean/
    • MBD_Theory.lean: Contains the standalone, machine-checked mathematical derivation of the $x = V_{\text{Bohr}} / \alpha$ proportionality limit. Proves that MBD screening establishes a formal mathematical parallel to the SERS exponential quenching envelope $\exp(-\rho)$.
    • Molecular_MBD.lean: Extends the scalar foundation into explicit geometry matrix evaluations (Matrix (Fin 3) (Fin 3) ℝ for anisotropic polarizability) and proves the bounding theorem: screened_is_bounded_unscreened, confirming $\varepsilon^{-x} \le 1$.
  • src/
    • compute_volumes.py: A PySCF-based derivation engine. Extracts finite-field polarizability constraints and maps them against the universal Bohr volume ($V_{\text{Bohr}} = 0.62 \text{ \AA}^3$) to emit target boundaries to the database.json.
    • screened_mbd.py: Framework for testing continuous isotropic interaction pairwise matrices over scaling parameters.
    • crystal_validation.py: The atomic grid lattice calculator. Integrates the extracted physics against exact empirical boundaries (e.g., Pbca spatial parameters).
  • results/
    • Standardized target location for database.json and future comparative mappings.

2. Benchmark Computation Outcomes

The computation validation matched the formal bounds dictated mathematically inside the Lean engine. Using aug-cc-pVDZ configurations to precisely calculate static polarizabilities against the unified $0.62 \text{ \AA}^3$ scaling benchmark:

A. The Baseline $x$ Ratios:

As validated by TS empirical standards, strongly-bound electron systems assert heavier screening constraints (due to comparatively smaller polarizabilities), whilst diffuse atoms assert minimal screening:

  • Helium ($He$): $x = 3.26$ (Strong Screening / Tightly Bound).
  • Neon ($Ne$): $x = 2.31$
  • Water ($H_{2}O$): $x = 0.52$
  • Xenon ($Xe$): $x = 0.32$ (Weak Screening / Diffuse Bound).

B. The Benzene Macroscopic Crystal Check:

Evaluating the extracted Benzene matrix bounds ($x \approx 0.061$) natively against actual macroscopic atomic configurations yielded results consistent with expectations:

  • Over 1,372 interacting molecular lattices.
  • Over 16,000+ structurally mapped Atomic Pairs computationally summed via $C_{6}^{ab} \cdot \varepsilon^{-x} / R_{ab}^{6}$.
  • Resulted in raw dispersion interaction potentials capturing -131.99 kJ/mol of empirical unit-cell energy. When modeled against bulk electrostatic potentials and heavy space-packing Pauli repulsion constraints, this raw dispersive baseline aligns closely with the net sublimation boundary (-184 kJ/mol).

3. Future Production Scaling

Immediate Scaling Goals:

  1. Repository Generation: Formally sync the established MBD-Framework configuration tree via Github targeting formal academic dissemination.
  2. Naphthalene & Anisotropic Crystals: Utilizing explicit diagonal matrices to track anisotropic sliding-plane dispersions missing in isotropic Benzene matrices.
  3. Hydrogen Bonding Metrics (Ice Ih): Running calculations against heavily polarized arrays tracking collective behavior.
  4. Finalizing The Unification: Linking the finalized Lean SERS exponential matrices natively into the resulting atomic computational outputs (publishing the explicit SERS-to-MBD theorem).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mbd_framework-1.0.0.tar.gz (9.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mbd_framework-1.0.0-py3-none-any.whl (9.8 kB view details)

Uploaded Python 3

File details

Details for the file mbd_framework-1.0.0.tar.gz.

File metadata

  • Download URL: mbd_framework-1.0.0.tar.gz
  • Upload date:
  • Size: 9.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for mbd_framework-1.0.0.tar.gz
Algorithm Hash digest
SHA256 8f168861d6ae80614e576209e9b8df57006492d7b7586e135878034edafb724f
MD5 506a0117c44c2351d9aea919159e317c
BLAKE2b-256 47bd2b2a0175c9bf3a64f5dfeef33788a7963be7732c106aa33b30ae773f1be0

See more details on using hashes here.

File details

Details for the file mbd_framework-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: mbd_framework-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 9.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for mbd_framework-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 0431c14026700ba6ff002463841f21a3512b2cb206f376c6e2e5065b81839232
MD5 0376cc51ab6b8570403c778b8c98d5cb
BLAKE2b-256 3212ed7d6f4b511e645e0587965b8419f859e825c2c9c501bb8a6758a2828385

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page