EOS Equation Registry#
Canonical, human-editable equation definitions. Edit each equation here once;
python3 engine/tools/sync_equation_registry.py generates the YAML index.
The index is not an implementation-availability declaration. Symbols, source
applicability and conventions are in full-eos.md and
formulation.md; methods and derivative domains
are in algorithms.md.
Each definition has one stable heading, the five metadata lines, and one LaTeX display block. Preserve this small format so the existing checker can reject accidental omissions. Source status describes derivation, not acceptance of a numerical implementation. Historical method equations do not select a current numerical method.
errors_in_variables_objective#
Section: Parameter estimation
Status: Exact derivation
Source: Zavala (2008), thesis chapter 4, §4.2, Eq. (4.2), printed p. 53 (PDF p. 65)
Description: Joint least squares for model parameters v and one standardized correction u per measured input shared by outputs of experiment k, with an optional known correlation R over the positive-weight output errors followed by the active input corrections.
Change note: sigma_q is finite and nonnegative; zero eliminates its coordinate. Objective sigma_y is finite and positive. Difference residuals use sqrt(w)=a/sigma_y exactly once. Report-only outputs and zero-sigma inputs occupy no row of e or R. A declared covariance C converts through the sigmas; R is fixed, symmetric positive definite with unit diagonal within 64 m epsilon, and never repaired. R = I recovers the independent sum.
heat_capacity_ratio#
Section: Thermodynamic properties
Status: Exact derivation
Source: Exact derivation from
pressure,residual_chemical_potentialand the T/V Hessian columns of StateDescription: Ratio of the total isobaric and isochoric molar heat capacities.
Change note: Computed only on request; unavailable unless the total c_p (
total_heat_capacity_cp) and c_v (total_heat_capacity_cv) are available, finite and positive, so it needs ideal thermochemistry.
henry_constant_px#
Section: Equilibrium / Reaction standard states
Status: Exact derivation
Source: Fugacity definition with the raw density-standard reference of
neutral_reaction_reference_transferDescription: Fugacity-based Henry constant in Pa of a neutral solute i in one pure solvent of an all-neutral model: H = lim f_i/x_i, not the partial-pressure volatility p/x.
Change note: Admitted per neutral solute on one unit reaction row of
neutral_reaction_reference_transfer, using the analytic solvent insertion ofinfinite_dilution_reference. Mixed solvents and charged models are refused (NonNeutralDeclaration). The molality form M_s H^px is not exposed.
independent_feed_measurement_coordinates#
Section: Parameter estimation
Status: Exact derivation
Source: Normalization and electroneutrality constraints in the equilibrium formulation
Description: Caller-named independent species fractions and dependent species preserve a fixed feed total N in mol, normalization and charge; B has identity rows for independent species.
Change note: Fractions are mol/mol; charges z are component charge numbers. One neutral dependent species or two dependent species with distinct charges solve the constraint block. The entire caller-declared box must map into [0,1], with fixed support; no trial normalization or input clipping is permitted.
errors_in_variables_residual_derivative#
Section: Parameter estimation
Status: Exact derivation
Source: Differentiation of errors_in_variables_objective and independent_feed_measurement_coordinates; existing exact pressure-closed and solved-equilibrium actions.
Description: Native first derivatives of standardized measurement residuals; D maps optimizer model parameters to physical parameters; a declared correlation applies the same triangular solve to every complete column.
Change note: Input-prior rows are exact identities before whitening. T/P actions include finite and reference states; molality actions hold the reference ladder fixed. Ionic T/P reference columns are the terminal-pair limit of
reference_limit_terminal_pair. Raw prediction columns dy/dv and sigma_q dy/dq come from the physical actions, never from whitened rows.
active_binary_interaction_mapping#
Section: Native phase coordinates
Status: Implementation convention
Source: EOS active-coordinate convention for the symmetric binary pair
Description: Map one active unlike-pair k_ij coordinate into the symmetric binary matrix.
Change note: Resolved diagonal values remain fixed.
active_binary_size_interaction_mapping#
Section: Native phase coordinates
Status: Implementation convention
Source: EOS active-coordinate convention for the symmetric binary pair
Description: Map one active unlike-pair l_ij coordinate into the symmetric binary matrix.
Change note: Resolved diagonal values remain fixed and k_ij remains unchanged.
active_parameter_coordinate_identity#
Section: Native phase coordinates
Status: Implementation convention
Source: Native active-coordinate convention for explicit storage slots
Description: Define one linear active coordinate and its derivative identity over the slots it owns.
Change note: A symmetric unlike pair owns both reciprocal off-diagonal slots; fixed slots have zero coordinate derivative.
affine_parameter_coordinate_map#
Section: Parameter regression / Affine coordinates
Status: Exact derivation
Source: Multivariate chain rule applied to
active_parameter_coordinate_identityDescription: A normalized optimizer value v maps to a base value q and proportional physical targets across parameter families. Bounds apply to q. Coefficients carry target-unit/base-unit; reciprocal pairs count once.
Change note: Nonzero signed coefficients and positive numerical scales are explicit inputs. Row order is independent EOS targets, dependent Born diameters, then reaction coefficients. Reaction coordinates have no EOS targets. Fixed slots remain outside the target list.
active_parameter_unit_transformation#
Section: Native phase coordinates
Status: Exact derivation
Source: Multivariate chain rule for linear unit conversion
Description: Transform active-coordinate gradients and mixed Hessians between source and native units.
Change note: Supported parameter conversions have a multiplicative scale and no additive offset.
angstrom_number_density#
Section: Symbols, bases, and units
Status: Exact derivation
Source: [Gross2001], unit conversion used by Appendix A
Description: Convert molar density to molecular number density on the angstrom basis.
Change note: Uses the current EOS Avogadro constant and angstrom conversion.
association_contact#
Section: Contribution intermediates / Association
Status: Source equation
Source: [Gross2001], hard-sphere contact rule used by association
Description: Unlike-site hard-sphere contact function.
Change note: Mirrors the reduced-diameter association contact expression.
association_helmholtz#
Section: Contribution intermediates / Association
Status: Source equation
Source: [Chapman1990], Eq.~(21)
Description: Association residual Helmholtz contribution.
Change note: Uses explicit site multiplicity from the resolved model.
pathway_weighted_association_helmholtz#
Section: Contribution intermediates / Association
Status: Source equation
Source: [Hong2027], Eq.~(11), with the stationary association potential of
association_helmholtzDescription: Two simultaneous association solutions as one augmented site vector: declared sites of block w (weight \(w\)) and block w̄ (weight \(\bar w=1-w\)) never bond across blocks, so each block keeps its own mass action, and an undeclared site has weight 1. \(L_b\) is the stationary potential summed over block \(b\); \(\ell_R\) is a corrected site’s own summand.
Change note: Off the root the weighted blocks stay stationary (energy error O(F²)), while the correction is not: its implicit site chain and the coupled site-defect error estimate are kept. A model without a declared block or correction keeps the ordinary arithmetic.
symmetric_reactive_site_correction#
Section: Contribution intermediates / Association
Status: Exact derivation
Source: [Hong2027], Eqs.~(7)–(10)
Description: The bonding-state weight of a symmetric two-site reactive species applied to that site’s association term only: with \(f_1=2X(1-X)\) and \(f_2=(1-X)^2\), \(\omega_2=2f_2/(2f_2+f_1)=1-X\) exactly, so the corrected term is the site’s ordinary term less \(X_R\) times it.
Change note: No 0/0 at \(X=1\): the continuous zero-bonding limit is \(\omega_2=0\). The correction is a per-site declaration; it names no species. It removes the reactive side of each reactive-partner pair from the second virial coefficient, because \(X_R\ell_R\) is O(ρ).
pathway_weight#
Section: Contribution intermediates / Association
Status: Implementation convention
Source: logistic weight law declared for the [Hong2027] blend (Eq.~11 takes \(w\) per state from Table S1)
Description: Weight of the declared pathway blocks as a function of the loading \(\alpha=x_a/x_b\) of two declared components and temperature, so one Helmholtz energy holds across states; \(\partial w/\partial n_i\) and \(\partial w/\partial T\) enter every derivative. The fixed pathway weight requires both \(b_\alpha=b_T=0\), fixed and inactive: exact for the declared \(w\), but resetting \(w\) between states (the Table S1 convention) is not one fluid model.
Change note: Both weights come from \(e=\exp(-|z|)\le1\), so neither overflows and \(\bar w\) keeps its relative precision. \(\alpha\) enters only with a nonzero or active \(b_\alpha\), and is then refused at \(x_b=0\), never clipped.
pathway_weighted_cross_dispersion#
Section: Parameter setup
Status: Source equation
Source: [Hong2027], Eq.~(12)
Description: The binary dispersion parameter of a pair that declares a complement-pathway law, blended by the pathway weight before dispersion is evaluated.
Change note: Blending the complete dispersion energies would be a different model. The complement law is a temperature law of the same form as
pair_parameter_temperature_law.
association_mass_action#
Section: Contribution intermediates / Association
Status: Source equation
Source: [Chapman1990], Eq.~(15)
Description: Association site-fraction mass-action equation with explicit multiplicity.
Change note: Written in the zero-residual form used by the EOS.
association_strength#
Section: Contribution intermediates / Association
Status: Source equation
Source: [Gross2002], cross-association rule; [Chapman1990], association strength
Description: Site-pair association strength using explicit source-resolved cross records. It carries
sigma_ij^3where Chapman1990 Eq. 18 carriesd^3(the PC-SAFT parameter convention); volumes fitted usingd^3are converted in their packets. For awolbach-sandlerrule edge, the Gross2002 Eq. 3 size factor makessigma_ijthe geometric meansqrt(sigma_i sigma_j)(1-l_ij).Change note: Keeps association energy and volume distinct from k_ij and l_ij.
association_volume_correction#
Section: Contribution intermediates / Association
Status: Source equation
Source: [Uyan2015], Eqs.~(8)–(9) and Table 5
Description: Volume of a combining-rule edge evaluated at the state temperature from its explicit self edges and a declared volume correction c; the Wolbach–Sandler size factor stays in
association_strength.Change note: (1 - c) multiplies the volume once, outside the square root; c = 0 recovers the existing rule.
born_outer_shell_diameter#
Section: Born solvation relations
Status: Source equation
Source: [Figiel2025], Eqs.~(8)–(10), parameterized to include its uncorrected limit
Description: Ion-specific outer Born shell diameter with one explicit fixed correction coefficient.
Change note: The fitted Born diameter, solvation factor, and model-definition coefficient remain distinct inputs.
born_radial_charging_work#
Section: Born solvation relations
Status: Source equation
Source: Born charging work; [Figiel2026Correction], corrected Eq.~(7)
Description: Canonical radial charging sum with an explicit dielectric-saturation coefficient.
Change note: The admitted fixed coefficients express the uncorrected, shell-only, and shell-plus-dielectric limits through one equation.
born_residual_helmholtz#
Section: Born solvation relations
Status: Source equation
Source: Born charging work; [Figiel2026Correction], corrected Eq.~(7)
Description: Dimensionless residual Helmholtz contribution from the sole Born charging equation.
Change note: Shared by fixed and active-coordinate evaluation paths. On an ion-free support the empty sum is identically zero before permittivity or solvation operations; this restriction does not supply ionic insertion derivatives.
candidate_phase_criteria#
Section: Equilibrium
Status: Source equation
Source: [Pereira2012] system PP with tolerances of Section 4
Description: A retained point is a candidate stable phase when its lower value is within the gap tolerance of the upper bound, its reduced gradient agrees with the multipliers on every coordinate away from the lower bound, and it is separated from every other candidate in packing fraction or in composition.
Change note: Gap 5e-2, relative derivative 0.5, packing and composition distinctness 1e-3, as in the source.
chemical_potential_stationarity#
Section: Equilibrium
Status: Source equation
Source: [Ascani2022] Eqs. 9–10; [Pereira2012] Eqs. 5–7; [Gross2001] Eq. (A.33)
Description: Intensive stationarity in phase composition with balance multipliers λ and per-phase charge multipliers φ_p; the same row for a free and a pinned phase.
Change note: Written intensively (divided by N_p) so a pinned phase carries the same row; phase equilibrium and reaction affinity follow from it.
close_packing_fraction#
Section: Density and packing
Status: Exact derivation
Source: Geometric close packing of equal spheres
Description: EOS hard upper packing-domain boundary.
Change note: Mirrors close_packing_fraction without introducing solver policy.
component_mixed_bulk_permittivity#
Section: Electrolyte dielectric and Debye–Huckel relations
Status: Source equation
Source: [AscaniHeld2021], Eq.~(13); all-ion limit [Bulow2019], Eq.~(7), and [Bulow2021], §2.3 and Table 5
Description: Ascani combined solvent-mass and ion-mole bulk relative permittivity; with no neutral solvent, the solvent sum is empty and the rule is linear in ion mole fractions.
Change note: Ion mixture permittivities remain distinct from Figiel radial-region permittivity.
solvent_mole_weighted_bulk_permittivity#
Section: Electrolyte dielectric and Debye–Huckel relations
Status: Implementation convention
Source: [Bulow2021a], Theory, Eq. (19)
Description: Sum over an explicitly declared nonempty set \(S\) of neutral solvents, using total-mixture mole fractions. Normalization is an explicit fixed declaration.
Change note: Component laws use component_permittivity_temperature_polynomial; the same expression supplies temperature/composition derivatives to DH and Born. No density or explicit ion term. The normalized form requires a positive solvent total at every evaluated point; no value is assigned at zero solvent total.
component_permittivity_temperature_polynomial#
Section: Electrolyte dielectric and Debye–Huckel relations
Status: Implementation convention
Source: Typed constitutive correlation
Description: Reference-temperature polynomial for one dielectric solvent’s relative static permittivity.
Change note: Each continuous coefficient is independently selectable while the polynomial powers and reference temperature remain fixed.
neutral_virial_coefficients#
Section: Thermodynamic properties
Status: Exact derivation
Source: [Gross2001], Eq.~(A.22), expanded at fixed temperature and composition; [Chapman1990], Eqs.~(15), (21) for association
Description: Neutral homogeneous-fluid expansion in molar density rho_m (mol/m³). B has units m³/mol and C m⁶/mol². Charged declarations are excluded because screening is nonanalytic at vacuum.
Change note: Ordinary Taylor coefficients contain the factorial; C is twice the quadratic coefficient of dimensionless molar residual Helmholtz energy.
compressibility_factor#
Section: Thermodynamic properties
Status: Source equation
Source: [Gross2001], Eq.~(A.22)
Description: Compressibility factor from the residual Helmholtz density derivative.
Change note: Uses molar density as the independent density coordinate.
cp_ideal_constant#
Section: Reference thermochemistry / Ideal-gas heat-capacity kinds
Status: Implementation convention
Source: Declared simplification; no literature form
Description: A constant ideal-gas heat capacity for a species with no better data, declared as such; its integrals are linear and logarithmic.
Change note: New declared kind; the only kind without a literature source, and the packet must say so.
cp_ideal_dippr_107#
Section: Reference thermochemistry / Ideal-gas heat-capacity kinds
Status: Bounded empirical relation
Source: Aly and Lee 1981, Fluid Phase Equilibria 6, 169 (DIPPR equation 107)
Description: Ideal-gas heat capacity of one species, hyperbolic form, with its closed-form enthalpy and entropy integral differences; valid on the declared temperature domain only.
Change note: The admitted real extension uses \(c=|C|/T\) and \(e=|E|/T\) in the even terms. Anchored differences use stable equivalents; \(C=0\) gives \(B\Delta T\) and \(B\ln(T/T_{\mathrm{ref}})\), while \(E=0\) gives no \(D\) contribution.
cp_ideal_nasa7#
Section: Reference thermochemistry / Ideal-gas heat-capacity kinds
Status: Bounded empirical relation
Source: NASA RP-1311 Part I (1994), section 4.2, Eqs. (4.6)-(4.8), https://ntrs.nasa.gov/citations/19950013764
Description: Ideal-gas seven-coefficient NASA7 (original NASA/Chemkin) standard-state thermochemistry on each source-declared temperature interval; coefficients a0-a4 give heat capacity and a5-a6 are enthalpy and entropy integration constants.
Change note: Uses dimensionless tau=T/(1 K) while preserving the source coefficients’ Kelvin convention; P_src is an explicit source standard pressure and P is the caller-declared standard pressure. Do not infer 298.15 K, 1 atm or interval continuity.
cp_ideal_nasa9#
Section: Reference thermochemistry / Ideal-gas heat-capacity kinds
Status: Bounded empirical relation
Source: NASA RP-1311 Part I (1994), section 4.2, Eqs. (4.9)-(4.11); McBride, Zehe and Gordon, NASA/TP-2002-211556 (2002), Empirical Equations for Fitting Thermodynamic Functions, Eqs. (1)-(3), https://ntrs.nasa.gov/citations/19950013764 and https://ntrs.nasa.gov/citations/20020085330
Description: Ideal-gas nine-coefficient NASA9 (new NASA/Glenn) standard-state thermochemistry on each source-declared temperature interval; coefficients a0-a6 give heat capacity and a7-a8 are enthalpy and entropy integration constants.
Change note: Uses dimensionless tau=T/(1 K) while preserving the source coefficients’ Kelvin convention; P_src is an explicit source standard pressure and P is the caller-declared standard pressure. Evaluate only on declared intervals, preserve source boundary behavior and do not infer 298.15 K or 1 atm.
cp_ideal_polynomial#
Section: Reference thermochemistry / Ideal-gas heat-capacity kinds
Status: Bounded empirical relation
Source: Poling, Prausnitz and O’Connell 2001, The Properties of Gases and Liquids, 5th ed., Appendix A polynomial form
Description: Ideal-gas heat capacity as a power series in centered temperature about an explicit reference temperature, with closed-form integrals; valid on the declared temperature domain only.
Change note: The accepted basis is \((T-T_{\mathrm{ref}})^k\), including the constant form; \(T_{\mathrm{ref}}\) anchors both integrals.
cp_ideal_shomate#
Section: Reference thermochemistry / Ideal-gas heat-capacity kinds
Status: Bounded empirical relation
Source: NIST Chemistry WebBook SRD 69, Gas Phase Heat Capacity (Shomate Equation), https://webbook.nist.gov/cgi/cbook.cgi?ID=C7732185&Mask=203, equations and unit definitions
Description: Use NIST tabulated numerical coefficients and their prescribed units: A-E and G in the heat-capacity/entropy convention, F and H_coef in the kJ/mol enthalpy convention. The enthalpy polynomial returns an increment; formation enthalpy/reference must be supplied separately. Valid only on each declared temperature interval.
Change note: The explicit 1000 factor converts the NIST kJ/mol enthalpy expression to Engine J/mol. H_coef names the NIST coefficient, not the observable; each source interval retains its fitted increment and supplied formation enthalpy.
cross_association_energy_correction#
Section: Native phase coordinates
Status: Implementation convention
Source: EOS typed cross-association correction applied to the declared arithmetic energy combining rule
Description: Correct every matching role-aware cross-association energy while preserving association volume.
Change note: One unordered component-and-role coordinate owns every multiplicity-equivalent matching edge.
cross_dispersion_energy#
Section: Parameter setup
Status: Source equation
Source: [Gross2001], Eq.~(A.15)
Description: Unlike-pair dispersion energy for an applicable pair.
Change note: Keeps k_ij semantically distinct from l_ij and association data. A pair with a declared reference temperature \(T_{\mathrm{ref},ij}>0\) takes the record’s linear-in-\(1/T\) law; its slope \(b_{ij}\) (K) is an active-parameter family like \(k_{ij}\). The applicable pairs are the first case of
same_sign_ionic_dispersion, with C the declared charged molecules.
cross_segment_diameter#
Section: Parameter setup
Status: Source equation
Source: [Gross2001], Eq.~(A.14), with source-resulted l_ij extension
Description: Unlike-pair segment diameter including the distinct l_ij family.
Change note: Makes the current l_ij semantics explicit.
debye_finite_size_chi#
Section: Electrolyte dielectric and Debye–Huckel relations
Status: Source equation
Source: [Bulow2019], finite-size function in Eq.~(2)
Description: Exact finite-size DH function and its Taylor series at zero, truncated at degree 24 in the implementation. The polynomial is not the exact function away from the limit.
Change note: The current reduced diameter y may select a cancellation-safe implementation, but is an algorithm choice, not a thermodynamic variable. With the switch at y = 0.2, chi and its first and second Taylor derivatives match 50-digit references to 3e-14, 7e-13 and 1.1e-11 relative on both branches (2026-09-23).
debye_huckel_helmholtz#
Section: Electrolyte dielectric and Debye–Huckel relations
Status: Source equation
Source: [Bulow2019], Eq.~(2)
Description: Finite-size Debye–Huckel residual Helmholtz contribution.
Change note: d_i^DH is the separately declared finite-size diameter in metres; equality to packing or Born diameters requires source justification. The ion-free support restriction is identically zero before screening operations; the dilute three-halves power does not admit a finite ionic insertion Hessian.
debye_screening_parameter#
Section: Electrolyte dielectric and Debye–Huckel relations
Status: Source equation
Source: [Bulow2019], Debye screening definition associated with Eq.~(2)
Description: SI Debye screening parameter for the resolved bulk dielectric.
Change note: Uses molar density and the current EOS physical constants.
declared_solvent_source_reference_transfer#
Section: Native phase coordinates
Status: Documentation-only
Source: Unqualified source-activity conversion; reference-pressure consistency must be established in Properties reference thermochemistry (M3)
Description: Trial-pressure fugacity/activity contraction; this expression is not an accepted conversion of a fixed source standard state. P in the displayed formula means P_trial, not P0.
Change note: Candidate for checking the reference-state discrepancy; not an adopted conversion. Do not infer that a source reference pressure is only provenance, or substitute trial pressure for fixed P0. The accepted pressure-density conversion has a separate ID.
density_correlation_mixed_parameters#
Section: Electrolyte dielectric and Debye–Huckel relations
Status: Bounded empirical relation
Source: Yang, Kontogeorgis, and de Hemptinne (2024), DOI 10.1016/j.fluid.2024.114103, Eqs. (2a)–(2b)
Description: Solvent-fraction-normalized Schreckenberg mixture parameters.
Change note: Only neutral-solvent components enter these mixtures.
density_residual#
Section: Density closure and mechanical domain
Status: Exact derivation
Source: Exact pressure-closure equation using Eq.~
pressureDescription: Scalar residual whose roots are specified-pressure EOS states.
Change note: Root-search mechanics are not thermodynamic equations.
density_upper_bound#
Section: Density closure and mechanical domain
Status: Exact derivation
Source: Exact inversion of Eqs.~
packing_fraction_coefficientandclose_packing_fractionDescription: Model-specific density boundary implied by close packing.
Change note: Reuses the sole EOS packing geometry owner.
dipolar_correlation_integral#
Section: Electrolyte dielectric and Debye–Huckel relations
Status: Source equation
Source: Rueben et al. (2024), DOI 10.1021/acs.jced.4c00347, Eq. (5)
Description: Rueben correlation integral from component correlation parameters.
Change note: The correlation parameter is an explicit record for every component.
dipolar_perturbation_bulk_permittivity#
Section: Electrolyte dielectric and Debye–Huckel relations
Status: Source equation
Source: Rueben et al. (2024), DOI 10.1021/acs.jced.4c00347, Eq. (6)
Description: Rueben perturbation-theory bulk relative permittivity.
Change note: The relation tends to one as all component partial densities vanish.
dipolar_helmholtz#
Section: Contribution intermediates / Dipole-dipole
Status: Source equation
Source: [Gross2006], Eq.~(7)
Description: Optional third-order Padé dipole-dipole Helmholtz contribution; zero when every dipolar species is absent.
Change note: Admitted as an opt-in family by ADR 0011.
dipolar_integrals#
Section: Contribution intermediates / Dipole-dipole
Status: Source equation
Source: [Gross2006], Eqs.~(10)–(16) and Table 1
Description: Pair and triplet correlation integrals with chain-length-interpolated coefficients, shared by the dipole (Table 1) and the quadrupole ([Gross2005], Eqs.~(12)–(19) and Table 2).
Change note: The unlike energy in J2 is the geometric mean without k_ij. Only the dipole caps its chain lengths at 2 (ADR 0011); the quadrupole uses the uncapped \(m_{ij}\), \(m_{ijk}\) (ADR 0014).
dipolar_second_order#
Section: Contribution intermediates / Dipole-dipole
Status: Exact derivation
Source: [Gross2006], Eq.~(8) with \(q_i=(\epsilon_i/kT)n_{\mu,i}\mu_i^{*2}\)
Description: Second-order dipole-dipole perturbation term.
Change note: The reduced moment \(q_i=n_{\mu,i}\mu_i^2/(4\pi\varepsilon_0kTm_i\sigma_i^3)\) absorbs \(\epsilon_i\).
dipolar_third_order#
Section: Contribution intermediates / Dipole-dipole
Status: Exact derivation
Source: [Gross2006], Eq.~(9) with the same \(q_i\)
Description: Third-order dipole-dipole perturbation term.
Change note: Uses \(\sigma_{ij}=(\sigma_i+\sigma_j)/2\) for every pair.
dispersion_chain_coefficients#
Section: Contribution intermediates / Dispersion
Status: Source equation
Source: [Gross2001], Eqs.~(A.18)–(A.19)
Description: Chain-length interpolation of universal dispersion coefficients.
Change note: Mirrors the current A0/A1/A2 and B0/B1/B2 arrays.
dispersion_compressibility_factor#
Section: Contribution intermediates / Dispersion
Status: Source equation
Source: [Gross2001], Eq.~(A.11)
Description: Chain compressibility correction multiplying the second-order term.
Change note: Mirrors the current rational expression.
dispersion_first_moment#
Section: Contribution intermediates / Dispersion
Status: Source equation
Source: [Gross2001], Eq.~(A.12)
Description: First unlike-pair dispersion mixture moment.
Change note: Includes current segment counts and cross diameter.
dispersion_helmholtz#
Section: Contribution intermediates / Dispersion
Status: Source equation
Source: [Gross2001], Eq.~(A.10)
Description: PC-SAFT first- and second-order dispersion Helmholtz contribution.
Change note: Reconciled to the current angstrom number-density basis.
dispersion_integral_one#
Section: Contribution intermediates / Dispersion
Status: Source equation
Source: [Gross2001], Eq.~(A.16)
Description: First PC-SAFT dispersion integral correlation.
Change note: Evaluated through the shared polynomial owner.
dispersion_integral_two#
Section: Contribution intermediates / Dispersion
Status: Source equation
Source: [Gross2001], Eq.~(A.17)
Description: Second PC-SAFT dispersion integral correlation.
Change note: Evaluated through the shared polynomial owner.
dispersion_polynomial#
Section: Contribution intermediates / Dispersion
Status: Exact derivation
Source: [Gross2001], polynomial form in Eqs.~(A.16)–(A.17)
Description: Horner-evaluated sixth-order dispersion polynomial.
Change note: Documents the real arithmetic performed by polynomial.
dispersion_second_moment#
Section: Contribution intermediates / Dispersion
Status: Source equation
Source: [Gross2001], Eq.~(A.13)
Description: Second unlike-pair dispersion mixture moment.
Change note: Includes the squared reduced pair energy.
dual_inner_problem#
Section: Equilibrium
Status: Source equation
Source: [Pereira2012] Eqs. 9–11
Description: Global inner infimum on the admitted phase domain; g is reduced molar Gibbs energy, x0 is feed composition. Reactive systems replace composition by conserved-moiety coordinates.
Change note: The feed multiplier term is required in the lower bound. A local inner minimum supplies no certified global lower bound.
effective_dipolar_density#
Section: Electrolyte dielectric and Debye–Huckel relations
Status: Source equation
Source: Rueben et al. (2024), DOI 10.1021/acs.jced.4c00347, Eq. (4)
Description: Rueben effective dipolar-density variable in the Angstrom number-density basis.
Change note: Dipole-squared and polarizability records are explicit for every component.
electrolyte_phase_coordinate_jacobian#
Section: Native phase coordinates
Status: Exact derivation
Source: Exact Jacobian of Eqs.~
phase_mole_fraction–phase_molar_densityDescription: State-coordinate Jacobian used to transform electrolyte Helmholtz gradients.
Change note: Kept as the explicit coordinate transformation; the generic EOS derivative tape differentiates amount-volume coordinates directly.
electrolyte_phase_hessian_chain_rule#
Section: Native phase coordinates
Status: Exact derivation
Source: Exact second-order multivariable chain rule
Description: Transform state Helmholtz Hessians into explicit amount-volume coordinates.
Change note: Kept as the explicit coordinate transformation; the generic EOS derivative tape differentiates amount-volume coordinates directly.
electroneutral_amount_chart#
Section: Equilibrium
Status: Implementation convention
Source: [Perdomo2025] Section 3.1 (elimination of one charged species before Eq. 18; reduced gradient Eq. 22)
Description: Electroneutral reduced coordinates for the tangent-plane search: one ion eliminated per charged trial phase.
Change note: Candidate reduced chart for charged search; not a current solver-availability claim. Eliminated ion has nonzero charge and reconstructed amounts must be nonnegative.
fixed_pressure_fugacity_correction#
Section: Thermodynamic properties
Status: Documentation-only
Source: EOS Newton correction using Eq.~
pressure_density_derivativeDescription: Correct a converged-state log fugacity for its bounded pressure residual.
Change note: First-order residual-error estimate for comparison with the exact extensive-coordinate pressure constraint; not a replacement for solving that constraint.
fixed_pressure_total_derivative#
Section: Thermodynamic properties
Status: Exact derivation
Source: Exact implicit derivative of the pressure constraint
Description: Total derivative of a property with respect to an active coordinate at fixed pressure.
Change note: Applied by the generic EOS active-coordinate block, including canonical Born, solvation, and permittivity coordinates.
fixed_pressure_heat_capacity_parameter_derivative#
Section: Thermodynamic properties
Status: Exact derivation
Source: Composition of
fixed_pressure_total_derivative,total_heat_capacity_cpandresidual_heat_capacity_cpDescription: First parameter derivative of total molar isobaric heat capacity at fixed T, P and normalized composition on a regular declared density branch. The ideal-gas thermochemistry coefficients are fixed inputs independent of the residual-EOS parameters. Parameter regression calls the Properties pressure-chart action once per parameter direction; the common energy order is three, including the implicit association-site chain (ALG-ACTIONS).
Change note: Qualified by the total-value, derivative-ladder and density-lift checks in
engine/tests/native/regression_j2_inventory_checks.cppand the retainedanalyses/2026-heat-capacity-fitting/evidence. No parameter Hessian or reacting-equilibrium heat-capacity derivative is claimed.
formula_unit_composition#
Section: Electrolyte reference states and reported activities
Status: Exact derivation
Source: [Figiel2025], formula-unit molality reference-state basis
Description: Convert salt formula-unit molality per kilogram of salt-free solvent to mole fractions.
Change note: Uses one kilogram of salt-free solvent as the construction basis.
hard_chain_helmholtz#
Section: Contribution intermediates / Hard chain
Status: Source equation
Source: [Gross2001], Eq.~(A.4)
Description: PC-SAFT hard-chain residual Helmholtz contribution.
Change note: Mirrors the site-independent chain term.
hard_sphere_contact#
Section: Contribution intermediates / Hard chain
Status: Source equation
Source: [Gross2001], Eq.~(A.7) at i=j
Description: Hard-sphere radial distribution function at segment contact.
Change note: Uses the current pure-component contact diameter d_i/2.
hard_sphere_helmholtz#
Section: Contribution intermediates / Hard chain
Status: Source equation
Source: [Gross2001], Eq.~(A.6)
Description: Boublik-Mansoori-Carnahan-Starling-Leland hard-sphere Helmholtz term.
Change note: Cancel density through composition moments before arithmetic at vacuum; the equivalent expression below is regular at zero density.
helmholtz_lagrangian_dual#
Section: Equilibrium
Status: Documentation-only
Source: [Pereira2012] problem D and Eq. 6
Description: Lagrangian dual in independent admissible composition-volume coordinates; a and v are molar Helmholtz energy and volume. Equality to the equilibrium convex envelope requires the source assumptions and an exact global inner infimum.
Change note: A source method, not an installed discovery claim; local search and finite outer cuts cannot certify a closed global gap.
ideal_gas_density#
Section: Density closure and mechanical domain
Status: Exact derivation
Source: Ideal-gas limiting relation
Description: Exact density closure for the declared neutral ideal-gas base; also the density scale for residual-model searches.
Change note: The ideal-gas base has one stable vapor root with pressure slope RT and no packing bound.
ideal_gas_helmholtz#
Section: Reference thermochemistry / Ideal side
Status: Exact derivation
Source: Michelsen and Mollerup 2007, Thermodynamic Models: Fundamentals and Computational Aspects, ch. 2 (ideal-gas contribution); the translational and mixing term is registered under phase_helmholtz_amount_volume
Description: Molar reference offset added to the dimensionless ideal density/mixing term using fixed rho0. Per-species pressure-standard thermochemistry must be declared; absent reference data makes total calorics unavailable.
Change note: Includes pressure-to-density standard-state conversion; a_ref denotes a molar offset, not an independently complete ideal Helmholtz function.
implicit_second_action#
Section: Equilibrium
Status: Exact derivation
Source: Twice differentiating F(y(theta),theta)=0 on a smooth fixed branch with nonsingular F_y
Description: a, b and c are independent parameter directions; subscripts on F are partial derivatives and y_a is a total directional action. The third relation uses the augmented variable z=(y,theta), tangents t_a=(y_a,a) and second variations u_ab=(y_ab,0). Along a diagonal path theta(t)=theta_0+t w the coefficients of y(t)=sum_k y_k t^k satisfy the same recurrence with the unknown coefficient set to zero; mixed actions follow by half-sign polarisation of the diagonal paths. Solve linear systems without explicitly inverting F_y.
Change note: Reconciled against transfer audit 2026-09-06; E5 (2026-09-16) adds the third-order relation and the coefficient recurrence that realises A1 to A3; required mathematics, not an availability claim.
implicit_sensitivity#
Section: Equilibrium
Status: Exact derivation
Source: Implicit-function theorem on the KKT system
Description: First implicit sensitivity of F(y,theta)=0 on a smooth fixed branch with a square nonsingular row Jacobian; solve the linear system rather than forming its inverse.
Change note: Rows made of first energy derivatives generally need second energy derivatives here. Higher-order observables/rows require their own order; see ALG-ACTIONS.
infinite_dilution_solvation_energy#
Section: Electrolyte reference states and reported activities
Status: Source equation
Source: [Figiel2025], infinite-dilution fugacity-to-solvation-energy relation
Description: Single-ion infinite-dilution solvation Gibbs energy on the EOS reference convention.
Change note: Uses the terminal reference-sequence log fugacity.
interphase_potential_equality#
Section: Equilibrium
Status: Exact derivation
Source: Consequence of chemical_potential_stationarity
Description: Equal chemical potential for neutral species and equal electrochemical potential for ions in two supports.
Change note: Not imposed a second time.
ion_suppressed_bulk_permittivity#
Section: Electrolyte dielectric and Debye–Huckel relations
Status: Source equation
Source: Zuber et al. 2014 per-ion suppression coefficients (Zuber2014); [Figiel2025] is the special case with one coefficient for every ion
Description: Bulk relative permittivity of an electrolyte solution as the salt-free solvent-mixture permittivity suppressed by the ion mole fractions with per-ion coefficients.
Change note: One equation covers ion-specific suppression, ion-fraction suppression (all alpha equal) and solvent-only (alpha = 0); the model layer fills the coefficients.
ionic_packing_diameter#
Section: Parameter setup
Status: Implementation convention
Source: Declared ion-specific hard-chain diameter; source packets retain the originating convention
Description: Ionic hard-chain packing diameter, independent of Debye–Huckel and Born diameters.
Change note: Removes the Born-selector dependency and keeps packing, Debye–Huckel, and Born lengths independently declarable. A declared charged molecule (i in C) takes
neutral_segment_diameterand declares no packing diameter.
ionic_strength_charge_sum#
Section: Electrolyte dielectric and Debye–Huckel relations
Status: Source equation
Source: [Bulow2019], charge-weighted composition in the screening definition
Description: Mole-fraction charge-square sum entering Debye screening.
Change note: Only charged components contribute.
isentropic_compressibility#
Section: Thermodynamic properties
Status: Exact derivation
Source: Exact derivation from
pressure,residual_chemical_potentialand the T/V Hessian columns of StateDescription: Isentropic compressibility at fixed composition.
Change note: Computed only on request; availability of
isothermal_compressibilityandheat_capacity_ratio.
isobaric_expansivity#
Section: Thermodynamic properties
Status: Exact derivation
Source: Exact derivation from
pressure,residual_chemical_potentialand the T/V Hessian columns of StateDescription: Isobaric expansivity at fixed composition.
Change note: Computed only on a derived_properties request; unavailable unless (dP/drho)_T,x is finite and positive. A positive slope does not certify phase stability.
isothermal_compressibility#
Section: Thermodynamic properties
Status: Exact derivation
Source: Exact derivation from
pressure,residual_chemical_potentialand the T/V Hessian columns of StateDescription: Isothermal compressibility at fixed composition.
Change note: Computed only on a derived_properties request; unavailable unless (dP/drho)_T,x is finite and positive. A positive slope does not certify phase stability.
joule_thomson_coefficient#
Section: Thermodynamic properties
Status: Exact derivation
Source: Exact derivation from
pressure,residual_chemical_potentialand the T/V Hessian columns of StateDescription: Joule-Thomson coefficient (dT/dP at constant molar enthalpy) in K/Pa; negative values are physical.
Change note: Computed only on request; unavailable unless total c_p is available and positive. Numerator and denominator are both molar.
log_fugacity_coefficient#
Section: Thermodynamic properties
Status: Source equation
Source: [Gross2001], Eq.~(A.32)
Description: Natural logarithm of the component fugacity coefficient.
Change note: Available only when the compressibility factor is positive.
log_fugacity_coefficient_terms#
Section: Thermodynamic properties
Status: Exact derivation
Source: Term-wise split of
residual_chemical_potentialinlog_fugacity_coefficient; [Gross2001], Eq.~(A.32)Description: Contribution of each residual Helmholtz term \(k\) to the component log fugacity coefficient; \(\ln Z\) is reported once.
Change note: Read on request at a temperature-density state. Association is stationary in the site fractions, so the partial derivative at the converged sites equals the total derivative.
log_fugacity_density_derivative#
Section: Thermodynamic properties
Status: Documentation-only
Source: Exact derivative of Eqs.~
residual_chemical_potentialandlog_fugacity_coefficientDescription: Density derivative of log fugacity used by active fixed-pressure observations.
Change note: Independent density-coordinate identity for checking the generic extensive-coordinate Hessian.
material_balance#
Section: Equilibrium
Status: Source equation
Source: [Pereira2012] Eq. 1 (without reactions) and Eq. 3
Description: Conserved-moiety balance over the phases, each weighted by its amount; B is the identity when no reaction is declared.
Change note: Rank of B is the number of balance rows.
mean_ionic_activity_coefficient#
Section: Electrolyte reference states and reported activities
Status: Source equation
Source: [Figiel2025], stoichiometric mean ionic activity definition
Description: Stoichiometric mean ionic activity coefficient on the mole-fraction basis.
Change note: Supports the one-formula-unit cation/anion topology.
mean_segment_count#
Section: Density and packing
Status: Source equation
Source: [Gross2001], Appendix A mixture definition
Description: Composition-averaged segment count.
Change note: Reconciled to the current residual Helmholtz owner.
mechanical_stability#
Section: Density closure and mechanical domain
Status: Source equation
Source: Standard isothermal mechanical-stability criterion
Description: Positive isothermal pressure slope required for a stable density root.
Change note: Finite positive slope defines local mechanical stability; numerical conditioning is recorded separately.
modified_fraction_chart#
Section: Equilibrium
Status: Exact derivation
Source: [Pereira2012] composition chart extended to charged species per Perdomo et al. 2025 (Perdomo2025) Section 3
Description: Modified mole fractions of a charged phase after eliminating one ion by electroneutrality; the modified fractions sum to one and the eliminated ion is reconstructed from the retained ones.
Change note: Valid only where each retained factor is nonzero and the reconstructed composition is admissible. Other supports require another regular charge chart; no installed search is implied.
molality_activity_conversion#
Section: Electrolyte reference states and reported activities
Status: Source equation
Source: [Figiel2025], mole-fraction to molality activity conversion
Description: Convert the mean ionic coefficient to formula-unit molality; define total solute-species molality for a single solvent.
Change note: Uses solvent molar mass in kilograms per mole. Each occupied non-solvent molecular or ionic species contributes once to q.
multiplier_potential_link#
Section: Equilibrium
Status: Exact derivation
Source: [Pereira2012] Eq. 7 in the modified chart of Perdomo et al. 2025 (Perdomo2025)
Description: Dimensional modified chemical potentials in J/mol are conjugate to modified fractions. Dimensionless dual multiplier alpha is their difference divided by RT; d is the dependent normalized coordinate.
Change note: The regular chart and admissible composition are required. Dual multipliers are distinct from dimensional balance/charge multipliers and numerical optimizer multipliers.
neutral_reference_stoichiometric_basis#
Section: Native phase coordinates
Status: Exact derivation
Source: Exact charge-neutral basis from explicit stoichiometric declarations
Description: Native standard-reference rows and log-fugacity contractions.
Change note: Neutral-component unit rows and a spanning set of cation-anion formula rows are immutable for a resolved model.
neutral_segment_diameter#
Section: Parameter setup
Status: Source equation
Source: [Gross2001], Eq.~(A.9); for i in C, [Held2014] Eqs.~(21)–(22) and the text after them, [Uyan2015] Eqs.~(10)–(11)
Description: Temperature-dependent hard-chain diameter for neutral components and declared charged molecules.
Change note: Reconciled to the current neutral diameter branch. C is the set of ions declaring
fixed.charged_molecule_ion. Held2014 and Uyan2015 obtain the fixed ion diameter 0.88 sigma from this equation with the like-ion dispersion energy set to zero; an ion that keeps its own like-pair well depth takes this equation with its own u_i (an inference from that derivation; the sources state only the zero-dispersion direction). Its u_i derivative ispacking_coefficient_parameter_derivative’s neutral rule.
outer_approximation_bound#
Section: Equilibrium
Status: Source equation
Source: [Pereira2012] problem OP; [Pereira2012] Section 2 after Mitsos and Barton 2007 (MitsosBarton2007)
Description: Finite outer approximation of the semi-infinite dual: maximize a scalar bounded by every retained cut and by the feed free energy; the optimum is an upper bound on the dual value and its multipliers drive the next inner problem.
Change note: Solved as a linear program over the retained set M; the feed cut has zero slope.
packing_coefficient_parameter_derivative#
Section: Native phase coordinates
Status: Exact derivation
Source: Chain rule through the packing-fraction coordinate map; the packing fraction definition and the temperature-dependent segment diameter are registered under packing_fraction and the hard-sphere diameter entries
Description: At fixed T, packing fraction and composition, differentiate c=(pi/6) N sum_i x_i m_i d_i cubed, where N=N_p N_A 10^-30 for phase amount N_p in mol and diameters in angstrom; c has cubic-metre units. The displayed partials specialize the neutral Gross diameter rule.
Change note: For other diameter correlations or active coefficients differentiate their defining equation as well; these partials do not establish universal zero derivatives for additional families.
packing_fraction#
Section: Density and packing
Status: Source equation
Source: [Gross2001], Eq.~(A.8) at n=3
Description: Packing fraction from molar density and segment geometry.
Change note: Shared by Helmholtz evaluation and EOS domain owners.
packing_fraction_coefficient#
Section: Density and packing
Status: Exact derivation
Source: Exact specialization of Eq.~
packing_fractionDescription: Composition and temperature coefficient satisfying eta=rho_m c_eta.
Change note: Mirrors the value-only volume-domain helper.
packing_moments#
Section: Density and packing
Status: Source equation
Source: [Gross2001], Eq.~(A.8)
Description: Segment-density moments used by hard-chain and association terms.
Change note: Uses the current angstrom number-density basis.
packing_volume_bounds#
Section: Native phase coordinates
Status: Exact derivation
Source: Exact inversion of eta=c_eta/V_m
Description: Molar-volume interval corresponding to caller-owned packing-fraction limits.
Change note: The EOS owns c_eta while the caller owns eta_min and eta_max.
pair_parameter_temperature_law#
Section: Parameter setup
Status: Implementation convention
Source: [Held2014], Tables 1–2; [Uyan2015], Eqs.~(26)–(27); [Bulow2021MDEA], Eq.~(26)
Description: One declared temperature law for k_ij, l_ij, explicit association energy over k_B or volume, or a combining-rule volume correction; the family covers the cited affine, quadratic and cubic laws and the existing reciprocal-temperature term.
Change note: Coefficients are active slots; T_r and the term powers are fixed declarations. Undeclared k_ij keeps
cross_dispersion_energy’s constant and reciprocal-slope arithmetic.
partial_molar_enthalpy#
Section: Thermodynamic properties
Status: Exact derivation
Source: Exact derivation from
pressure,residual_chemical_potentialand the T/V Hessian columns of StateDescription: Partial molar enthalpy of component i at fixed T and P on the supplied ideal thermochemistry basis.
Change note: Computed only on request; availability of
partial_molar_volumeplus Available thermochemistry for the whole record. Component h_i^o comes from the existing interval selection and correlation owner at the record’s standard pressure P^o. d_i is the fixed-P, fixed-x temperature derivative of ln phi_i. The x-weighted sum equals the total molar enthalpy.
partial_molar_entropy#
Section: Thermodynamic properties
Status: Exact derivation
Source: Exact derivation from
pressure,residual_chemical_potentialand the T/V Hessian columns of StateDescription: Partial molar entropy of component i at fixed T and P on the supplied ideal thermochemistry basis.
Change note: Availability of
partial_molar_enthalpy, and unavailable at x_i = 0, where ln x_i diverges. It keeps the same-density residual entropy of State; the x-weighted sum equals the total molar entropy.
partial_molar_volume#
Section: Thermodynamic properties
Status: Exact derivation
Source: Exact derivation from
pressure,residual_chemical_potentialand the T/V Hessian columns of StateDescription: Partial molar volume of component i at fixed T and P, the amount derivative of extensive volume, evaluated at N = 1 mol.
Change note: Computed only on request, in component order; unavailable for an IonicInsertion component or a nonpositive slope. A zero-fraction neutral species gives its finite insertion limit. For present ions only electroneutral combinations carry a physical claim.
phase_dimensionless_helmholtz#
Section: Native phase coordinates
Status: Exact derivation
Source: Exact ideal-mixing plus residual Helmholtz construction
Description: Dimensionless mechanical phase energy. Reference offsets are omitted only for mechanical/nonreactive differences where they cancel; reactive and total caloric calculations require the declared total phase energy.
Change note: n_ref=1 mol and rho_ref=rho0=1 mol per cubic metre. Phi in mechanical derivative entries denotes this mechanical function.
phase_electroneutrality#
Section: Equilibrium
Status: Source equation
Source: [Ascani2022] Eq. 5; Tsanas et al. 2019 Section 2.2.1 and 2022 Section 2.4 (Tsanas2019, Tsanas2022)
Description: Per-phase electroneutrality for every ion-containing phase except one phase of nonzero amount; the omitted phase’s neutrality follows from the balance rows and a neutral feed.
Change note: One row fewer than the ion-containing phases; if every ion-containing phase is pinned at zero amount, all carry the row.
phase_helmholtz_amount_volume#
Section: Equilibrium
Status: Exact derivation
Source: [Gross2001] Appendix A with the ideal-gas mixing term
Description: Mechanical phase energy contains ideal density/mixing and residual terms; total phase energy additionally contains the molar reference offset defined by ideal_gas_helmholtz.
Change note: N_p is mol, V_p is cubic metres, rho0 is the fixed reference molar density. Missing reference thermochemistry does not define total calorics.
phase_molar_density#
Section: Native phase coordinates
Status: Exact derivation
Source: Exact extensive-to-intensive coordinate transformation
Description: Phase molar density from total amount and extensive volume.
Change note: Uses SI mole and cubic-metre coordinates.
phase_mole_fraction#
Section: Native phase coordinates
Status: Exact derivation
Source: Exact extensive-to-intensive coordinate transformation
Description: Phase mole fractions from explicit component amounts.
Change note: Requires positive total amount n and nonnegative component amounts. Positive individual amounts are required only for their logarithmic interior coordinates; insertion derivatives have separate domains.
phase_normalization#
Section: Equilibrium
Status: Implementation convention
Source: Composition closure of every declared phase
Description: Composition normalisation of every phase, free or pinned, so that the coordinates (N_p, x_p, V_p) are uniform and a pin removes exactly one variable.
Change note: Replaces incipient_normalization, which named a row that is now universal.
phase_packing_fraction#
Section: Density and packing
Status: Exact derivation
Source: Exact extensive-coordinate form of Eq.~
packing_fractionDescription: Packing fraction in explicit component amounts and extensive volume.
Change note: Mirrors the native phase-domain derivative owner.
phase_packing_volume#
Section: Equilibrium
Status: Exact derivation
Source: Packing-fraction definition, [Gross2001] Eq. (A.8)
Description: Phase volume in cubic metres from amounts in mol, diameters in angstrom and dimensionless packing fraction.
Change note: Includes molecule-per-mol and cubic-angstrom-to-cubic-metre conversion; matches phase_packing_fraction.
phase_pressure#
Section: Native phase coordinates
Status: Exact derivation
Source: Exact extensive Helmholtz derivative
Description: Phase pressure from the volume gradient of the dimensionless phase Helmholtz function.
Change note: Returned on the original pascal scale.
phase_support#
Section: Equilibrium
Status: Implementation convention
Source: Declared phase support; structural, no source equation
Description: A species outside a phase’s declared support has zero amount in that phase; the coordinate is removed, not bounded.
Change note: Structural row: it removes a variable rather than adding an equation, so it carries no multiplier and does not enter the count rule.
phase_total_amount#
Section: Native phase coordinates
Status: Exact derivation
Source: Exact extensive-coordinate definition
Description: Total phase amount from explicit component amounts.
Change note: Shared by neutral and electrolyte phase blocks.
practical_osmotic_coefficient#
Section: Electrolyte reference states and reported activities
Status: Source equation
Source: [HamerWu1972], practical molal osmotic-coefficient definition; common-pressure identity from Eqs.~
log_fugacity_coefficientandpressureDescription: Dimensionless practical molal osmotic coefficient from pure-solvent-referenced solvent activity.
Change note: One neutral solvent, evaluated at common prescribed T/P with the same parameters and permittivity model. The scalar residual chemical-potential difference uses the extensive Helmholtz Euler identity in extended precision, with Z=P/(RT rho). Subscripts f and p denote the finite solution and pure solvent, a^r is per mole, and the sum traverses occupied non-solvent species. For one salt, q=(nu_++nu_-)m. At q=0 activity is exactly one and Phi is undefined; below the total-species molality floor Phi is unavailable. The one-salt helper also retains its formula-molality floor. Liquid-side regularity is required; this does not establish global phase stability.
pressure#
Section: Thermodynamic properties
Status: Source equation
Source: [Gross2001], Eq.~(A.23)
Description: EOS pressure from compressibility factor.
Change note: Returns pressure in pascals on the SI molar-density basis.
pressure_density_derivative#
Section: Thermodynamic properties
Status: Exact derivation
Source: Exact derivative of Eq.~
pressureDescription: Isothermal pressure derivative used by density closure and stability checks.
Change note: Transforms CppAD density partials without expanding the EOS derivative.
pressure_state_hessian#
Section: Thermodynamic properties
Status: Exact derivation
Source: Differentiate Eq.~
pressurewith Eq.~compressibility_factor, at fixed composition and physical parametersDescription: Pressure gradient and Hessian on the independent SI temperature/molar-density chart. Here a denotes dimensionless molar residual Helmholtz energy, r denotes molar density, and subscripts denote partial derivatives.
Change note: Implemented for the bounded single-component neutral case by
HelmholtzModel::neutral_propertyusing the existing Helmholtz tape, and checked by a native property test and the adapter campaign. Association, electrolyte and active-parameter cases remain unavailable; broader use requires a smooth branch and complete implicit chains.
pressure_equality#
Section: Equilibrium
Status: Source equation
Source: [Pereira2012] Eq. 8; [Gross2001] Eq. (A.23)
Description: Stationarity in phase volume: every EOS phase is at the system pressure.
Change note: A stationarity row of the same minimization.
pure_active_parameter_mapping#
Section: Native phase coordinates
Status: Implementation convention
Source: EOS parameterized pure-phase coordinate convention
Description: Construct the pure nonassociating model from active m, sigma, and epsilon-over-k coordinates.
Change note: No generic mutable parameter overlay is introduced.
quadrupolar_helmholtz#
Section: Contribution intermediates / Quadrupole-quadrupole
Status: Source equation
Source: [Gross2005], Eq.~(8)
Description: Optional third-order Padé quadrupole-quadrupole Helmholtz contribution; zero when every quadrupolar species is absent.
Change note: Admitted as an opt-in family by ADR 0014; it shares the dipole’s Padé form and J integrals.
quadrupolar_second_order#
Section: Contribution intermediates / Quadrupole-quadrupole
Status: Exact derivation
Source: [Gross2005], Eq.~(9) with \(q_i=(\epsilon_i/kT)n_{Q,i}Q_i^{*2}\)
Description: Second-order quadrupole-quadrupole perturbation term.
Change note: The reduced moment \(q_i=n_{Q,i}Q_i^2/(4\pi\varepsilon_0kTm_i\sigma_i^5)\) absorbs \(\epsilon_i\).
quadrupolar_third_order#
Section: Contribution intermediates / Quadrupole-quadrupole
Status: Exact derivation
Source: [Gross2005], Eq.~(10) with the same \(q_i\) and \(J_{3,ij}=0\) (Eq.~(14))
Description: Third-order quadrupole-quadrupole perturbation term.
Change note: \((4\pi^2/3)(3/4)^3=9\pi^2/16\); the sign is positive, as in Eq.~(A11).
reaction_affinity#
Section: Equilibrium
Status: Exact derivation
Source: Consequence of chemical_potential_stationarity with \(\mathbf{B}\boldsymbol\nu=0\)
Description: Vanishing affinity for every reaction in the nullspace of the balance matrix.
Change note: A problem with B = I has no affinity row.
reaction_activity_quotient#
Section: Equilibrium / Reaction standard states
Status: Exact derivation
Source: Chemical-potential definition on one declared standard-state basis
Description: Products-positive reaction quotient from dimensionless activities on one identified basis. Activities and the equilibrium constant must use the same basis. On the pressure basis the activities are fugacity ratios \(f_i/P^\circ\) at a declared standard pressure; \(f_i=x_i\rho RT\exp(\mu^{\mathrm{res}}_i/RT)\) gives \(\ln Q_P=\ln Q_\rho+\Delta\nu\ln(RT/P^\circ)\) with \(\Delta\nu=\sum_i\nu_i\), equal to \(\ln K_P\) at equilibrium by standard_pressure_density_conversion. A present pure solid has activity one on its pure-solid standard state (solid_standard_gibbs).
Change note: Zero activities may have limiting values, but logarithmic insertion derivatives are not implied. The pressure-basis quotient’s first actions are partial derivatives at the phase state along \(T\), \(P\) and \(\mathbf e_j-\mathbf x\), from the exact log-fugacity actions.
ideal_mole_fraction_reaction#
Section: Equilibrium / Reaction standard states
Status: Source equation
Source: Nasrifar and Tafazzol (2010), DOI 10.1021/ie901181n, Eq. (11), Table 1 and section 6, pp.7621,7627; ideal activity assumption
Description: Dimensionless mole-fraction activities with standard fraction one; positive products stoichiometry and caller-declared constants on the ideal-mole-fraction basis. Pressure does not enter these liquid chemistry rows.
Change note: Specializes reaction_activity_quotient. ReactionLogPolynomial owns the temperature law; its finite positive logarithm reference is independent of its evaluation interval. No EOS density or infinite-dilution correction applies.
ideal_molarity_reaction#
Section: Equilibrium / Reaction standard states
Status: Exact derivation
Source: IAPWS TGD9-18, Table 2, p.15, 25 °C concentration constants; reaction_activity_quotient and ideal_reaction_amount_coordinates
Description: Fixed declared solution volume V in m³ and absolute amounts in mol, with standard concentration c° = 1000 mol/m³. A declared neutral solvent has unit activity; no identifier selects this exception.
Change note: Products-positive stoichiometry. The formal proton convention H3O+ = H+ + H2O with unit water activity preserves the numerical source constants. This is ideal concentration chemistry, without EOS density closure or real-solution validation.
ideal_reaction_amount_coordinates#
Section: Equilibrium / Amount coordinates
Status: Exact derivation
Source: ideal_mole_fraction_reaction, ideal_molarity_reaction and material_balance; logarithm and exponential chain rules
Description: Log amounts on either ideal activity basis, scaled by positive feed mol, with independent conserved null-space rows. There are s coordinates and r+(s-r) equations; charge conservation follows from the neutral feed and charge-conserving reactions.
Change note: The feasibility objective is zero. No density, phase-amount, normalization or balance-dual coordinate is added. CppAD differentiates the same row expression for the existing Ipopt driver and exact-Jacobian polish.
mdea_reaction_conserved_amounts#
Section: Equilibrium / Reaction inventories
Status: Exact derivation
Source: Null space of Nasrifar and Tafazzol (2010), Eqs. (1)-(6), p.7621; hydronium stoichiometry
Description: Physical inventory checks for the caller-declared aqueous MDEA/CO2/H2S example. The Engine computes a general null-space basis, independent of these example species names.
Change note: Water equivalent includes hydronium. The paper’s printed Eq. (12) omits it and does not conserve R1; these conserved equations do not reproduce that printed balance.
reaction_standard_state_conversion#
Section: Equilibrium / Reaction standard states
Status: Exact derivation
Source: Invariance of chemical potential under a declared standard-state change
Description: Convert a reaction constant only from explicit per-species standard chemical-potential offsets. Units alone do not define a conversion.
Change note: Mole-fraction uses explicit dimensionless standard fraction one; molarity and molality require explicit positive standard concentration or molality and the matching coefficient/reference path.
reaction_standard_state_polynomial_image#
Section: Equilibrium / Reaction standard states
Status: Exact derivation
Source: Integration of \(\Delta c_p(T)=\Delta c_{p,0}+\Delta c_p'(T-T_0)\) into Eq.~
reaction_standard_state_conversionDescription: A standard-state change whose old-minus-new reaction enthalpy, entropy, heat capacity and heat-capacity slope are known at \(T_0\) shifts \(\ln K\) by a member of the
reaction_constant_ln_polynomialfamily, so one correlation form carries the change exactly through every temperature derivative. Zero heat-capacity terms give the constant-enthalpy shift.Change note: Its implementation replaces the former constant-enthalpy point-conversion routine; the general identity in
reaction_standard_state_conversionremains its source. The reference-state pressure path is not part of this identity; a fixed-pressure or system-pressure reference chain contributes separately.
reaction_constant_ln_polynomial#
Section: Equilibrium / Reaction standard states
Status: Bounded empirical relation
Source: Austgen, Rochelle, Peng and Chen 1989, Ind. Eng. Chem. Res. 28, 1060, ln K(T); Parkhurst and Appelo (2013), USGS Techniques and Methods 6-A43, SOLUTION_SPECIES, printed p.200, analytical expression (https://doi.org/10.3133/tm6A43).
Description: Temperature correlation of a reaction equilibrium constant on its declared standard state, with its analytic temperature derivative, which is the van ‘t Hoff reaction enthalpy on that standard state divided by RT²; valid on the declared temperature domain only.
Change note: \(T_{ref}>0\) is explicit. A legacy \(c\ln(T/(1\,\mathrm K))\) coefficient is normalized without changing values by replacing \(a_{old}\) with \(a=a_{old}+c\ln(T_{ref}/(1\,\mathrm K))\). Standard-state quantities are held fixed in the displayed derivative; temperature-dependent reference conversions contribute separately. Engine fitting admits stored natural-log coefficients through
reaction_constant_coordinate_derivative, at first order for state actions and for referenced finite-addition enthalpy actions at fixed temperature. Heat-capacity coefficient actions, coefficient Hessians and referenced free-temperature fitting are not implied; parameter adoption remains application-owned. Coefficients \((a,b,c,d,e,f)\) have units \((1,\mathrm K,1,\mathrm K^{-1},\mathrm K^2,\mathrm K^{-2})\); temperatures are in kelvin and \(K\) is dimensionless on its declared source activity standard. All coefficients are finite and \(0<T_{min}\le T\le T_{max}\); the interval is inclusive. The two added coefficients default to zero and remain fixed during fitting. PHREEQC’s \(\log_{10}K=A_1+A_2T+A_3/T+A_4\log_{10}[T/(1\,\mathrm K)]+A_5/T^2+A_6T^2\) maps, for the same reaction direction and source standard, by the displayed coefficient conversion.
reaction_constant_coordinate_derivative#
Section: Equilibrium / Reaction standard states
Status: Exact derivation
Source: Chain rule for
reaction_constant_ln_polynomial, the minimum-norm standard state inchemical_potential_stationarity, andimplicit_sensitivityDescription: A fitted source-basis coefficient changes its density-basis reaction target by the same basis function. The source molality scale and reference contraction have no reaction-coefficient dependence. The minimum-norm image supplies chemical-row derivatives, and the existing defining Jacobian supplies the solved-state derivative.
Change note: Coefficients a, b, c, d have units 1, K, 1, K⁻¹, with explicit positive Tref. Scalar ln K admits only a with basis 1. Evaluate the coefficient law at the path temperature T(t) for state actions, including its free-temperature chain. For referenced enthalpy actions at fixed temperature, coefficient directions also change the source temperature slope by \(\phi_k'(T)\) and the reaction enthalpy by \(RT^2\phi_k'(T)\). The bounded caloric actions consume the same analytic thermal coefficient terms; outer coefficient Hessians remain outside this consumer set. Source/reference declarations and non-fitted coefficients remain fixed. The stoichiometric matrix N has reactions as rows and species as columns. The constant source reaction-enthalpy shift \(h\) (J/mol) at a fixed declared pivot \(T_p\) is one derived coefficient direction, preserving the supplied correlation. The existing coefficient chain consumes the combined direction \(\mathbf w\). For the
reaction_constant_log10_reciprocalview, a native law with \(c=e=f=0\) replays as \((A,B,C)=-(b,a,d)/\ln 10\); source metadata remains caller-owned.
source_log_equilibrium_constant_observation#
Section: Parameter regression / Reaction observations
Status: Exact derivation
Source:
reaction_constant_ln_polynomial(Austgen et al. 1989, ln K(T) correlation)Description: A direct observation is the named reaction’s declared source-basis natural-log equilibrium constant at fixed positive temperature. It does not contain the EOS reference contraction or an equilibrium-state derivative.
Change note: Fixed source declarations and Tref; a/b/c/d units are 1, K, 1, K⁻¹. Scalar K admits ln K with the a basis only. Reuse named-coordinate tying and rejection of fixed thermochemistry, affinity targets and dependent sets. Only Difference residuals are admitted. An absolute ln K uncertainty σ uses scale=1 and weight=σ⁻²; a chosen nondimensionalization scale requires the corresponding weight transformation. Covariance retains ALG-FIT’s local rank/bound/error assumptions.
reaction_constant_log10_reciprocal#
Section: Equilibrium / Reaction standard states
Status: Bounded empirical relation
Source: The −log10 K = a/T + b + cT form as recorded for MEA reaction R5 in the MEA-Thermodynamics source specification (Aroua 1999, Tong 2012)
Description: Temperature correlation of a reaction equilibrium constant in decadic-logarithm form, converted to the natural logarithm, with its analytic temperature derivative; fitting uses the explicitly converted native coefficients; valid on the declared temperature domain only.
Change note: The three-coefficient view requires native \(c=e=f=0\); otherwise it is refused. Source notation ln(T) means ln(T/(1 K)); coefficients use the numerical Kelvin convention. Standard-state quantities are held fixed in the displayed derivative; temperature-dependent reference conversions contribute separately. Engine fitting admits stored natural-log coefficients through
reaction_constant_coordinate_derivative, at first order only; parameter adoption remains application-owned.
reduced_hessian_stability#
Section: Equilibrium
Status: Exact derivation
Source: Second-order sufficient condition for a constrained local minimum
Description: Reduced Lagrangian Hessian over the constraint nullspace is positive definite.
Change note: Sufficient strict local minimum condition at a regular stationary point; neither necessary in degenerate cases nor a global certificate.
neutral_reaction_reference_transfer#
Section: Equilibrium / Reaction standard states
Status: Exact derivation
Source: Chemical-potential equality on the density standard and the dilute molality-to-mole-fraction identity
Description: Charge-neutral reaction contraction with a declared neutral solvent and optional per-species pure-liquid, pure-vapor or infinite-dilution references. Products have positive stoichiometry; solvent molar mass is in kg/mol and the molality standard in mol/kg. The source basis is explicit.
Change note: The solvent standard uses the exact ion-free liquid state. Pure overrides require neutral species and a positive-slope root on the declared side of the pure isotherm’s mechanical loop; a single root with no sampled loop serves either branch. Infinite-dilution species use
infinite_dilution_referenceat the same source pressure. Every returned T/P/parameter column differentiates that reference, with independent numerical availability. Nondefault mixed common-molality declarations are refused. Uyan (2015), Eqs. 22–23, specify pure water and solute infinite dilution; the historical CO2 vapor selection at e12a5ff8 is not an unambiguous paper attribution. Per-species activities use raw mole fractions; uniform common molality retains A_r. Declarations are fixed under system composition actions. Fixed-source system-pressure derivatives are exact zeros. Ionic references qualify charge-neutral contractions, without an absolute single-ion standard.
neutral_reaction_reference_pressure_jet#
Section: Equilibrium / Reaction standard states
Status: Exact derivation
Source: Implicit differentiation of the pressure closure and the neutral reaction reference contraction at fixed temperature and composition
Description: First and second source-pressure derivatives of the analytic solvent-limit contraction. The extensive regular residual potential is psi=Ares/(RT), at N=1 mol and V=1/rho_s; its single ionic insertion includes Born and the zero Debye–Hückel limit. DeltaNu is the stoichiometric mole change.
Change note: Derivatives follow the same regular positive-slope density branch as the value. A reference at fixed source pressure has zero derivatives with respect to system pressure. E2 and E3 provide the displayed single-state partials; for mixed references, sum the masked dilution contribution and each selected pure-state contribution through
reference_single_insertion_taylor. No runtime finite differences are used. Higher source-pressure derivatives are supplied byreference_mixed_temperature_pressure_derivativesin Properties; downstream use is separately qualified. The first temperature and parameter derivatives arestandard_state_transfer_temperature_derivativeandstandard_state_transfer_parameter_derivative, and the mixed temperature-pressure derivative isstandard_state_transfer_temperature_pressure_derivative.
speed_of_sound#
Section: Thermodynamic properties
Status: Exact derivation
Source: Exact derivation from
pressure,residual_chemical_potentialand the T/V Hessian columns of StateDescription: Thermodynamic speed of sound in m/s: the composition-frozen acoustic limit without transport, chemical relaxation or phase redistribution.
Change note: Computed only on request; availability of
isentropic_compressibility, plus a positive molar mass for every occupied species. M is in kg/mol; zero-fraction species do not contribute.
standard_state_transfer_temperature_derivative#
Section: Equilibrium / Reaction standard states
Status: Exact derivation
Source: Implicit differentiation of the pressure closure at the fixed ion-free solvent composition of the neutral reaction reference; Lambda = ln phi + ln(P/(RT rho0)) and RT^2 d ln phi_i/dT|_P = -hbar_i^res
Description: First temperature derivative at fixed reference pressure of the returned reference limit and of the density-basis equilibrium constant. psi=Ares/(RT) is evaluated at N=1 mol and V=1/rho, and the source basis term A is temperature independent. The target is transported as s=-ln K_rho, whose slope maps to species through the same minimum-norm owner as its value.
Change note: Differentiate the returned solvent insertion with
reference_single_insertion_taylor, retaining the implicit density and site chains. No finite dilution or terminal-change criterion is evaluated. A system-pressure row combines this slope with the pressure jet. The second T derivative and active-parameter derivatives have their own requested columns.
standard_state_transfer_parameter_derivative#
Section: Equilibrium / Reaction standard states
Status: Exact derivation
Source: Implicit differentiation of the pressure closure in an active EOS coordinate at fixed temperature, reference pressure and ion-free solvent composition of the neutral reaction reference
Description: First and mixed second derivatives in active EOS parameters theta_a, theta_b, at fixed temperature and reference pressure, of the returned reference limit. psi=Ares/(RT) is evaluated at N=1 mol and V=1/rho. ln K_src and the molality scale A are parameter independent, so the target slopes are -dC/dtheta_a and -d2C/dtheta_a dtheta_b. They map to species through the same minimum-norm owner as the value and enter each chemical row as the first- and second-order Taylor terms in theta at the solved state.
Change note: One or two active coordinates at ion-free solvent fractions; a pair column carries T/P order through two for caloric second-order actions and order zero otherwise. The parameter scale used in polarization is max(abs(theta),1) in native units, with max(abs(d_V),1e-3 m3/mol) for dielectric volume; a pair column scales by the product of its two coordinate scales. Scaling is restored after extraction; it introduces no approximation or column admission tolerance. The second derivatives are evaluated only for a second-order action with two or more parameter-bearing directions, and only on the coordinates those directions move; with one such direction the second-order term cancels between the polarised paths. Referenced enthalpy additionally consumes
standard_state_transfer_temperature_parameter_derivative; heat capacity consumesreference_mixed_temperature_pressure_derivatives.
standard_state_transfer_temperature_parameter_derivative#
Section: Equilibrium / Reaction standard states
Status: Exact derivation
Source: Mixed implicit differentiation of the isobaric reference contraction and pressure closure along one active EOS coordinate, at fixed temperature, reference pressure and ion-free solvent composition
Description: Mixed derivative \(\partial^2C/\partial T\partial\theta\) of the returned reference limit, with \(\psi=A^{res}/(RT)\) at \(N=1\) mol. It supplies the EOS-coordinate derivative of referenced reaction enthalpy; \(C\) is independent of the solved equilibrium state.
Change note: Evaluate only for a consumed referenced-enthalpy parameter column. The shared single-insertion Taylor calculation supplies the mixed partial at the ion-free solvent root, with exact Born, association and density chains. A failed column retains its action cause and does not erase values or sibling directions. Higher consumed derivatives follow
reference_mixed_temperature_pressure_derivativesandreference_species_calorics.
standard_state_transfer_temperature_second_derivative#
Section: Equilibrium / Reaction standard states
Status: Exact derivation
Source: Second implicit differentiation of the pressure closure at the fixed ion-free solvent composition; for identical species RT^2 dLambda/dT = -(h^res + RT) gives d2Lambda/dT2 = -(c_p^res + R)/(RT^2) + 2(h^res + RT)/(RT^3)
Description: Second temperature derivative at fixed reference pressure of the returned reference limit along w = e_T + V_T e_V, with psi = Ares/(RT) at N = 1 mol. The shared single-insertion Taylor owner evaluates this lower partial, including implicit association and pressure closure. It supplies the EOS-basis reaction heat capacity consumed by reference species calorics.
Change note: Evaluate only for a consumed heat-capacity value, enthalpy temperature action or second temperature action. The analytic solvent-limit column supplies s_TT=-(d2 ln K_src/dT2 + C_TT). Numerical failures retain their causes independently. Qualification retains the existing 0.01 J/(mol K) scaled comparison with the pinned finite calculation; this comparison is outside runtime.
standard_state_transfer_temperature_pressure_derivative#
Section: Equilibrium / Reaction standard states
Status: Exact derivation
Source: Implicit differentiation of C_P = C_V/p_V (
neutral_reaction_reference_pressure_jet) along the isobaric temperature direction w ofstandard_state_transfer_temperature_second_derivative, at the fixed ion-free solvent compositionDescription: Mixed temperature-pressure derivative of the returned reference limit of a system-pressure reference, with psi = Ares/(RT) at N = 1 mol. The shared single-insertion Taylor owner evaluates the raw source-pressure partial at the resolved terminal state. It supplies s_TP = -d2C/dTdP to the chemical rows of second-order actions that move temperature and pressure, and the pressure slope of the EOS-basis reaction enthalpy, d(Delta_r h_rho)/dP = RT^2 d2C/dTdP, to reference species calorics.
Change note: Evaluate when pressure and temperature columns are both requested. A fixed source pressure gives exact zero system-pressure derivatives. Differentiate the same returned solvent insertion; a failed mixed column leaves values and sibling columns available. Higher orders are supplied only by
reference_mixed_temperature_pressure_derivatives.
repeated_direction_energy_third#
Section: Helmholtz derivatives / Directional actions
Status: Exact derivation
Source: Multivariate Taylor expansion with one direction inserted at order three and the repeated direction at order one
Description: Cancellation-resistant third directional energy action with two equal directions. Brackets extract a Taylor coefficient, not a finite step evaluation; all derivatives include the same implicit association solution.
Change note: Pure fifth-order terms cancel and terms with two copies of u start at order six. This evaluates a third derivative, not a public fifth-derivative capability. Normalize directions before coefficient evaluation and restore their three norms afterwards. Scale v by the largest power of two s <= 1 with s|v_i| <= n_i for every present ion and divide by s^2: the D^5F[v^5] term cancels only exactly, and outside the radius of the DH ionic-strength power it swamps D^3F[u,v,v] in double. No association equation or physical parameter changes.
repeated_direction_energy_gradient#
Section: Helmholtz derivatives / Directional actions
Status: Exact derivation
Source: Reverse propagation of Taylor coefficients (CppAD
Reverse(q, w), vendored documentationxrst/reverse/reverse_any.xrst) applied to the order-two coefficient of the energy along a path, with the implicit site fractions eliminated by Lagrange multipliersDescription: Every coordinate of the twice-repeated third directional energy action, D^3F[v,v,.], at one point from one second-order forward pass along v and third-order reverse sweeps of the existing Helmholtz tape. The tape’s inputs are p = (T, V, n, active parameters) and the site fractions X; its outputs are the energy and the site equations g. X(t) = X_0 + X_1 t + X_2 t^2 follows [t^k]g = 0 for k = 1, 2.
Change note: A model without sites needs one reverse sweep; with sites one per multiplier as well, each multiplier admitted by the residual of its own transposed site equation against the association-action residual limit. Normalize v and restore its norm squared afterwards. No coefficient above order two is formed and no third derivative along a single coordinate is subtracted.
repeated_direction_energy_thirdremains the route of a single repeated-direction action.
reference_single_insertion_taylor#
Section: Helmholtz derivatives / Reference derivatives
Status: Exact derivation
Source: Taylor expansion of the neutral reaction contraction and implicit pressure closure
Description: One fixed-volume amount insertion in the extensive reduced residual Helmholtz energy supplies gradient coefficients along a pressure-closed, fixed-composition base path. Temperature and EOS coordinates can move. Orders one and two also supply the lower reference slopes. The degree-seven/nine evaluations are bounded reference calculations, not unrestricted energy derivative surfaces.
Change note: The same central unweighted site Jacobian eliminates association through degree nine. At an ion-free reference, a separate tape reuses the regular scalar contributions and Born radial work while excluding the analytically zero DH insertion; ordinary state admission is unchanged. Two amount insertions start above the extracted degree. No zero-concentration ionic Hessian is evaluated. Coefficients retain factorials until mixed extraction, and physical normalization is restored once. Mask pure-selected species from the solvent insertion and add their pure-state insertions. Fixed-source system-pressure derivatives are zero.
reference_mixed_temperature_pressure_derivatives#
Section: Properties / Reaction references
Status: Exact derivation
Source: Differentiation of
neutral_reaction_reference_transferwith the single-insertion constructionDescription: Raw SI derivatives through fourth temperature/pressure order, and through third temperature/pressure order with one active EOS-coordinate partial. The only repeated parameter derivatives are the fixed-T/P pairs of
standard_state_transfer_parameter_derivative; no dilution-composition derivatives are consumed.Change note: Each column differentiates the returned analytic reference at the ion-free solvent state using
reference_single_insertion_taylor. Columns retain independent action diagnostics and causes. The existing scaled comparison withreference_limit_terminal_pairis qualification evidence only; no terminal sequence is evaluated in runtime.
reference_limit_terminal_pair#
Section: Electrolyte reference states and reported activities
Status: Implementation convention
Source: Finite terminal-change diagnostic for the declared reference molality sequence.
Description: Pinned qualification comparison for the former finite-molality reference. It extrapolates the 1e-12 and 1e-14 mol/kg points and reports its change from the 1e-10/1e-12 pair. It is not the runtime reference.
Change note: Convergence diagnostic; neither an error bound nor an estimate of actual bias without additional convergence assumptions. The neutral limit removes the Debye-Hueckel c sqrt(m) tail exactly; an O(m) remainder d m leaves -d 1e-13. For Held 2014 NaCl in water at 298.15 K, e_f is 1.3e-11 against raw rung changes of 1.06e-5.
reference_molality_sequence#
Section: Electrolyte reference states and reported activities
Status: Implementation convention
Source: EOS convergence sequence for the [Figiel2025] infinite-dilution reference
Description: Historical finite-molality inputs retained only for qualification of
infinite_dilution_reference. No runtime ladder remains.Change note: The paired baseline declaration and numerical record identify the old inputs and extrapolation. Terminal changes are convergence diagnostics, not certified error bounds. The runtime molality is now exactly zero and terminal-change fields are unavailable; solvent-root and association diagnostics remain defined.
infinite_dilution_reference#
Section: Electrolyte reference states and reported activities
Status: Exact derivation
Source: [Gross2001], A.32–A.33; [Chapman1990], Eqs. 21–24;
born_radial_charging_workDescription: Fixed-volume first insertion into the extensive residual potential at one ion-free solvent pressure root, for a pure solvent or declared neutral solvent mixture. The reference is dimensionless and uses one total log Z correction.
Change note: Hard chain, dispersion, association and admitted polar energy reuse their scalar owners. Association retains solvent-contact response even for a site-free ion. Born has a nonzero insertion; DH and cation pair/triple mixing have zero first insertions. Bulk permittivity and Born shell diameters must be positive, with a regular density root and association Jacobian. A net-neutral charged background is refused as IonicReferenceBackground. T/P and active-coordinate derivatives retain the implicit density/site chains. This defines no ionic-concentration Hessian. No factor of solvent molar mass enters b_i or ln(phi_i); the existing molality conversion remains separate. The retained NaCl comparisons have a case-specific 1e-9 log-fugacity criterion, not a universal error bound or physical validation.
residual_chemical_potential#
Section: Thermodynamic properties
Status: Source equation
Source: [Gross2001], Eq.~(A.33)
Description: Dimensionless residual chemical potential under unconstrained composition partials.
Change note: Mirrors the current constant-temperature, constant-density mixture convention.
one_component_two_density#
Section: Equilibrium
Status: Exact derivation
Source: [Gross2001], Eqs. (A.23), (A.33); pressure, pressure_density_derivative, residual_chemical_potential and phase_helmholtz_amount_volume.
Description: One neutral component at fixed T, with distinct positive densities rho_L > rho_V and positive mechanical slopes; the common standard term cancels and is restored in the full chemical multiplier.
Change note: The reduced form analytically eliminates normalized compositions, feed amount, pressure and the common multiplier; full defining rows remain for admission and actions. E is A^r/(RT); v is V/n; the series uses unit amount. ALG-EQUILIBRIUM owns iteration and conditioning.
residual_enthalpy#
Section: Thermodynamic properties
Status: Source equation
Source: [Gross2001], Eq.~(A.46)
Description: Residual molar enthalpy.
Change note: Includes the residual pressure-volume term Z-1.
residual_entropy#
Section: Thermodynamic properties
Status: Source equation
Source: [Gross2001], Eq.~(A.48) without the ln Z term (same temperature and density)
Description: Residual entropy at the same temperature and density.
Change note: Does not silently change to a same-pressure ideal-gas reference.
residual_heat_capacity_cp#
Section: Thermodynamic properties
Status: Exact derivation
Source: Temperature and density derivatives of [Gross2001] Eqs.~(A.22) and (A.46)
Description: Residual isobaric molar heat capacity on a conditioned mechanical branch.
Change note: The final minus one removes the ideal-gas cp-cv contribution.
residual_heat_capacity_cv#
Section: Thermodynamic properties
Status: Exact derivation
Source: Temperature derivative of [Gross2001] Eq.~(A.46)
Description: Residual isochoric molar heat capacity.
Change note: Transforms CppAD first and second temperature partials.
cation_pair_triple_mixing_helmholtz#
Section: Residual Helmholtz energy
Status: Exact derivation
Source: Solvent-mass integration of the constant short-range terms in Song et al. (2010), §2, p. 1287, Eqs. (1), (2), (10-1), (10-2), Zotero W3AX2GHK. Multi-anion indexing: Pitzer and Kim (1974), Eqs. (8), (9), (11), doi:10.1021/ja00825a004; like-sign θ independent of the counter-ion and ψ per ion triple as written in Peiper and Pitzer (1982), J. Chem. Thermodyn. 14, 613–638, Eqs. (7)–(8), Zotero X8GEDSJ2.
Description: Each record declares one neutral solvent s, distinct cations i and j and declared anion k; M_s is kg/mol, W is kg solvent, theta is kg/mol and psi is kg²/mol². The reduced molar contribution is Delta a^r = F/N, with N = sum n.
Change note: Several records add independently, with total F equal to the sum of the per-record F below. An unordered cation pair may occur only once because theta is independent of the anion. An ion in several records receives the sum of their chemical-potential contributions; no three-cation cross term is added. Evaluated in every phase on the declared solvent’s molality basis, with positive solvent mass and the declared anion retained. Additional anions are admitted: theta_ij is independent of the anion; only the declared psi_ijk is nonzero, with psi_ija = 0 for every other anion as a model assumption. The unequal-charge electrostatic Etheta terms are excluded. Transfer of chloride-fitted coefficients to sulfate is unvalidated. Other neutral components enter this contribution only through mole fractions and total-mole normalization; their masses are not added to W. The constant coefficients are qualified only for retained aqueous water/chloride-salt cases at 298.15 K and 1 bar. Occupied additional neutrals and organic-phase effects are unqualified extrapolation, with no phase selector or automatic deactivation; at exact zero declared solvent with either participating cation exactly absent, the contribution is defined as zero on that fixed support. All derivatives within that support are zero; transverse entries in dense arrays have defined zero storage and claim no physical insertion derivative. Dry states containing both cations remain refused, including zero coefficients. Existing absent-ion action refusals remain; in a dry phase containing one participating cation, the absent partner’s scalar chemical potential and fugacity are also unavailable with IonicInsertion. This is not a continuous full-composition extension or organic-ion qualification. No density dependence, pressure correction, unequal-charge electrostatic mixing, vapor, dry-salt, mixed-solvent or caloric qualification. For W > 0, faces retain nonzero absent-ion insertion derivatives. Coefficients correct this EOS and are not imported Pitzer coefficients. Full EOS §12 gives an illustrative organic-phase substitution and its limits.
residual_helmholtz#
Section: Residual Helmholtz energy
Status: Implementation convention
Source: [Gross2001], PC-SAFT residual decomposition extended by admitted electrolyte terms
Description: Sum of every active residual Helmholtz contribution; \(a^{dd}\) only when the optional polar family is declared, and \(a^{mix}\) only with
cation_mixing.Change note: Mirrors the single EOS Helmholtz owner and its contribution result.
residual_internal_energy#
Section: Thermodynamic properties
Status: Exact derivation
Source: Temperature derivative of [Gross2001] Eq.~(A.46) with u=h-Pv
Description: Residual molar internal energy.
Change note: Uses the CppAD temperature partial at fixed density and composition.
salt_free_solvent_permittivity#
Section: Electrolyte dielectric and Debye–Huckel relations
Status: Source equation
Source: [Figiel2025], Eq.~(12); [AscaniHeld2021], Eq.~(13)
Description: Mass-weighted relative permittivity of the salt-free solvent mixture.
Change note: Uses component molar masses and includes exactly the neutral components with declared permittivity correlations.
same_sign_ionic_dispersion#
Section: Parameter setup
Status: Implementation convention
Source: [Figiel2025], same-sign ion exclusion; [Ji2012] §2.1 and Eq.~(4), all-ion-pair dispersion and ion-based species with dispersion among all ion pairs; [Held2014] text after Eqs.~(21)–(22)
Description: Select the source-declared dispersion rule for equally charged ions.
Change note: The caller selects all ion pairs or same-sign exclusion as part of the electrolyte model family. C is the opt-in set of charged molecules (
fixed.charged_molecule_ion, no default). The pair i, j in C includes i = j, so a declared ion keeps its self pair with k_ii = 0; two different declared molecules of the same sign keep their pair under the combining rule and need a declared k_ij like any applicable pair.
segment_sigma_correlation#
Section: Parameter setup
Status: Bounded empirical relation
Source: Source-resulted component correlation represented by the EOS parameter fields
Description: Evaluate a component segment-size correlation from its constant and exponential terms.
Change note: Mirrors the general sparse correlation implemented by segment_sigma.
single_ion_activity_coefficient#
Section: Electrolyte reference states and reported activities
Status: Source equation
Source: [Figiel2025], electrolyte reference-state fugacity relation
Description: Single-ion mole-fraction activity coefficient relative to the infinite-dilution fugacity reference.
Change note: Exposes the exponential of the finite-minus-reference log fugacity.
standard_pressure_density_conversion#
Section: Reference thermochemistry
Status: Exact derivation
Source: Exact derivation from the ideal chemical potential and h = -T squared times the temperature derivative of g/T at fixed standard basis
Description: Fixed P0 and rho0; Delta nu is the sum of reaction stoichiometric coefficients, products positive. The density-basis enthalpy coefficient is an offset; total physical calorics remain basis invariant.
Change note: Reconciled against transfer audit 2026-09-06; required mathematics, not an availability claim.
system_gibbs_helmholtz_coordinates#
Section: Equilibrium
Status: Exact derivation
Source: [Pereira2012] Eqs. 2–4; exact derivation from \(G=\min_V[A+PV]\)
Description: System Gibbs objective in Helmholtz coordinates; density-standard offsets appear exactly once and are consistent with ideal_gas_helmholtz. The ideal-gas base uses q = ln[(1/v)/rho0], v = exp(-q)/rho0 for unit-amount volume v; at an unnormalized trial S = sum_i x_i, physical density is S/v.
Change note: Use either mechanical energy plus offsets or total energy, never both reference terms. At fixed q, v_q = -v, v_qq = v and composition/temperature partials vanish. Do not normalize trial compositions.
tangent_plane_distance#
Section: Equilibrium / Tangent-plane testing
Status: Exact derivation
Source: [Michelsen1982] Part I; [Pereira2012] Eq. 12; [Perdomo2025] §3.3 Eqs. 37–40; [Ascani2022] §3.3 Eqs. 33–35
Description: Reduced molar tangent-plane distance at fixed positive T/P, normalized charge-neutral composition w on support S and molar volume v in m³/mol; e is the all-ones vector and z contains charge numbers. The mechanical reduced energy includes residual and ideal-density Helmholtz energy plus Pv/RT; s is the dimensionless density-standard offset and π the chemical balance plane.
Change note: Freeze standards including reference transfer and gauge at the solved snapshot. Chemical λ is dimensionless here, unlike dimensional chemical_potential_stationarity. A negative plane value needs feasible donor withdrawal and error qualification; finite search supplies no global certificate. The envelope derivative assumes a unique stationary trial on fixed support and parent/root branch; normalization and charge multipliers cancel the composition response and pressure stationarity cancels the trial-volume response. EOS, standard/reference/source-law actions and parent density/speciation/plane actions use the original parent before amount repair. ALG-STABILITY owns resolution, ties and event refusal; no derivative is assigned across a resolution jump.
tangent_plane_gibbs_dual_identity#
Section: Equilibrium / Tangent-plane testing
Status: Exact derivation
Source: Homogeneity of system_gibbs_helmholtz_coordinates and chemical_potential_stationarity
Description: Gibbs-dual identity for an exact feasible all-free fixed-T/P stationary candidate and any charge-neutral split with the same conserved totals b. N_q is mol; extensive reduced energies are on the request feed basis.
Change note: Pinned feasibility cells and approximate numerical states do not inherit exact stationary equality. The split identity alone does not construct a feasible withdrawal.
tangent_plane_trial_balance#
Section: Equilibrium / Tangent-plane testing
Status: Exact derivation
Source: Basis transformation of normalization/electroneutrality and Euler stationarity
Description: Internal unit-amount trial balance basis on S; R contains total-amount and charge rows, omitting charge for neutral support. H is the retained full-rank row transformation; λ_t is conjugate to B_t, not an optimizer multiplier.
Change note: No feed-moiety-proportion constraint or reaction is imposed. Charged density-temperature Vapor trials use H=I and the numerical log-charge row h below, evaluated by maximum-shifted log sums. Only that trial charge balance or a declared Vapor Electro row is replaced in Newton correction and classification. Original physical criteria, Ipopt callbacks and solved-state derivatives remain unchanged; full transformed rank does not establish branch or recovery accuracy. Qualification remains incomplete. Other trials retain their existing basis; use λ_t dot b_t in every basis.
michelsen_modified_tangent_plane#
Section: Equilibrium / Tangent-plane testing
Status: Source equation
Source: [Michelsen1982] Part I Eqs. 13–19 and 25–27; T,P Jacobian derived from the IsothermalPhaseHessian columns
Description: Michelsen’s modified tangent-plane objective g* over positive trial mole numbers W on support S, at fixed T/P and the frozen shift s = standard − plane of
tangent_plane_distance; w = W/ΣW and v is the trial label’s density-owner molar volume (m³/mol). ψᵢ = Fᵢ − ln v = ln φᵢ + ln(P/RT), with F the residual reduced Helmholtz energy at unit amount (Fᵢ dimensionless, F_iV in m⁻³, F_VV in mol m⁻⁶, and Fᵢⱼ in mol⁻¹, using SI derivative columns). Jᵢⱼ = n ∂ln φᵢ/∂nⱼ at fixed T,P is dimensionless and symmetric with Σᵢ wᵢJᵢⱼ = 0.Change note: All-neutral, non-reacting systems only. A stationary point has tpd = k = −ln ΣW; the shared tail reevaluates tpd and keeps every acceptance check.
tangent_plane_shift_log_curvature#
Section: Equilibrium / Tangent-plane testing
Status: Exact derivation
Source: Exact log-composition chain rule for the frozen standard shift in system_gibbs_helmholtz_coordinates
Description: Shift coefficients c=s−π are fixed, but supported fractions w_i=exp(y_i) and free amount N are coordinates. Curvature of the extensive reduced shift must remain in shared exact callbacks at arbitrary points.
Change note: Linear amount-space energy does not imply zero log-chart curvature; direct amount curvature is zero.
electroneutral_trial_reconstruction#
Section: Equilibrium / Tangent-plane testing
Status: Implementation convention
Source: Charge equality and common normalization
Description: Reconstruct finite positive supported u=exp(y). Ionic supports require both charge signs. Rescale charge groups and normalize; unsupported entries retain their input values. Liquid trials increase the largest opposite-sign entry to correct charge roundoff (ties by index), then normalize by common division. Charged Vapor trials use multiplicative log rescaling and omit the additive ionic correction to preserve trace coordinates.
Change note: Reject loss of positivity/support or domain. Neutral supports normalize directly; a singleton is exactly one. Reevaluate energy at v=c(T,w)/η. This is numerical admission, not exact-real feasibility. For \(q=0\), use \(v=w\) and the same common normalization. Stored fractions must remain finite and strictly positive; both absolute sum and charge defects must be at most \(10^{-12}\). Overflow or underflow is not repaired.
normalized_trial_reaction_affinity#
Section: Equilibrium / Tangent-plane testing
Status: Exact derivation
Source: tangent_plane_trial_balance contracted with charge-conserving Bν=0
Description: Normalized stationary trial affinity for a mole-changing reaction, products positive; μ_mech/RT+s is the total reduced chemical potential. The trial’s normalized reaction direction differs from the amount-space reaction vector.
Change note: π annihilates ν in amount space, not generally its normalized direction. The added full declaration restores original zero-affinity rows; the search trial need not have zero affinity.
present_phase_tangent_plane_identity#
Section: Equilibrium / Tangent-plane testing
Status: Exact derivation
Source: Euler homogeneity of phase_helmholtz_amount_volume with chemical and pressure rows
Description: Full present-phase identity on normalized compositions. a_V,p is the SI molar-volume column of residual reduced Helmholtz energy at unit amount; pressure-row error cannot be omitted. μ_mech contains ideal-density and residual chemical potentials without s.
Change note: The charge term is retained until charge-neutral admission; approximate chemical equality alone does not force zero TPD.
tangent_plane_donor_descent#
Section: Equilibrium / Tangent-plane testing
Status: Exact derivation
Source: First variation of system_gibbs_helmholtz_coordinates along conserved donor withdrawal
Description: Withdraw βw from strictly positive donor p containing S and create βw in the trial, holding donor and trial molar volumes fixed. β and its capacity are mol; d_p is the per-mole slope of extensive G/RT.
Change note: Compute the donor slope directly from physical gradients; chemical plane uncertainty cancels. A negative TPD without finite positive donor capacity is an unresolved plane trial.
tangent_plane_descent_uncertainty#
Section: Equilibrium / Tangent-plane testing
Status: Implementation convention
Source: First-order propagation, Euler homogeneity and final-summation rounding
Description: ε_tg estimates trial reduced molar energy error; ε_pμi donor reduced chemical error; ε_pP pressure-row error; ε_f feasibility/representation correction; ε_fp arithmetic. Include supplied standard-term uncertainty separately in the applicable energy/chemical terms. F_n and F_V denote native association derivative-floor estimates in unit-mol amount and SI volume columns. For the single full candidate amount correction, freeze ν_j^0=μ_j^0/(RT) at the parent; d=m¹−m⁰ is the stored update, u=δ−d its update-rounding discrepancy, m²=N′x′ the physical representation and m³=N′exp(ℓ′) its reported log representation. C_n is the applied and representation displacement in mol; ε_f is extensive G/(RT) on the request amount basis. Update rounding contributes only to ε_f, retaining nonzero uncertainty when a stored update rounds away. Candidate and donor consumers share the final totals.
Change note: Report association residual/conditioning and Euler defect at reevaluated points. A maximum floor may replace each column floor with its scale retained. γ_m bounds final summation rounding only, not the EOS evaluator. Local first-order estimates are not certified enclosures.
conserved_finite_phase_split#
Section: Equilibrium / Tangent-plane testing
Status: Exact derivation
Source: Component-conserving donor split of system_gibbs_helmholtz_coordinates
Description: Finite split preserving every component and thus moieties and charge. The withdrawn donor is reclosed at the request pressure on its declared density branch; the trial keeps its own molar volume. Other phases are unchanged. ΔG/RT and E_Δ are extensive on the request’s mol feed basis.
Change note: Try β_max/2 and at most eight halvings, reevaluating physical points. Numerical descent requires actual conservation and a Gibbs decrease exceeding its propagated estimate; proof additionally requires justified feasibility and error bounds. A fixed donor volume is admissible for the minimized A+PV, but its mechanical penalty (g_vv>0 on a stable root) blocked useful finite descent within the bounded search; the reclosed donor volume also seeds the added declaration. With exact pressure closure and a smoothly continuing root, g_v=0 makes N_p g_v dv_p/dβ vanish, so the first-order donor slope is unchanged; no smooth path is claimed across a root-selection change.
thermochemistry_from_reactions#
Section: Reference thermochemistry / Declared derivations
Status: Implementation convention
Source: Minimum-norm conserved gauge as practised in MEA-Thermodynamics (evaluate_direct_absorption_heat.py, build_thermochemistry), made a declared native derivation
Description: For an independent reaction-row matrix nu, the minimum-norm solution defines one declared gauge of reaction enthalpies. Adding a conserved-moiety vector preserves reaction enthalpies but does not determine absolute calorics.
Change note: Gauge is a convention, not replacement evidence for missing enthalpies, entropies or heat capacities. Equilibrium invariance additionally requires consistent Gibbs reference functions. Native calorics on referenced reactions use
reference_species_calorics, which anchors this gauge on supplied records and leaves only the ionic charge gauge.
equilibrium_isobaric_heat_capacity#
Section: Equilibrium / Caloric observables
Status: Exact derivation
Source: Total extensive enthalpy differentiated along the fixed-pressure equilibrium branch
Description: Apparent isobaric heat capacity includes phase and reaction relaxation, normalized by the declared positive feed sum. Native actions use physical increments on a dimensionless path parameter; the auxiliary thermal increment is 1 K. Under a PH specification (free T, fixed P, enthalpy-target direction w_H with increment delta_H; P, feed and parameters held) the value and first action come from the temperature actions, and the parameter derivative holds H rather than T fixed.
Change note: Equilibrium owns the phase-amount/enthalpy Taylor products. Parameter fitting consumes the value and first mixed thermal actions, dividing out physical increments before the affine optimizer map. Driven T/P or free T with a fixed-P enthalpy target, and a smooth regular branch, are required. No second apparent heat-capacity action or physical calorimetry is established.
reference_species_calorics#
Section: Reference thermochemistry / Declared derivations
Status: Exact derivation
Source: Gibbs-Helmholtz and Gibbs derivatives, using standard_pressure_density_conversion and the anchored Gibbs construction
Description: Supplied species records anchor density-standard Gibbs energy, enthalpy and entropy. Record-less species and every consumed derivative are completed through the same stoichiometric system. Its remaining null space, embedded into the full species vector with zeros on supplied-record coordinates, must lie in the full charge span, which cancels in electroneutral phases and neutral directions. The chemical rows’ minimum-norm representative preserves affinities but cannot replace these caloric anchors.
Change note: The completion checks consistency with supplied records on the selected smooth interval. Each raw derivative retains its own admission status. The bounded reference inventory is T/P order at most four and T/P order at most three with one EOS-coordinate derivative and at most two with two. Source coefficients are evaluated at the path temperature. Missing anchors, an undetermined neutral combination, or a singular chart cannot be supplied by a gauge. Numerical availability is qualified by the retained notebook, not by this equation definition.
Here \(\mathbf E_D\) embeds record-less coordinates into the full species vector, with zeros on supplied coordinates. A supplied ionic record fixes the global charge gauge, so \(\boldsymbol\nu_D\) must then have full column rank. When all supplied species are neutral, a one-dimensional null space proportional to \(\mathbf z_D\) remains admissible.
For a raw T/P derivative of a reaction reference, all lower product terms remain:
gibbs_conjugate_molar_volume#
Section: Reference thermochemistry / Declared derivations
Status: Exact derivation
Source: Frozen-composition Gibbs derivatives and the anchored completion
Description: The volume conjugate to system pressure includes the record-anchored standard pressure derivative. It is distinct from the EOS mechanical volume. Internal energy and frozen heat capacity use that same Gibbs volume.
Change note: Frozen raw T/P partials eliminate density and association at fixed composition before following the solved composition path. The local volume chart requires finite v_G and finite nonzero v_G,P, with a regular EOS root and site Jacobian. Record v_G>0 and v_G,P<0 as stable-chart diagnostics alongside quotient conditioning; these signs do not restrict mathematical admission or establish global reacting stability. Fixed-source-pressure standards have zero system-pressure derivatives and reduce to the mechanical definitions. A zero or unresolved denominator is diagnosed before a negative disposition; it is never replaced by the mechanical volume.
ideal_enthalpy#
Section: Reference thermochemistry / Ideal calorics
Status: Exact derivation
Source: Ideal-gas mixture calorics on declared component pressure-standard records
Description: Molar ideal enthalpy is the linear mixture of component standard enthalpies.
Change note: Every component record must be available on its selected source interval.
ideal_internal_energy#
Section: Reference thermochemistry / Ideal calorics
Status: Exact derivation
Source: Ideal-gas identity \(h-u=RT\)
Description: Molar ideal internal energy on the same declared thermochemical basis as ideal enthalpy.
Change note: No trial-pressure or density-standard offset is inserted into the physical value.
ideal_entropy#
Section: Reference thermochemistry / Ideal calorics
Status: Exact derivation
Source: Ideal-gas mixture entropy at the phase’s actual molar density
Description: Molar ideal entropy from component pressure-standard entropies plus ideal mixing and density terms.
Change note: Use \(x_i\ln x_i\to0\) at zero amount; no logarithmic insertion derivative is promised there.
ideal_heat_capacity_cp#
Section: Reference thermochemistry / Ideal calorics
Status: Exact derivation
Source: Ideal-gas mixture calorics
Description: Molar ideal isobaric heat capacity is the linear mixture of component source correlations.
Change note: Each source is evaluated only on its selected interval.
ideal_heat_capacity_cv#
Section: Reference thermochemistry / Ideal calorics
Status: Exact derivation
Source: Ideal-gas identity \(c_p-c_v=R\)
Description: Molar ideal isochoric heat capacity on the same selected source intervals.
Change note: It inherits ideal-\(c_p\) availability.
total_enthalpy#
Section: Reference thermochemistry / Totals
Status: Exact derivation
Source: Michelsen and Mollerup 2007, ch. 2, residual-plus-ideal decomposition at fixed (T, V, n)
Description: Enthalpy of a phase as the declared ideal reference part plus the residual part the residual EOS definition; reported on the P° basis of the declared thermochemistry. Unavailable without declared reference thermochemistry.
Change note: Required total-property definition; registration does not establish implementation.
finite_addition_enthalpy#
Section: Parameter regression / Enthalpy observations
Status: Exact derivation
Source: Closed-system enthalpy balance for a declared finite feed addition, using EqIDs
total_enthalpy,ideal_enthalpyandresidual_enthalpyDescription: Signed total-system enthalpy increment per mole of total feed added between two declared equilibrium states, less the ideal-plus-residual feed enthalpy at its declared temperature, pressure, composition and branch. Each phase enthalpy uses EqID
total_enthalpyon the declared thermochemistry’s \(P^{\circ}\) basis. Exothermic absorption is negative. A zero-pinned phase contributes zero and is not evaluated.Change note: Both endpoint problems share parameters, thermochemistry, ordered reactions and source reference. Their feed amounts differ by \(n_{add}\mathbf y\) within the admission tolerance. Each endpoint may have its own specification and temperature, with referenced free-temperature endpoints consuming the shared native first caloric actions at their solved temperatures. Every feed species needs an ideal-gas record. The exact first action holds feed state and amount fixed, differentiates both endpoint phase amounts and enthalpies, and subtracts the feed residual action; ideal feed enthalpy is independent of fitted parameters. The observation is an enthalpy increment for free-pressure endpoints; interpreting it as measured heat is an energy-balance choice unless endpoints and feed are isobaric at one pressure. For the fixed-T/P saturation-capped declaration, the fixed analytical basis is N_b mol and source loading cap is alpha_LP mol/mol. The existing bubble rows compose n(alpha)=n0+N_b alpha y with (p_b-P)/P=0 through the same driver; ALG-EQUILIBRIUM owns the search and its limits. The endpoint enthalpy action includes movement of its feed. The source branch has zero endpoint-loading action; the saturation branch uses the loading coordinate action from EqID
implicit_sensitivity. The eliminated ordinary-bubble check is alpha_s,v=-p_b,v/p_b,alpha at fixed physical P. Exact equality preserves heat but refuses its classical gradient, with one-sided loading action min(0,D alpha_s); unresolved nearby branches also refuse the gradient without changing the exact minimum. EqIDaffine_parameter_coordinate_mapapplies the coordinate map once.
total_entropy#
Section: Reference thermochemistry / Totals
Status: Exact derivation
Source: Michelsen and Mollerup 2007, ch. 2, ideal-gas mixture entropy at the phase volume plus the residual at fixed (T, V, n)
Description: Entropy of a phase as the ideal-gas mixture entropy at the phase’s own (T, V, n) plus the residual EOS entropy; reported on the P° basis of the declared thermochemistry, which enters only through the per-species s°. Unavailable without declared reference thermochemistry.
Change note: Required total-property definition; registration does not establish implementation.
total_internal_energy#
Section: Reference thermochemistry / Totals
Status: Exact derivation
Source: Residual-plus-ideal decomposition at fixed \((T,V,\mathbf n)\)
Description: Molar total internal energy is the ideal value plus the residual EOS value and obeys the full pressure-volume identity.
Change note: Unavailable without declared reference thermochemistry. These mechanical definitions apply to fixed-source-pressure standards. System-pressure references use the same record-anchored Gibbs volume in
gibbs_conjugate_molar_volume.
total_heat_capacity_cp#
Section: Reference thermochemistry / Totals
Status: Exact derivation
Source: Residual-plus-ideal decomposition on a regular fixed-pressure branch
Description: Molar total isobaric heat capacity combines ideal and residual values at the same state.
Change note: It is unavailable when either input is unavailable, including a nonpositive mechanical denominator for the residual term.
total_heat_capacity_cv#
Section: Reference thermochemistry / Totals
Status: Exact derivation
Source: Residual-plus-ideal decomposition at fixed density
Description: Molar total isochoric heat capacity combines ideal and residual values at the same state.
Change note: For fixed-source-pressure standards this mechanical quantity does not inherit the fixed-pressure mechanical-stability condition. System-pressure references use frozen c_v,G on the regular local Gibbs-volume chart in
gibbs_conjugate_molar_volume; it is not a reacting heat capacity at fixed total volume.
transfer_free_energy#
Section: Electrolyte reference states and reported activities
Status: Source equation
Source: [Figiel2025], transfer Gibbs-energy relation
Description: Ion transfer free energy between compatible solvent reference states.
Change note: Source and target must share temperature, pressure, phase, ions, and stoichiometry.
tunneling_transform#
Section: Equilibrium
Status: Documentation-only
Source: [Pereira2012] Eq. 10 and 11
Description: Exponential tunneling transform of the tangent-plane distance used by the source for the stage-I search from 10 nc random starts. Source search candidate; not an adopted discovery algorithm.
Change note: Evaluate only within a separately reviewed search design using the shared thermodynamic owner.
weighted_lagrangian_hessian#
Section: Numerical methods
Status: Exact derivation
Source: Exact differentiation of the constrained objective used by the Ipopt eval_h callback
Description: All primal coordinates and arbitrary callback multipliers are included. Lambda_opt denotes optimizer constraint multipliers, separate from embedded chemical balance/charge coordinates. Objective scaling never scales constraint curvature.
Change note: Reconciled against transfer audit 2026-09-06; required mathematics, not an availability claim.
log_fugacity_coefficient_parameter_derivative#
Section: Properties / Pressure-closed parameter actions
Status: Exact derivation
Source: Implicit differentiation of
pressure,compressibility_factorandlog_fugacity_coefficient; extensive residual Helmholtz Hessian including implicit association.Description: First physical-parameter columns at fixed temperature, pressure and component amounts.
Change note: Requires positive finite pressure-density slope. Parameters use their native units; the volume is m³ for the declared amounts. Numerical qualification belongs to the electrolyte parameter-gradient analysis.
electrolyte_activity_parameter_derivative#
Section: Properties / Electrolyte reference actions
Status: Exact derivation
Source:
mean_ionic_activity_coefficient,molality_activity_conversion,practical_osmotic_coefficientandlog_fugacity_coefficient_parameter_derivative.Description: Molality-scale mean ionic activity, solvent activity and practical osmotic first parameter columns.
Change note: Ionic reference columns are the terminal-pair limit of
reference_molality_sequence, the exact derivative of the returned reference. Solvent columns subtract the same-T/P pure-solvent column, including the implicit density, association and dielectric/Born derivatives. Physical coordinates, composition, T/P and molar masses are held fixed. At pure solvent activity columns are zero; unavailable Phi has unavailable columns. Energies multiply ionic reference columns by RT in J/mol.
dependent_born_diameter_derivative#
Section: Parameter regression / Dependent hydration coordinate
Status: Exact derivation
Source: Implicit-function theorem applied to
infinite_dilution_solvation_energyandlog_fugacity_coefficient_parameter_derivative.Description: A Born diameter holds a declared single-ion solvation energy, with exact first columns contracted through the independent cross-family affine chart.
Change note: Independent scalar holds only; nonzero scaled H_d, a declared bracket and both energy and diameter-correction criteria are required. Final acceptance uses the stored diameter without solving the equality again. Target uncertainty is fixed, not estimated.
For the explicit targets \((\sigma_i,d_{\mathrm{packing},i},d_{\mathrm{DH},i})=(q,0.88q,0.88q)\), the implicit-function contraction includes every independent raw column:
extensive_enthalpy_specification#
Section: Equilibrium caloric specifications
Status: Exact derivation
Source:
total_enthalpy, extensive phase summation and resolved-feed normalizationDescription: Fixed pressure and one extensive enthalpy target H_spec [J] determine free temperature and phase amounts on declared supports.
Change note: Same-density total calorics use the supplied component anchors and standard pressure; the denominator uses the current feed and temperature. Source-referenced or record-less supports take each species’ ideal part from the anchored g of
reference_species_calorics, h_i = g_i - T g_i,T + RT, as a local Taylor polynomial at the current point.
extensive_volume_specification#
Section: Equilibrium volume specifications
Status: Exact derivation
Source: Paterson, Stenby and Yan (2023), doi:10.1016/j.fluid.2023.113795, Eq. (2), Tables 1–2; extensive phase summation
Description: Fixed temperature and total volume determine common pressure and the split on declared neutral nonreacting supports. Phase molar volume is v_p [m³/mol], phase amount N_p [mol], and the target is an extensive volume [m³].
Change note: The volume row uses the shared packing/amount geometry and its exact derivatives, including the moving target denominator. The physical potential is total Helmholtz energy. The volume constraint is retained in the physical stability tangent; pressure and chemical duals are excluded from that tangent’s coordinates.
extensive_internal_energy_specification#
Section: Equilibrium caloric specifications
Status: Exact derivation
Source: Paterson, Stenby and Yan (2023), doi:10.1016/j.fluid.2023.113795, Eq. (2), Tables 1–2;
total_internal_energy, Gross and Sadowski (2001) Eq. (A.46) with H=U+PVDescription: Total internal energy U_spec [J], volume V_spec [m³] and neutral nonreacting component inventories [mol] determine free common temperature and pressure on one or two declared fluid phases. Complete ideal thermochemistry is required.
Change note: The shared caloric geometry supplies exact U derivatives. Internal energy uses EOS pressure, not the independent common-pressure coordinate before pressure closure. The driver solves the conserved rows and qualifies entropy curvature on their physical tangent. T_* and P_* are held fixed when differentiating the physical Lagrangian; mu_i,* uses the declared thermochemical reference. Its reported potential is -S_tot/R.
extensive_entropy_specification#
Section: Equilibrium caloric specifications
Status: Exact derivation
Source:
total_entropy, extensive phase summation and resolved-feed normalizationDescription: Fixed pressure and one extensive entropy target S_spec [J/K] determine free temperature and phase amounts on declared supports.
Change note: Same-density ideal and residual entropy share the supplied component anchors and standard pressure; zero pinned amounts contribute zero. Source-referenced or record-less supports use s_i = R - g_i,T - R ln(x_i rho/rho_0) from the anchored g of
reference_species_calorics.
critical_equations#
Section: Equilibrium critical and envelope conditions
Status: Source equation
Source: Heidemann and Khalil 1980, AIChE J. 26, 769–779 (doi:10.1002/aic.690260510); Michelsen 1980, Fluid Phase Equilib. 4, 1–10, pp. 7–8, Eqs. 24–26; normalized amount perturbation as in the FeOs “Stability and critical points” documentation
Description: Necessary critical conditions of one neutral nonreactive phase on a positive feed z at fixed (T, V), with F = A/(RT), n the phase amounts, unknown mode u, D = diag(sqrt z) and w = D u; T and P are free and the pressure row closes P.
Change note: Ideal parts Q_ij = δ_ij/n_i and F_ijk = −δ_ijk/n_i²; residual parts are the extensive residual contractions E2–E5. ∂c/∂u_j = 3 sqrt(z_j) F_nnn[w,w,e_j] and ∂²c/∂u_i∂u_j = 6 sqrt(z_i z_j) F_nnn[w,e_i,e_j]. A solution is a critical-equation candidate: the conditions certify no stability.
diffusive_spinodal#
Section: Equilibrium critical and envelope conditions
Status: Source equation
Source: Michelsen (1980), Fluid Phase Equilib. 4, 1–10, pp. 7–8, Eqs. 24–26; Heidemann and Khalil (1980), doi:10.1002/aic.690260510; the Hessian and mode normalization of
critical_equations, without its critical cubic conditionDescription: At specified T and positive full-support composition x of a neutral nonreacting mixture, find density rho and normalized mode u. At unit amount n=x, V=1/rho, F=A/(RT), Q=F_nn and D=diag(sqrt(x)), M=DQD must have one lowest zero eigenvalue and all other eigenvalues resolved positive. P is the EOS pressure at that state.
Change note: The density derivative is r_l=-V D F_nnV D u for l=ln(rho); the mode columns are M. Exact row curvature consumes E4. The fixed-composition fold sets the density derivative of the lowest eigenvalue to zero; it does not generally set the null-mode critical cubic to zero.
envelope_local_condition#
Section: Equilibrium critical and envelope conditions
Status: Source equation
Source: Michelsen 1980, Fluid Phase Equilib. 4, 1–10, pp. 2–4, Eqs. 9 and 14–18 (selectable specification and local parametrization), adapted to the raw T/P chart
Description: One scalar row of an envelope cell (a finite feed phase and an incipient phase pinned at zero amount, T and P free): the selected comparison coordinate minus its target s, with T_unit = 1 K, P_unit = 1 Pa and K_k = x_k^inc/x_k^feed.
Change note: ∂row/∂s = −1. The ln T and ln P rows have second derivatives −1/T² and −1/P²; the ln K row is a difference of log-composition coordinates and is affine.
azeotrope_condition#
Section: Equilibrium critical and envelope conditions
Status: Source equation
Source: equal phase compositions at a homogeneous azeotrope (Gibbs–Konovalov); FeOs
PhaseEquilibrium.binary_azeotropeas the independent implementationDescription: The C − 1 rows of a binary azeotrope cell (a free feed phase and an incipient phase pinned at zero amount, exactly one of T and P free) that replace the first C − 1 species balances; the remaining balance is the total amount, and the declared feed composition is only the seed.
Change note: The rows are affine in the log-composition chart and add no Hessian. The C-th equality follows from the two normalization rows.
solid_standard_gibbs#
Section: Equilibrium pure stoichiometric solids
Status: Exact derivation
Source: dissolution S(s) = Σ_i ν_{s,i} A_i with Σ_i ν_{s,i} μ_i° − μ_s° = −RT ln K_s; the density-basis constant from
neutral_reaction_reference_transferat the source standard pressure P°Description: Standard Gibbs energy of a pure stoichiometric solid at unit activity on its pure-solid standard state, with g_i the compiled fluid standard vector, ln K_s^ρ the sourced dissolution constant converted on the charge-neutral fluid-side stoichiometry at the declared reference pressure P°, and V_s the declared solid molar volume.
Change note: P° is required, so ∂g_s/∂P = V_s exactly at fixed T; a transfer at system pressure would add the dissolved ions’ infinite-dilution partial molar volume. Only ln K_s is physical: a shift of g_i along the balance row space moves the objective by a constant. Solved-state actions carry ln K_s^ρ as its second-order Taylor term in T and the active EOS parameters about the solved state, so T, P and parameter actions reach order two; V_s(P − P°)/RT is exact. The ASL property record’s solid row is ℓ_s = ln K_s^ρ(T, P°) + V_s(P − P°)/RT − Δν ln(P/(RTρ°)), ρ° = 1 mol/m³, so a present solid satisfies Σ_i ν_{s,i}(ln x_i + ln φ_i) = ℓ_s.
solid_saturation_index#
Section: Equilibrium pure stoichiometric solids
Status: Exact derivation
Source: affinity of dissolution at the solved fluid state; with
chemical_potential_stationarity, Σ_i ν_{s,i} μ_i = RT λ·(Bν_s) because Σ_i ν_{s,i} z_i = 0Description: Saturation index of solid s in decades; at the optimizer endpoint its scaled affinity is the bound multiplier, z_s = −A_s/RT, and the row g_s/RT − λ·Bν_s = 0 holds for a present solid.
Change note: A Pinned(0) solid reports SI_s at the solved fluid state without a coordinate or row.
solid_amount_complementarity#
Section: Equilibrium pure stoichiometric solids
Status: Exact derivation
Source: KKT conditions of the Gibbs minimum with the bound n_s ≥ 0 and no stationarity row for n_s
Description: Complementarity between the solid amount n_s (mol) and its saturation index; Ipopt’s returned bound multiplier of n_s on the extensive objective G/RT is z_s = −A_s/RT, so (n_s/N_feed) z_s is the barrier parameter at an interior-point endpoint.
Change note: One endpoint classification makes the declaration square: present (n_s/N_feed > z_s, saturation row) or absent (n_s = 0). The rule replaced A_s/RT ≥ −ε after the barrier left a stable solid at −A_s/RT above ε for small excess feeds.
solid_material_balance#
Section: Equilibrium pure stoichiometric solids
Status: Exact derivation
Source:
material_balancewith the solids’ moiety columnsDescription: Conserved-moiety balance over the fluid phases and the free solid amounts; the solid term adds n_s g_s/RT to the objective and is linear in n_s, so it adds no curvature.
Change note: No upper bound on n_s: the balance bounds it.
molality_ionic_strength#
Section: Electrolyte reference states and reported activities
Status: Source equation
Source: IUPAC Gold Book, ionic strength, I03180, molality-basis definition; Green Book, 2nd ed., p. 50
Description: Ionic strength per kilogram of the declared solvent; all charged species present contribute.
Change note: Uses species molality from molality_activity_conversion, independently of the solutes naming a fit domain.