fa480ed303
- Added port_mass_flows to Component trait and implements for core components. - Added System::check_mass_balance and integrated it into the solver. - Restored connect methods for ExpansionValve, Compressor, and Pipe to fix integration tests. - Updated Python and C bindings for validation errors. - Updated sprint status and story documentation.
Entropyk
A thermodynamic cycle simulation library with type-safe APIs and idiomatic Rust design.
Features
- Type-safe physical quantities: Never mix up units with NewType wrappers for Pressure, Temperature, Enthalpy, and MassFlow
- Component-based modeling: Build complex systems from reusable blocks (Compressor, Condenser, Evaporator, etc.)
- Multiple solver strategies: Newton-Raphson with automatic fallback to Sequential Substitution
- Multi-fluid support: CoolProp integration, tabular interpolation, incompressible fluids
- Zero-panic policy: All errors return
Result<T, ThermoError>
Quick Start
Add to your Cargo.toml:
[dependencies]
entropyk = "0.1"
Example
use entropyk::{
System, Solver, NewtonConfig,
Compressor, Condenser, Evaporator, ExpansionValve,
Ahri540Coefficients, ThermalConductance,
};
// Build a simple refrigeration cycle
let mut system = System::new();
// Define component parameters (see API docs for details)
let coeffs = Ahri540Coefficients { /* ... */ };
let ua = ThermalConductance::new(5000.0);
// Add components
let comp = system.add_component(Box::new(Compressor::new(coeffs)));
let cond = system.add_component(Box::new(Condenser::new(ua)));
let evap = system.add_component(Box::new(Evaporator::new(ua)));
let valve = system.add_component(Box::new(ExpansionValve::new()));
// Connect components
system.add_edge(comp, cond)?;
system.add_edge(cond, valve)?;
system.add_edge(valve, evap)?;
system.add_edge(evap, comp)?;
// Finalize and solve
system.finalize()?;
let solver = NewtonConfig::default();
let result = solver.solve(&system)?;
Documentation
See the API documentation for full details.
License
Licensed under either of Apache License, Version 2.0 or MIT license at your option.