Introducing Simple Equation Solver (SES): Thermal Engineering in Your Browser

If you have ever taken a course in thermodynamics, heat transfer, or fluid mechanics, you know how useful an equation solver is. For decades, Engineering Equation Solver (EES) has been the standard tool in mechanical engineering departments. It lets you write the equations of a problem as they appear on paper, in any order, without rearranging terms or coding iterative loops.

Traditional solvers also carry real friction: installation and licensing hurdles, dated interfaces, limited platform support, and prices that keep them on institutional lab computers. In my case the last straw was practical: EES runs on Windows, and under Wine or CrossOver on Apple Silicon Macs it crashes repeatedly.

So I built Simple Equation Solver (SES), a web application that brings simultaneous equation solving, fluid properties and engineering correlations to any modern browser. It runs entirely on your computer: nothing you type is sent to a server. It is free and open source (GPL-3.0); see its GitHub page.

What Simple Equation Solver does

Equations. Write algebraic equations in any order. SES finds which equations must be solved together, solves the rest one at a time, and handles each coupled block with a bounded Newton method with a Levenberg-Marquardt fallback. Any variable can be the unknown, including the argument of a property function or a correlation, so problems can be solved backward. Arrays, “duplicate” blocks for finite-difference grids, unit tags such as [kPa] or [degC] on any value, and a Check button that tests the dimensional consistency of every equation are all included. Did I mention that unit handling is automatic, with no need of convert() functions?

Properties. Real fluids through CoolProp, compiled to WebAssembly: over 100 pure fluids with reference-quality equations of state, incompressible fluids and brines, humid air, and fugacities. Also: ideal-gas data for combustion from the NASA polynomials, with chemical exergy; water in every phase, including ice; lithium bromide-water solutions for absorption refrigeration; the solid properties of Incropera’s tables; and the Lee-Kesler generalized compressibility charts, for substances that have no equation of state of their own.

Heat transfer and fluid flow. Correlations for forced and free convection, boiling and condensation, fins, transient conduction, conduction shape factors, radiation and view factors, all named after the correlation and cited to the equation numbers of Incropera’s textbook, with a warning when a correlation is used outside its range. The effectiveness-NTU relations of every heat exchanger type, and a model of rotary regenerators. Compressible flow: isentropic flow, normal and oblique shocks, Fanno and Rayleigh flow, Prandtl-Meyer expansions, and the choking of a gas flow by injected particles, each with inverse functions that return the subsonic or the supersonic Mach number as asked.

Tools. Parametric tables and publication-quality plots, Min/Max optimization of one or several variables, ODE blocks integrated alongside the algebraic equations (adaptive Dormand-Prince, or a stiff solver), interpolation in 1-D and 2-D tables, and user functions with if, for and while for the parts of a model that are naturally sequential.

Code examples

Here are a few examples of how SES handles typical thermal engineering problems.

1. Simultaneous equations and fluid properties

You don’t need to isolate anything. Write the state relations with their unit tags, and SES solves for whatever is unknown:

// Steam turbine expansion with isentropic efficiency
P_1 = 8 [MPa]
T_1 = 500 [degC]
P_2 = 10 [kPa]
eta = 0.85
h_1 = enthalpy('water', T_1, P_1) [kJ/kg]
s_1 = entropy('water', T_1, P_1) [kJ/(kg K)]
s_2s = s_1
h_2s = enthalpy('water', 'P', P_2, 'S', s_2s) [kJ/kg]
h_2 = h_1 - eta * (h_1 - h_2s) [kJ/kg]
w_t = h_1 - h_2 [kJ/kg]                  // 1078.9 kJ/kg
x_2 = quality('water', 'P', P_2, 'H', h_2)   // 0.890

2. Heat transfer correlations

Correlations are called by name, so the choice of correlation stays visible in your equations:

// Cylinder in cross flow of air, properties at the film temperature (Incropera, Example 7.4)
D = 0.0127 [m]
V = 10 [m/s]
T_inf = 26.2 [degC]
T_s = 128.4 [degC]
P = 101325 [Pa]
T_f = (T_inf + T_s)/2
k = conductivity('air', T_f, P)
Pr = prandtl('air', T_f, P)
Re = V*D/kinematicviscosity('air', T_f, P)
Nu = nu_churchillbernstein(Re, Pr)
h = Nu*k/D                      // 96.66 W/(m^2 K)

3. Sequential user functions

When part of a model needs loops or piecewise logic, write it as a function and call it from the equations like any other function. (SES already has the Colebrook equation built in, as f_colebrook; this is just an illustration.)

// Darcy friction factor: laminar 64/Re, or the Colebrook equation by fixed-point iteration
function f [-] = colebrook(Re, rr)
  if Re < 2300
    f = 64/Re
    return
  end
  f = 0.02
  n = 0
  while true
    f_new = (-2*log10(rr/3.7 + 2.51/(Re*sqrt(f))))^(-2)
    n = n + 1
    if abs(f_new - f) < 1e-12 or n > 50
      break
    end
    f = f_new
  end
  f = f_new
end
Re = 75000
roughness_ratio = 0.001
f_friction = colebrook(Re, roughness_ratio)   // 0.02284

4. Ordinary differential equations

ODE blocks are solved together with the algebraic equations, so you can ask for the time at which something happens:

// Lumped cooling of a copper sphere down to 320 K
D = 0.02 [m]
rho = 8933 [kg/m^3]
c = 385 [J/(kg K)]
h = 50 [W/(m^2 K)]
T_inf = 300 [K]
A = pi*D^2
m = rho*pi*D^3/6
ode t = 0 : t_end : 60
  q = h*A*(T - T_inf)
  T' = -q/(m*c)
  T(0) = 400 [K]
end
T = 320 [K]     // the solver finds t_end = 369 s

How SES compares

When building thermal system models, engineers usually choose between a dedicated commercial solver, a general-purpose computing environment, or an open-source desktop package. Here is how SES compares:

EESMATLABCoolSolveSES
PlatformsWindows (unstable on Apple Silicon under Wine/CrossOver)Windows, macOS, LinuxWindows binary; other systems build from sourceAny modern browser
InstallationDesktop applicationLarge desktop installationDesktop executableNone: open a web page
LicenseCommercialCommercialOpen sourceOpen source (GPL-3.0), free
Where your work runsYour computer, with license checksYour computer, with license checksYour computerYour browser; nothing is sent to a server
Fluid propertiesBuilt-in databaseAdd-on toolboxes or external librariesCoolPropCoolProp, plus ice, solids, LiBr-water, ideal gases, Lee-Kesler
Modeling styleSimultaneous equationsProcedural scriptsSimultaneous equationsSimultaneous equations, with sequential functions

What sets SES apart

1. It runs everywhere. SES runs in the browser’s JavaScript engine, so it works the same on macOS, Windows, Linux, Chromebooks and tablets, with no emulation layer and no virtual machine.

2. Nothing to install, nothing sent away. SES opens from a URL. The math, plotting and property libraries load into your browser, and from then on your equations, guesses and results stay on your computer: there is no account, no license server and no data sent anywhere. If you want, you can save the files to your computer.

3. Equations as written, not programs. General environments like MATLAB or Python (SciPy) are powerful, but setting up a cycle in them means rearranging equations, managing state arrays or chaining solver calls. SES keeps the declarative style that made EES popular: energy balances and property calls go in exactly as you would write them on paper.

4. Checked results. Accuracy comes first. Every correlation cites its source, data come from published tables and are checked against them, and an automated test suite of about a thousand checks compares the program with exact solutions, textbook examples and reference values every time it changes. Every result shown in the help’s worked examples is computed by the program, not typed.

Try it out

Whether you are checking a Rankine cycle homework problem, sizing a heat exchanger with the effectiveness-NTU method, finding where a shock stands in a nozzle, or modeling transient conduction with finite differences, SES gives you a light, private environment to do it.

You can run the app in your browser at:

https://prgomez.com/ses

The help page, opened with the Help button, covers the syntax, every function and property, units, and dozens of worked examples you can copy and run.

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.