xsteamrs

An IAPWS-IF97 water/steam thermophysical properties library for Rust. It provides two usage styles:

• IF97 low-level functions: region-based *_p_t / *_rho_t functions using IF97 conventional SI units (p: MPa, T: K, h/u: kJ/kg, s: kJ/(kg·K), v: m³/kg).
• Public string-dispatch API: props / props_si, dispatching by function name strings (e.g. "h_pT", "T_ph").

Installation

Add this to your Cargo.toml:

[dependencies]
xsteamrs = "0.1"

Quick start

XSteam-style units: props

• Pressure p: bar
• Temperature T: °C

use xsteamrs::props;

fn main() -> Result<(), xsteamrs::If97Error> {
    let h = props("h_pT", 1.0, 100.0)?;
    println!("h_pT(p=1 bar, T=100°C) = {h} kJ/kg");

    let t_c = props("T_ph", 1.0, 500.0)?;
    println!("T_ph(p=1 bar, h=500 kJ/kg) = {t_c} °C");

    Ok(())
}

SI pressure unit: props_si

• Pressure p: Pa
• Temperature T: K

use xsteamrs::props_si;

fn main() -> Result<(), xsteamrs::If97Error> {
    let p_pa = 101_325.0;
    let t_k = props_si("Tsat_p", p_pa, 0.0)?;
    println!("Tsat_p(p=101325 Pa) = {t_k} K");

    let t_k = 373.15;
    let p_sat_pa = props_si("psat_T", t_k, 0.0)?;
    println!("psat_T(T=373.15 K) = {p_sat_pa} Pa");

    Ok(())
}

Low-level IF97 example

If you want to work directly with IF97 conventional SI units (p: MPa, T: K), call the low-level functions:

use xsteamrs::{h1_p_t, psat_mpa_from_t_k};

fn main() -> Result<(), xsteamrs::If97Error> {
    let p_sat_mpa = psat_mpa_from_t_k(373.15)?;
    println!("psat(T=373.15 K) = {p_sat_mpa} MPa");

    let h = h1_p_t(0.101_325, 373.15)?;
    println!("h1_p_t(p=0.101325 MPa, T=373.15 K) = {h} kJ/kg");

    Ok(())
}

Build and test

cargo fmt
cargo test
cargo clippy --all-targets --all-features -- -D warnings

Generate and open local documentation:

cargo doc --no-deps --open

Documentation

After publishing to crates.io, docs are built and hosted by docs.rs:

• https://docs.rs/xsteamrs