Control Valve Cv Screening
Use this skill for public, educational control-valve sizing screening. It estimates the required flow coefficient (Kv and Cv) and flags choked flow for liquid and gas service using the open IEC 60534-2-1 / ISA-75.01 equations so an agent can scope a valve and decide whether to invoke validated NeqSim valve calculations.
When to Use
- When a user asks roughly what Cv a control valve needs for a duty.
- When an agent needs a quick choked-flow (flashing or critical) flag.
- When examples must run without confidential valve data, vendor curves, or company specs.
Inputs
Common:
service:"liquid"or"gas".inlet_pressure: valve inlet pressureP1in bar absolute.pressure_drop: valve pressure dropdPin bar.rated_cv: optional rated valve Cv for the margin check.
Liquid service:
flow_rate: volumetric flow in m3/h.specific_gravity: liquid specific gravity (water = 1).vapor_pressure: fluid vapor pressure in bar absolute, default 0.critical_pressure: fluid critical pressure in bar absolute (forFF), optional.fl: liquid pressure-recovery factorFL, default 0.9.
Gas service:
mass_flow: gas mass flow in kg/h.inlet_density: inlet gas density in kg/m3.specific_heat_ratio: ratio of specific heatsk, default 1.3.xt: pressure-drop-ratio factorxT, default 0.7.
Outputs
service: the resolved service.required_kv: required flow coefficient in metric Kv.required_cv: required flow coefficient in US Cv (1.156 * Kv).choked: choked-flow flag.choke_limit: choked pressure drop in bar (liquid) or chokingx(gas).cv_margin_ratio:rated_cv / required_cv, ornullif no rating.valve_warning:ok,watch,under-sized,choked, orno-rating.assumptions: public assumptions used by the placeholder model.
Engineering Method
The Python class ControlValveCvModel uses public IEC 60534-2-1 / ISA-75.01 equations:
- liquid Kv uses
Kv = Q * sqrt(SG / dP_sizing). - the liquid liquid-critical-pressure-ratio factor uses
FF = 0.96 - 0.28 * sqrt(Pv / Pc). - liquid choke occurs when
dP >= FL^2 * (P1 - FF * Pv); the sizingdPis capped at this limit. - gas uses
x = dP / P1,Fk = k / 1.4, chokex = Fk * xT, expansion factorY = 1 - x / (3 Fk xT)bounded to[0.667, 1], and the mass-flow formKv = W / (N6 * Y * sqrt(x * P1 * rho1))withN6 = 27.3. Cv = 1.156 * Kv.
This is educational and screening-only logic. It assumes single-phase, fully turbulent flow with no piping geometry factor (Fp), no Reynolds-number correction, and no two-phase or flashing mixture handling. It is not a replacement for validated control-valve sizing and qualified selection.
Python Usage Pattern
from control_valve_cv_screening import ControlValveCvModel
model = ControlValveCvModel()
result = model.evaluate(
service="gas",
inlet_pressure=50.0,
pressure_drop=12.0,
mass_flow=5000.0,
inlet_density=40.0,
specific_heat_ratio=1.3,
)
print(result.required_cv)
print(result.choked)
print(result.valve_warning)
Inverse use: capacity test at a travel stop
control_valve_cv_screening.capacity answers the inverse questions that come up when a
valve is held at a mechanical travel stop and a capacity test disagrees with the design
number: what Cv did the test demonstrate, what will the same stop pass at another
pressure drop (for example a relief/flare case), and which opening would just meet a flow
limit.
from control_valve_cv_screening import verify_stop_capacity
res = verify_stop_capacity(
[{"q_sm3h": 579e3, "p1_bara": 189.4, "p2_bara": 135.8}], # measured test
cv_max=602.8, stop_fraction=0.38, # datasheet Cv, stop position
temperature_k=353.15, molar_mass=17.8, z=0.88, k=1.3, xt=0.5,
limit_case={"p1_bara": 214.0, "p2_bara": 192.0, "q_limit_sm3h": 729e3},
)
print(res.ratio_to_nominal, res.flow_at_limit_case_sm3h, res.opening_fraction_for_limit)
Gotchas verified on a gas-export valve study: (1) check the pressure-drop basis of every
quoted "maximum flow" - a number sized at 65 bar drop is not valid at 22 bar; (2) a flow
that is the same in three successive tests at different dates is a physical capacity, not
a mis-set stop, whereas one older test with a much higher flow shows the stop moved;
(3) report the sensitivity to xt, z, molar mass and temperature (they move the back-
calculated Cv by about 10 percent but cancel largely in the prediction at another
pressure drop); (4) a valve whose command sits at 100 percent for most hours is a fixed
restriction, not a controller - screen that with the control-authority agent.
Related NeqSim Functionality
For validated control-valve behaviour, redirect to existing NeqSim classes:
neqsim.process.equipment.valve.ThrottlingValve— flow-vs-Cv valve withgetCv/setCvand pressure-drop response.neqsim.process.equipment.valve.ControlValve— control valve with characteristic and controller coupling.neqsim.process.equipment.valve.SafetyValve— relief-valve modelling for the relieving case.
This skill is a public sizing triage layer that decides when to invoke those validated valve classes.
Validation Checklist
-
inlet_pressureandpressure_dropare positive anddP < P1. - Liquid service supplies flow and specific gravity; gas service supplies mass flow and density.
- The choked flag uses
FL(liquid) orFk xT(gas). - Tests cover liquid sizing, gas sizing, choking, rating margin, and invalid input.
- Real sizing is redirected to validated NeqSim valve classes and qualified review.
Common Mistakes
| Symptom | Cause | Fix |
|---|---|---|
| Cv too small | Used choked dP not realising flow is critical |
The model caps dP; check the choked flag |
| Gas Cv off | Density not at inlet conditions | Pass inlet_density at P1, T1 |
| Liquid choke never flags | vapor_pressure left at 0 |
Provide vapor and critical pressure |
| Wrong units | Q in m3/s or W in kg/s |
Use m3/h (liquid) and kg/h (gas) |
Limitations
- No piping geometry factor
Fp, Reynolds correction, or low-flow laminar handling. - No two-phase, flashing, or multiphase valve sizing.
- No vendor valve characteristic, noise, or actuator sizing.
References
- NeqSim repository: https://github.com/equinor/neqsim
- NeqSim Skills Guide: https://github.com/equinor/neqsim/blob/master/docs/integration/skills_guide.md