tpt-sci-dft-classical 0.1.0

Classical/soft-matter density functional theory (wraps feos/feos-dft), for the tpt-science pillar
Documentation

tpt-sci-dft-classical

Classical / soft-matter density functional theory (DFT) for the tpt-science pillar, provided by wrapping the feos framework ([feos_dft], MIT OR Apache-2.0).

Features

  • ClassicalDft — a handle that owns any concrete feos Helmholtz energy functional (PC-SAFT, PeTS, …) and is the entry point for 1-D profile solves.
  • SquareGradientDft — a from-scratch van der Waals square-gradient local density functional with 1-D planar and 3-D real-space solvers (no feos dependency required).
  • Re-exports of feos and feos_dft so downstream code can reach the full machinery (DFTProfile, DFTSolver, ConvolverFFT, geometries) directly.

The numerical heavy lifting — functional derivatives, FFT-based convolutions, Picard / Anderson-mixing solvers, grand-potential minimization — is done by feos itself. This crate only assembles the inputs and exposes a tidy result.

Example

The adsorption example (cargo run --example adsorption -p tpt-sci-dft-classical) shows a complete PC-SAFT density-profile solve (density profile + adsorption isotherm) wired through this wrapper, using feos's built-in PC-SAFT parameters.

use tpt_sci_dft_classical::ClassicalDft;
use feos::pcsaft::{PcSaft, PcSaftParameters};
use feos_core::parameter::IdentifierOption;

let parameters = PcSaftParameters::from_json(
    vec!["propane"], "../../parameters/pcsaft/esper2023.json",
    None, IdentifierOption::Name,
).unwrap();
let dft = ClassicalDft::with_functional(PcSaft::new(parameters));

Scope (v1)

This crate provides two complementary classical-DFT paths:

  • Wrapped feos/feos-dft — ClassicalDft owns any concrete feos Helmholtz energy functional (PC-SAFT, PeTS, …) for 1-D planar density profiles, adsorption isotherms, and surface tension. The numerical heavy lifting (FFT convolutions, Picard/Anderson mixing) is done by feos.
  • From-scratch square-gradient / local density-functional (SquareGradientDft) — a self-contained van der Waals square-gradient functional F[n] = ∫ (f_bulk(n) + κ/2 (∇n)²) dr for a simple inhomogeneous fluid, minimised by gradient relaxation of the Euler–Lagrange equation μ = ∂f_bulk/∂n − κ∇²n to a constant chemical potential. It ships a 1-D planar solve (bulk, hard wall, capillary length) and a 3-D generalisation that reuses tpt-sci-grid's sparse 3-D Laplacian per node. See examples/square_gradient.rs.

Building a molecular (hard-sphere / fundamental-measure) functional from scratch and full 3-D electronic DFT remain out of scope (use feos's functionals directly).

License

Licensed under either of MIT or Apache-2.0 at your option.