Water Hammer and Liquid Hammer Screening
Use this skill when a task involves hydraulic surge from fast valve movement,
pump trip, check-valve slam, ESD closure, or other rapid liquid-flow changes.
The core model is WaterHammerPipe; the workflow facade is
WaterHammerStudy; MCP clients use runWaterHammer.
When To Use
- Fast ESD or isolation-valve closure in water, condensate, oil, MEG, glycol, or
other liquid-rich lines.
- Pump trip, pump start, check-valve slam, or sudden flow setpoint changes.
- STID/P&ID/E3D/stress-isometric route screening before a detailed surge study.
- Tagreader event-window replay where measured pressure, flow, temperature, and
valve position should override design-basis values.
- Ranking which lines need detailed vendor or specialist surge analysis.
Do not use this as final pipe-stress approval. Treat it as a fast screening and
evidence-pack workflow.
Workflow
- Extract line geometry from STID/P&ID/E3D/stress isometrics: length, internal
diameter, wall thickness, roughness/piping class, elevation change, fittings,
valves, and source references.
- Extract or infer event data: initiating valve, start time, closure/opening
duration, start/end opening, pump trip status, and relevant controller action.
- Pull plant data with tagreader when available: inlet pressure, temperature,
flow rate, valve opening, pump speed/status, and downstream pressure.
- Run
WaterHammerStudy or MCP runWaterHammer with the equivalent route,
field-data overrides, and event schedule.
- Report wave speed, Courant time step, wave round-trip time, Joukowsky surge,
max/min pressure envelope, design-pressure margin, assumptions, and evidence.
- Recommend detailed surge analysis when peak pressure approaches design
pressure, the route has varying diameters/branches, vapor cavities are likely,
or support loads/stress checks are required.
MCP Input Pattern
{
"studyName": "ESD valve closure screening",
"model": "SRK",
"temperature_C": 20.0,
"pressure_bara": 45.0,
"components": {"water": 1.0},
"flowRate": {"value": 120000.0, "unit": "kg/hr"},
"designPressure_bara": 95.0,
"pipe": {
"length_m": 1200.0,
"diameter_m": 0.2032,
"wallThickness_m": 0.0127,
"roughness_m": 4.6e-5,
"elevation_m": 8.0,
"numberOfNodes": 80
},
"fieldData": {
"inletPressure_bara": 46.0,
"inletTemperature_C": 19.0,
"flowRate_kg_hr": 118000.0,
"valveOpening": 1.0
},
"eventSchedule": [
{
"type": "VALVE_CLOSURE",
"startTime_s": 0.10,
"duration_s": 0.15,
"startOpening": 1.0,
"endOpening": 0.0
}
],
"simulationTime_s": 4.0,
"sourceReferences": [
"generic STID line-list row",
"generic tagreader event window"
]
}
For route extraction, use stidRoute.segments with segment lengths, diameters,
wall thickness, roughness, elevation change, and minorLosses K values. The
study facade aggregates a serial route into an equivalent single line for fast
screening and warns when diameters vary.
Result Interpretation
maxPressure_bara and minPressure_bara: pressure envelope extrema during
the transient.
pressureSurge_bar: calculated surge above the initial outlet pressure.
joukowskySurgeEstimate_bar: independent screening estimate using rho times
wave speed times velocity change.
waveRoundTripTime_s: acoustic round-trip time; closure faster than this is
a fast-closure case.
maxStableTimeStep_s: Courant time-step limit used to control numerical
stability.
designPressureExceeded: true when the supplied design pressure is exceeded.
Standards And Review Triggers
Use applicable pipeline and piping standards as context: DNV-ST-F101,
NORSOK L-001, ASME B31.3, ASME B31.4, ASME B31.8, API 14E, and company piping
classes. Escalate to detailed study if any of these apply:
- Peak pressure exceeds design pressure or MAOP.
- Surge margin is small after including instrument uncertainty and model
uncertainty.
- The route has branches, non-return valves, pump curves, relief devices, or
vapor-cavity risk.
- Pipe stress, supports, nozzle loads, or valve actuator closure curves matter.
- The line contains multiphase fluid; simplify only with explicit assumptions.
Related Skills
neqsim-pid-process-operations for valve actions and operational scenarios.
neqsim-stid-retriever and neqsim-technical-document-reading for route and
evidence extraction.
neqsim-plant-data for tagreader snapshots and event windows.
neqsim-process-safety for risk framing and escalation into safety studies.
neqsim-flow-assurance for broader pipeline operating-envelope work.
1---2name: neqsim-water-hammer3description: Water hammer and liquid hammer screening workflow for NeqSim. USE WHEN: evaluating fast valve closures, pump trips, check-valve slam, hydraulic surge, STID/P&ID route extraction, tagreader event windows, or MCP runWaterHammer studies. Covers WaterHammerPipe, WaterHammerStudy, STID route geometry, tagreader field-data overrides, pressure envelopes, Joukowsky checks, and screening limitations.4---56# Water Hammer and Liquid Hammer Screening78Use this skill when a task involves hydraulic surge from fast valve movement,9pump trip, check-valve slam, ESD closure, or other rapid liquid-flow changes.10The core model is `WaterHammerPipe`; the workflow facade is11`WaterHammerStudy`; MCP clients use `runWaterHammer`.1213## When To Use1415- Fast ESD or isolation-valve closure in water, condensate, oil, MEG, glycol, or16 other liquid-rich lines.17- Pump trip, pump start, check-valve slam, or sudden flow setpoint changes.18- STID/P&ID/E3D/stress-isometric route screening before a detailed surge study.19- Tagreader event-window replay where measured pressure, flow, temperature, and20 valve position should override design-basis values.21- Ranking which lines need detailed vendor or specialist surge analysis.2223Do not use this as final pipe-stress approval. Treat it as a fast screening and24evidence-pack workflow.2526## Workflow27281. Extract line geometry from STID/P&ID/E3D/stress isometrics: length, internal29 diameter, wall thickness, roughness/piping class, elevation change, fittings,30 valves, and source references.312. Extract or infer event data: initiating valve, start time, closure/opening32 duration, start/end opening, pump trip status, and relevant controller action.333. Pull plant data with tagreader when available: inlet pressure, temperature,34 flow rate, valve opening, pump speed/status, and downstream pressure.354. Run `WaterHammerStudy` or MCP `runWaterHammer` with the equivalent route,36 field-data overrides, and event schedule.375. Report wave speed, Courant time step, wave round-trip time, Joukowsky surge,38 max/min pressure envelope, design-pressure margin, assumptions, and evidence.396. Recommend detailed surge analysis when peak pressure approaches design40 pressure, the route has varying diameters/branches, vapor cavities are likely,41 or support loads/stress checks are required.4243## MCP Input Pattern4445```json46{47 "studyName": "ESD valve closure screening",48 "model": "SRK",49 "temperature_C": 20.0,50 "pressure_bara": 45.0,51 "components": {"water": 1.0},52 "flowRate": {"value": 120000.0, "unit": "kg/hr"},53 "designPressure_bara": 95.0,54 "pipe": {55 "length_m": 1200.0,56 "diameter_m": 0.2032,57 "wallThickness_m": 0.0127,58 "roughness_m": 4.6e-5,59 "elevation_m": 8.0,60 "numberOfNodes": 8061 },62 "fieldData": {63 "inletPressure_bara": 46.0,64 "inletTemperature_C": 19.0,65 "flowRate_kg_hr": 118000.0,66 "valveOpening": 1.067 },68 "eventSchedule": [69 {70 "type": "VALVE_CLOSURE",71 "startTime_s": 0.10,72 "duration_s": 0.15,73 "startOpening": 1.0,74 "endOpening": 0.075 }76 ],77 "simulationTime_s": 4.0,78 "sourceReferences": [79 "generic STID line-list row",80 "generic tagreader event window"81 ]82}83```8485For route extraction, use `stidRoute.segments` with segment lengths, diameters,86wall thickness, roughness, elevation change, and `minorLosses` K values. The87study facade aggregates a serial route into an equivalent single line for fast88screening and warns when diameters vary.8990## Result Interpretation9192- `maxPressure_bara` and `minPressure_bara`: pressure envelope extrema during93 the transient.94- `pressureSurge_bar`: calculated surge above the initial outlet pressure.95- `joukowskySurgeEstimate_bar`: independent screening estimate using rho times96 wave speed times velocity change.97- `waveRoundTripTime_s`: acoustic round-trip time; closure faster than this is98 a fast-closure case.99- `maxStableTimeStep_s`: Courant time-step limit used to control numerical100 stability.101- `designPressureExceeded`: true when the supplied design pressure is exceeded.102103## Standards And Review Triggers104105Use applicable pipeline and piping standards as context: DNV-ST-F101,106NORSOK L-001, ASME B31.3, ASME B31.4, ASME B31.8, API 14E, and company piping107classes. Escalate to detailed study if any of these apply:108109- Peak pressure exceeds design pressure or MAOP.110- Surge margin is small after including instrument uncertainty and model111 uncertainty.112- The route has branches, non-return valves, pump curves, relief devices, or113 vapor-cavity risk.114- Pipe stress, supports, nozzle loads, or valve actuator closure curves matter.115- The line contains multiphase fluid; simplify only with explicit assumptions.116117## Related Skills118119- `neqsim-pid-process-operations` for valve actions and operational scenarios.120- `neqsim-stid-retriever` and `neqsim-technical-document-reading` for route and121 evidence extraction.122- `neqsim-plant-data` for tagreader snapshots and event windows.123- `neqsim-process-safety` for risk framing and escalation into safety studies.124- `neqsim-flow-assurance` for broader pipeline operating-envelope work.