convective-heat-transfer-correlations
Skill7 starsChanged 6 months agoApache-2.0View on GitHub
Single-phase convective heat transfer coefficient correlations (Dittus-Boelter, Gnielinski, Sieder-Tate, Churchill-Chu natural convection, pool boiling via Rohsenow). Use when computing h for tube-side or shell-side flow, natural convection from a surface, or screening pool-boiling heat transfer. Don't use for shell-and-tube full sizing (use heat-exchanger-sizing), or for low-quality two-phase pressure drop (use two-phase-flow).
In this repository31 other files it gives its agents.
- absorption-stripping-designSkill
- bayesian-hierarchical-process-modelsSkill
- caustic-merox-extractionSkill
- censored-regressionSkill
- compositional-data-analysisSkill
- control-valve-sizing-isa75Skill
- design-of-experimentsSkill
- dimensionless-numbersSkill
- distillation-shortcut-designSkill
- distributed-lag-modelsSkill
- engg-skills-commonSkill
- engineering-skill-creatorSkill
- engineering-statisticsSkill
- equation-of-state-selectionSkill
- heat-exchanger-sizingSkill
- literature-search-engineeringSkill
- material-energy-balancesSkill
- pipe-flow-pressure-dropSkill
- process-causal-inference-dagsSkill
- process-units-conversionSkill
- reactor-sizing-and-kineticsSkill
- relief-valve-sizing-api520Skill
- separator-vessel-sizingSkill
- sour-gas-amine-treatingSkill
- statistical-process-controlSkill
- steam-tables-iapwsSkill
- thermo-process-propertiesSkill
- time-series-process-data-analysisSkill
- two-phase-flowSkill
- uvSkill
- vle-flash-calculationsSkill
The file
We split this skill into the rules it gives an agent
3 rules. About 0 are common, 1 is distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 96
If ht is not installed, the single-phase correlations are pure Python and work without it.
- Very specific: line 104
Run the listed script with representative inputs and an --output file when a deterministic calculation is available.
- Distinctive: line 106
Check result magnitudes against the stated assumptions, references, and a hand calculation or known operating range before reporting them.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 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
Convective Heat Transfer Correlations
Overview
Pure-Python implementations of the classical pipe/duct flow correlations
plus a thin wrapper around ht.boiling_nucleic.Rohsenow:
- Dittus-Boelter: simplest turbulent pipe correlation, broad use.
- Gnielinski: turbulent / transitional pipe, wider Pr range, more accurate than Dittus-Boelter for moderate-Pr fluids.
- Sieder-Tate: turbulent pipe with viscosity correction (good for oils, high-viscosity service).
- Laminar pipe (constant Tw or constant q).
- Churchill-Chu: natural convection from a vertical plate (laminar + turbulent unified).
- Rohsenow pool boiling: screening estimate via
ht.
Prerequisites
uvavailable.- On first use, the script writes
LICENSE_NOTIFICATION.txt.
When to Use
- Estimating
hfor one side of a heat exchanger before passing toheat-exchanger-sizing. - Sizing a steam tracing or insulation problem with natural convection.
- Screening pool boiling heat transfer for a kettle reboiler.
Don't use for
- Full shell-and-tube exchanger design — use
heat-exchanger-sizing. - Plate exchangers — vendor-specific correlations apply.
- Falling-film, agitated vessel, or specialty geometries — those have their own correlations and are not in this skill.
Utility Scripts
uv run scripts/h.py dittus-boelter --Re 50000 --Pr 4.5 --k 0.6 --Dh 0.025 --output /tmp/db.jsonuv run scripts/h.py gnielinski --Re 50000 --Pr 4.5 --k 0.6 --Dh 0.025 --output /tmp/gn.jsonuv run scripts/h.py sieder-tate --Re 50000 --Pr 4.5 --k 0.6 --Dh 0.025 --mu-bulk 0.001 --mu-wall 0.0007 --output /tmp/st.jsonuv run scripts/h.py laminar --regime constant-T --k 0.6 --Dh 0.025 --output /tmp/lam.jsonuv run scripts/h.py natural --Ra 1e9 --Pr 0.7 --k 0.026 --L 1.0 --output /tmp/nc.jsonuv run scripts/h.py boiling --T-sat 373.15 --T-wall 383.15 --P 101325 --k-l 0.68 --rho-l 958 --rho-g 0.6 --sigma 0.059 --cpl 4217 --dHvap 2257000 --mu-l 0.00028 --output /tmp/boil.json
Procedure
- Decide the flow regime: Re, Pr, geometry, heated/cooled.
- Pick the matching correlation:
- Pipe, turbulent (Re > 10000), simple fluid: Dittus-Boelter.
- Pipe, transitional or wide Pr (oils, gases): Gnielinski.
- Pipe, large viscosity gradient at the wall: Sieder-Tate.
- Pipe, laminar (Re < 2300): laminar formulas with the proper BC.
- Surface, natural convection: Churchill-Chu (geometry-dependent).
- Pool boiling: Rohsenow as screening; site-specific surface factors dominate.
- Compute
h = Nu * k / Dh. - Cross-check with a second correlation; flag the spread.
Pitfalls
- Using Dittus-Boelter for Re = 5000. Outside its validity range.
- Using Dittus-Boelter for Pr = 200. Outside its validity range.
- Forgetting that Pr changes with temperature; use a properly averaged film temperature.
- Treating the "heating" exponent (0.4) as universal; use 0.3 for cooling.
- Using a single
hfor the entire tube length when entrance effects are significant (short tubes, low Re); Nu varies along the entrance length. - Ignoring the viscosity correction
(mu_bulk / mu_wall)^0.14for oils. - Using Rohsenow with the wrong
Csfsurface factor (it varies by 2x for real surfaces); thehtwrapper uses the canonical Csf for water/copper.
Fallback Strategies
- If
htis not installed, the single-phase correlations are pure Python and work without it. - For specialty boiling (forced convective, flow film boiling), this skill has only the screening Rohsenow form; surface a request to the user for a different correlation.
Verification
- Run the listed script with representative inputs and an
--outputfile when a deterministic calculation is available. - Confirm the JSON result contains
ok: true, expected units, and no unhandled warnings. - Check result magnitudes against the stated assumptions, references, and a hand calculation or known operating range before reporting them.
References
references/correlation_summary.md— equation forms and ranges.- Incropera & DeWitt, Fundamentals of Heat and Mass Transfer.
- Kakac, Liu, Heat Exchangers Selection, Rating, and Thermal Design.
htdocumentation: https://ht.readthedocs.io/
Anti-Patterns
- Picking a correlation by name rather than by validity range.
- Reporting
hwithout stating the correlation used. - Computing tube-side
honly and ignoring the shell-side (it usually dominates).
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.

