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.
For Safety Shutdown, read the current
kernel and prescribed-travel guide
and campaign acceptance first.
The single-line kernel integrates characteristic fluxes over physical cells.
Use cell mean pressure and accepted-substep inlet/outlet exchanges for its linear
acoustic volume ledger; nodal pressure/flow are face traces, not inventory means.
Report first-order space/time refinement and boundary endpoint-hold quadrature.
A PASS acoustic balance does not qualify full EOS conservation, pump coastdown,
disc slam, network coupling, cavitation, support loads or integrated safety logic.
Reuse the canonical coordinator and existing ESD APIs for future integration.
Forward acoustic pump coastdown
AcousticPumpBoundary optionally couples one declared reference-speed curve
through existing PumpChart affinity scaling and a prescribed actual-speed
table to upstream PUMP. Supply explicit positive speed limits, original
forward-flow data, head units and suction pressure with matching velocity and
elevation bases. Configure before run() and reinitialize after replacing the
boundary. Speed and valve knots share the existing conservative pipe clock.
An explicit empty eventSchedule selects a pump-only study.
Use the complete API/JSON contract and executed evidence.
Read pumpHydraulicWork_J as accepted interval hydraulic work, not shaft/EOS
energy. Study errors retain last accepted time/cells/work/internal outlet history;
never report an unsupported transition as a completed trip. Do not extrapolate
clamped forward curves or invent stopped/reverse/check-valve continuations.
Actual-speed data must have declared provenance; the public example is synthetic.
Full trips, shaft inertia, disc/slam, NPSH/cavitation and integrated Safety Shutdown
remain NOT_EVALUATED. neqsim-dynamic-simulation owns the canonical coordinator
and ESD handoff; this boundary adds no independent scheduler or solver.
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": "Safety Shutdown 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.
Ideal translating acoustic check valve
AcousticLiftCheckValve is experimental: equal pressure/swept area, signed
orifice flow, declared translating mass/spring/preload/damping and perfectly
inelastic numerical contact. Supply independent initial force/flow equilibrium;
no automatic parameter calibration. WaterHammerStudy accepts liftCheckValve
SI fields and an empty eventSchedule. Keep accepted interval jet plus swept
flow; omitting swept flow violates pressure work. Separate physical damping,
BE numerical loss and impact loss. Refine contact and pressure together; do not
claim continuous grazing-event accuracy or vendor slam from numerical contact.
Read the API, equations, public executed case and limits.
Use defensive getLiftHistory() and aligned named study diagnostics. Rejection
retains last accepted local cells/disc/clock/work; serialization is local replay,
not global rollback. Forward-pump domains remain unchanged. Full trips, swing
discs, flow-force/added-mass, rebound, cavitation, structural loads and integrated
Safety Shutdown remain NOT_EVALUATED. Hand off shared stepping/logic to
neqsim-dynamic-simulation; add no parallel scheduler or generic solver.
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."4last_verified: "2026-10-29"5metadata:6 source: https://skillmd.com/skills/equinor/neqsim-water-hammer7---89# Water Hammer and Liquid Hammer Screening1011Use this skill when a task involves hydraulic surge from fast valve movement,12pump trip, check-valve slam, ESD closure, or other rapid liquid-flow changes.13The core model is `WaterHammerPipe`; the workflow facade is14`WaterHammerStudy`; MCP clients use `runWaterHammer`.1516## When To Use1718- Fast ESD or isolation-valve closure in water, condensate, oil, MEG, glycol, or19 other liquid-rich lines.20- Pump trip, pump start, check-valve slam, or sudden flow setpoint changes.21- STID/P&ID/E3D/stress-isometric route screening before a detailed surge study.22- Tagreader event-window replay where measured pressure, flow, temperature, and23 valve position should override design-basis values.24- Ranking which lines need detailed vendor or specialist surge analysis.2526Do not use this as final pipe-stress approval. Treat it as a fast screening and27evidence-pack workflow.2829For **Safety Shutdown**, read the current30[kernel and prescribed-travel guide](../../../docs/wiki/water_hammer_implementation.md)31and [campaign acceptance](https://github.com/equinor/neqsim/issues/4707) first.32The single-line kernel integrates characteristic fluxes over physical cells.33Use cell mean pressure and accepted-substep inlet/outlet exchanges for its linear34acoustic volume ledger; nodal pressure/flow are face traces, not inventory means.35Report first-order space/time refinement and boundary endpoint-hold quadrature.36A PASS acoustic balance does not qualify full EOS conservation, pump coastdown,37disc slam, network coupling, cavitation, support loads or integrated safety logic.38Reuse the canonical coordinator and existing ESD APIs for future integration.3940## Forward acoustic pump coastdown4142`AcousticPumpBoundary` optionally couples one declared reference-speed curve43through existing `PumpChart` affinity scaling and a prescribed actual-speed44table to upstream `PUMP`. Supply explicit positive speed limits, original45forward-flow data, head units and suction pressure with matching velocity and46elevation bases. Configure before `run()` and reinitialize after replacing the47boundary. Speed and valve knots share the existing conservative pipe clock.48An explicit empty `eventSchedule` selects a pump-only study.4950Use the [complete API/JSON contract and executed evidence](../../../docs/wiki/water_hammer_implementation.md#safety-shutdown-forward-pump-coastdown).51Read `pumpHydraulicWork_J` as accepted interval hydraulic work, not shaft/EOS52energy. Study errors retain last accepted time/cells/work/internal outlet history;53never report an unsupported transition as a completed trip. Do not extrapolate54clamped forward curves or invent stopped/reverse/check-valve continuations.55Actual-speed data must have declared provenance; the public example is synthetic.56Full trips, shaft inertia, disc/slam, NPSH/cavitation and integrated Safety Shutdown57remain NOT_EVALUATED. `neqsim-dynamic-simulation` owns the canonical coordinator58and ESD handoff; this boundary adds no independent scheduler or solver.5960## Workflow61621. Extract line geometry from STID/P&ID/E3D/stress isometrics: length, internal63 diameter, wall thickness, roughness/piping class, elevation change, fittings,64 valves, and source references.652. Extract or infer event data: initiating valve, start time, closure/opening66 duration, start/end opening, pump trip status, and relevant controller action.673. Pull plant data with tagreader when available: inlet pressure, temperature,68 flow rate, valve opening, pump speed/status, and downstream pressure.694. Run `WaterHammerStudy` or MCP `runWaterHammer` with the equivalent route,70 field-data overrides, and event schedule.715. Report wave speed, Courant time step, wave round-trip time, Joukowsky surge,72 max/min pressure envelope, design-pressure margin, assumptions, and evidence.736. Recommend detailed surge analysis when peak pressure approaches design74 pressure, the route has varying diameters/branches, vapor cavities are likely,75 or support loads/stress checks are required.7677## MCP Input Pattern7879```json80{81 "studyName": "Safety Shutdown valve closure screening",82 "model": "SRK",83 "temperature_C": 20.0,84 "pressure_bara": 45.0,85 "components": {"water": 1.0},86 "flowRate": {"value": 120000.0, "unit": "kg/hr"},87 "designPressure_bara": 95.0,88 "pipe": {89 "length_m": 1200.0,90 "diameter_m": 0.2032,91 "wallThickness_m": 0.0127,92 "roughness_m": 4.6e-5,93 "elevation_m": 8.0,94 "numberOfNodes": 8095 },96 "fieldData": {97 "inletPressure_bara": 46.0,98 "inletTemperature_C": 19.0,99 "flowRate_kg_hr": 118000.0,100 "valveOpening": 1.0101 },102 "eventSchedule": [103 {104 "type": "VALVE_CLOSURE",105 "startTime_s": 0.10,106 "duration_s": 0.15,107 "startOpening": 1.0,108 "endOpening": 0.0109 }110 ],111 "simulationTime_s": 4.0,112 "sourceReferences": [113 "generic STID line-list row",114 "generic tagreader event window"115 ]116}117```118119For route extraction, use `stidRoute.segments` with segment lengths, diameters,120wall thickness, roughness, elevation change, and `minorLosses` K values. The121study facade aggregates a serial route into an equivalent single line for fast122screening and warns when diameters vary.123124## Result Interpretation125126- `maxPressure_bara` and `minPressure_bara`: pressure envelope extrema during127 the transient.128- `pressureSurge_bar`: calculated surge above the initial outlet pressure.129- `joukowskySurgeEstimate_bar`: independent screening estimate using rho times130 wave speed times velocity change.131- `waveRoundTripTime_s`: acoustic round-trip time; closure faster than this is132 a fast-closure case.133- `maxStableTimeStep_s`: Courant time-step limit used to control numerical134 stability.135- `designPressureExceeded`: true when the supplied design pressure is exceeded.136137## Standards And Review Triggers138139Use applicable pipeline and piping standards as context: DNV-ST-F101,140NORSOK L-001, ASME B31.3, ASME B31.4, ASME B31.8, API 14E, and company piping141classes. Escalate to detailed study if any of these apply:142143- Peak pressure exceeds design pressure or MAOP.144- Surge margin is small after including instrument uncertainty and model145 uncertainty.146- The route has branches, non-return valves, pump curves, relief devices, or147 vapor-cavity risk.148- Pipe stress, supports, nozzle loads, or valve actuator closure curves matter.149- The line contains multiphase fluid; simplify only with explicit assumptions.150151## Related Skills152153- `neqsim-pid-process-operations` for valve actions and operational scenarios.154- `neqsim-stid-retriever` and `neqsim-technical-document-reading` for route and155 evidence extraction.156- `neqsim-plant-data` for tagreader snapshots and event windows.157- `neqsim-process-safety` for risk framing and escalation into safety studies.158- `neqsim-flow-assurance` for broader pipeline operating-envelope work.159160## Ideal translating acoustic check valve161162`AcousticLiftCheckValve` is experimental: equal pressure/swept area, signed163orifice flow, declared translating mass/spring/preload/damping and perfectly164inelastic numerical contact. Supply independent initial force/flow equilibrium;165no automatic parameter calibration. `WaterHammerStudy` accepts `liftCheckValve`166SI fields and an empty eventSchedule. Keep accepted interval jet plus swept167flow; omitting swept flow violates pressure work. Separate physical damping,168BE numerical loss and impact loss. Refine contact and pressure together; do not169claim continuous grazing-event accuracy or vendor slam from numerical contact.170171Read the [API, equations, public executed case and limits](../../../docs/wiki/water_hammer_implementation.md#safety-shutdown-ideal-translating-check-valve).172Use defensive `getLiftHistory()` and aligned named study diagnostics. Rejection173retains last accepted local cells/disc/clock/work; serialization is local replay,174not global rollback. Forward-pump domains remain unchanged. Full trips, swing175discs, flow-force/added-mass, rebound, cavitation, structural loads and integrated176Safety Shutdown remain NOT_EVALUATED. Hand off shared stepping/logic to177`neqsim-dynamic-simulation`; add no parallel scheduler or generic solver.