Open Tools · Pinchgrid
Pinchgrid user guide
The Pinchgrid user guide: streams and units, utility targets, composite and grand composite curves, the unit target, placing matches against the pinch rules, files and limits. To use the tool itself, open Pinchgrid.
Professional use. Results are for education and preliminary design. They must be checked by a qualified professional, and they are not a substitute for code-compliant design or licensed engineering judgement.
Pinchgrid is a heat-integration bench for process engineers and students: enter hot and cold process streams, choose a minimum approach temperature, and read off the least external heating and cooling, the pinch, the composite curves and a unit target, then build a heat-exchanger network on a grid diagram and check it against the pinch rules. This Guide is reference documentation for every panel and number.
Start in two minutes
- Open the Examples menu and choose Four streams, a pinch-respecting network, or keep the example that is loaded the first time you visit.
- Read the tiles above the views: the minimum hot utility, the minimum cold utility, the maximum heat recovery, the pinch and the unit target. They update as you edit.
- Drag the minimum approach slider (ΔTmin). The composite curves move apart or together and every target recalculates. Type an exact value in the box next to the slider if you prefer.
- Edit a stream: change a supply or target temperature or its heat-capacity flow (CP). A stream that cools is shown as hot, one that warms as cold, and the label follows your temperatures.
- Open the Grid view, pick a hot and a cold stream, and press Add match. Leave the duty empty to use the largest duty the two streams can exchange. The pinch rules panel tells you at once whether the match respects the pinch.
- Save writes your project to a JSON file; Open reads one back. Your work is also kept automatically in this browser.
Streams and units
Each stream has a name, a supply temperature (where it starts), a target temperature (where it must end) and a heat-capacity flow CP, the mass flow multiplied by the specific heat, not the specific heat alone. The heat the stream gives up or takes up is CP times the temperature change, shown in the Duty column.
A stream is hot when its target is below its supply (it must be cooled) and cold when its target is above its supply (it must be heated). If you type temperatures that reverse the direction, the stream turns around. If matches already use the stream, the edit is refused with a message instead, so a match can never end up joining two hot streams.
Choose the display units with the two selectors in the toolbar: temperature in °C, K or °F, and heat in W, kW or MW. Heat-capacity flow follows the pair, for example kW/K. A temperature difference such as the minimum approach is in K when the temperature unit is °C or K, and in °F when it is °F. Units are a view setting: the file stores kelvin, watts and watts per kelvin, so changing units never changes your model.
Numbers must be plain decimals such as 120, 1.5e3 or .25. Thousands separators, units typed into the cell and words are refused with a message next to the cell. While any cell holds text that cannot be applied, the results are hidden and Save is disabled, so no number is ever calculated from half-typed input.
Pinchgrid works with sensible heat at constant CP. A stream that boils or condenses has latent heat; do not hide it inside an arbitrary CP. The engine accepts up to 100 streams, 500 ordered process matches and 101 sweep values. Absolute temperatures must be above 0 K and at most 1e7 K, the approach between 0 and 1e7 K, and CP between 1e-12 and 1e12 W/K. Stream duties in one problem must stay within a ratio of 1e12, and a number may have at most 40 decimal places (the size of the exact fraction). A value typed in another unit is converted exactly. If the converted value is a decimal that no stored number holds exactly (1e-14 °C is 273.15000000000001 K, and entering that in kelvin is refused too), it is refused rather than replaced by a nearby number, because a shorter or nearby value would change the engineering input. Values with no finite decimal form, such as a difference of 1 °F (5/9 K), are rounded once to the nearest stored number. Files you open or import are held to the same rule: a number in a file that cannot be stored exactly refuses the file. These are admission limits, not physical validity ranges for any material.
Reading the targets
The targets follow from the heat cascade. Hot streams are shifted down by half the minimum approach and cold streams up by half, so a hot and a cold stream at the same shifted temperature are exactly one approach apart. Between every pair of neighbouring shifted temperatures the net heat of the streams present is added to a running total. The most negative running total is the minimum hot utility; adding it to the cascade keeps every value non-negative, and the last value is the minimum cold utility.
- Maximum heat recovery is the heat that can be exchanged between process streams: the smaller of the hot load less the cold utility and the cold load less the hot utility.
- Pinch is the shifted temperature at which the feasible cascade is zero. It is shown as a hot-side and a cold-side temperature that differ by the minimum approach. Several levels can be zero, giving several pinch points; a zero at the very top or bottom of the temperature range is a threshold, not an internal pinch, and is reported as such.
- Unit target (N − 1) is a planning figure, not a proven minimum. The shifted temperature range is cut at every level where no heat crosses; each piece is treated as one connected sub-network needing its number of streams, plus a utility where one is used, less one unit, and the pieces are added. A design whose streams split into independent groups that balance among themselves can use fewer exchangers, so treat the figure as the usual counting rule for a connected design. The tile also shows the figure for the same rule without cutting at the pinch; this changes the counting convention, not the calculated utility targets.
- Checks on your model are three self-checks on the engine's own output: the energy balance closes exactly, no cascade value is negative, and the composite curves carry the full hot and cold loads. A failed check is shown in red; it is never hidden.
Targets are thermodynamic bounds. They assume unrestricted matching at the chosen approach and say nothing about utility temperatures, equipment area, pressure drop or whether a network can be built. A zero minimum approach is only a limiting case.
The five views
Composite curves
The hot composite curve (red) adds the heat of every hot stream that is present at each temperature; the cold composite curve (blue) does the same for cold streams and is shifted right by the cold utility. Where the curves overlap in heat load, heat can be recovered. The overhang at the top is the hot utility and the gap at the bottom is the cold utility, both labelled on the chart. Rings mark each internal pinch with the approach drawn between them. The curves are drawn from the engine's arrays with no smoothing or thinning; a flat run where no stream is present appears as a vertical step.
Grand composite
The grand composite plots the feasible cascade against shifted temperature. Its distance from the vertical axis is the heat carried by the feasible cascade at that level: process heat released by hot streams plus whatever utility entered above it. Only the top value is the hot utility and only the bottom value is the cold utility; in between, the curve can rise because process streams release heat, so an ordinate is not a request for utility at that level. The curve shows where the process leaves room for utilities of a given grade, but this release does not allocate utilities. A point on the axis is a zero-heat-flow level, marked with a ring.
Heat cascade
The table lists every temperature interval with the hot and cold CP present, the net heat, the cascade without utility and the cascade with the hot utility. Rows where the last column is zero are the pinch levels.
Grid
The grid diagram draws hot streams on top running left to right, with their hot ends on the left, and cold streams below running right to left, so every stream's hot end is on the left. Each pinch is a dashed vertical line. Your matches are numbered circles joined by a vertical line, grouped by the region of the pinch they belong to. Heaters (H) and coolers (C) mark the load each stream still needs from a utility. The drawing always fits its panel; nothing scrolls.
Approach sweep
The sweep calculates the utility targets and the unit count at a list of approach values you type (up to 101). Each value is its own calculation. The chart joins the points with dashed lines only to guide the eye: targets between two values are not interpolated, and a value the engine refuses is listed with its reason instead of being drawn.
Placing matches and the pinch rules
A match is a heat exchanger between one hot and one cold stream with a duty. Matches are applied in list order: each stream carries on from the temperature its earlier matches left it at. Use the arrows in the match table to reorder them. Streams are not split and no match joins more than one pair.
To add a match, choose the two streams in the selectors or click their names on the grid, then press Add match. An empty duty box means the largest duty the two streams can exchange given what they have already done. Typing a duty is allowed; if it asks for more than a stream has left, or breaks the minimum approach at either end of the exchanger, the match is marked as not feasible with the engine's reason and every later match is marked as not checked until you fix it. Max on a row sets that match to the largest duty it can take.
For each match the table shows the temperatures in and out on both sides, the approach at each end, the largest duty it could take and its status. Crosses pinch means some of its heat moves from a hot stream above the pinch into a cold stream below it.
The pinch rules for every internal pinch are:
- no heat is moved across the pinch;
- no cooling utility is used above the pinch;
- no heating utility is used below the pinch.
Each rule is shown as OK, Broken or Open. Rule 1 is judged from the matches you have placed. Rules 2 and 3 stay Open while more matching could still remove the load; they become Broken only when the matches already reach the energy target and load remains on the wrong side. Open is never shown as OK. With several pinch points the rules are listed per pinch, and the heat that crosses one pinch can also cross another, so the figures are not added together.
Every decision in the engine is exact: each number you enter is read as the exact decimal you typed (423.15 means 42315/100, not the nearest binary fraction), and shifting, the cascade, the pinch, utilities, remaining loads, match states, crossing and the three rules are computed in exact rational arithmetic with no tolerances. A load of one watt left on a stream is a load, whatever else is in the process. Numbers shown on screen and in exports are the nearest double of the exact result, so a displayed value can be rounded in its last digit while every classification (zero level, pinch, utility used, crossing, load left) is exact. Because the arithmetic is exact, a match duty you type as a decimal (for example 1777.155) rarely empties a stream exactly: the rest is a real, tiny remaining load, shown as a heater or cooler.
Under the rules the panel states the utility still required against the targets, how much heat the matches recover against the maximum, and the number of units in your design against the target. A design that breaks the rules can still be a working exchanger network; it simply uses more utility than the target allows.
Files, exports and the browser
Save downloads a JSON project (format pinchgrid-project, version 1) holding the title, the streams, the minimum approach, the matches and the sweep values in SI units, with the copyright and professional-use notices. Open reads such a file strictly: unknown fields, other versions, altered notices, values outside the limits and files larger than 1 MiB UTF-8 are refused with a reason, and your current project stays as it was. Save depends only on the project being valid; it never waits for a calculation.
The Export menu offers:
- Results as CSV: the targets, the curves, the cascade, the pinch points and the unit count, or, when matches exist, the full network with each match and the pinch figures. It is enabled only while the results on screen are current.
- Stream table as CSV: six columns in SI units, id, name, kind, supplyK, targetK, heatCapacityFlowWPerK. Import stream CSV reads the same layout back.
- This view as PNG or SVG: the drawing on screen, with the footer Made with Pinchgrid · simulations4all.com and the professional-use notice.
CSV cells that start with a formula character are prefixed so spreadsheets show them as text. Projects and CSV files are limited to 1 MiB UTF-8. Before a large job the engine estimates its memory and refuses anything over 64 MiB; heavy work runs in a Web Worker and the Cancel button appears if a calculation takes longer than a moment.
The project is saved to this browser's local storage a moment after each edit and restored on your next visit; nothing is sent to a server. If storage is blocked the tool still works and simply does not remember. New starts an empty project and Undo brings the previous one back. Undo and redo step through edits; typing in the same cell is one step, and leaving and re-entering a cell starts a new one.
Keyboard shortcuts
| Keys | Action |
|---|---|
| Ctrl/⌘ Z | Undo |
| Ctrl/⌘ Shift Z, or Ctrl Y | Redo |
| Ctrl/⌘ S | Save the project file |
| Ctrl/⌘ O | Open a project file |
| 1 to 5 | Switch view |
| H | Add a hot stream |
| C | Add a cold stream |
| ? | Show or hide the shortcut list |
| Esc | Close the shortcut list |
Letter and number keys act only when no text box has focus. The views are a tab list: use the arrow keys, Home and End to move between them. The grid's stream names are buttons that select a stream for the next match.
What Pinchgrid does not do
This release covers transparent constant-CP targeting, a unit target (the N − 1 counting rule) and the checking of matches you place yourself. It does not do the following, and nothing in the tool implies that it does.
- Latent heat, variable CP, mixing, recycle or stream splitting.
- Several utility levels, utility temperature feasibility, or the choice of utility.
- Heat-exchanger area, cost or total-cost targets, and the economic optimum approach. The sweep shows utility targets and unit counts only.
- Automatic network synthesis or retrofit constraints: you place the matches.
- Exchanger sizing, pressure drop, fouling or layout. Individual exchanger rating belongs in a dedicated sizing tool.
- Batch or multi-period operation.
The numbers are for education and preliminary design. A target is a bound under the stated assumptions, not a promise that a plant can be built to it.
How we verify Pinchgrid
Every figure comes from one engine that refuses what it cannot compute instead of guessing. Its reference cases live in a single register that the automated test suite and the Verify page both read, so what you see is exactly what is checked. Each case states its method, the reference value, its tolerance and the result. The references are hand derivations and closed forms written for this tool; the test suite adds two independent algorithms, a whole-stream availability cut and a heat-packet maximum-flow, that never import the engine, run on hundreds of seeded random processes, and a third independent count for the number of units.
Open Verify and press Run all checks. The badge appears only when every check has run and passed in your browser; any failure or incomplete run says so instead. The page counts method families once, however many checks a family contains, and lists the cases that are still pending a source. A printable report with the result and a Mountain Time stamp is one click away.
No openly published worked-example validation has been admitted yet: such a case needs a published stream table with published utility targets that can be opened in full, and it is listed as pending source rather than filled in. Passing the checks shows that the implementation matches independent calculations; it is not experimental validation and not a complete-design review.
Compared with other tools
Desktop process-integration packages are larger: they add variable properties, several utility levels, area and cost targets, automatic network synthesis and links to flowsheet simulators. Pinchgrid does none of that. What it offers is a free tool in a web browser with nothing to install, your data stays on your device, the Verify page shows independent reference calculations, files are open JSON and CSV, and every number can be traced from the stream table through the cascade to the target. If your task needs the features above, use a dedicated package and treat this tool as a way to check a first design or to learn the method.
Troubleshooting
- Results are hidden. One or more cells cannot be applied; they are outlined and explain why. Fix them and the results return.
- The engine did not accept this problem. The message names the cause: INPUT for a field or direction problem, RESOLUTION for stream duties more than 1e12 apart, RESOURCE when a size limit is exceeded.
- A match is not feasible. Its row shows the engine's reason. Approach means the exchanger would bring the hot and cold streams closer than the minimum approach at one end; reduce the duty or change the order. Overshoot means a stream would go past its target.
- Open refuses my file. The reason is shown. Only files saved by Pinchgrid, version 1, with their notices intact are accepted.
- Nothing is remembered. Browser storage may be blocked (private window). Use Save to keep your work.
- Calculations are blocked. The tool runs only from simulations4all.com; reconnect to continue. Editing, files and this Guide keep working.
Frequently asked questions
Why do the targets change when I move the slider? A larger minimum approach reduces the heat that can be exchanged at each temperature, so external heating and cooling can both rise even though the process loads do not change.
Does a target guarantee a buildable network? No. It is a thermodynamic bound under the stated assumptions. Equipment, matching and utility constraints need a separate design assessment.
What is a threshold problem? One where at most one kind of utility is needed at the chosen approach, so no internal pinch exists. The tiles and rules say which: hot only, cold only or neither. Raising the approach far enough usually creates a pinch.
Why does a network that breaks the pinch rules still show as feasible? A match is feasible when it respects the minimum approach at both ends. The pinch rules are a separate test of whether the design reaches the energy target.
Can I enter a stream that boils? Not directly. The model has constant CP. Do not hide a latent duty inside an arbitrary CP without a separate justification.
Professional use
For education and preliminary design. Results must be checked by a qualified professional. Not a substitute for code-compliant design or licensed engineering judgement. Pinchgrid makes no claim of code compliance or regulatory acceptance.
Made with Pinchgrid · simulations4all.com