Skip to content

Releases

epcsaft 1.3.1

Choose a tag to compare

@tannerpolley tannerpolley released this 17 Nov 06:03

Scientific source distribution for ePC-SAFT Engine 1.3.1, cut from candidate 1b46e57ce8f78b79891b5fe5293917c58fa0f671.

Documentation: https://tannerpolley.github.io/epcsaft/

Changes since 1.3.0

  • CppAD thread-slot cleanup avoids promise destruction during Windows library initialization while preserving safe thread-exit reuse.
  • Windows bindings can link the native active-parameter value accessor, restoring the extension build.
  • Zero-loading reactive states can now be searched by the Full stability search and used with the stability penalty when a reacting inventory is absent from the feed. Generated trial phases exclude species proved absent by the conserved inventory constraints, instead of requiring a positive amount of an unavailable species. This restores the search on the admissible composition face; it does not establish global stability.
  • More equilibrium specifications: neutral fixed-volume TV and UV flashes; charged and source-referenced PH and PS flashes; apparent equilibrium heat capacity for a fixed-pressure enthalpy specification; reaction-relaxed stability checks. Searches remain finite and do not prove global stability.
  • Additional properties and derivative actions: second and third virial coefficients, native state arrays, fugacity coefficients by contribution, and referenced second-order actions in EOS-parameter and reaction-law directions.
  • Broader process-model declarations: ASL records accept active EOS parameters, temperature and pressure controls with reaction laws, system enthalpy and thermochemistry, liquid–vapor pairs, and declared-present pure solids. Charged-species pressure-property records carry exact derivatives.
  • Parameter estimation can fit a solid's equilibrium-constant law to solubility observations and impose tangent-plane stability requirements. Reaction enthalpy-shift coordinates carry through fit sequences and minimax estimation.
  • Pathway-weighted reactive cross-association is available with exact derivatives. Dilute-limit arithmetic, trace-ion splits, pure saturation recovery and continuation admission have been corrected. Numerical failures retain their cause and finite diagnostics.
  • Parameter records can add cation-pair interactions. The HCl packet figiel-2025-chloride-mixture-refit/4 includes fitted H–Na and H–Mg interactions. At 298.15 K and 1 bar, the lowest-acid measured checks are 0.1 mol/kg HCl in NaCl at ionic strengths 4, 5 and 6 mol/kg (acid contributes 1.7–2.5% of ionic strength). Above 6 mol/kg, checks extend to 7 mol/kg only for acid fractions of at least 10%, in HCl–NaCl and HCl–LiCl. H–Mg is checked to ionic strength 5 mol/kg, H–Ca to 3 mol/kg; H–K is unmeasured. Trace-acid states, acidic states above 7 mol/kg and acidic brines with multiple salt cations have no measured comparison. HCl–water at ionic strength 7–16 mol/kg remains report-only, with worst discrepancy 0.07433 decade. Inherited chloride-packet limits and the absence of propagated parameter uncertainty remain.
  • Packet domains can state composition bounds and report applicability on request. Temperature-law admission now checks the declared temperature interval consistently. Density diagnostics share their native defaults.
  • The public repository now directly owns Engine source. Private research inputs and analysis trees stay outside this distribution. The two MIT FeOs Gross–Sadowski packets remain installed in the conda package; omitted non-commercial FeOs packets can be restored from pinned upstream bytes with bash data/tools/restore_feos.sh.

