Flow Assurance Analysis with NeqSim
Consolidated guide for all flow assurance threats — hydrate, wax, asphaltene, corrosion, hydraulics, water/liquid hammer screening, slugging, and thermal management — with NeqSim code patterns.
A complete study report with pipeline drawings (route, profiles, hydrate margin, threat matrix, validation) is produced by
neqsim flow-assurance-report— see theneqsim-flow-assurance-study-reportskill. This skill stays the calculation reference. A whole subsea SURF network (templates, injection, risers, umbilical, concept comparison) is generated, solved and documented byneqsim surf-study— see theneqsim-surf-design-studyskill.
When to Use This Skill
- Hydrate formation temperature/pressure prediction
- Hydrate inhibitor dosing (MEG, methanol, ethanol)
- Wax appearance temperature (WAT) and wax deposition risk
- Asphaltene stability screening (de Boer, CII)
- CO2 and H2S corrosion rate estimation
- Elemental sulfur (S8) deposition risk at pressure/temperature letdown (compressor inlets, control/letdown valves, dry-gas seals, filters)
- Pipeline pressure drop and temperature profile
- DNV-RP-F109 vertical and lateral on-bottom stability screening
- Water hammer/liquid hammer screening for fast valve closure, pump trip, or check-valve slam
- Multiphase flow pattern prediction (slug, annular, stratified)
- Thermal insulation sizing for subsea pipelines
- Arrival temperature and cooldown calculations
Applicable Standards
| Domain | Standards | Key Requirements |
|---|---|---|
| Pipeline design | DNV-ST-F101, DNV-RP-F104 for CO2, NORSOK L-001, ASME B31.4/B31.8 | Structural design plus composition-specific CO2 phase/hydraulic and lifecycle basis |
| Corrosion | NORSOK M-001, DNV-RP-F112, ISO 21457 | Material selection, CO2/H2S corrosion rates |
| On-bottom stability | DNV-RP-F109 | Vertical stability, absolute lateral stability, displacement acceptance |
| Free spans | DNV-RP-F105 | Free-span response and fatigue assessment |
| Global buckling and pipe-soil interaction | DNV-RP-F110, DNV-RP-F114 | Caller-controlled external response and demand-resistance screening |
| Subsea systems | NORSOK U-001 | Subsea production-system requirements |
| Hydrate management | DNV-RP-F116 | Hydrate prevention and remediation |
| GRP piping | ISO 14692 | Non-metallic pipe design |
| Pipeline integrity | DNV-RP-F101, DNV-RP-F116, API 1160 | Inspected metal-loss remaining strength and integrity management |
For fast acoustic transients, also load neqsim-water-hammer. Use
WaterHammerStudy or MCP runWaterHammer with STID route geometry, tagreader
event windows, and valve/pump event schedules; use this flow-assurance skill for
the broader operating-envelope and mitigation context.
For on-bottom stability, load neqsim-subsea-and-wells and use the typed
DnvRpF109OnBottomStabilityKernel. It provides a transparent absolute-static
screen and checks externally calculated response displacements. It does not
contain generalized design tables, produce dynamic response, qualify environmental
or soil models, or claim DNV conformity. A pass still requires independent review.
This skill quantifies the threat (hydrate curve, WAT, SI, corrosion rate). For the
chemical answer — which product, minimum effective dose, cocktail compatibility, H2S/O2
scavenger sizing, demulsifier vs oil-in-water spec, and chemical root-cause of a deposit —
load neqsim-production-chemistry (neqsim.process.chemistry) and feed it the numbers
computed here.
For local dry hydrocarbon gas/oil interface investigations, the existing film boundary
has a default-off setCoupledMassHeatTransferEnabled(true) numerical option. Read
docs/fluidmechanics/InterphaseHeatMassTransfer.md for its residual gates and limited
positive-composition/finite-transport range. It is not connected to the transient
TwoFluidPipe source. Zero liquid Reynolds number currently gives an unsupported
stratified transfer coefficient and rejects; never interpret the old unit-matrix
fallback as stationary-pool evaporation. Keep #4674 physical boundary/full-cycle and
#4675 heat/area/diffusion qualification separate from numerical convergence.
1. Hydrate Analysis
EOS Selection for Hydrate Calculations
| Aqueous phase | NeqSim Class | Mixing Rule |
|---|---|---|
| Pure water / fresh water | SystemSrkCPAstatoil |
10 |
| Water + MEG / methanol / ethanol | SystemSrkCPAstatoil |
10 |
| Salt brine / formation water (NaCl, CaCl2, ...) | SystemElectrolyteCPAstatoil |
10 |
| Pitzer salt-brine water activity | SystemPitzer |
"classic" |
CPA or a consistent activity-based aqueous model is needed for water–hydrocarbon hydrate modeling.
When dissolved salts / electrolytes are present, use SystemElectrolyteCPAstatoil or a
parameterized SystemPitzer so the salt
thermodynamic (hydrate-suppression) effect is captured — plain
SystemSrkCPAstatoil ignores ion activity and underestimates subcooling margin.
For Pitzer hydrate onset, load neqsim-electrolyte-systems and read
docs/thermo/pitzer_hydrate_equilibrium.md. Accept its hand-off of salt mole basis, dataset,
explicit CO2-chloride zeta values (and K-Mg theta when both ions are present), pressure grid and operating temperature. Use the standard
temperature/pressure/curve operations; the Pitzer route checks the fugacity residual and throws
on failed points. Preserve the aqueous reference-state convention and guest Henry limits.
Do not label onset calculations as hydrate amounts, kinetics or validated complete drilling-mud predictions.
Carry forward the experimental assessment separately from convergence: the mixed-chloride high-pressure cases
include errors exceeding 1 K. Do not generalize the NaCl benchmark to all salts, concentrations or pressures.
Hydrate Formation Temperature
// CPA EOS required for accurate water-hydrocarbon modeling
SystemInterface fluid = new SystemSrkCPAstatoil(273.15 + 10, 100.0);
fluid.addComponent("methane", 0.80);
fluid.addComponent("ethane", 0.05);
fluid.addComponent("propane", 0.03);
fluid.addComponent("CO2", 0.02);
fluid.addComponent("water", 0.10);
fluid.setMixingRule(10); // CPA mixing rule
fluid.setMultiPhaseCheck(true);
fluid.setHydrateCheck(true);
ThermodynamicOperations ops = new ThermodynamicOperations(fluid);
ops.hydrateFormationTemperature();
double hydrateT_C = fluid.getTemperature() - 273.15;
setHydrateCheck(true) is mandatory: without it hydrateFormationTemperature() fails
(no hydrate phase) and any wrapper that swallows the exception reports NaN. The fluid must
contain water. HydrateRiskMapper (and MCP runFlowAssurance hydrateRiskMap) now sets the
flag itself and returns RiskLevel.UNKNOWN / RESULT_NOT_AVAILABLE with failureReasons when
no equilibrium temperature exists — never treat an unavailable hydrate temperature as safe.
Hydrate Equilibrium Curve (Multiple Pressures)
// Calculate hydrate T at several pressures for the full curve
double[] pressures = {20, 40, 60, 80, 100, 120, 150, 200};
double[] hydrateTemps = new double[pressures.length];
for (int i = 0; i < pressures.length; i++) {
SystemInterface testFluid = fluid.clone();
testFluid.setPressure(pressures[i]);
ThermodynamicOperations testOps = new ThermodynamicOperations(testFluid);
testOps.hydrateFormationTemperature();
hydrateTemps[i] = testFluid.getTemperature() - 273.15;
}
Hydrate Inhibitor Dosing (MEG)
// Add MEG to suppress hydrate formation temperature
SystemInterface inhibitedFluid = new SystemSrkCPAstatoil(273.15 + 4, 100.0);
inhibitedFluid.addComponent("methane", 0.80);
inhibitedFluid.addComponent("water", 0.15);
// 25 wt% MEG in the water + MEG phase: n_MEG = n_water * 18.015 * 0.25 / 0.75 / 62.07 = 0.0145 mol
// (0.05 mol MEG per 0.15 mol water would be 53 wt%: amounts are MOLES, never weight percentages)
inhibitedFluid.addComponent("MEG", 0.0145);
inhibitedFluid.setMixingRule(10);
inhibitedFluid.setMultiPhaseCheck(true);
inhibitedFluid.setHydrateCheck(true);
ThermodynamicOperations ops = new ThermodynamicOperations(inhibitedFluid);
ops.hydrateFormationTemperature();
double inhibitedHydrateT = inhibitedFluid.getTemperature() - 273.15;
// Compare with uninhibited to get subcooling margin
For the injection rate that delivers a required wt% in the water phase (including purity
and lean/rich MEG bookkeeping), use
neqsim.process.chemistry.hydrate.ThermodynamicHydrateInhibitorPerformance — see
neqsim-production-chemistry. Use the CPA curve above for the design concentration and the
chemistry model for the rate.
Salt-Inhibited Hydrate (Formation Water / Brine)
// Dissolved salts depress the hydrate temperature — use the electrolyte CPA model
SystemInterface brineGas = new SystemElectrolyteCPAstatoil(273.15 + 4, 100.0);
brineGas.addComponent("methane", 0.80);
brineGas.addComponent("water", 0.18);
brineGas.addComponent("Na+", 0.01); // dissociated NaCl
brineGas.addComponent("Cl-", 0.01);
brineGas.setMixingRule(10);
brineGas.setMultiPhaseCheck(true);
brineGas.setHydrateCheck(true);
ThermodynamicOperations ops = new ThermodynamicOperations(brineGas);
ops.hydrateFormationTemperature();
double brineHydrateT = brineGas.getTemperature() - 273.15;
// SystemSrkCPAstatoil would miss the salt suppression — always use electrolyte CPA with ions
MEG Concentration Sweep
// Find required MEG concentration for target subcooling
double[] megWtPct = {0, 10, 20, 30, 40, 50};
for (double wt : megWtPct) {
// wt % MEG is a MASS fraction of the water + MEG mixture: convert to moles (M_water 18.015, M_MEG 62.07 g/mol)
double waterMol = 0.20 * (1.0 - wt / 100.0) / 18.015;
double megMol = 0.20 * (wt / 100.0) / 62.07;
double waterFrac = waterMol / (waterMol + megMol) * 0.20;
double megFrac = megMol / (waterMol + megMol) * 0.20;
SystemInterface testFluid = new SystemSrkCPAstatoil(273.15, 100.0);
testFluid.addComponent("methane", 0.80);
testFluid.addComponent("water", waterFrac);
testFluid.addComponent("MEG", megFrac);
testFluid.setMixingRule(10);
testFluid.setHydrateCheck(true);
ThermodynamicOperations testOps = new ThermodynamicOperations(testFluid);
testOps.hydrateFormationTemperature();
// Record hydrate T vs MEG concentration
}
Sweep gotchas (found building an HPHT tie-back, Fogelberg VPbo task): hydrateFormationTemperature()
with a rich gas condensate (C7+ pseudo-components) plus water and MEG at 40 wt % MEG did not return
(CPA hydrate solver loop, no exception, no timeout). Run every MEG/pressure point of a sweep in a
watchdog thread or subprocess with a hard time limit and keep the sweep to at most 30 wt % MEG. If a
40-50 wt % row is still needed, a linear extrapolation (about -4.5 K per 10 wt % at 30-400 bara) is an
UNVALIDATED screening number: label it as extrapolated, never use it for a pass/fail margin, and do not
let the whole script hang for it. Write the intermediate JSON before the hydrate loop so a kill does not lose the
fluid and CVD results.
For flowline hydraulics with PipeBeggsAndBrills a trial inlet pressure that is too low throws
HydraulicDomainException: Non-positive pipeline pressure instead of returning a low outlet pressure:
catch it inside the chain function and return outlet 0 (infeasible). Letting it propagate out of a
bisection silently turns a whole row of the inlet-pressure table into NaN.
ThermodynamicOperations.hydrateFormationTemperature() is void: the answer is left in the fluid
temperature, so read fluid.getTemperature() - 273.15 after the call (float(ops.hydrateFormationTemperature())
fails with NoneType; found in the Mistral Nord VPbo task). A wellstream built with SystemSrkEos plus
setHydrateCheck(true) also under-predicts the hydrate temperature (methane benchmark about -8 K): rebuild
the composition in SystemSrkCPAstatoil (mixing rule 10) and benchmark methane at 43/76/140 bara against
5/10/15 C before using the numbers (CPA gives -0.03/+0.33/+0.58 K).
To benchmark PipeBeggsAndBrills against Darcy-Weisbach use a dry single-phase gas (pure methane, 60 C,
setHeatTransferCoefficient large): the deviation is then 0.2-0.4 %. A lean-gas condensate line cooled
to seabed temperature differs by 25-50 % because the liquid holdup is real, so that difference is not a defect.
Gas-condensate saturation pressure (Tyrihans cellar task): a bubble-point search on a lean gas-condensate fluid returns
a wrong value because the fluid has a dew point; take the saturation pressure of GOR above about 1500 Sm3/Sm3 fluids
from the CVD first step (dew point) and record it as a limitation. hydrateFormationTemperature() on a GOR 250 oil fluid
with 3 mol % water at 200 bara did not converge and left the temperature unchanged: check that the returned temperature
differs from the start temperature before reporting it and report None as a gap, not as a hydrate-free result.
HPHT wellstream hydrates (Erlend / Kristin study): the CPA hydrate solver also stalls (no exception) with the
C7+ TBP/plus pseudo-components at 50 bara and 1 mol % water, even without MEG. Rebuild the CPA mixture from the
light components only (C1-C6, N2, CO2, water, renormalised), as C7+ barely moves the hydrate temperature; a
Kristin-type gas (CGR 300 Sm3/MSm3) with 1 mol % water gave 17.2 / 21.2 / 26.6 / 31.9 C at 50 / 100 / 300 / 600 bara.
Do not iterate PipeBeggsAndBrills inlet pressure by a fixed point p_in += p_out_target - p_out: it stalls at high
pressure drop (unconverged tables looked like data). Use a secant solve, treat a HydraulicDomainException as outlet
pressure 0, store an ok flag and exclude ok == False rows when interpolating; beyond the last converged rate
extend the table with dp proportional to q^2 instead of the last slope.
MEG/Water Film Conditioned by Dry Gas (pipeline drying after glycol swabbing)
Question pattern: "what MEG:H2O ratio does a residual film reach under dry export gas, and why is
the gas above the dew-point spec?" Worked task: 2026-09-29_steady_state_megh2o_ratio_during_dry_gas_drying_of_a_meg.
- Direction: a 99 wt% MEG film is drier than the plateau (about 90 wt% at 6 C, 140 bara), so the gas is the wetter side and the film absorbs water. It "dries" only if it starts wetter than the plateau.
- Equilibrium curve: two-phase
SystemSrkCPAstatoilTPflashes over an MEG sweep give gas water and MEG content versus film composition (gas composition depends on the liquid composition, T and P only). Report film composition on a gas-free basis, MEG/(MEG+water); dissolved CO2/CH4 is ~0.8 wt%. MEG is not strictly non-volatile: about 5 ppm wt in the gas at 140 bara. - Dew-point spec fixes only the water mole fraction y_in, not the pipe condition. Hand chain: water
fugacity continuity,
a_w = y_in * phiV_w(T,P) * P / f0_w(T,P), withf0_w= IAPWS vapour pressure x Poynting;a_wfrom the CPA liquid fugacity coefficient divided by the pure-water coefficient. Use binary (gas-free) mole fractions when fittingln gamma_wor the fit mis-predicts at high MEG. - Plateau offset by mass balance: with a stationary film the gas leaves carrying water and MEG in the
film's own ratio, so
(y_out - y_in)/y_in = r * y_MEG / y_in(about 1.7 %), independent ofK_Gat large NTU. The film inlet zone is stripped of MEG first (a film-free zone grows at ~200 m/day in a 0.4 m, 60 kg/s example). - Flash per time step is backward Euler: unconditionally stable, plateau independent of step size; an
explicit coding is stable only below
2 / (d y*_H2O / d r)kg gas per kg film MEG per step. - Dew point is logarithmic (~6 % in water content per K at these conditions) and, for CPA, nearly pressure independent at 70-140 bara: reading the same gas as a dew point at pipe pressure adds ~0.9 K.
- Basis traps: CPA liquid-water dew point is a supercooled-liquid reference below freezing;
ISO 18453 / GERG-water uses an ice reference below 273.16 K. These are different phase boundaries.
For GERG-water, use
SystemGERGwaterEos,setMixingRule(8), and aThermodynamicOperationsinstance'swaterDewPointTemperatureFlash(); follow the ISO 18453 execution rule inneqsim-standards-lookupand the dew-point guide. Recalculate outputs from the former non-convergent solver before comparing models. Neither an ideal-gas estimate nor a CPA/GERG difference alone identifies an ISO implementation error. - Numerics: for N >= 100 film cells use
solve_ivp(method="BDF"); LSODA stalls on the film-exhaustion switch. Regulariser = W/(M + delta)so a film-free cell cannot return a spurious composition.
2. Wax Analysis
Wax Appearance Temperature (WAT)
// Oil system with C7+ fractions for wax prediction
SystemInterface oil = new SystemSrkEos(273.15 + 60, 50.0);
oil.addComponent("methane", 0.30);
oil.addComponent("ethane", 0.10);
oil.addTBPfraction("C7", 0.10, 92.0 / 1000, 0.727);
oil.addTBPfraction("C10", 0.15, 134.0 / 1000, 0.78);
oil.addTBPfraction("C15", 0.15, 206.0 / 1000, 0.83);
oil.addPlusFraction("C20", 0.20, 350.0 / 1000, 0.88);
oil.getCharacterization().setWaxModel(true);
oil.getCharacterization().characterisePlusFraction();
oil.setMixingRule("classic");
ThermodynamicOperations ops = new ThermodynamicOperations(oil);
ops.calcWAT();
double wat_C = oil.getTemperature() - 273.15;
Wax Fraction vs Temperature (PVT Simulation)
import neqsim.pvtsimulation.simulation.WaxFractionSim;
WaxFractionSim waxSim = new WaxFractionSim(oil);
waxSim.setTemperatures(new double[]{333.15, 313.15, 293.15, 273.15});
waxSim.run();
double[] waxFractions = waxSim.getWaxFraction();
3. Asphaltene Stability
de Boer Screening
// Assess asphaltene precipitation risk
// Key parameters: reservoir pressure, bubble point, density difference
// Risk increases when operating pressure approaches bubble point
// High-risk zone: ΔP > 200 bar above bubble point for light oils
// Use CPA for asphaltene modeling
SystemInterface aspFluid = new SystemSrkCPAstatoil(273.15 + 90, 300.0);
// Add components including heavy asphaltenic fractions
aspFluid.setMixingRule(10);
ThermodynamicOperations ops = new ThermodynamicOperations(aspFluid);
ops.TPflash();
aspFluid.initProperties();
// Check if asphaltene phase is stable
// Compare upper/lower asphaltene onset pressures vs operating P
4. Pipeline Hydraulics
Simple Adiabatic Pipe
AdiabaticPipe pipe = new AdiabaticPipe("Export Pipeline", feedStream);
pipe.setLength(50000.0); // 50 km in meters
pipe.setDiameter(0.508); // 20 inch in meters
pipe.setInletElevation(0.0);
pipe.setOutletElevation(-350.0); // negative = downhill (subsea)
pipe.run();
double outletP = pipe.getOutletStream().getPressure(); // bara
double outletT = pipe.getOutletStream().getTemperature() - 273.15; // C
double dP = feedStream.getPressure() - outletP; // pressure drop
DNV-RP-F105 free-span routing
When a hydraulics or environment study feeds an explicit current DNV-RP-F105 2025-12 free-span
screen, route verified structural and environmental inputs through
DnvRpF105FreeSpanScreeningKernel. Keep steel and hydrodynamic diameters distinct and use velocities
normal to the span. Effective modal mass, axial force, span geometry, and response-trigger basis are
external structural inputs, not quantities inferred silently from a hydraulic pipe object.
The kernel is a simply supported first-mode/dimensionless escalation screen. Its Strouhal number,
frequency-ratio band, and reduced-velocity triggers are project-controlled and cannot be called DNV
limits. Keep soil/shoulder and multi-span response, VIV amplitudes, direct wave loading, ULS/FLS,
fatigue, monitoring, and intervention external. Never relabel
PipeMechanicalDesignCalculator.calculateAllowableSpanLength(...) as F105 evidence.
DNV-RP-F101 inspected metal-loss routing
When inspection data feeds an explicit current DNV-RP-F101 2019-09+AMD:2025-09 screen, route one
verified isolated longitudinal metal-loss defect under internal pressure through
DnvRpF101CorrodedPipelineScreeningKernel. Require the measured depth and axial length,
assessment wall-thickness definition, inspection/growth allowance, characteristic ultimate
tensile strength, internal/external absolute pressures, and project-controlled pressure factor.
Do not infer defect geometry from hydraulic corrosion-rate calculations or projected uniform wall loss. The typed kernel does not handle defect interaction or complex profiles, longitudinal compression, probabilistic assessment, crack-like damage, repair, or fitness-for-service approval. It also does not replace DNV-ST-F101 original-design checks.
DNV-RP-F104 CO2 pipeline routing
When an actual-composition phase-envelope and hydraulic/thermal study feeds a current
DNV-RP-F104 2021-02+AMD:2021-09 screen, route the bounded project composition, CO2/water limits,
ordered profile, absolute MAOP, design temperatures, and a separately verified minimum single-phase
pressure boundary at each point through DnvRpF104Co2PipelineEnvelopeScreeningKernel.
The external thermodynamic basis must establish that pressure above each boundary represents the
intended single-phase region for the specific composition, temperature, path, EOS, and uncertainty.
Do not substitute pure-CO2 critical conditions or CO2FlowCorrections.isDensePhase(...). Treat
composition, phase-boundary, MAOP, and temperature margins as screening findings. Keep transient
cases, F104 decompression/fracture and crack arrest, materials/corrosion, release consequences,
construction, operation, requalification, and all DNV-ST-F101 structural checks external.
DNV-RP-F114 pipe-soil interaction routing
When route, hydraulic/thermal, or installation work feeds a current DNV-RP-F114 2021-05 screen,
route named design situations with externally verified vertical, axial, and lateral action and
resistance magnitudes through DnvRpF114PipeSoilInteractionScreeningKernel. Treat margin and
utilization outputs as caller-controlled screening findings.
Do not convert burial depth, soil thermal resistance, or a generic friction factor into geotechnical resistance. Keep site investigation, soil interpretation, penetration/burial and load-displacement response, time/cyclic effects, characteristic values, uncertainty, structural actions, and F109/F110/F105/ST-F101 acceptance external.
DNV-RP-F110 global-buckling response routing
When hydraulic/thermal, route, or installation work feeds a current
DNV-RP-F110 2019-09+AMD:2021-09 screen, route named external structural-analysis cases through
DnvRpF110GlobalBucklingResponseScreeningKernel. Supply effective force, peak longitudinal strain,
peak global displacement, and required feed-in length with caller-controlled allowable or available
values. Treat margins and utilizations as screening findings.
Require external evidence for the effective-force derivation, pipe/as-laid geometry, pipe-soil response, imperfections/triggers/strategy, global structural model, load combinations, local capacity and strain criteria, uncertainty/sensitivity/buckle sharing, and lifecycle actions. Never derive critical buckling, initiation/prevention criteria, structural response, or soil springs from NeqSim hydraulic or thermal output. Keep F109/F114/F105 and all ST-F101 acceptance external.
Beggs and Brill Multiphase Correlation
PipeBeggsAndBrills pipe = new PipeBeggsAndBrills("Subsea Flowline", feedStream);
pipe.setPipeWallRoughness(5e-5); // meters
pipe.setLength(50000.0); // meters
pipe.setAngle(0.0); // horizontal
pipe.setDiameter(0.254); // 10 inch
// For subsea with heat loss
pipe.setOuterTemperature(277.15); // 4°C seawater
pipe.run();
// Get flow regime, liquid holdup, pressure profile
double outP = pipe.getOutletStream().getPressure();
double outT = pipe.getOutletStream().getTemperature() - 273.15;
Liquid Holdup, Flow Regime & Liquid-Loading (gravity-dominated screening)
Verified reader methods on PipeBeggsAndBrills (after run()):
String regime = pipe.getFlowRegime(); // SEGREGATED / TRANSITION / INTERMITTENT / DISTRIBUTED
double dP = pipe.getPressureDrop(); // bar (inlet - outlet)
double vmix = pipe.getMixtureVelocity(); // m/s
double[] holdupProfile = pipe.getLiquidHoldupProfile(); // fraction per segment (0-1)
// per-segment access (0 .. numberOfIncrements-1):
Double hSeg = pipe.getSegmentLiquidHoldup(i);
Double vsgSeg = pipe.getSegmentGasSuperficialVelocity(i);
Double vslSeg = pipe.getSegmentLiquidSuperficialVelocity(i);
Double elevSeg = pipe.getSegmentElevation(i);
// average holdup = mean(holdupProfile); "liquid content" for the line
// liquid inventory (m3) = sum_i holdup_i * (pi/4*D^2) * segmentLength
Liquid-loading / gravity-dominated screening (PEPR-style "is the line filling
with liquid?"): sweep gas rate (and water cut) and read average holdup +
regime. As gas rate falls, holdup rises and the regime moves
INTERMITTENT -> TRANSITION -> SEGREGATED (stratified) = gravity-dominated /
liquid loading. Higher water cut lifts holdup at every rate and pushes toward
INTERMITTENT (slugging). Define liquid-loading onset as the gas rate where
average holdup crosses a threshold (e.g. 25%).
for (double qgMSm3d : gasRates) {
SystemInterface feed = fluidTemplate.clone(); // gas-condensate + water (CPA, rule 10)
Stream s = new Stream("feed", feed);
s.setFlowRate(qgMSm3d, "MSm3/day"); // wellstream gas standard volume
s.setTemperature(50.0, "C"); s.setPressure(150.0, "bara");
s.run();
PipeBeggsAndBrills p = new PipeBeggsAndBrills("line", s);
p.setLength(21000.0); p.setDiameter(0.254); p.setAngle(0.0);
p.setPipeWallRoughness(5e-5); p.setNumberOfIncrements(40);
try {
p.run();
double[] h = p.getLiquidHoldupProfile();
// record mean(h), p.getFlowRegime(), p.getMixtureVelocity()
} catch (RuntimeException e) {
// "Outlet pressure is negative" = DELIVERABILITY LIMIT, not a bug (see gotcha)
}
}
GOTCHA — deliverability limit vs bug.
PipeBeggsAndBrillsuses a fixed inlet pressure. If frictional ΔP over a long/small line exceeds the inlet pressure,run()throwsInvalidOutputException: ... Outlet pressure is negative. That is a genuine deliverability limit (the line cannot pass that rate at that inlet P), not a solver failure — catch it and report the max deliverable rate. To model to a fixed arrival (outlet) pressure instead, raise the inlet pressure until the delivered rate matches, or iterate inlet P per rate.
PATTERN — tubing outflow (VLP) and gas-lift need on a heavy-oil tie-back. Put the bottom-hole pressure on the inlet stream (
P_bh = P_res - q_liq / PI), setsetLength(MD),setElevation(+TVD),setAdiabatic(true)and read the outlet pressure as the wellhead pressure; add lift gas as extra gas in the stream composition (bottom injection slightly over-states the lift). A 24 API oil (10 cP at 85 C) with 2000 m TVD has a hydrostatic head of about 170 bar, so a 205 bar reservoir cannot reach a 40 bar arrival without lift: sweep water cut x rate x lift GLR once, tabulate the WHP margin againstarrival + line dP + choke, and read the deliverable rate per well and the GLR needed from the table (it falls from about 2.5 kSm3/d per well at 5 % water cut to zero near 85 %). EveryNone/exception in the table is the deliverability limit above, not a failure.getMixtureViscosityProfile()/getSegmentMixtureViscosity()return cP, not Pa.s (do not multiply by 1000).
GOTCHA —
getFlowRegime()naming. Beggs & Brill regimes are returned asSEGREGATED(stratified/annular — gravity-dominated),TRANSITION,INTERMITTENT(plug/slug),DISTRIBUTED(bubble/mist). "Gravity-dominated / liquid loading" = SEGREGATED (+ low-velocity TRANSITION).
GOTCHA — profile index vs
getFlowRegime().run()evaluates the correlation once per increment and then once more at the outlet state, so every correlation profile (getLiquidHoldupProfile(),getFlowRegimeProfileList(), …) hasnumberOfIncrements + 1entries and index i belongs togetPressureProfile()[i].getFlowRegime()returns the outlet state. ReadinggetFlowRegime()next togetSegmentLiquidHoldup(0)compares two different states and can look like a discontinuity. Always pairgetSegmentFlowRegime(i)withgetSegmentLiquidHoldup(i).
VALIDITY — low liquid loading. On a long wet-gas export line (ID 0.355 m, no-slip liquid fraction λ_L ≈ 0.006), Beggs & Brill over-predicts ΔP well above a single-phase Darcy-Weisbach integration of the same line, and the gap is entirely the two-phase friction multiplier
exp(S): removing it brings ΔP within 4% of that analytic integration.Sis monotonically increasing iny = λ_L / H_L², so less liquid gives a larger multiplier — the opposite of the physical trend — up to a bounded maximum ofexp(S) = 3.19aty = 52.1. B&B is calibrated for λ_L down to roughly 0.01–0.02; below that, useTwoFluidPipeor a mechanistic simulator and treat B&B as a conservative upper bound. The published map also has a genuine step where the segregated and distributed correlations meet atL1for λ_L < 0.01 (no transition band exists there): hold-up ×0.70 and ΔP ×1.12 across a 1 bara change. That step is in the correlation — do not smooth it.
Fixed defects worth knowing (all affected the inclination correction). Older NeqSim builds silently returned the horizontal hold-up on an inclined leg when (a) the pipe angle was converted degrees→radians twice, (b) the Baker-Swerdloff surface tension went negative above 274 bara or for a very light liquid, making the liquid velocity number NaN, or (c) the flow regime was
TRANSITION, which had no inclination branch at all. All three are fixed and locked byPipeBeggsAndBrillsCorrelationTest. If you are on an older build, sanity-check that uphill hold-up clearly exceeds horizontal hold-up before trusting an inclined result.
Phase-count code paths.
PipeBeggsAndBrillsassumes phase 0 is the gas whenever the stream has more than one phase. A gas-free stream that splits into oil and water (dead oil with free water at high pressure) used to be modelled as gas–liquid, with the oil phase acting as the gas: fictitious flow regime, hold-up 0.21 instead of 1, and ΔP 44% above the homogeneous liquid value. It is now carried as a homogeneous liquid with a volume-weighted density and viscosity. The three-phase liquid density is also now combined on volume fractions (total mass over total volume) rather than mass fractions. Locked byPipeBeggsAndBrillsPhasePathsTest.
Where the error sits. On a single-phase gas line Beggs & Brill matches a Darcy-Weisbach integration to a few tenths of a per cent on pressure drop and to ~0.15 K on arrival temperature — the friction and energy paths are sound. The over-prediction seen on the two-phase version of the same line is therefore entirely the two-phase friction multiplier, not the solver.
Comparisons against commercial transient multiphase simulators are not published in this repository. Their licence terms generally prohibit publishing benchmark results and prohibit using the software to develop competing software, so no NeqSim closure is tuned to such a tool and no measured deviation against one is recorded here. Validate against experimental, laboratory or field data, or against an analytic/first-principles check.
TwoFluidPipesteady-state usage. Gate every result on the complete immutableSteadyStateConvergenceReport, not a stationary pressure trace or iteration count. RequireisConverged(), inspect the explicit termination reason, and retain pressure-momentum, pressure-update, total-liquid-holdup, water/oil-split, thermodynamic-property, and total-pressure-drop residuals against the report's unchanged tolerance. Pressure-floor and wall-clock termination are non-converged. Repeat mesh sensitivity for the actual geometry; no fixed cell length is universally qualified.
MCP
runPipelinesolver and response handoff. Omitsolver(or usebeggsBrill) for the established correlation path. Usesolver: "twoFluid"when the task needs finite-volume pressure, temperature, holdup, phase-velocity, flow-regime, inventory, erosion-margin, hydrate/wax, or slug profiles. PasssectionLengths_m,elevationProfile_m,heatTransferProfile_W_m2K, andsurfaceTemperatureProfile_Cor_Kas equal-length per-section arrays; the lengths must sum tolength_m. Bound expensive solves withsteadyStateMaxWallClockTime_s. RequestdetailLevel: FULLfor spatial profiles,SUMMARYfor engineering KPIs without profiles, orMINIMUMfor the compact core result. The authoritative object isTwoFluidPipeResponse(aBaseResponse): preserve it through MCP/report handoffs instead of independently reconstructing fields from the equipment. Always propagate its convergence/pressure-floor/wall-clock validation findings and apply the limitations below before quoting a result.
Three defects found by auditing the solve against its own governing equations — all fixed, but the symptoms are generic and worth recognising elsewhere. (1) A time integrator inside a fixed-point sweep. The steady solve integrated
LiquidAccumulationTrackeronce per iteration with a nominaldt; that tracker only ever adds liquid, ratchets its volume up to what the sections already hold, then adds it back on top of that holdup, so it has no fixed point. Valley sections climbed to the 0.85/0.95 cap and the profile never settled. (2) A correlation overriding a solved momentum balance. The minimum-slip constraint applied the Beggs and Brill horizontal holdup correlation as a lower bound in every regime. It is fitted to 1–1.5 inch air-water loops at near-atmospheric pressure with λ_L ≥ 0.01; the line runs λ_L ≈ 0.008 in a 14-inch pipe at 200 bara, and the floor was binding in EVERY section — so the reported holdup was the correlation, not the solved momentum balance, worth ≈+20% on ΔP through the mixture density. Only the scale-freelambdaL * minimumSlipFactorbound remains. (3) Convergence declared without re-evaluating thermodynamics. The flash runs everyssFlashIntervalsweeps but the "flash moved nothing" flag started false, so a non-flash sweep read as settled. The solve could exit after ONE sweep on densities it had never revisited. If you see a steady profile with a section sitting exactly on a cap, orgetSteadyStateIterationsUsed()returning 1 on a long line, suspect these.
Behaviour after those fixes, on that line at default settings: the rate exponent in ΔP ~ rate^n rises from about 2.1 to about 3.1 across a 3x rate range, i.e. the density feedback along the line is reproduced, not just the level at one rate; 10 MW of DEH raises arrival T by ~17 K and ΔP by ~15%, so the energy equation feeds the momentum balance. Grid-converged (160 vs 320 sections within 0.4%). Terrain response is solved, not tuned: the annular film balance carries
tau_i = tau_wL + rhoL*g*sin(theta)*delta, so holdup responds to inclination and scales withsin(theta). The compact public 3 km, 10-degree uphill gas/oil/water fixture now converges on 30 and 60 cells, with 0.538% arrival-pressure and 0.983% mean-liquid-holdup sensitivity and every final report residual below1e-4. This is numerical verification, not experimental qualification. The historical 73.8 km / 15 m3/hr free-water input is unavailable, so the earlier 4,078-iteration / 1,200 s report cannot be reproduced or claimed fixed. Never generalize the compact result to that unavailable case.
TwoFluidPipealso fails silently when a line has no deliverability. The marching solver clamps section pressure at a 1 bara floor; that clamp is a fixed point of itself, so the per-section change falls below tolerance and the sweep would report success on a case with no physical solution. Checkpipe.isSteadyStatePressureFloorLimited()— when it is true,isSteadyStateConverged()is withheld and the profile must be discarded, not reported.PipeBeggsAndBrillsthrowsOutlet pressure is negativeon the same condition.
TwoFluidPipeholdup at low rate is dominated by terrain trap sections. The MAXIMUM holdup at 4 and 7 MSm3/d sits well above the line mean (a single valley section), so do not quote localTwoFluidPipeholdup or valley inventory as a design number. The three-phase bookkeeping is sound — gas/oil/water fractions sum to one and stay in range at every node.
The minimum-slip bound applies only level and uphill.
alphaL >= lambdaL * minimumSlipFactor(default 2.0) states that the gas outruns the liquid, which is a property of gas-driven transport. On a downhill section gravity moves the liquid and the slip ratio legitimately falls, so the bound is not applied there. It used to be applied everywhere and was binding on 39 of 42 downhill sections of an undulating fixture, replacing the momentum balance with a constant.
The horizontal annular criterion is the Taitel-Dukler equilibrium level.
pipe.setUseEquilibriumLevelAnnularTransition(false)restores the earlier path, the vertical droplet-entrainment thresholdU_SG > 3.1*(sigma*g*drho/rhoG^2)^0.25, which is about 0.75 m/s on a 14-inch export line and so classified essentially any horizontal gas pipeline as annular, solving a shallow stratified layer with a thin-film closure. The two agree wherever the Kelvin-Helmholtz margin exceeds one — identical at 10 MSm3/d on the export line — and differ at 4 MSm3/d, where the equilibrium branch reclassifies 272 of 320 sections as stratified-wavy.
Transient closure sources follow continuous regime weights. During dynamic evaluation, the existing dimensionless normalized weights from
FlowRegimeDetector.classify(...)blend wall friction, interfacial friction and area, and entrainment. A non-zero stratified weight keeps the matching segment geometry active. The flow map, transition bands, hold-up closure, and regime-specific formulas are unchanged, and pure-regime endpoints recover their original closures. This is experimental numerical continuation, not severe-slugging or liquid-rich qualification; require the public Tengesdal, 1,800 s inventory, conservation, nearby-point, refinement, and solver-diagnostic gates.Friction is per-phase wall shear in stratified flow.
setSeparatedFrictionModel(false)restores the mixture correlation, which charges the whole perimeter with a holdup-weighted density; on a stratified line at 41% holdup that over-predicts ΔP by ~2.3x, and because it scales asG^2/rho_mixit makes extra liquid REDUCE the gradient, inverting the terrain response. The separated form is scoped to stratified flow because its perimeters come from a circular-segment layer; annular flow, whose film wets the whole perimeter, is not that geometry.
The historical 73.8 km comparison is not a public qualification basis. Its complete input and measurement package is unavailable in the repository, so earlier reported pressure-drop and holdup deviations are retained only as repair history. Do not route or certify a study from those values. Use the reproducible public evidence and explicit failed/unsupported rows in the T
…(truncated)