Guide and components
With the heat balance tool you put a plant together from components on a grid of tiles and get the steady-state heat and pressure balance – for heating circuits, steam networks, power plant processes, flue gas paths and cooling circuits. This help explains how to use the tool and every component.
Tip: in the tool, the ? next to the name of a selected component leads directly to its description.
First steps: a heating circuit in ten minutes
The quickest way to learn the tool is with a small circuit: a boiler (heat source) heats water, a pump delivers it to a consumer (heat sink) and back.
- New diagram: In the menu Project (top left) choose “New diagram”. To try things out you can also load any example there – your other diagrams are kept.
- Place heat source: In the catalogue, open the tab Heat transfer tap “Heat source” and tap a cell in the grid.
- Pump and consumer: Under Pumps & fans the pump and under Heat transfer place the heat sink on other cells.
- Connect: Under Piping choose “Pipe” and “Bend” and fill the cells in between until a closed circuit is formed. Select a placed component and rotate it via the small bar on the component (↻) or the key R until its connections point to the pipes.
- Enter values: With Select tap a component. Its inputs appear in the data area: at the pump e.g. mass flow and pressure rise, at the source the outlet temperature, at the sink the heat output.
- Read results: Behind each component there is a value cross with ṁ, p, T and h. Below the plan, the Overall balance, shows whether mass and energy balance, and each loop lists its components with all values. The message counter in the row above the grid shows errors, warnings and notes.
How the tool calculates
The tool follows the pipes from component to component and forms runs (open, from a feed to an outlet) and loops (closed). Each run has one mass flow; pressure and enthalpy are calculated component by component. Nodes such as pipe tee, feedwater tank, steam generator with circulation, preheater and condenser connect several runs and balance mass and energy. The calculation is iterative: first the energy balance without pipe friction, then with hydraulics, until in one pass no enthalpy, no pressure and no mass flow changes by more than 10−7 (at most 500 passes). The tool then checks mass and energy of the whole plant. All equations and assumptions are openly available in the Calculation basis.
- Who fixes the mass flow? Pumps, feeds, firing and air intake, the steam generator with “Specify live steam flow”, heat exchangers with “Mass flows: specify here” and outlets with a flow specification. A feedwater tank decouples: the pump downstream delivers what flows to it.
- Who fixes the pressure? Pumps (pressure rise or outlet pressure), feeds, vessels (operating pressure), pressure reducers and pressure retaining valves, turbines (outlet pressure) and flash vessels. Pipes, valves and apparatus subtract their pressure loss.
- Media: Water/steam to IAPWS-IF97, flue gas as an ideal gas mixture from the combustion calculation, air as dry air. The medium of a run follows from its start.
- Units: Water and steam pressures in bar(a) (absolute), flue gas and air in mbar(g) (gauge); mass flow optionally t/h or kg/s; temperatures in °C; powers in kW.
Interface
Tab
| Tab | Content |
|---|---|
| Project | Project data, logos, structure of the document number, tagging (KKS, RDS-PP, free). Applies to all diagrams of the same project. |
| Diagram | The tile grid with catalogue, data area and results – this is where you draw and calculate. The tab Cover sheet to the right of the catalogue groups shows the cover sheet of the diagram. |
| Specifications | Project-wide definitions in sub-tabs: perm. velocity (permissible flow velocities per medium and nominal size catalogue, see piping), VGB short texts (the whole abbreviation catalogue in alphabetical order; new abbreviations via “New abbreviation”, change short forms per row; additions and changes apply per project and are marked), KKS number groups (number ranges AN for piping, valves, measurements) and Connection type (per KKS system: valves welded, flanged or screwed/pressed, optionally with a DN limit; defaults for common systems; determines connection type and face-to-face length in the valve list). |
| Data | The data model behind the diagram: functions, lines, valves, instruments with tags and calculated values; lists as CSV. |
| PFD | The process flow diagram is in development and will be released soon. |
| Document list | All documents of the project with number, revision and file name, export as Excel. |
Kopfleiste
At the top are the project and diagram names, at the very top of the header the menu Project (visible on all tabs: new project, open, save, close; new diagram, recently opened, examples). At the far left of the tab is the menu File for this diagram (print / PDF, save diagram, open file, duplicate diagram – also with the rated load case only; the copy takes over components, values and tags, but no process flow diagrams and revisions –, rearrange as a copy, build or change from a description, delete diagram, clear all), next to it the selection of the diagrams of this project – the pencil next to it or a double-click renames the diagram –, Select and Multiple, the drop-down menu load case (Choose load case, + Load case, name, load factor, delete) with Compare next to it, calculation (real time/design), mass flow, colours and on the right Build with AI and Separate window ↗. The row below: Undo (arrow), the zoom (− / + and the symbol Fit), the counter for errors, warnings and notes, the ? with the usage notes and keyboard shortcuts (hovering shows them, tapping keeps them open) and the grid symbol with columns, rows and the side of the data area. On the right of this row, directly above the components, are the Catalogue groups (piping, heat transfer, steam & vessels, pumps & fans, storage & renewables, valves, inlets/outlets, other, cover sheet). The Components of the selected group are listed one below the other in the column to the right of the grid; with many components you scroll there. The Legend of the line types floats semi-transparently at the top right over the grid. The Data area can be collapsed via the narrow bar at its top edge; a handle then remains at the edge that opens it again. The header bar stays in place when scrolling.
Werkzeugleiste
- Work area: Columns (up to 40) and rows (up to 30) of the grid.
- Calculation: Real time calculates after every change, Design only at the push of a button (“Calculate now”) – handy for large diagrams. Next to it Goal seek (siehe Goal seek).
- Select / Multiple: to the left of the catalogue tabs above the tile area.
- Mass flow: Display in t/h or kg/s, applies to inputs, value crosses, messages and lists.
- Colours: Medium (default) colours the lines by medium: steam red, water blue (also cooling and heating water), flue gas brown, air grey-turquoise. Temperature colours by a temperature scale from cold (blue) to hot (red). The choice is saved with the diagram and also applies to the printout; the legend in the title block adapts. The line types (steam dashed, gas dotted) remain in both cases so that black-and-white printing stays readable.
- Data area: to the left or right of the grid.
Load case bar and message bar
Above the grid you choose the load case (see load cases). The message bar counts errors, warnings and notes; a click opens the list (see Messages).
Value cross and lines
The value cross behind a component shows the mass flow at top left, the pressure at top right, the temperature at bottom left and the enthalpy at bottom right (for wet steam the steam quality x). The legend at the top explains the arrangement in the current unit. Water is drawn as a thin line, steam as a thick line, flue gas and air as a medium line; the colour shows the temperature. On pipes you can show an additional value cross.
Drawing and editing
| Action | How to |
|---|---|
| Place a component | Choose it in the catalogue, then tap a free cell. The tool stays active until you choose Select . |
| Select | Tool Select, Tap a component. Its inputs appear in the data area. |
| Rotate / mirror / delete | A click only selects. A small bar appears on the selected component: ↻ rotate, ⇋ mirror, 🗑 delete (the same buttons are in the component window). Keys: R drehen, Shift+R rotate back, M mirror, Del delete. Only the buttons the component supports appear: vessels, steam generator with circulation, condenser (2 tiles) and flash vessel are only mirrored; large heat pump and feedwater heater are rotated and mirrored; the thermal store is fixed. |
| Move | Drag the component or move it with the arrow keys. |
| Select several | Shift/Ctrl + click, drag a frame with the mouse on an empty cell, tool Multiple (also on a tablet) or Ctrl+A. Drag selected components together or move them with the arrows; pipes in the way are overwritten. |
| Copy, cut, paste | Ctrl+C, Ctrl+X, Ctrl+V. |
| Delete | Del or the “Delete” button in the data area. |
| Undo | Ctrl+Z or the button in the header bar. |
| Zoom | Ctrl + mouse wheel, two-finger zoom or − / + / fit. Only the grid is zoomed. |
| Separate window | Separate window ↗ opens the grid in a second window, e.g. on the second screen. The window is built like the main window: at the top select/multiple, load case, columns/rows, zoom, calculation (real time/design), mass flow, colours, the message counter and the ? with the usage notes; below them the catalogue groups, on the right the components one below the other, the legend floats at the top right over the grid. The main window keeps the load case bar and a narrow bar with Bring window to front and Bring back; the data area uses the full width in three columns (inputs · values of the component · calculation). When the window is brought back or closed, everything returns to its place. |
- Crossing lines only via the component “Crossing”. Branching only via the “Pipe tee”.
- Multi-tile components (feedwater tank, preheater, condenser, turbine with extractions, steam generator with circulation) need free neighbouring cells; if there is no room, the tool reports which cell is blocking.
- Connections are labelled on the symbol. If a pipe does not fit, the message names the component and the cell.
Calculation and results
Below the grid are the results: first the Overall balance, then each loop or run with its components.
Overall balance
- Overall efficiency = benefit / effort. Benefit: net electrical output, heat sinks and water/steam enthalpy delivered net to outlets (cooling water counts as waste heat). Effort: firing heat input, electric boilers, heat sources, waste heat and enthalpy supplied.
- Carnot efficiency = 1 − Tu/To with the highest water/steam temperature To and the ambient temperature Tu (project setting) – the theoretical upper limit for comparison.
- Mass flow and enthalpy flow in/out, heat supplied and removed, firing heat input, the electrical output per generator, total electrical, auxiliary and net output, remainder of the mass and energy balance.
“Balanced” means: mass and energy are correct within the calculation accuracy. “Open” means that something leaves the cycle (sampling, deaeration) without being replenished.
Results per component
If you select a component, the results are listed below its inputs: inlet and outlet state, output, for pumps the electrical power, for pipes nominal size, velocity, run length, pressure and heat loss. Fields that are overwritten or have no effect are marked and explained (“follows from …”, “has no effect because …”).
load cases
A plant rarely runs only at its rated point. In the drop-down menu load case above the grid you use + Load case to create further load cases, e.g. 70 % or winter/summer. Each load case has a name and a Load factor, that scales the load-determining quantities: mass flows of the feeds, firing output, heat outputs, fixed branch flows, outlet mass flows. Under Hours per year you enter how long the plant runs in this load case per year; from this the value table calculates annual values (total at most 8,760 h).
- Each input can additionally be overriddenper load case. Overridden fields are marked and can be reset to the rated-load value.
- The circuit itself applies to all load cases.
- Compare shows all load cases side by side. The PDF contains one plan per load case and the comparison.
- Some components need a design load case: orifice plate (bore diameter) and turbine with steam cone law.
Design with ƒx and outlet specifications
Often you do not know the input but the target: “Which pump do I need so that 6 bar arrive at the consumer?” There are two ways to do this:
- ƒx on an input field: The field is calculated instead of entered. You choose a target quantity at any component (temperature, pressure, mass flow, power or pressure margin) and the set value. The tool adjusts the input so that the target is reached.
- Specifications at the outlet: At the “Outlet” component you can specify mass flow, pressure and temperature and choose for each which upstream input is adjusted. In the plan, ◂ indicates a specified value. If two specifications adjust the same input, the tool reports a conflict.
Goal seek (Planner, Campus)
For tasks with several unknowns and limits: button Goal seek neben Real time/design. Example: which district heating mass flow can be heated to 90 °C without the brine return falling below 40 °C?
- Variable quantities: Inputs of components that may be adjusted, each with a limit from … to. All other inputs stay fixed.
- Conditions: quantity =, ≥ or ≤ value. Quantities are temperature, pressure, enthalpy and mass flow at the outlet of a component or on a line clicked in the plan, key figures of the components (outputs, efficiencies …) and rows of a value table, e.g. the heat output between two measuring points.
- Objective (optional): one quantity as large or as small as possible, e.g. the mass flow. The search adjusts the variables until a limit is reached; the log names the governing limit (“limit active”).
- load cases: only the current or all one after another. In the rated load case the results go into the inputs, otherwise into the overrides of the load case. Discard result or Ctrl+Z restores the previous state.
- Method: Newton method with damped step size (Levenberg-Marquardt) for the conditions, gradient projection for the objective, active-set method for ≥/≤. It only calculates at the push of a button. If a variable is at its limit, the log says so – then widen the limit if necessary.
Messages
The message bar above the grid counts Error (calculation not possible or physically meaningless), Warnings (calculates, but check) and Notes. A click opens the list with component and cell; “What does it mean, what to do?” explains each message, a click on the component jumps there. In the grid, red and yellow badges mark the affected components; pipes with too high a velocity have a dashed outline (yellow above the permissible velocity, red above twice the permissible velocity).
Typical messages and what to do about them are in the frequently asked questions and with the individual components.
piping
Automatic nominal size
Each pipe gets the smallest nominal size at which the velocity does not exceed the permissible velocity of its medium. The tool chooses the medium from the calculated state (e.g. “Hot water downstream of pump”, “Superheated steam”); on the pipe it can be set permanently, as can a fixed nominal size. The tables for this are on the tab piping and can be changed:
- Permissible flow velocities per medium (e.g. water upstream of pump 0.5 m/s, downstream of pump 3 m/s, superheated steam 50 m/s, flue gas 15 m/s).
- Pipe dimensions DN 15 to DN 3800 with outside diameter, wall thickness and inside diameter (seamless steel pipes to DIN EN 10220; large nominal sizes with assumed wall thicknesses). From about DN 2400, two parallel lines are usually built in practice.
Run length, pressure and heat loss
How many tiles a pipe has in the diagram does not matter for the calculation. All pipe, bend and crossing tiles between two components form a Rohrstrang with a Run length (default 10 m), which you change on the pipe – it applies to all tiles of the run, for the crossing per direction. From this the tool calculates:
- Pressure loss to Darcy-Weisbach. The friction factor λ follows from the Reynolds number and Rohrrauheit (project setting, default 0.05 mm for steel pipe) to Colebrook; the Reynolds number and λ are shown on the pipe.
- Fittings and valves: enter on the pipe the sum of the resistance coefficients Σζ of the run, or set a percentage allowance on pipe friction in the project settings (20–50 % is usual in preliminary design).
- Height difference of the run in metres, positive = upwards in flow direction; the pressure changes by ρ · g · Δz. In a closed circuit the heights must cancel out.
- Heat loss with the heat loss per metre and kelvin from the project settings (default 0.3 W/(m·K)) against the ambient temperature. If you enter an Insulation thickness there, the tool calculates the heat loss per nominal size from the insulation thickness and the thermal conductivity of the insulation.
Project settings for the calculation
With no component selected, the right-hand column shows the project settings: ambient temperature, heat loss or insulation thickness of the pipes, pipe roughness, allowance for fittings, site altitude and water content of the combustion air. The air pressure follows from the site altitude (standard atmosphere); it applies to all gauge pressures, to the cooling tower, the air-cooled condenser and the density of air and flue gas. The water content of the combustion air affects the flue gas quantity and the dew point.
Further calculation functions of the components
- Turbine: The Type sets the guide value of the isentropic efficiency – industrial turbine 0.80 (usually 0.70–0.86), high-performance turbine 0.90 (usually 0.86–0.92); an own value sets the type to “own value”. Optionally the Baumann wetness correction, the leaving loss via the exhaust area of the last stage and the mechanical efficiency. A warning appears from 12 % exhaust wetness.
- Generator: “with gearbox” additionally takes the gearbox efficiency into account. With a rated output, the generator efficiency drops at part load.
- Condenser and Heat exchanger with “Hold k·A from the design load case”: the first load case fixes k·A. In the other load cases the heat exchanger calculates the heat from this k·A; for the condenser, the condenser pressure follows the cooling water and sets the exhaust pressure of the turbine upstream.
- Pump: shows the available NPSH; with “NPSH required” the tool warns if less than 0.5 m margin remains.
- Control valve and pressure retaining valve: show the required Kv-value in the current load case.
- Outlet in the flue gas path: With a stack height, the tool calculates the stack draught; with sulphur-containing fuel the acid dew point is shown on the flue gas.
- Gas turbine: optionally conversion from 15 °C (ISO) to the intake air and efficiency at part load via the rated output. Steam generator: radiation loss optionally constant in absolute terms.
- Large heat pump: pressure losses of the suction and hot gas lines, separate efficiency of the high-pressure stage, start-up losses when cycling, quality grade relative to the Lorenz cycle.
- Water and steam are calculated up to 1000 bar, including supercritical.
The selected pipe shows the run length, pressure loss and heat loss of the whole run; the page Data the columns L and Δp per line.
Data, lists, tagging
Behind the diagram there is a data model: each component is a Function with a fixed tag, the pipes form Lines (new line number when the nominal size changes). The page Data zeigt:
- Functions with tag, type, role, medium, P&ID sheet, ṁ, pressures, temperatures, heat output and electrical power.
- Lines with tag, medium, DN, from/to, ṁ, p, T, length and pressure loss.
- Valves and inline items sowie Instruments from the process flow diagram with measuring location, medium and operating value.
- Lists as CSV for Excel, all load cases side by side: equipment list, line list, consumer list, instrument list.
- States: freeze the current state under the revision index of the cover sheet, compare it with the current state or return to it.
Tag are assigned by the tool to KKS (default), optionally RDS-PP or free; you set unit and line on the Project page. A tag can be overwritten in the table – it is then locked and kept when renumbering. In the project lists (equipment, line, consumer, instrument, piping and valve list, interface list) every field can be changed: The calculated value is shown in grey as a suggestion in the field; an entry replaces it (also in the export), empty restores the calculated value. The tag changes everywhere. You can import your own key catalogues as CSV.
Project, cover sheet, document list
- Project: Project name and code, client and designer with codes and logos, Project participants (name, company, role, e-mail, phone; copy addresses with one click or open an e-mail), structure of the document number (order, separators), tagging with plant type, counting groups. The project is the container for all documents (diagrams, process flow diagrams, lists; later P&IDs and data sheets). Exactly one project is always open; the selection “Project” at the top of the page and File → Open project … switch it, the previous one stays in the browser.
- Cover sheets: uniformly in A4 portrait with the logos of designer and client: title, project, company, client, document number and revisions. Project data are taken over automatically; your own entries take precedence. The diagram has its tab Cover sheet next to the catalogue groups; when printing it is the first page, the plan keeps its format. With Professional every list (Data page, switch “List | Cover sheet”) and the document list also get a cover sheet with their own document number and revisions; “Print / PDF” outputs cover sheet and list. A new revision is only created when you click “+ Revision”. Process flow diagrams have their own revisions (button “Revisions …” on the PFD tab), but no cover sheet.
- Save PDF: creates the PDF file directly, without a print dialogue – as vector graphics with embedded fonts and the file name from the document list. For the diagram in the dialogue “Print / PDF” (cover sheet, plan per load case, results, messages), for the PFD on the PFD tab, for lists and the document list next to “Print”.
- Heat exchanger evaluation (Design → Heat exchanger evaluation): key figures per heat exchanger (Q, k·A, NTU, C*, ε, ΔTm, smallest temperature difference, U-value, area with margin, volume flows, pressure losses) with notes (series connection, other type, temperature cross, pressure loss) and five curves: T-Q diagram, pressure loss versus flow, ε-NTU family, U versus Re and fouling U(t) with cleaning time (area margin, Rf∞ and τ adjustable on the page); for “HX diagonal” and “HX straight”; with Planner as PDF with cover sheet.
- Heat pump evaluation (Design → Heat pump evaluation): for each large heat pump, operating point and limits with comment and remedy, comparison of variants (economiser, series, cascade, compressor, refrigerant) with “apply”, COP map over the outlet temperatures of heat source and heat sink, and part-load behaviour over the load ratio (heating output ÷ rated heating output) – directly from the cycle, without additional load cases. Each diagram explains with “Use:” what it is meant for. With Planner (or Professional): load case wizard for one year (heating curve, outdoor temperature classes; source temperature constant, equal to the outdoor temperature for air or with an annual profile between winter and summer values for river, lake and waste water), annual load duration curve with coverage shares, full-load hours and seasonal performance factor (the annual COP: annual heat ÷ annual electricity), levelised cost of heat with the minimum full-load hours compared with the gas boiler and electricity/gas price sensitivity, and the PDF of the evaluation.
- Valve list: according to the template with short and long text, medium, DN, PN, PS/TS (inherited from the piping), valve type and actuator (also apply to the symbol in the PFD), material, face-to-face length with source, connection type, manufacturer, model, lot and remark; responsibility P (planner) and L (supplier). Naming: Main components get their long text in the equipment list; valves, lines and measurements refer to it (“Shut-off valve downstream of feedwater pump 1”, “Suction line feedwater pump 1”, “Pressure live steam line downstream of steam generator”). The short text (at most 25 characters) is formed with the abbreviation catalogue. Each actuator appears as a separate object (tag of the valve with -M01) in the consumer list.
- Line list: per line short and long text, operating data, PS/PSmin/TS with derivation, material, DN, PN, outside diameter, wall thickness, piping class, installation location, trace heating, insulation, PED classification, lot and remark. The supplier columns (quantity, unit, mass per unit, unit prices for supply, installation and insulation) can be filled in here or in Excel; total mass and total prices are calculated. Manual values of a line are kept even when the diagram is recalculated.
- Decouple PFD: When the diagram is finished, you freeze the process flow diagrams at this state – on the PFD tab “Decouple from HBD” or for all of them on the cover sheet of the diagram “Close HBD – decouple follow-up documents”. Later changes to the diagram then no longer take effect automatically. With “Apply changes from HBD …” you see the differences per object and apply selectively what you tick. “Couple again” makes the PFD follow the diagram again.
- Document list: all documents of the project with creation date, document number, format, revision, title, author and file name; export as Excel. Saved diagrams carry the file name from the list. A click on a row opens the document in the matching tab; ✕ at the end of the row deletes a diagram (together with its PFDs) or a single PFD after confirmation. Assigned numbers are not reassigned. “duplicate” marks two diagrams with the same identifier (copies from older project files) – delete one of them.
Save, open, print
- All diagrams are automatically saved in the browser . Nothing goes to a server.
- Save diagram saves the current diagram as
.wsb.jsonab. Save project saves the whole project as.toome.json: all diagrams of the project, project data with logos and number range, and the data model. Open file reads both. - Projects and documents: Documents are only created when you create them: via New diagram, on the PFD tab via “Derive PFD from …” or “New PFD …”, via examples, Open file or the AI connector. A document gets its document number when it is created. New project creates an empty project without documents. Open project … shows all projects in the browser (open, delete) and opens project files (
.toome.json); if the project is already in the browser, you are asked once whether the state from the file is applied, added as a copy or the browser state is kept. Close project … removes the open project with all documents and project data from this browser, on request after saving it as a project file. Open file … loads a single document (.wsb.json) into the open project – project files only via “Open project”. Under Open are the documents of this project that you have already opened in this session; all diagrams of the project are shown in the selection to the left of the diagram name. Examples open as a separate project. - If you open a file of the same project, the tool offers a comparison : you tick which changes are applied, or open the file as a new diagram.
- In Chrome and Edge, a dialogue for location and name opens when saving; other browsers save to the download folder.
- “File” menu per tab: Diagram, Data, Design, PFD and document list each have their own menu at the far left File with Print, PDF and the exports of the tab (Data: Excel, CSV; PFD: DXF, DEXPI, import DEXPI). In the separate window it is at the top left; in the main window it remains accessible.
- Print / PDF (menu File on the Diagram tab): print view with title block in A4 to A2, cover sheet as first page, one plan per load case, comparison table and optionally the calculation results. Save as PDF via the browser's print dialogue.
- Build with AI, rearrange, build from a description (beta): the tool arranges components itself and routes the pipes. Rearrange creates a copy of the diagram (values and load cases are kept, pipes are routed anew). Build or change from a description creates a diagram from a list of components and connections (JSON), e.g. written by an AI, or changes the open diagram with commands (set values, add a load case, insert a component or place it in a line, remove, connect, disconnect). Only the new pipes are routed; if there is not enough room, the tool rearranges. “Copy result” returns the messages of the calculation to the AI. With the button ✦ Build with AI you set up the AI connector : an AI such as Claude can, via the address
https://toolmeyer.de/mcp(add as a custom connector in the AI application, sign in with the Toolmeyer account) build, change, calculate and read diagrams itself. It gives you a link that opens the diagram here. With “Provide this diagram” you give it a diagram from the tool. Detailed guide: toolmeyer.de/ki. Basis for the planned AI integration. - Checksum: Saved files carry a checksum. If a file has been changed outside the tool (e.g. in a text editor), the tool asks before applying it when opening. So edit diagrams only in the tool.
- Account and watermark: Without signing in (guest) and with a Free account, printouts will later get a watermark. With a university e-mail address (Campus) you print up to 50 objects without a watermark; every component counts as an object except pipe, bend, crossing, pipe tee and note. The rule that currently applies is shown in the print dialogue. During the beta everyone prints without a watermark. You can sign in via Sign in in the header bar or on the page Account.
Components
Each component with purpose, connections, calculation and notes. The table “Inputs” shows all fields with unit and default value. Some fields only appear with certain settings (e.g. fuel analysis only with “own analysis”).
Piping
- Purpose
- Connects two connections straight across one tile. “Bend” turns by 90°.
- Calculation
- Nominal size automatically from the permissible velocity of the medium or fixed. Pressure and heat loss from the run length (see piping).
- Notes
- On the pipe: medium (automatic or fixed), show value cross, run length, nominal size. Medium and run length apply to the whole run up to the next component.
- Purpose
- Distributor or collector (header) over 2 to 4 tiles with up to 10 connections: at both ends and at the top/bottom of each tile (rotated vertically: left/right). The connections are numbered on the symbol; only connections in use are drawn.
- Calculation
- Like the pipe tee, only with more connections: all incoming flows are mixed (mixing temperature), all outlets have this state and the lowest inlet pressure. Several outlets share the flow according to “Split in %” in the order of the connection numbers, e.g. “50 / 30 / 20”; empty or with the wrong number, evenly.
- Notes
- Rotating switches between horizontal and vertical (the cells must be free for this). You set the length in the data area.
- Purpose
- Pipe bend by 90°. Calculates like a pipe.
- Purpose
- Two lines cross without being connected. This is the only way lines may intersect.
- Notes
- Medium, value cross and run length can be set per direction.
- Purpose
- Splits a run or joins two runs. The branch is the outlet at right angles to the inlet.
- Connections
- Three: inlet, through, branch (reversed for a junction).
- Calculation
- As in the plant, the branch itself does not set a flow: The split follows from the outlets. If a component in one outlet fixes the flow – control valve with “Flow”, heat sink or source with “Output and temperature”, steam generator with live steam flow, feedwater tank, desuperheater, outlet with a flow specification, extraction “on demand” –, this outlet gets its flow and the other the remainder; the input field at the tee is then omitted. If both outlets fix the flow, the inlet follows the sum (if it is adjustable, otherwise a message). As long as no outlet fixes the flow, an assumed split (share in % or fixed flow) applies, with a note in the message list and in the process flow diagram (“Control in outlet open”). Junction: mixing enthalpy, the pressure is the lower of the two inlets.
- Minimum flow control
- Downstream of a pump: if the main outlet falls below the minimum flow (in % of the rated-load flow or as a fixed flow), the pump delivers the remainder via the branch – continuously or open/closed.
Pumps & fans
- Purpose
- Delivers water and determines flow direction and mass flow in closed circuits. Every closed circuit needs a pump.
- Connections
- Suction side and discharge side (the tip of the symbol points in the delivery direction).
- Calculation
- Pressure: by the pressure rise or to a fixed outlet pressure. With a curve (three points H over V̇ and speed), the head follows from the volume flow; with “Operating point” also the mass flow from the intersection with the system. Shaft power from the hydraulic power and the pump efficiency, electrical power additionally with the motor efficiency.
- Notes
- Downstream of a vessel or a feed, the pump delivers what flows to it. The suction-side inlet pressure applies if the circuit does not fix another pressure. Cavitation messages appear when the water on the suction side is close to boiling. “Number in PFD / P&ID” determines how many pumps are drawn in the process flow diagram. Pump bypass: If the pump is off (e.g. the charging pump of a thermal store during discharging), the water flows past it via the bypass – also in reverse – without head.
- Purpose
- Delivers flue gas or air, e.g. induced-draught fan upstream of the stack or fresh-air blower.
- Calculation
- Pressure rise in mbar; power from volume flow, pressure rise and efficiencies, counts towards auxiliary consumption.
- Purpose
- Compressor for air or flue gas with a larger pressure ratio, e.g. process air. For water vapour there is the steam compressor, for heat pumps separate components.
- Calculation
- Outlet pressure = inlet pressure × pressure ratio (absolute). Isentropic compression of the ideal gas mixture, then the actual outlet temperature via the isentropic efficiency. Electrical power via the motor efficiency, counts towards auxiliary consumption.
- Notes
- Only in the air or flue gas path; in a water or steam run there is a message.
- Purpose
- Steam compressor (mechanical vapour recompression, MVR): raises water vapour to a higher pressure, e.g. vapours from an evaporator or low-pressure steam from a large heat pump, so that it can be used again as heating steam.
- Calculation
- Outlet pressure = inlet pressure × pressure ratio (absolute). Equal pressure ratio per stage, isentropic compression with water vapour properties (IAPWS-IF97), actual outlet enthalpy via the isentropic efficiency. Electrical power via the motor efficiency, counts towards auxiliary consumption.
- Notes
- The steam is strongly superheated downstream of the compressor. For saturated steam, place a desuperheater downstream. Wet steam at the inlet is reported (droplet impact); water at the inlet is an error.
Heat transfer
HX diagonal, HX straight, heat source and heat sink have the same basic symbol as the feedwater heater: a square with a Z line (tube bundle). They are distinguished by the code letter at the top right: D HX diagonal (connections at the corners), G Straight HX (connections opposite), Q Heat source, S heat sink. The Z line always stands for the heat-absorbing medium: for the heat exchanger the cold side (after the calculation), for the heat source the run flowing through; for the heat sink the run gives off heat, so the Z line lies across it. Arrows on the nozzles of the heat exchangers show after the calculation where the media enter and leave.
- Purpose
- Heating heat pump as a series-produced unit for buildings and commercial use, usually up to about 500 kW (also as a cascade of several units), with outdoor air, brine or water as heat source. It is calculated with data sheet values. Until 15.11.2026 the component was called “Small heat pump”.
- Which heat pump?
- heating heat pump if a unit data sheet is available (flow temperature up to about 55–75 °C depending on the refrigerant). Large heat pump for engineered plants in district heating and industry, usually from about 100 kW, also above 70 °C, if the refrigeration cycle itself is to be designed. Between 100 and 500 kW both fit. Outside these ranges a note appears.
- Connections
- Heating side from left to right, source side from bottom to top (none for air).
- Calculation
- The COP at the rating point (A2/W35, B0/W35, W10/W35) gives the quality grade relative to the Carnot cycle. It continues to apply at the operating point: evaporation = source outlet − approach, condensation = flow + approach. For air below 7 °C the defrost loss is deducted. Above the operating limit the electric heater takes over if it is switched on. Electrical power (compressor, auxiliary energy, electric heater) counts towards auxiliary consumption.
- Output limit
- Rated heating output per unit at the rating point from the data sheet and Number of units give the largest heating output (0 = no limit). For air, the output changes with the outdoor temperature by the set value per K relative to A2 (guide value 2–4 %/K). If more is demanded, the electric heater covers the remainder; without an electric heater the flow temperature drops. The units are switched on one after another; if the load per unit is below the minimum modulation, it cycles (note: provide a buffer store). The inspector shows load ratio and running units.
- Auxiliary power
- Fan or source pump in the unit in % of the compressor power. Guide values: air 3–5 %, brine 5–8 %, groundwater 8–15 %. If the source pump is drawn as a separate component, enter 0.
- Refrigerant
- Information only, the calculation uses the data sheet COP. Safety group and global warming potential (GWP to the F-gas Regulation) are shown; with the charge also the CO₂ equivalent. If the max. flow temperature is above the usual value for the refrigerant, a note appears.
- Notes
- With several load cases and operating hours, the inspector calculates the seasonal performance factor (SPF).
- Connections
- Two tiles, all four connections on the long sides: on one tile the sink (S, condenser), on the other the source (Q, evaporator), each straight through. Rotating sets the component horizontal or vertical, mirroring swaps the sides. Example: menu “Examples” → “Large heat pump in district heating”.
- Purpose
- Large heat pump for district heating and industry, calculated as a real cycle with refrigerant data: R717 (ammonia), R290 (propane), R1234ze(E), R1233zd(E), R744 (CO₂, transcritical), R134a and R718 (water). R513A will follow as soon as the mixture properties calculate reliably in the browser; until then R134a with similar pressures is the closest.
- Circuits
- single-stage (optionally with internal heat exchanger), two-stage with economiser (open intermediate-pressure vessel, intermediate pressure as geometric mean), several compressors in parallel, two heat pumps in series on the sink side (each heats part of the temperature spread) and Cascade (low-temperature and high-temperature circuit with their own refrigerant). Compressor type centrifugal, reciprocating or screw sets the default efficiency and the usual pressure ratio per stage.
- Calculation
- Evaporation = source outlet − approach, condensation = sink outlet + approach. With a subcooler, the liquid is cooled to close to the sink inlet. Properties from CoolProp (loaded on first use, approx. 6.5 MB). The inspector shows COP, quality grade, pressures, refrigerant flow, per stage pressure ratio, discharge temperature, suction volume flow and power, and the log p-h diagram.
- Part load
- The Load ratio is the heating output in the load case divided by the Rated heat output (Cell „Rated heat output“; 0 = Output limit bzw. largest load case). Die Output limit actually limits the heating output: if the sink needs more, the heat pump delivers exactly the limit, the sink leaves colder and a Spitzenkessel in series downstream (component “Hot water boiler” with outlet temperature) reheats the rest – if it is missing, the tool reports this. In the load case wizard it can be set as a share of the peak load. The Bestpunkt determines at which load the compressor has its best efficiency (100 % = rated load; e.g. 70 % = design for the load with the most hours); above it the efficiency falls to the “factor at rated load” at rated load. The isentropic efficiency drops at part load according to a standard curve for the type (guide values, not manufacturer data): centrifugal is best at rated load (ηs 0.80), but drops more at part load and only turns down to about 40 % (surge limit); screw with speed control to about 25 %, with slide valve to about 20 %, but then considerably worse; reciprocating with speed control to about 20 % with almost constant efficiency, with cylinder unloading to about 25 % and somewhat worse, with a lower rated value (0.70). The fields always show the effective value with the usual range next to it: isentropic efficiency, minimum load and the factors at minimum load, 50 % and 75 % follow type and control until you enter something yourself. 0 in the efficiency or the minimum load resets to the default; changing a factor switches on “own part-load curve”, untick = guide values again. All figures are in the Calculation basis. With several compressors in parallel, as few as necessary run, each with the same load ratio. Cycling: If the load ratio is below the minimum load, the machine runs intermittently at minimum load and stops in between; it is calculated with the efficiency at minimum load, plus a warning (remedy: thermal store, several smaller compressors, another type). The Type comparison calculates the plant over all load cases with centrifugal, screw and reciprocating compressors and shows SPF, electricity demand and load cases with cycling. Example: “Large heat pump in district heating” with winter, transition and summer.
- Notes
- Messages for too large a pressure ratio, too hot a discharge gas and too small a volume flow for centrifugal compressors. Seasonal performance factor over the load cases as for the heating heat pump.
- Purpose
- Hot water boiler for natural gas, light heating oil or electric (electrode or resistance boiler), e.g. as a peak or standby boiler in series downstream of a large heat pump or as the base-load boiler of a heating network.
- Calculation
- Like the heat source: fixed Outlet temperature (the output follows – as a peak boiler it reheats exactly the rest up to the flow temperature) or fixed Heat output (the outlet temperature follows). Fuel or electrical input = heat output ÷ boiler efficiency (relative to the net calorific value; default natural gas 0.95, heating oil 0.92, electric 0.99, with the usual range next to it; 0 = back to default). Consumption with net calorific value natural gas H 10.0 kWh/m³ (standard conditions) or light heating oil 11.9 kWh/kg (≈ 10.0 kWh/l), CO₂ 0.201 or 0.266 kg/kWh. The firing heat or electrical power counts as effort in the overall balance; the electric boiler appears in the consumer list.
- Notes
- Message if the heat output is above the rated heat output or the water arrives warmer than the outlet temperature. In the result evaluation the boiler appears in the annual load duration curve as a separate generator.
- Purpose
- Supplies heat without modelling its origin (e.g. boiler, heat pump, waste heat).
- Calculation
- Fixed outlet temperature (the output follows), fixed heat output (the outlet temperature follows) or both – then the mass flow follows (the flow adjusts itself, e.g. in the outlet of a pipe tee).
- Purpose
- Removes heat, e.g. radiators, air heaters, process consumers.
- Calculation
- Like the heat source: fixed outlet temperature, fixed output or Output and temperature – then the flow adjusts itself (like a consumer with control valve) and determines e.g. the split at a pipe tee. Heat sinks count as benefit in the total efficiency.
- Purpose
- Couples two circuits through a wall, e.g. district heating substation, oil cooler, feedwater preheating with water.
- Connections
- HX diagonal: the connections of one side are at the corners – left/top one side, right/bottom the other. After the calculation, arrows on the nozzles show inlet and outlet.
- Calculation
- Counterflow or parallel flow. You fix the heat transferred via exactly one specification: effectiveness ε, an outlet temperature or an approach (hot end, cold end or in parallel flow at the outlet end). The efficiency takes heat losses into account: the cold side receives efficiency × heat given off. Pinch check via the temperature profile.
- Design parameters
- The data field shows k·A (kW/K) and NTU: logarithmic mean temperature difference ΔTm from the four temperatures (counterflow or parallel flow), k·A = Q / ΔTm, NTU = k·A / Ċmin (Ċ = Q / temperature change of the side; approximation for evaporating or condensing). Under “Design” you choose the Type (plate, shell-and-tube, double-pipe heat exchanger) and optionally the k value; 0 takes the guide value of the type (plate 6,750, shell-and-tube 2,000, double-pipe 850 W/(m²·K)). This gives the area A = k·A / k, with several units also per unit. For the plate heat exchanger there is a note from NTU > 10 to check a series connection. Redundancy: number of units and output per unit in % (e.g. 2 × 70 %, 3 × 40 %); the labelling in the PFD follows from it (also applies to pumps and air coolers). With several units you choose the Connection in the PFD: parallel (distributor and collector per side) or series (units one after another, one bypass per unit). From this the PFD builds the piping with butterfly valves, safety valves against thermal expansion, temperature measurements and trim valves.
- Notes
- With “Mass flows: specify here”, the mass flows at the heat exchanger replace those of the pumps or feeds. If one side runs with flue gas, pressure losses are in mbar. The water side may evaporate.
- Purpose
- Straight HX: the connections of each side are opposite each other – one side left/right, the other top/bottom. Typical for heating surfaces in the flue gas path (economiser, superheater, air preheater).
- Calculation
- Like HX diagonal. In the flue gas path the tool recognises from the state of the water side whether the heating surface is an economiser, evaporator or superheater (tagging).
- Purpose
- Cools water with ambient air (dry cooler).
- Calculation
- Cools to the set water outlet temperature. The air flow follows from the air temperature rise (inlet → outlet); in addition LMTD and required UA.
- Purpose
- Wet cooling tower (natural draught or hybrid with fan) for cooling water circuits.
- Calculation
- Cools to the set outlet temperature. Air flow and evaporation follow from air temperature, humidity and saturated air outlet; with the cycles of concentration, blowdown and make-up water. The fan of the hybrid cooling tower counts towards auxiliary consumption.
- Notes
- It cannot cool below the wet-bulb temperature; with a margin below 3–5 K there is a note.
- Purpose
- Air-cooled condenser downstream of a turbine.
- Calculation
- Condenses the steam to the set subcooling; the condensing pressure comes from the turbine upstream. Air flow from air inlet and outlet, fan power from pressure rise and efficiencies (auxiliary consumption). At the condensate outlet the static head is added as geodetic pressure ρ·g·h.
- Purpose
- Water-cooled condenser with hotwell, e.g. downstream of the condensing turbine.
- Connections
- Two tiles one above the other: cooling water in and out, exhaust steam in, condensate out, cascade or secondary condensate in (numbered and labelled on the symbol).
- Calculation
- Condenses the steam to the subcooling; pressure loss only on the cooling water side (default 0.6 bar), the shell side has no pressure loss. At the condensate outlet the static head upstream of the condensate outlet is added as geodetic pressure – important for the cavitation safety of the condensate pump.
- Notes
- Older diagrams may still contain the single-tile condenser; a button on the component converts it to the new design. If cooling water and condensing temperature cross, there is a message with the required cooling water flow.
- Purpose
- Feedwater heater: heats feedwater with extraction steam from a turbine.
- Connections
- Two tiles: feedwater in on the right, out on the left; heating steam at the top and cascade at the bottom of the first tile; condensate at the bottom of the second tile. “Rotate” (90° steps) and “Mirror” change the orientation.
- Calculation
- Feedwater out = saturation temperature at the heating steam pressure − top approach. The heating steam flow follows from the heat balance (cascade heat is taken into account) and is controlled on demand if the steam comes from an extraction “on demand” or a feed.
Desuperheating zone (symbol “DSH”): allows a negative top approach – the feedwater may be heated above saturation, limited by the superheat of the heating steam and 5 K below its temperature.
Drain cooling (symbol “DC”): condensate out = feedwater in + bottom approach; without drain cooling the condensate leaves saturated.
At the condensate outlet the static head is added as geodetic pressure. - Notes
- The condensate can be pumped into the feedwater line; this pump delivers what comes from the heater.
Steam & vessels
- Purpose
- Steam generator: evaporates and superheats feedwater. Types once-through boiler, electrode boiler, drum boiler with forced or natural circulation.
- Connections
- Feedwater (S), live steam (D), continuous blowdown (A). With circulation the boiler occupies 2 × 2 tiles and shows the type in the picture; tapping mirrors it.
- Calculation
- Supplies exactly the heat required. Temperature via superheat or live steam temperature, pressure via pressure loss or live steam pressure (the feed pump must provide the pressure). With “Specify live steam flow” the boiler fixes the circulating flow in the cycle.
Heating: fuel (enter boiler efficiency or from the flue gas loss with fuel analysis, excess air ratio/O₂, air and flue gas temperature; gives firing heat input and fuel mass flow), electric (the electrical power with efficiency), flue gas (heat comes from evaporator heating surfaces) or waste heat/external.
Circulation (drum boiler, electrode boiler): circulation flow via circulation ratio (related to the current or rated-load steam flow) or fixed; with delivery pressure and efficiencies the electrical power of the circulation pumps (auxiliary consumption).
Continuous blowdown (only calculated if a line is connected at connection A): from the conductivities of feedwater and boiler water, as a share of the steam flow or as a fixed flow. The continuous blowdown water leaves boiling and must be replenished as make-up water. - Electrode boiler
- Type “Electrode boiler” with heating “electric”: the circulation pump delivers from the outer to the inner cup, the electrodes heat the water directly. The electrical power follows from the boiler heat and the electrical efficiency and appears in the consumer list.
- Purpose
- Firing: starts a flue gas path.
- Calculation
- From fuel (natural gas, heating oil, wood, waste, hard coal or own ultimate analysis), output or fuel flow, excess air ratio λ or residual oxygen and air temperature: air demand, flue gas quantity and composition, temperature at the furnace exit. Alternatively a specified exhaust gas (flow and temperature). At the end of the flue gas path the firing shows stack temperature, flue gas loss and boiler efficiency.
- Notes
- An air run can lead into the firing (on the side opposite the flue gas outlet); the air temperature then comes from the run, e.g. downstream of an air preheater, and the air intakes upstream supply exactly the combustion air.
- Purpose
- Gas turbine as a macro model (compressor, combustion chamber, turbine in one component), e.g. for combined-cycle plants with heat recovery steam generator.
- Connections
- Exhaust gas (flue gas path), optionally intake air as an air run, shaft for the generator.
- Calculation
- The fuel heat follows from shaft power and shaft efficiency; exhaust gas via temperature or mass flow, losses in % of fuel heat. A generator on the shaft calculates the electrical power.
- Purpose
- Combined heat and power unit with gas engine and generator as a macro model.
- Connections
- Engine cooling water in and out, exhaust gas (flue gas path), optionally combustion air (labelled on the symbol).
- Calculation
- The fuel heat follows from electrical power and efficiency; the engine cooling water heat (share of fuel heat, incl. oil and mixture coolers) goes into the cooling water, the exhaust gas into the flue gas path. If the cooling water return is too warm, there is a message.
- Notes
- Without connected cooling water, the engine heat is lost via the emergency cooler.
- Purpose
- Evaporator heating surface in the flue gas path, e.g. membrane walls and evaporator bundles of a heat recovery steam generator.
- Calculation
- Supplies the heat for a steam generator with heating “flue gas”; the flue gas cools by exactly its share of the boiler heat. Several heating surfaces share the boiler heat. If the flue gas falls below saturation temperature plus minimum margin, there is a message.
- Notes
- With ƒx on the feedwater flow, the steam flow can be determined so that the flue gas downstream of the heating surface reaches a target temperature.
- Purpose
- Feedwater tank with deaerator: collects condensate and make-up water, heats with heating steam and decouples the cycle.
- Connections
- Two tiles: heating steam (D) from above, water (W) and minimum flow (M) at the side, feedwater outlet (A) at the bottom, deaeration (E) at the top of the dome. “Dome left/right” mirrors, “Swap W/M” swaps the two connections.
- Calculation
- Operating pressure fixed. With “Heating steam automatic” the tank sizes the steam so that the feedwater reaches the set temperature (at most the boiling temperature). If the steam comes via a pipe tee, its split follows. The deaeration removes the set vent steam (only if a line is connected there). The static head to the outlet raises the pressure upstream of the feed pump.
- Notes
- To fix the circulating flow in the cycle, switch on “Specify live steam flow” at the steam generator; losses are made up by a water feed with “Make-up water automatic”.
- Purpose
- Flash vessel: separates hot water (e.g. continuous blowdown water, condensate) at the flash pressure into vapour and boiling water.
- Connections
- Inlet at the side, vapour at the top, water at the bottom. Tapping mirrors.
- Calculation
- The steam fraction follows from the energy balance.
- Purpose
- Steam turbine, optionally with one or two extractions.
- Connections
- Live steam at the top of the first tile, extractions at the bottom, exhaust steam at the top and/or bottom of the last tile (with both: split by share or demand), shaft on the right to the generator.
- Calculation
- Expansion section by section with the isentropic efficiency. Controlled extractions hold their pressure, uncontrolled ones follow the load according to the steam cone law. Extraction flow on demand (e.g. for feedwater tank or heater), fixed or as a share.
Part load: With “Steam cone law”, the flow constant is determined in the design load case; in other load cases the required inlet pressure follows, the rest is throttled at the control valve. The outlet pressure can equal the inlet of a following turbine. - Notes
- Several turbines side by side share one shaft and one generator. If the final wetness is too high, there is a message.
- Purpose
- Generator on the shaft of a turbine, gas turbine or several turbines.
- Calculation
- Electrical power = shaft power × efficiency. Appears in the overall balance as a separate row and in the consumer list as generation.
- Notes
- Place it directly at the shaft side and rotate it so that the shaft points to the turbine; otherwise the tool reports “not connected to any turbine shaft”.
Valves
- Purpose
- Control valve that reduces the downstream pressure to a set point. The catalogue has three entries: Control valve steam (e.g. steam pressure reducing station), Control valve water and Control valve Turbine inlet (directly upstream of a turbine). The type is shown as a letter on the symbol (D, W, T) and can be changed at any time in the field “Type”. It determines which valves and measurements the process flow diagram adds.
- Calculation
- “Controls” selects the task. Outlet pressure (pressure controller): outlet pressure = set point, but at least the minimum pressure loss. In closed circuits it sets the pressure. If the inlet pressure is not sufficient, there is a message. Flow (flow controller): the run gets the flow set point, e.g. as an outlet downstream of a pipe tee; the pressure drops by the set pressure loss. In the process flow diagram a flow measurement is placed upstream of the valve.
- Notes
- If the type does not match the calculated state (e.g. “Water”, but steam is present at the inlet) or if no turbine follows downstream of “Turbine inlet”, a warning appears. The former component “Pressure reducer” is now the control valve; older diagrams are converted when opened (type according to the medium at the inlet). “Cover valve in PFD” only exists for the type steam.
- Purpose
- Pressure retaining valve (upstream pressure regulator): keeps the pressure vor itself constant, e.g. at the end of a network.
- Calculation
- The upstream pressure is held at the set point; the pump upstream is adjusted accordingly.
- Purpose
- Three-way valve for mixing: controls a mixing temperature, e.g. admixing circuit in a heating circuit.
- Connections
- Inlet A, inlet B, outlet AB (labelled on the symbol).
- Calculation
- Splits the flows of A and B so that the set temperature is reached at the outlet; in the end position there is a message.
- Purpose
- Orifice plate with a fixed bore diameter, e.g. in minimum flow or bypass lines.
- Calculation
- Bore diameter designed from a chosen load case (upstream pressure from the plant, downstream pressure = outlet pressure), from substitute values or specified directly. In all load cases it then determines the pressure loss to ISO 5167-2 (C = 0.61, expansibility factor for steam), permanent pressure loss.
- Purpose
- Desuperheater: cools steam by injected water, e.g. between two superheaters or in a bypass station.
- Connections
- Steam in, water in, outlet (labelled on the symbol).
- Calculation
- Controls the injection flow to the set temperature or superheat downstream. The water comes directly from a water feed or from a pipe tee, whose split then follows.
- Purpose
- Water injection into flue gas (quench, conditioning tower, spray absorber).
- Calculation
- The water evaporates completely. The specification is the flue gas outlet temperature (the water flow follows) or the water flow. Downstream, the flue gas has more water vapour and a higher dew point; supersaturation is not possible.
Inlets and outlets
- Purpose
- Water feed: starts an open run with mass flow, pressure and temperature, e.g. mains water, cooling water, make-up water.
- Notes
- If it leads into a feedwater tank, it can automatically supply as make-up water exactly what the cycle is missing (deaeration, continuous blowdown, withdrawals).
- Purpose
- Steam feed: starts an open steam run with mass flow, pressure and superheat (0 = saturated steam), e.g. steam from a network.
- Purpose
- Air intake: starts an air run (dry air, pressure in mbar).
- Notes
- If the run leads into a firing, the intakes supply exactly the combustion air; several share the flow in proportion to their settings.
- Purpose
- Outlet: end of an open run (consumer, sewer, stack).
- Calculation
- Mass flow, pressure and temperature can be specified; for each you choose an upstream input that is adjusted (see Outlet specifications).
- Purpose
- Sampling: a small flow leaves the cycle, correspondingly less flows downstream.
- Notes
- If there is no make-up, the mass balance is “open”; the tool continues to calculate anyway.
- Purpose
- Outlet to atmosphere with one connection, e.g. vent, vapour to atmosphere.
- Calculation
- If it sits at an outlet of a pipe tee, its flow sets the split; directly downstream of a feed, the feed's flow.
Storage & renewables
- Purpose
- Thermal store (buffer store, district heating store) as a vertical stratified store with one connection at the top and one at the bottom.
- Charging / discharging
- You choose the operation in the store; the flow direction adjusts accordingly: Charging – water enters at the top, the cold layer flows out at the bottom. Discharging – water enters at the bottom, the warm layer flows out at the top. A pump that delivers into the store during charging is off during discharging; the water then flows back via its Pump bypass (tick at the pump). If the bypass is missing, an error message appears. For discharging, another pump or tee must deliver the water into the bottom of the store, e.g. the network pump via the return tee.
- Calculation
- Snapshot during charging or discharging: the outlet temperature is the temperature of the layer at the outlet (cold or warm layer), the output follows from mass flow and temperature difference. Capacity from volume and the two layer temperatures; with the state of charge it follows when the store is full or empty. Indirect (heating coil): The store water does not flow through; the outlet temperature of the heating coil is the approach above (charging) or below (discharging) the store temperature, which follows from the state of charge.
- Schedule
- With several load cases (e.g. “Charging at night 8 h”, “Discharging by day 9 h”) and the duration per load case, the inspector calculates the energy balance of one cycle: energy charged versus energy withdrawn and heat losses. It carries the state of charge from load case to load case and reports if the store overflows or runs empty. If the balance does not close, the store becomes emptier and emptier over several cycles or cannot absorb the heat charged.
- Notes
- Messages for too cold charging water or too warm return (stratification disturbed), full or empty store and when the store becomes full or empty within the load case duration. Example: menu “Examples” → “Thermal store in a heating network” (with heat generator and pump bypass) and “District heating network with thermal store (day / night)” (direct store between flow and return without its own heater).
- Purpose
- Thermischer Solar collector (Kollektorfeld) im Wasserkreis.
- Calculation
- Heat output Q = A · G · η with η = η₀ − a₁ · ΔT / G − a₂ · ΔT² / G; ΔT = mean collector temperature − ambient temperature (project). The outlet temperature follows from this iteratively.
- Notes
- The parameters η₀, a₁, a₂ are in the collector data sheet (test to EN ISO 9806). As with the heat source on output, the circuit needs a component that sets the temperature.
- Purpose
- Photovoltaic system. Has no line connections.
- Calculation
- Pel = peak power · irradiance / 1000 W/m² · system efficiency. The electricity counts as generation in the overall balance.
- Purpose
- Wind turbine. Has no line connections.
- Calculation
- Simplified curve: below the cut-in speed and from the cut-out speed 0 kW, rising cubically between cut-in and rated wind speed, above that rated output. The electricity counts as generation in the overall balance.
- Notes
- The wind speed can be overridden per load case.
Other
- Purpose
- Free text on a tile, may run beyond the neighbouring tiles. Line break with Enter, font size and bold adjustable. Not calculated.
- Purpose
- Shows important values of the diagram at a freely chosen position: the heat output between two measuring points and any number of further values. The table floats above the tiles, is not calculated and also appears in the printout and the PDF.
- Measuring points
- In the component window, at measuring point A or B click setzen then click a line or a component in the plan. A green pin with the letter shows the measuring point. At a crossing, the line closer to the click counts. Esc cancels.
- Heat output
- Q̇ = ṁ·h at A minus ṁ·h at B (enthalpy to IAPWS-IF97), in kW, from 1,000 kW in MW. If A and B are in the same stream before and after heating – for example district heating return upstream of the first and flow downstream of the last heat generator – this is the total output absorbed. If the mass flows at A and B differ, an asterisk is shown at the value: the result then depends on the reference point of the enthalpy (water at 0.01 °C).
- Further values
- Via Add value: pressure, temperature, enthalpy and mass flow at the measuring points and all key figures of the components (outputs, mass flows, efficiencies …), including heat pumps (heating output, electrical power, source heat, COP, load ratio), the electrical auxiliary consumption split into pumps, heat pumps, other components and total, and Total useful heat, Overall plant COP (useful heat divided by the total electricity consumption), Heat pump COP and the share of the heat pumps in the useful heat. Useful heat includes all heat pumps and every component with the tick Include in total COP (e.g. the geothermal water heat exchanger of a geothermal plant). Pumps and other electrical consumers with the tick exclude from total electrical consumption are excluded from the total consumption (e.g. network pumps outside the plant); the row “of which not included” shows their power. In addition CHP unit, gas turbine, compressor, steam compressor, thermal store, solar collector, photovoltaics, wind turbine, three-way valve, feedwater heater, distributor/collector, control and pressure retaining valve. Labels can be changed, rows moved and removed.
- load cases
- All load cases as columns shows each load case side by side. For this, each load case is calculated once in the background. If load cases have Hours per year (load case menu), the column Year is added: outputs as energy in kWh/a, MWh/a or GWh/a, performance figures as seasonal performance factor Σ heat·h ÷ Σ electricity·h (e.g. SPF of the whole plant). Load cases without hours do not count there.
- Move
- Grab the table anywhere and drag it; it snaps to the tiles. The cell it is attached to must be free. The table always stays within the working area.
Calculation basis
Engineers want to be able to check the calculation. That is why what the tool calculates with is openly documented. The detailed version with all formulas is on the page Calculation basis; here are the key points:
Stoffwerte
- Water and steam: IAPWS-IF97, own implementation. In the diagram regions 1, 2 and 4 (triple point to 165 bar(a), up to 800 °C), above that region 3 up to 1000 bar; steam tables and design additionally region 3 (up to 1000 bar). Wet steam homogeneous. Verified against the IAPWS check values.
- Refrigerant: CoolProp 6.6.0 with the Helmholtz reference equations (backend HEOS): R717, R290, R1234ze(E), R1233zd(E), R744, R134a, R718. Mixtures such as R513A are not included.
- Flue gas and air: ideal gas mixture (N₂, O₂, CO₂, H₂O, SO₂, Ar) with temperature-dependent heat capacity; complete combustion, calorific value reference 25 °C, without dissociation and condensation (the dew point is reported). Moist air for the cooling tower.
Equations of the main components
- Pipe: Δp = (λ · L/d + Σζ) · ρw²/2 + ρ · g · Δz with λ from Reynolds number and roughness (Colebrook), run length L (default 10 m); heat loss Q = k′ · L · (T − Tu).
- Pump: h₂ = h₁ + v·Δp/η; electrical power Pel = ṁ·(h₂ − h₁)/ηMotor.
- Turbine: h₂ = h₁ − ηs·(h₁ − h2s) per section; part load according to the steam cone law (Stodola).
- Heat exchanger: Q = ε · Qmax, Qmax in counterflow, with phase change via a pinch search along the temperature profile; in addition logarithmic mean temperature difference and UA as parameters.
- Boiler: Fuel heat = heat to the water / ηK; ηK entered or ηK = 1 − flue gas loss − other losses from the combustion calculation.
- Orifice plate: ISO 5167-2 with C = 0.61 and expansibility factor, permanent pressure loss.
- Heating heat pump: COP = quality grade · TK/(TK − TV), quality grade from the data sheet COP. Large heat pump: Refrigeration cycle with CoolProp, isentropic compressor efficiency per type, part-load curves as guide values.
- Static heads: geodetic pressure ρ · g · h with the actual density.
Heat pump evaluation
- Load ratio = heating output ÷ rated heating output. Seasonal performance factor = Σ(heat × hours) ÷ Σ(electricity × hours) over the load cases. Full-load hours = annual heat ÷ rated heating output.
- Levelised cost of heat Heat pump = investment · (1 − subsidy rate) · (annuity factor + maintenance) ÷ full-load hours + electricity price ÷ SPF; gas boiler = (gas price · factor gross/net calorific value + CO₂ price · emission factor) ÷ boiler efficiency. Gas is billed per kWh of gross calorific value, efficiency and emission factor refer to the net calorific value – hence the factor (natural gas 1.11; 1 if the price already applies per kWh of net calorific value).
What is not modelled
Dynamics, individual resistances and Reynolds-dependent friction, heat transfer via geometry, transport properties, refrigerant mixtures and manufacturer curves. Guide values (efficiencies, part load) are marked and can be replaced by your own values.
Frequently asked questions
“Nothing in this cycle fixes the circulating flow” – what to do?
In a circuit with a feedwater tank, everything the pump delivers flows back into the tank. Switch on “Specify live steam flow” at the steam generator and make up losses with a water feed “Make-up water automatic”.
The pump is not sufficient (“Pressure rise not sufficient”).
The losses in the circuit are greater than the pressure rise. Increase the pressure rise, have it calculated with ƒx or check the losses (run lengths, pressure losses of the apparatus, nominal sizes too small).
A pipe has a dashed outline.
The velocity is above the permissible velocity (yellow) or above twice that (red). Choose a larger nominal size, adjust the table on the Specifications tab → perm. velocity, or reduce the mass flow.
Cavitation or boiling warning at the pump.
The water on the suction side is close to boiling. Increase the inlet pressure, check the static head at the vessel or condenser, or subcool the water more beforehand (drain cooling).
Why are the pressures absolute?
Steam tables and properties calculate with absolute pressure. Gauge pressure = absolute pressure − 1.013 bar. Flue gas and air pressures are still given as gauge pressure in mbar because they are close to ambient pressure.
Where are my diagrams?
In your browser's storage on your device. To back them up or pass them on, save them as a file (.wsb.json or .toome.json).
I have found an error or have a request.
Enter it on the feedback page – ideally with the current diagram.