Verification on the exact archive bytes before publication

  • The documented locked setup and source installation pass from the extracted archive outside a Git checkout and load 1.3.1. The README NaCl example prints exactly the documented activity and osmotic coefficients.
  • linux-64 / CPython 3.13: the conda package built from these bytes passes its import, dependency and numerical tests and includes exactly the two MIT FeOs Gross–Sadowski packets. The installed test gives pressure 1695742.8953910787 Pa and temperature action 39302.24177938896 Pa/K, with largest central residual 8.88e-16 and action linear residual 3.87e-17.
  • The corpus comparisons were run at candidate 3c2046a6; the final corrections change Windows symbol export and thread-slot cleanup without changing thermodynamic formulas. These extended comparisons have not been rerun on the final archive. With OpenBLAS and MUMPS, the installed and development builds agree with zero corpus comparison failures: Cameretti 1800/1800, Gross 721/724, neutral sweep 63/70, matrix 42/42, replay 4385 rows and MEA flash family 73/73. The known unavailable states are retained on both sides.
  • Key solves and the full fit have zero comparison failures. Largest scaled state difference is 1.0036538265939643e-11 and largest scaled full-fit difference is 6.443695845532716e-12, both below the existing 1e-10 comparison tolerance. Full-fit costs are 31.12372699861994 (development) and 31.123726998610728 (installed), an absolute difference of 9.212186569129699e-12. Both fits take 14 iterations.
  • All inner and outer source-set SHA-256 checks pass. Native package libraries contain no home-directory or local build paths; local /tmp paths remain in Python bytecode, installation metadata and recipe metadata.
  • The full documentation build passed at candidate 3c2046a6: all twelve example notebooks are executed, both Sphinx warning logs are empty, and all 37 doctests pass. The settler example now supplies fixed temperature and pressure to the ASL callback; Sphinx displays Mermaid diagram source as plain text while GitHub keeps its rendered diagram.
  • The standard host fast checks pass. An additional run forcing MUMPS fails one native endpoint-observation precheck; the identical executable passes with the ordinary host solver. This solver-dependent assertion also fails at the 1.3.0 source and is a separate check defect; it does not show a new equilibrium failure. The package tests, documentation, and installed/development numerical comparisons above pass with MUMPS.
  • win-64 / CPython 3.13: the conda package built locally from these archive bytes, with MSVC v142 14.29 clang-cl and Boost headers 1.89.0 h57928b3_3 from the source set, passes its import and run tests and imports 1.3.1 in a fresh environment. The installed test gives pressure 1695742.8953910803 Pa and temperature action 39302.241779389 Pa/K. These differ from linux-64 by 1.6e-9 Pa and 3.6e-11 Pa/K, within the 1e-8 package tolerance. Four threads evaluating the same pure-ethane state, 300 K and 10,000 mol/m³, agree at 4316185.179414262 Pa, and the process exits normally. The Windows native libraries embed seven Boost.Multiprecision exception source-location header paths from the build tree. They contain no home directory or username, and 1.3.0's Windows libraries carried six of the same header paths from its CI build.

The corresponding-source set includes this archive, Ipopt 3.11.9 with its patch, embedded dependency sources, Boost 1.89.0 headers, original notices and the exact recipe. Coin-HSL is not distributed.

Packaging comparisons are numerical verification of how model predictions carry through packaging. They do not establish physical validation. The HCl range above describes the packet's retained measured comparisons and their limits. Other platforms and Python versions are not qualified by the Linux packaging checks.

epcsaft 1.3.0

Choose a tag to compare

@tannerpolley tannerpolley released this 04 Nov 21:12

Scientific source distribution for ePC-SAFT Engine 1.3.0, cut from Engine commit d25b56f9e.

Documentation: https://tannerpolley.github.io/epcsaft/

Changes since 1.2.1

  • IDAES property package. The optional epcsaft.idaes module (install with the idaes extra: IDAES 2.12.0, Pyomo 6.10.1) builds a generic IDAES property configuration. It uses the FTPx state, LogBubbleDew fugacity equalities and the SmoothVLE formulation. The Engine supplies density, total molar enthalpy and component ln φ, with exact first and second derivatives. A short example solves a methane/ethane flash with a standard IDAES Flash unit.
  • Readable diagnostics and logging:
    • Calls report through the standard epcsaft Python logger, and an Ipopt log level is available.
    • A converged equilibrium point that fails the phase check now stops as infeasible. Its message begins with a sentence saying what the check observed.
    • jacobian_table lists the Jacobian with labeled coordinates. pressure_action_difference and solved_state_difference compare exact first-order actions with central differences, as a verification aid.
    • density_diagnostics resolves its defaults explicitly. Multistart fits log the cause of each failed start.
  • Association conditioning:
    • Warnings about poorly conditioned association site fractions now carry through to returned states, fits and endpoints instead of being dropped.
    • The site-fraction conditioning record (site_conditioning: basis, rank, condition estimate) is readable, and is absent for nonassociating fluids.
    • A singular association solve names the declared sites in its error.
  • Faster refusal of infeasible two-phase flashes. When a fixed temperature and pressure flash coalesces, a bounded tangent-plane stability test runs before recovery. It refuses a two-phase answer that has no unstable trial phase sooner.
  • Faster property evaluation when traces are captured: ordinary trace capture evaluates only the derivative order the state needs.
  • The conda package now includes the FeOs Gross–Sadowski 2001 and 2002 parameter packets (MIT). Locate them under the installed epcsaft package's data/packets.
  • The source archive omits the Esper 2023 and Rehner 2023 packets and the two analysis inputs that copy CC BY-NC 4.0 data. Rebuild those packets from the original FeOs distribution with bash data/tools/restore_feos.sh, which checks every download against pinned SHA-256 values.
  • Documentation corrections: packet installation, quadrupole guidance and the termination and diagnostics guides.
  • Paper corrections: refreshed references, corrected links between the paper and its supplement, clearer symbols, units and comparison labels, a data-archive link in the availability statement, and disclosure of the NaCl and halite temperature limits. The manuscript sources stay outside the source archive.

