break_coolprop/__init__.py

"""
break_coolprop — Numba-JIT Helmholtz EOS replacement for CoolProp H2 properties.

Implements the Leachman et al. (2009) Helmholtz free energy equation for normal
hydrogen, compiled to native code via Numba. Forward evaluations (T,D -> p,h,cv,s
and P,T -> h,s,d) use exact Helmholtz derivatives. The slow (P,S) inverse uses
a pre-built 2D lookup table with bilinear interpolation.

Usage:
    from break_coolprop import h2_props
    h2_props.init()  # Load PS table + JIT warmup (~3s first time)

    # Then in hot loop:
    P, H, S, Cv = h2_props.props_td(T, rho)
    rho, converged = h2_props.newton_pt(P_target, T)
    d, h = h2_props.ps_flash(P, S, ...)
"""