Skip to content

epcsaft 1.3.0

Choose a tag to compare

@tannerpolley tannerpolley released this 04 Nov 21:12
· 2896 commits to main since this release

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.