Verification on the exact archive bytes before publication

  • The documented locked setup and source installation pass from the extracted archive, outside any Git checkout, and load 1.3.0. The README example run from the archive prints the values shown in the README.
  • linux-64: the conda package built from this archive passes its tests and contains exactly the two MIT FeOs Gross–Sadowski packets. Against the development build (OpenBLAS runtime, MUMPS), every equilibrium corpus, key solve and full fit agrees, with zero comparison failures.
  • The documentation builds from this source with every example notebook executed and no warnings.
  • win-64: the package built from this archive passes its tests and reproduces the Linux run_test.py values exactly. Its native library exports 189 named symbols: the 183 of 1.2.1, less two internal symbols removed since and plus eight added since. A qualification build from the same archive passed every check in its process: every equilibrium corpus, key solve and full fit agreed between its development and installed builds, with zero comparison failures.

The corresponding-source set includes this archive, Ipopt 3.11.9 with its patch, the embedded dependency sources, Boost 1.89.0 headers, the original notices and the exact recipe. Every SHA-256 in it was verified before publication. Coin-HSL is not distributed.

This is numerical verification of how model predictions carry through packaging, not physical validation. Other platforms and Python versions are not qualified.

ePC-SAFT 1.2.1

Choose a tag to compare

@tannerpolley tannerpolley released this 03 Nov 00:40

Scientific source distribution for ePC-SAFT Engine 1.2.1, cut from Engine commit 34b54dbe5.

Documentation: https://tannerpolley.github.io/epcsaft/

Changes since 1.2.0

  • Explicit fast phase discovery, Discover(mode="fast"), for nonreacting neutral and electrolyte fluids at fixed temperature and pressure. Full discovery remains the default. When a fast search finds no split, that holds only for the trials it ran.
  • Tied reaction coordinates are accepted across declarations that differ only in their temperature bounds; each problem keeps its own interval.
  • A reacting equilibrium attempt that stops with its iteration budget exhausted now qualifies for the retry in physical mole amounts, and phase discovery counts the work of a retried attempt once.
  • The Engine and its conda recipe build on macOS (x86-64 and arm64). macOS packages are not part of this release.
  • A public README and the documentation site: quickstart, user guide, theory with the equation registry, limits, executed examples and the Python reference.
  • Manuscript sources are no longer part of the source archive.

Verification on the exact archive bytes before publication

  • The documented locked setup and source installation pass from the extracted archive, outside any Git checkout, and load 1.2.1. The README example run from the archive prints the values shown in the README.
  • linux-64: the conda package built from this archive passes its tests. Against the development build (OpenBLAS runtime, MUMPS), every equilibrium corpus, key solve and full fit agrees, with zero comparison failures.
  • win-64: the package built from this archive passes its tests and reproduces the Linux run_test.py values exactly; its native library exports the same 183 named symbols as 1.2.0. A qualification build from the same archive passed every numerical and process check: every equilibrium corpus, key solve and full fit agreed between its development and installed builds, and both loaded the same native library.

The corresponding-source set includes this archive, Ipopt 3.11.9 with its patch, the embedded dependency sources, Boost 1.89.0 headers, the original notices and the exact recipe. Every SHA-256 in it was verified before publication. Coin-HSL is not distributed.

This is numerical verification of how model predictions carry through packaging, not physical validation. Other platforms and Python versions are not qualified.

ePC-SAFT 1.2.0

Choose a tag to compare

@tannerpolley tannerpolley released this 30 Oct 20:21

Scientific source distribution for ePC-SAFT Engine 1.2.0, cut from Engine commit 4cb87490b.

Changes since 1.1.3

  • Native Windows x86-64 build: a private Ipopt 3.11.9 with MUMPS, built with clang-cl and flang, and the Engine libraries exported for Windows callers.
  • The reactive bubble-point solve now starts its vapor phase correctly.
  • The conda recipe builds linux-64 and win-64 for CPython 3.13. Its package tests are the import, pip check and run_test.py. The Windows qualification is a manual double-check (the windows-qualification workflow).

Verification on the exact archive bytes before publication

  • The documented locked setup and source installation pass from the extracted archive, outside any Git checkout.
  • linux-64: the conda package built from this archive passes its tests. Against the development build (OpenBLAS runtime, MUMPS), every equilibrium corpus, key solve and full fit agrees, with zero comparison failures.
  • win-64: the package built from this archive passes its tests and reproduces the Linux run_test.py values exactly; its native library exports 183 named symbols. A manual qualification build from the same archive, whose libraries differ from the shipped ones only in an embedded build-directory name and the PE timestamp, passed every numerical and process check. Every equilibrium corpus, key solve and full fit agreed with its development build, and both loaded the same native library.

