Free, open-source calculation notebook for engineers: physical units, symbolic math, matrices and plots with instant LaTeX output. Several worksheets in one file, print or export to pdflatex-ready .tex. Runs locally on Windows and Linux, no cloud, no account, no internet connection needed.
- Calculate with physical units (
10'kg,5'W/(m*K),2'bar | Pa) and get dimension checks for free - Symbolic math: derivatives, integrals, equations, sums, products, limits
- Your own functions (
f(x) = x^2 + 1), comparisons and checks (σ <= σ_zul | MPagives 180 MPa ≤ 235 MPa ⇒ true),if,min,max, rounding - Vectors, matrices and plots; a matrix can be typed over several lines
- Results typeset with MathJax while you type (optional live update); MathJax and the fonts are part of the program, nothing is loaded from the internet
- Worksheets: several named sheets in one file that read each other's values (
Loads::F) - Undo/Redo: buttons and
Ctrl+Z/Ctrl+Yfor the whole workbook (also sheet add/delete/rename), usable on tablets - Pictures: show a PNG sketch in the output with
picture("beam", width=400, align=center); it is stored inside the saved text file - Print or export the sheet(s) as a standalone
.texdocument (with plots and pictures)
The interface consists of a text editor on the left and a LaTeX/plot output area on the right.
Download for Linux (.AppImage)
Fluid properties from CoolProp, solve, a sketch in the output
Definite integral with units, own function, laminar check, plot
Two worksheets (inputs and results), unit conversion, stress check and utilisation
Matrix and vector with units
Derivative, overshoot check, numerical integration, plot
The complete guide (input syntax, units, worksheets, settings, printing and export) is in USER_GUIDE.md. Fluid properties have their own guide: COOLPROP_GUIDE.md.
- Web UI using Flask, HTML/CSS/JavaScript and MathJax
- Expressions are parsed by a small, purpose-built parser and evaluated through a fixed function whitelist — no
eval()/sympify()is ever run on user input (see Security) - SymPy integration for symbolic expressions (
diff,integrate,Eq,solve,csolve,nsolve,sum,prod,lim), numeric evaluation, symbolic display mode (:=) and result-only mode (=:) - Unit system: apostrophe syntax (
10'J,5'm), dimension checks, automatic unit simplification, and explicit target units with| unit— any product/quotient/power of known units (| kWh,| J/(kg*K)) - User-defined functions
f(x) = …,g(a, b) = …, usable inplot,nsolve,diff,integrate - Fluid properties from CoolProp:
prop(ρ, T, 20'degC, p, 1'bar, Water)andhaprop(...)for humid air, with units; usable in functions, plots,nsolveandnintegrate(see COOLPROP_GUIDE.md) - Special functions
erf,erfc,besselj,bessely,besseli,besselk(also in plots, without SciPy) - Comparisons
< > <= >= == !=with unit checking,if(condition, a, b),min,max,round,floor,ceil,sign, percent display with| % - Vectors and matrices:
vec,mat,det,inv,dot,cross,eigenvals, indexing from 1 likev[1],A[2][1],sol[1], one unit for a whole vector (vec(20, 40, 60)'degC), results with units and| unit, … - Tables:
interp(x, y, value)andinterp2(...)(linear interpolation with units, no extrapolation); numerical integrationnintegrate(f, (x, a, b))with units - Statements may continue over several lines while a bracket is open (e.g. one matrix row per line)
nsolvewith units: the start value carries the unit of the unknown (nsolve(Eq(...), U, 0.5'V))- Plotting with
plot(f, x, xmin, xmax) - Pictures:
picture("name", width=300, align=left)shows a PNG (button Insert image). The pictures are stored in the saved text file (Base64 blocks at its end), appear in the printout and in the LaTeX export; at most 10 pictures, total size limited by a setting (1–3 MB) - Worksheets:
##Namesheets in one text file, tabs below the editor (add, rename by double-click, delete), read-only cross-sheet referencesSheet::var - Live update on Enter (optional) and Ctrl+Enter to calculate
- Text lines (
"bold",'plain', spaces preserved) and#comments - Greek variables and accent notation (
Q__dot,Q__bar,Q__hat,Q__tilde) - Settings: rounding precision, font size, unit size, sheet-prefix size, print/export all sheets, timeout, image limit, live update
- Print layout with sheet name in the page header; export to
pdflatex-compilable.tex(or.zipwith plots and pictures), one sheet or all sheets - Configurable computation timeout protects against very expensive input
Expressions are evaluated through a custom recursive-descent parser (parsing/) and a small AST-to-SymPy bridge (mathlib/sympy_bridge.py) that only ever calls a fixed whitelist of functions (mathlib/functions.py). Unknown function names become inert symbolic placeholders rather than being executed. No user input is ever passed to Python's eval() or SymPy's sympify()/parse_expr().
plot() and nsolve() are the two places where SymPy turns an expression into Python code (lambdify). Both refuse any expression that contains an unknown function name before that happens, so a placeholder can never be executed there either. A function defined in the sheet (f(x) = …) is stored as a parsed formula, never as text; a call is replaced by that formula through the same parser and whitelist before anything reaches lambdify.
The output is HTML-escaped: text from the input (comments, error messages) is shown as text and is never interpreted as HTML by the browser.
Pictures are accepted as PNG only and are checked by their bytes (signature, header, end marker) with hard limits for size and pixel count before anything decodes them, so a small file that would expand to gigabytes is refused. Picture names are restricted to letters, digits and underscore, pictures are never read from a file path on the server, and the browser shows them only as <img> (no SVG, no scripts). The LaTeX export checks everything again on the server.
Each computation additionally runs in a separate process with a hard timeout (core/safe_runner.py, default 10 s) so a single expensive or hanging input can't tie up the server.
The bundled run.py binds to 127.0.0.1 by default — if you expose this on a network beyond localhost, review app.py/run.py first. Behind a reverse proxy, allow request bodies of about 8 MB (e.g. nginx client_max_body_size 8m;), otherwise the LaTeX export of a sheet with several pictures is refused by the proxy.
- Python 3
- Python packages: see
requirements.txt(Flask,Jinja2,sympy,matplotlib,numpy,coolprop). CoolProp is pinned to 6.8.0 (it loads much faster than newer versions) and is optional at run time: without it onlypropandhapropare unavailable - MathJax 3 and the fonts Inter and JetBrains Mono are included in
static/vendor/; no CDN is used - For running the test suite: see
requirements-dev.txt(pytest); the browser tests additionally needplaywrightwith Chromium and are skipped without it
pip install -r requirements.txtpython run.pyThe application runs on http://127.0.0.1:5000. If that port is already in use by another program, EngiPad uses the next free one (5001, 5002, …) and prints the address; the packaged executable opens the browser at the port actually used. ENGIPAD_PORT sets the first port to try. As a normal Python script it starts the server without opening a browser; as a packaged executable it also opens the browser automatically.
Optional environment variable: ENGIPAD_LIVE_DEFAULT=1 or 0 sets whether live update is on by default (on in the local version, off on a server).
pip install -r requirements.txt -r requirements-dev.txt
pytestReady-made builds are available under Download. To build your own Linux AppImage or Windows executable/installer, see BUILDING.md.
- Author: Prof. Dr. Peter Stein
- Coding: Claude (Anthropic) — the implementation, architecture, tests, and documentation were written with Claude as an AI coding assistant.
This project is licensed under the GNU General Public License v3.0 (GPL-3.0).
See the LICENSE file for details.
This project uses ICONS from Lucide Icons
Included third-party files (static/vendor/, each with its license file):
- MathJax 3.2.2, Apache License 2.0
- Fonts Inter and JetBrains Mono, SIL Open Font License 1.1
Fluid properties are calculated by CoolProp (MIT licence), installed as a Python package and included in the downloads.





