Reservoir-to-Facility Gas Value Chain
Screening workflow that couples a reservoir tank, well deliverability and a facility capacity curve,
so one model answers "who limits production now, and when does that change?". It was built for the
Troll A/B/C to Kollsnes chain (Troll East, Troll West gas province, Troll B and C oil rims) and is
field-agnostic. Use NeqSim process models (ProcessSystem, ProcessModel) for the facility numbers and
NeqSim SimpleReservoir or OPM Flow when a 3D reservoir model exists; this skill is the fast layer
between them.
When to Use
- Reservoir depletion must be linked to a platform or export system in one model.
- A gas field needs a history match from shut-in wellhead pressure and allocated volumes.
- The question is whether wells or the facility limit production, and when that changes.
- Compression or well levers must be valued against a forecast.
Inputs
- Monthly allocated volumes per wellbore and a daily sample with WHP, choke and on-stream hours.
- Gas composition, reservoir temperature, TVD for the static column.
- A facility throughput sweep at several separation pressures (utilisation versus rate).
- Flowline pressure drop at a reference rate, and the export arrival pressure.
Outputs
- Tank parameters (p/z_i, GIIP) and the fitted well law per well group.
- Facility capacity versus separation pressure, the best separation pressure and the binding side (SUPPLY or FACILITY) per month.
- Scenario comparison and P10/P90 from bootstrap and parameter sampling.
Engineering Method
| Step |
Python (this skill) |
NeqSim Java (neqsim.process.fielddevelopment.integrated) |
| Shut-in WHP to reservoir pressure |
static_bottomhole_pressure |
MaterialBalanceHistoryMatch.staticBottomholePressure |
| p/z line, GIIP, outlier rejection |
fit_pz_line |
MaterialBalanceHistoryMatch.fitPzLine |
| Real-gas p/z tank |
GasTank |
RealGasMaterialBalanceDrive + DranchukAbouKassemZ |
| Well law q = C (pr^2 - pwh^2)^n |
RSDeliverability.fit |
RawlinsSchellhardtFit, WellDeliverabilityCurve.fromRawlinsSchellhardt |
| Facility capacity from sweep |
capacity_from_sweep, PressureCapacityCurve |
SupplyCapacityBalance.PressureCapacityCurve |
| Best separation pressure |
maximise_rate |
SupplyCapacityBalance.maximiseRate |
Workflow
- Data. Monthly allocated volumes per wellbore and a daily sample (a few days every 6 months) with
WHP, choke, on-stream hours. Pull per year with retries and check month coverage per facility:
a 5-year query window can time out and silently return zero rows.
- Tank. Use shut-in WHP (on-stream hours = 0, WHP above ~20 barg, per-window maximum or upper
quartile) as the pressure proxy. Convert with the static column, fit p/z against cumulative gas,
reject outliers (single-well, recently shut-in). Check that the intercept is a sane initial pressure
and that two compartments with the same gas give similar p/z_i.
- Wells. Fit the Rawlins-Schellhardt law on rows with the choke wide open only. Early-life rates are
choke-controlled and give nonsense (negative quadratic term, R2 below 0). Keep n between 0.5 and 1.0;
a short window can return n above 1, so fix n from a longer-record neighbour and refit C. Always
hold out the latest 2-3 years.
- Equivalent wells. Wells on stream = sum of on-stream hours / (24 x days in month). Do not use the
well count from the register; subsea templates ramp up and wells cycle.
- Facility. Run the platform process model over a throughput grid at several separation pressures
(
throughput_sweep). Capacity is where first-constraint utilisation reaches 1.0
(capacity_from_sweep). Utilisation above 1.0 at every rate means a head or speed limit that does
not depend on flow, so that pressure is below the facility floor. Scale capacity with polytropic
head when the discharge or export pressure changes.
- Balance. Wellhead pressure is the separation pressure plus a flowline drop that scales with
rate squared. Solve
q = rate(Ps + dp (q/q0)^2) by bisection (flow_balance); fixed-point iteration
oscillates and can collapse to zero. Choose Ps with maximise_rate; the binding side (SUPPLY or
FACILITY) is the headline result, per month.
- Export coupling. Several fields feeding one export line raise the discharge pressure through
P_man^2 = P_arr^2 + K q_total^2 (K from one measured point). The arrival pressure is an input;
the receiving terminal is not modelled unless asked.
- Scenarios and uncertainty. Fixed versus optimised Ps, extra low-pressure compression (extra
capacity and a lower Ps floor), extra wells, capacity upgrades. Bootstrap the p/z points and refit
(p/z_i and GIIP jointly), sample the deliverability exponent, well performance and capacity.
Python Usage Pattern
from reservoir_facility_value_chain import (
Gas, GasTank, PressureCapacityCurve, RSDeliverability, maximise_rate, static_bottomhole_pressure)
gas = Gas({"C1": 0.92, "C2": 0.04, "CO2": 0.02, "N2": 0.02})
pr_now = static_bottomhole_pressure(whp_barg=220.0, gas=gas, tvd_m=1500.0, t_mean_k=330.0)
tank = GasTank(gas=gas, t_res_k=345.0, pz_i=300.0, giip=1.0e11)
pr = tank.pressure(cum=2.0e10) # reservoir pressure after 2e10 Sm3
wells = RSDeliverability.fit([320, 300, 280, 260], [200, 180, 160, 140], [9.0, 8.0, 7.5, 6.0])
capacity = PressureCapacityCurve([60, 70, 80], [30.0, 36.0, 41.0]) # from the process-model sweep
ps, rate, binding = maximise_rate(lambda ps: wells.rate(pr, ps + 10.0), capacity, 60.0, 80.0)
The numbers above only show the call shape; use field data and a real sweep for a study.
Common Mistakes (each cost a failed run)
- Pressure is a difference of two large numbers. Moving GIIP by 8 % with p/z_i fixed put the
present reservoir pressure at the wellhead pressure and the calibration became complex. Sample
(p/z_i, GIIP) together from a bootstrap of the data, never independently.
- Oil-rim shut-in WHP is an index, not an absolute pressure (liquid column); report it as such and
label the fitted GIIP "effective".
- Allocated gas of oil-rim wells is largely gas-cap gas; model it by drawdown scaling against the gas-cap
pressure, not by GOR times oil.
- Month 0 of a pull is usually partial. Exclude the current month from rates and totals.
- Hindcast honestly: tank fitted to 2020, deliverability trained to 2023, tested 2024-2026. Report the
bias per year; monthly errors are dominated by outages that on-stream hours do not capture.
- Comparing options (a well swap, a tie-back, a host change): (1) put every option on one calendar
- a surrogate that starts both routes in the same year hides the years a template delays the gas
(it flipped a separate-compartment NPV from -0.5 to -1.0 GNOK). (2) Decompose a bundled proposal
into its parts (an extra well on a shared tank is acceleration worth about +1 GNOK; the tie-back
that carries it can cost about -1 GNOK) and value each alone; the sum hides which part pays.
(3) A well-count cap on "extra wells" must be read against the base project's own wells; a cap of a
few MSm3/d silently removes the whole project. Give capacity as MSm3/d for all wells at that host,
sized to the planned wells. (4) Check that the stated base case and the code agree (a notes table
said f = 0.8 while the headline run used f = 1.0); run both and say which one the headline uses.
(5) Check a flowline dP assumption against a real hydraulic run at the actual well rate and host
pressure. For a 320 m riser in wet gas the gas-only head is about 1 bar, but Beggs and Brill adds
2-3 bar of condensate holdup; treat that as an upper bound and cross-check with OLGA.
Validation Checklist
Run python -m pytest in the skill folder. For a real study, validate the tank against held-out
shut-in pressures, the wells against a hold-out period, and the facility curve against the process
model at two operating points.
Limitations
- Screening layer: dry-gas Kay's-rule properties, a single tank per compartment and a quadratic flowline drop.
- Facility numbers come from process-model sweeps; the receiving terminal is not modelled unless asked.
- Monthly errors are dominated by outages that on-stream hours do not capture.
- Built from the Troll chain; other fields need their own data checks.
- The time horizon is an input; cap it at the earliest unmitigated life limiter of the host and its risers/pipelines from
neqsim-ageing-life-extension-screening rather than assuming a field life.
Related
neqsim-integrated-production-and-lifecycle, neqsim-capacity-and-utilization-analysis,
neqsim-production-optimization, neqsim-reservoir-model-builder, neqsim-near-well-and-injectivity,
neqsim-ncs-value-chain-optimization, neqsim-optimization-and-doe.
References
- Rawlins, E.L. and Schellhardt, M.A. (1935), Back-Pressure Data on Natural Gas Wells and Their Application to Production Practices, US Bureau of Mines Monograph 7.
- Dranchuk, P.M. and Abou-Kassem, J.H. (1975), Calculation of Z factors for natural gases using equations of state, J. Can. Pet. Technol. 14(3).
- NeqSim
neqsim.process.fielddevelopment.integrated classes named in the method table.
1---2name: neqsim-reservoir-facility-value-chain3calculation_basis: "screening"4version: "0.1.0"5description: "History-match and forecast a gas chain from reservoir to export: p/z tank from shut-in wellhead pressure, well deliverability, facility capacity from process-model sweeps, separation pressure at the supply/capacity crossing, multi-field export coupling, scenarios, P10/P90. USE WHEN: linking reservoir depletion to a platform or export system, history matching, finding whether wells or facility limit production, or valuing compression and well levers."6last_verified: "2026-10-07"7requires:8 python_packages: []9 java_packages: []10 env: []11 network: []12metadata:13 source: https://skillmd.com/skills/equinor/neqsim-reservoir-facility-value-chain14---1516# Reservoir-to-Facility Gas Value Chain1718Screening workflow that couples a reservoir tank, well deliverability and a facility capacity curve,19so one model answers "who limits production now, and when does that change?". It was built for the20Troll A/B/C to Kollsnes chain (Troll East, Troll West gas province, Troll B and C oil rims) and is21field-agnostic. Use NeqSim process models (ProcessSystem, ProcessModel) for the facility numbers and22NeqSim `SimpleReservoir` or OPM Flow when a 3D reservoir model exists; this skill is the fast layer23between them.2425## When to Use2627- Reservoir depletion must be linked to a platform or export system in one model.28- A gas field needs a history match from shut-in wellhead pressure and allocated volumes.29- The question is whether wells or the facility limit production, and when that changes.30- Compression or well levers must be valued against a forecast.3132## Inputs3334- Monthly allocated volumes per wellbore and a daily sample with WHP, choke and on-stream hours.35- Gas composition, reservoir temperature, TVD for the static column.36- A facility throughput sweep at several separation pressures (utilisation versus rate).37- Flowline pressure drop at a reference rate, and the export arrival pressure.3839## Outputs4041- Tank parameters (p/z_i, GIIP) and the fitted well law per well group.42- Facility capacity versus separation pressure, the best separation pressure and the binding side (SUPPLY or FACILITY) per month.43- Scenario comparison and P10/P90 from bootstrap and parameter sampling.4445## Engineering Method4647| Step | Python (this skill) | NeqSim Java (`neqsim.process.fielddevelopment.integrated`) |48|------|---------------------|-------------------------------------------------------------|49| Shut-in WHP to reservoir pressure | `static_bottomhole_pressure` | `MaterialBalanceHistoryMatch.staticBottomholePressure` |50| p/z line, GIIP, outlier rejection | `fit_pz_line` | `MaterialBalanceHistoryMatch.fitPzLine` |51| Real-gas p/z tank | `GasTank` | `RealGasMaterialBalanceDrive` + `DranchukAbouKassemZ` |52| Well law q = C (pr^2 - pwh^2)^n | `RSDeliverability.fit` | `RawlinsSchellhardtFit`, `WellDeliverabilityCurve.fromRawlinsSchellhardt` |53| Facility capacity from sweep | `capacity_from_sweep`, `PressureCapacityCurve` | `SupplyCapacityBalance.PressureCapacityCurve` |54| Best separation pressure | `maximise_rate` | `SupplyCapacityBalance.maximiseRate` |5556## Workflow57581. **Data.** Monthly allocated volumes per wellbore and a daily sample (a few days every 6 months) with59 WHP, choke, on-stream hours. Pull per year with retries and check month coverage per facility:60 a 5-year query window can time out and silently return zero rows.612. **Tank.** Use shut-in WHP (on-stream hours = 0, WHP above ~20 barg, per-window maximum or upper62 quartile) as the pressure proxy. Convert with the static column, fit p/z against cumulative gas,63 reject outliers (single-well, recently shut-in). Check that the intercept is a sane initial pressure64 and that two compartments with the same gas give similar p/z_i.653. **Wells.** Fit the Rawlins-Schellhardt law on rows with the choke wide open only. Early-life rates are66 choke-controlled and give nonsense (negative quadratic term, R2 below 0). Keep n between 0.5 and 1.0;67 a short window can return n above 1, so fix n from a longer-record neighbour and refit C. Always68 hold out the latest 2-3 years.694. **Equivalent wells.** Wells on stream = sum of on-stream hours / (24 x days in month). Do not use the70 well count from the register; subsea templates ramp up and wells cycle.715. **Facility.** Run the platform process model over a throughput grid at several separation pressures72 (`throughput_sweep`). Capacity is where first-constraint utilisation reaches 1.073 (`capacity_from_sweep`). Utilisation above 1.0 at every rate means a head or speed limit that does74 not depend on flow, so that pressure is below the facility floor. Scale capacity with polytropic75 head when the discharge or export pressure changes.766. **Balance.** Wellhead pressure is the separation pressure plus a flowline drop that scales with77 rate squared. Solve `q = rate(Ps + dp (q/q0)^2)` by bisection (`flow_balance`); fixed-point iteration78 oscillates and can collapse to zero. Choose Ps with `maximise_rate`; the binding side (SUPPLY or79 FACILITY) is the headline result, per month.807. **Export coupling.** Several fields feeding one export line raise the discharge pressure through81 P_man^2 = P_arr^2 + K q_total^2 (K from one measured point). The arrival pressure is an input;82 the receiving terminal is not modelled unless asked.838. **Scenarios and uncertainty.** Fixed versus optimised Ps, extra low-pressure compression (extra84 capacity and a lower Ps floor), extra wells, capacity upgrades. Bootstrap the p/z points and refit85 (p/z_i and GIIP jointly), sample the deliverability exponent, well performance and capacity.8687## Python Usage Pattern8889```python90from reservoir_facility_value_chain import (91 Gas, GasTank, PressureCapacityCurve, RSDeliverability, maximise_rate, static_bottomhole_pressure)9293gas = Gas({"C1": 0.92, "C2": 0.04, "CO2": 0.02, "N2": 0.02})94pr_now = static_bottomhole_pressure(whp_barg=220.0, gas=gas, tvd_m=1500.0, t_mean_k=330.0)95tank = GasTank(gas=gas, t_res_k=345.0, pz_i=300.0, giip=1.0e11)96pr = tank.pressure(cum=2.0e10) # reservoir pressure after 2e10 Sm397wells = RSDeliverability.fit([320, 300, 280, 260], [200, 180, 160, 140], [9.0, 8.0, 7.5, 6.0])98capacity = PressureCapacityCurve([60, 70, 80], [30.0, 36.0, 41.0]) # from the process-model sweep99ps, rate, binding = maximise_rate(lambda ps: wells.rate(pr, ps + 10.0), capacity, 60.0, 80.0)100```101102The numbers above only show the call shape; use field data and a real sweep for a study.103104## Common Mistakes (each cost a failed run)105106- **Pressure is a difference of two large numbers.** Moving GIIP by 8 % with p/z_i fixed put the107 present reservoir pressure at the wellhead pressure and the calibration became complex. Sample108 (p/z_i, GIIP) together from a bootstrap of the data, never independently.109- Oil-rim shut-in WHP is an index, not an absolute pressure (liquid column); report it as such and110 label the fitted GIIP "effective".111- Allocated gas of oil-rim wells is largely gas-cap gas; model it by drawdown scaling against the gas-cap112 pressure, not by GOR times oil.113- Month 0 of a pull is usually partial. Exclude the current month from rates and totals.114- Hindcast honestly: tank fitted to 2020, deliverability trained to 2023, tested 2024-2026. Report the115 bias per year; monthly errors are dominated by outages that on-stream hours do not capture.116- **Comparing options (a well swap, a tie-back, a host change):** (1) put every option on one calendar117 - a surrogate that starts both routes in the same year hides the years a template delays the gas118 (it flipped a separate-compartment NPV from -0.5 to -1.0 GNOK). (2) Decompose a bundled proposal119 into its parts (an extra well on a shared tank is acceleration worth about +1 GNOK; the tie-back120 that carries it can cost about -1 GNOK) and value each alone; the sum hides which part pays.121 (3) A well-count cap on "extra wells" must be read against the base project's own wells; a cap of a122 few MSm3/d silently removes the whole project. Give capacity as MSm3/d for all wells at that host,123 sized to the planned wells. (4) Check that the stated base case and the code agree (a notes table124 said f = 0.8 while the headline run used f = 1.0); run both and say which one the headline uses.125 (5) Check a flowline dP assumption against a real hydraulic run at the actual well rate and host126 pressure. For a 320 m riser in wet gas the gas-only head is about 1 bar, but Beggs and Brill adds127 2-3 bar of condensate holdup; treat that as an upper bound and cross-check with OLGA.128129## Validation Checklist130131Run `python -m pytest` in the skill folder. For a real study, validate the tank against held-out132shut-in pressures, the wells against a hold-out period, and the facility curve against the process133model at two operating points.134135- [ ] The p/z intercept gives a sane initial pressure and two compartments with the same gas give similar p/z_i.136- [ ] The deliverability exponent n lies between 0.5 and 1.0 and the fit uses choke-wide-open rows only.137- [ ] The latest 2-3 years are held out and the bias per year is reported.138- [ ] Every compared option uses one calendar and the stated base case matches the code.139140## Limitations141142- Screening layer: dry-gas Kay's-rule properties, a single tank per compartment and a quadratic flowline drop.143- Facility numbers come from process-model sweeps; the receiving terminal is not modelled unless asked.144- Monthly errors are dominated by outages that on-stream hours do not capture.145- Built from the Troll chain; other fields need their own data checks.146- The time horizon is an input; cap it at the earliest unmitigated life limiter of the host and its risers/pipelines from `neqsim-ageing-life-extension-screening` rather than assuming a field life.147148## Related149150`neqsim-integrated-production-and-lifecycle`, `neqsim-capacity-and-utilization-analysis`,151`neqsim-production-optimization`, `neqsim-reservoir-model-builder`, `neqsim-near-well-and-injectivity`,152`neqsim-ncs-value-chain-optimization`, `neqsim-optimization-and-doe`.153154## References155156- Rawlins, E.L. and Schellhardt, M.A. (1935), Back-Pressure Data on Natural Gas Wells and Their Application to Production Practices, US Bureau of Mines Monograph 7.157- Dranchuk, P.M. and Abou-Kassem, J.H. (1975), Calculation of Z factors for natural gases using equations of state, J. Can. Pet. Technol. 14(3).158- NeqSim `neqsim.process.fielddevelopment.integrated` classes named in the method table.