The corresponding-source set includes this archive, Ipopt 3.11.9 with its patch, the embedded dependency sources, Boost 1.89.0 headers, the original notices and the exact recipe. Every SHA-256 in it was verified before publication. Coin-HSL is not distributed.

This is numerical verification of how model predictions carry through packaging, not physical validation. Other platforms and Python versions are not qualified.

ePC-SAFT 1.1.3

Choose a tag to compare

@tannerpolley tannerpolley released this 29 Oct 21:03

Scientific source distribution for ePC-SAFT Engine 1.1.3, cut from Engine main 3d5f6c124855a2196c3f7005e8c1c8c0e0b90184.

Supersedes 1.1.1 and 1.1.2 because their uv.lock entries were stale or drifted; 1.1.2 also has no release assets. Published historical tags and assets are preserved.

All non-workspace uv.lock entries match the Engine cut. The source archive excludes agent configuration and instructions, and its documented locked installation passed from the extracted archive. The linux-64 / CPython 3.13 conda recipe was built and tested against these exact local source bytes before publication; fresh-prefix installed-versus-development qualification had zero comparison failures across the declared corpora.

The corresponding-source set includes the source archive, private HSL-free Ipopt 3.11.9, embedded dependency sources, original notices and final recipe. All 20 inner SHA-256 checksums verified before publication. Coin-HSL is not distributed.

This is numerical verification of package transport of model predictions, not physical validation. Other platforms and Python versions are not qualified by this release.

ePC-SAFT 1.1.2

Choose a tag to compare

@tannerpolley tannerpolley released this 29 Oct 20:32

ePC-SAFT 1.1.2 supersedes 1.1.0 and 1.1.1 for public README and packaging hygiene, with consistent locked workspace metadata. Earlier tags remain immutable.

The export excludes agent configuration and private maintenance instructions. The snapshot includes Engine main through PR #889. Linux x86-64 / CPython 3.13 qualification uses Ipopt 3.11.9 with MUMPS, without Coin-HSL. The corresponding-source set retains the exact Engine archive, upstream and embedded sources, notices, and final recipe. Package comparisons are numerical verification, not physical validation.

Superseded by v1.1.3 because of drifted uv.lock dependency entries; this release also has no assets. Published tag and existing assets are preserved.

ePC-SAFT 1.1.1

Choose a tag to compare

@tannerpolley tannerpolley released this 29 Oct 20:26

ePC-SAFT 1.1.1 supersedes 1.1.0 for public README and packaging hygiene. The source export excludes agent configuration and private maintenance instructions. Version 1.1.0 remains available unchanged.

Linux x86-64 / CPython 3.13 source qualification uses Ipopt 3.11.9 with MUMPS, without Coin-HSL. The corresponding-source set includes the exact Engine archive, upstream and embedded sources, notices, and the final recipe with its source checksum. Package qualification is numerical verification, not physical validation.

Superseded by v1.1.3 because of stale uv.lock workspace metadata. Published tag and existing assets are preserved.

ePC-SAFT 1.1.0

Choose a tag to compare

@tannerpolley tannerpolley released this 29 Oct 19:53

ePC-SAFT Engine 1.1.0 source distribution, including the HSL-free linux-64 / CPython 3.13 conda recipe and merged native thermodynamic work.

The curated source includes documentation, retained analyses and 74 parameter packets. Figiel 2025 chloride-mixture refit version 3 is included under the owner's publication decision. This snapshot contains no Engine Git history or Coin-HSL payload.

Engine origin/main at cut: da73ef241844efb01fba3249e369568dd1e99608. Release metadata candidate: e592fc7b06103df144d7bea0b53d11fee905a14e.

A version-associated corresponding-source set with checksums accompanies this release. Conda-forge submission is separate from binary availability. Numerical qualification does not establish physical validation for other systems or conditions.

ePC-SAFT 1.0.0

Choose a tag to compare

@tannerpolley tannerpolley released this 25 Oct 05:30

First public release of ePC-SAFT.

ePC-SAFT is an electrolyte PC-SAFT equation-of-state package with exact derivatives. Its equilibrium and parameter-fitting calculations run natively in C++.

  • Install: see "Install from source" in README.md.
  • License: GPLv3 with an additional permission for linking with EPL-licensed Ipopt; see LICENSE.
  • Third-party code and data terms: see NOTICE.
  • Cite: see CITATION.cff.