neqsim-heat-integration
Skill167 starsChanged 7 months agoApache-2.0View on GitHub
Pinch analysis and heat integration — composite curves, ΔTmin selection, MER targeting, grand composite, HEN synthesis, retrofit. USE WHEN: a task involves reducing utility cost, evaluating heat recovery, sizing utility duties, or comparing process alternatives on energy efficiency. Anchors on neqsim.process.equipment.heatexchanger.heatintegration.PinchAnalysis.
In this repository140 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- analyze-convergenceSkill
- analyze-gibbs-convergenceSkill
- book-creationSkill
- design-flash-benchmarkSkill
- design-reactor-benchmarkSkill
- figure-discussionSkill
- generate-publication-figuresSkill
- journal-formattingSkill
- neqsim-acid-gas-treatingSkill
- neqsim-advanced-control-mpc-and-virtual-sensingSkill
- neqsim-agent-handoffSkill
- neqsim-agentic-process-optimizationSkill
- neqsim-api-patternsSkill
- neqsim-autonomous-investigationSkill
- neqsim-capability-mapSkill
- neqsim-capacity-and-utilization-analysisSkill
- neqsim-capacity-increase-screeningSkill
- neqsim-ccs-hydrogenSkill
- neqsim-code-healthSkill
- neqsim-code-hygieneSkill
- neqsim-code-reviewSkill
- neqsim-column-internals-and-rate-basedSkill
- neqsim-compressor-antisurge-recycleSkill
- neqsim-consequence-analysisSkill
- neqsim-continuous-task-improvementSkill
- neqsim-controllability-operabilitySkill
- neqsim-cooling-waterSkill
- neqsim-cpa-water-boundariesSkill
- neqsim-depressurization-mdmtSkill
- neqsim-distillation-designSkill
- neqsim-document-intelligence-extractionSkill
- neqsim-dynamic-equipment-implementationSkill
- neqsim-dynamic-simulationSkill
- neqsim-electrolyte-systemsSkill
- neqsim-emulsion-separationSkill
- neqsim-energy-systems-and-electrificationSkill
- neqsim-engineering-design-packageSkill
- neqsim-eos-regressionSkill
- neqsim-equipment-cost-estimationSkill
- neqsim-exploration-strategy-selectionSkill
- neqsim-field-developmentSkill
- neqsim-field-economicsSkill
- neqsim-firewater-deluge-designSkill
- neqsim-flow-accelerated-corrosionSkill
- neqsim-flow-assuranceSkill
- neqsim-flow-assurance-study-reportSkill
- neqsim-forward-separator-trainSkill
- neqsim-future-operation-studySkill
- neqsim-hazid-fmea-eta-ftaSkill
- neqsim-hydrogen-productionSkill
- neqsim-input-validationSkill
- neqsim-integrated-production-and-lifecycleSkill
- neqsim-in-writingSkill
- neqsim-java8-rulesSkill
- neqsim-jurisdiction-regulatory-basisSkill
- neqsim-literature-searchSkill
- neqsim-lng-liquefactionSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 42
No external heating below the pinch
- Distinctive: line 43
No external cooling above the pinch
- Distinctive: line 44
No heat transfer across the pinch
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
NeqSim Heat Integration Skill
Linnhoff-method pinch analysis to determine minimum hot/cold utility duties, the pinch temperature, composite & grand-composite curves, and to evaluate heat-exchanger network (HEN) opportunities.
When to Use
- Determining MER (Minimum Energy Requirement) for a flowsheet
- Setting utility duties before equipment sizing
- Retrofit analysis — quantify potential savings vs. existing HEN
- Comparing process alternatives on energy footprint
- Sizing utility headers (steam, cooling water) consistently across a plant
Standard reference: B. Linnhoff & E. Hindmarsh (1983), Chem. Eng. Sci.; operational guidance from Smith — Chemical Process Design and Integration (2nd ed.).
Core Concept
Hot streams (need cooling) ──┐
├── shifted by ΔTmin/2 → temperature intervals → cascade → MER
Cold streams (need heating) ──┘The pinch divides the system in two:
- Above pinch — heat sink (only hot utility allowed)
- Below pinch — heat source (only cold utility allowed)
- Across pinch — every kW transferred costs 1 kW hot + 1 kW cold
Three golden rules — never violate any of them:
- No external heating below the pinch
- No external cooling above the pinch
- No heat transfer across the pinch
Pattern 1 — Streams Defined Manually
import neqsim.process.equipment.heatexchanger.heatintegration.PinchAnalysis;
PinchAnalysis pinch = new PinchAnalysis(10.0); // ΔTmin in °C
// addHotStream(name, supplyT_C, targetT_C, mCp_kW_per_K)
pinch.addHotStream("H1 — reactor effluent", 180.0, 80.0, 30.0);
pinch.addHotStream("H2 — flash gas", 150.0, 50.0, 15.0);
pinch.addColdStream("C1 — feed preheat", 30.0, 140.0, 20.0);
pinch.addColdStream("C2 — reboiler feed", 60.0, 120.0, 25.0);
pinch.run();
double Qh = pinch.getMinimumHeatingUtility(); // kW
double Qc = pinch.getMinimumCoolingUtility(); // kW
double Tpinch = pinch.getPinchTemperatureC();Pattern 2 — Auto-Extract from a ProcessSystem
PinchAnalysis pinch = PinchAnalysis.fromProcessSystem(process, 10.0);
pinch.run();This walks every Heater, Cooler, and HeatExchanger and registers their duties as streams.
Pattern 3 — Choosing ΔTmin
| Service | Typical ΔTmin |
| Gas–gas refinery | 15–25 °C |
| Gas–liquid | 8–15 °C |
| Liquid–liquid | 5–10 °C |
| Cryogenic | 1–3 °C |
| Steam reboiler / cooling water | 8–10 °C |
Trade-off: lower ΔTmin → less utility (good OPEX) but bigger HX area (worse CAPEX). Optimum is found from supertargeting — sweep ΔTmin and plot total-annual-cost.
Pattern 4 — Composite Curves for Visualization
// (after pinch.run())
double[] Th = pinch.getHotCompositeT();
double[] Qh_ = pinch.getHotCompositeQ();
double[] Tc = pinch.getColdCompositeT();
double[] Qc_ = pinch.getColdCompositeQ();
// Plot T vs Q → composite curves; the overlap = recoverable, the tails = utilityPlot the grand composite curve (getGrandCompositeQ/T()) to choose utility levels (HP/MP/LP steam, CW, refrigeration).
Pattern 5 — Retrofit Diagnostics
double existingUtility = sumExistingHotUtilities(process); // user supplies
double saving = existingUtility - pinch.getMinimumHeatingUtility();
double saving_pct = 100.0 * saving / existingUtility;Identify cross-pinch transfer with stream-level diagnostics (each violation costs double).
Common Mistakes
| Mistake | Fix |
| Using mass flow instead of mCp | mCp = ṁ × cp (kW/K); for phase-change, treat as multiple linear segments |
| Single ΔTmin for both gas–gas and liquid–liquid | Use stream-individual film coefficients or split into zones |
| Counting reboiler/condenser duties as process streams | They are utilities — exclude or model as utility curves above pinch |
| Ignoring soft constraints (forbidden matches) | Note them in the report; pinch gives the target, HEN respects constraints |
| Cross-pinch transfer in MER design | Re-route hot stream to above-pinch cold stream; never quench across pinch |
| Reporting only utility numbers without ΔTmin | Always state ΔTmin assumption; results scale strongly with it |
Validation Checklist
- ΔTmin chosen and justified (table above + sensitivity sweep)
- Three golden rules satisfied in any proposed HEN
- Composite curves plotted; pinch temperature reported
- Hot + Cold utility duties cross-checked: ΣQ_hot − ΣQ_cold = enthalpy balance
- Retrofit savings quantified vs. base case
- Utility level selection justified by grand composite curve
- Result saved to
results.jsonunderheat_integrationwithmin_hot_utility_kW,min_cold_utility_kW,pinch_T_C,delta_T_min_C
Related Skills
neqsim-power-generation— utility-side: HRSG, steam levels; also the "added exhaust heat recovery for a heating-medium circuit" retrofit pattern (hot-end versus stack-end coil: the temperature driving force, not the heat quantity, sets area and cost)neqsim-equipment-cost-estimation— HX area→cost for supertargetingneqsim-platform-modeling— apply pinch across multiple process areas
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

