Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_water_hammer_joukowsky_surge

Calculate water hammer pressure spikes and acoustic wave speed from rapid valve closure using the Joukowsky equation, plus critical closure time and surge severity.

Instructions

Water Hammer Joukowsky Shockwave Pressure Surge & Wave Speed Calculator. Calculate rapid valve closure acoustic pressure spike (Joukowsky equation ΔP = ρ·c·Δv) and acoustic wave speed in elastic pipe walls. Discipline: ENGINEERING. Governing mathematical model / formula: Pressure Surge ΔP = ρ · c · Δv | Acoustic Wave Speed c = √[(K / ρ) / (1 + (K / E) · (D / t))].

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of joukowsky_pressure_spike_psi (Peak Water Hammer Pressure Surge), acoustic_wave_speed_fps (Acoustic Pressure Wave Speed (c)), critical_closure_time_sec (Critical Sudden Closure Time (2L/c)), surge_severity_grade (Pipe Burst Threat Assessment) using steady_flow_velocity_fps (Initial Steady Water Velocity (v in ft/s) in ft/sec), pipe_material_modulus (Pipe Material (1 = Carbon Steel, 2 = Ductile Iron, 3 = PVC Plastic)), valve_closure_time_sec (Valve Closure Duration (Seconds) in seconds). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.

  • WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.

DISAMBIGUATION & BOUNDARIES:

  • Use this dedicated specialist tool for 'Water Hammer Joukowsky Shockwave Pressure Surge & Wave Speed Calculator' rather than generic dispatchers like omni_universal_query.

  • For multi-calculation chained jobs, use 'omni_batch_calculate'.

  • To inspect schema fields, see 'omni_describe_solver'.

BEHAVIOR & SAFETY:

  • Pure deterministic computation with machine floating-point precision.

  • Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.

  • Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.

RETURNS:

  • Structured JSON object containing:

    • status (string): "success" on valid execution or "error" if validation fails

    • calculator (string): "water-hammer-joukowsky-surge"

    • category (string): "engineering"

    • name (string): "Water Hammer Joukowsky Shockwave Pressure Surge & Wave Speed Calculator"

    • formula (string): Governing mathematical formula string

    • inputs (object): Echoed input parameter dictionary with applied defaults

    • metrics (object): Dictionary of computed outputs:

      • metrics.joukowsky_pressure_spike_psi (Peak Water Hammer Pressure Surge): Formatted display string (e.g. '411.0 PSI Spike')

      • metrics.acoustic_wave_speed_fps (Acoustic Pressure Wave Speed (c)): Formatted display string (e.g. '3,820 ft / second')

      • metrics.critical_closure_time_sec (Critical Sudden Closure Time (2L/c)): Formatted display string (e.g. '0.26 Seconds (1000 ft pipe)')

      • metrics.surge_severity_grade (Pipe Burst Threat Assessment): Formatted display string (e.g. 'Severe Transient (Water Hammer Arrestor Required)')

    • execution_time_ms (number): Latency in milliseconds.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "omni_water_hammer_joukowsky_surge"
  }
}

Input Schema

NameRequiredDescriptionDefault
pipe_material_modulusNoPipe Material (1 = Carbon Steel, 2 = Ductile Iron, 3 = PVC Plastic). 1: Steel (c ≈ 3,800 fps), 2: Ductile Iron (c ≈ 3,500 fps), 3: PVC (c ≈ 1,200 fps). Default: 1. Min: 1. Max: 3.
valve_closure_time_secNoValve Closure Duration (Seconds) (seconds). Solenoid valve ~0.1-0.3s; quarter-turn ball valve ~0.5-1.0s. Default: 0.25. Min: 0.05. Max: 10.
steady_flow_velocity_fpsNoInitial Steady Water Velocity (v in ft/s) (ft/sec). Normal operating velocity prior to valve shutoff. Default: 8. Min: 1. Max: 25.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools