Norwegian Continental Shelf Reference Data
Use this skill to load a bundled, source-attributed snapshot of public
Norwegian Continental Shelf (NCS) facts and run screening-level analysis of
production, resources, and the field inventory. The data is sourced from
norskpetroleum.no (Norwegian Petroleum,
run by the Norwegian Ministry of Energy and the Norwegian Offshore Directorate)
and the Norwegian Offshore Directorate (Sodir, formerly NPD) FactPages, which
publish open, reusable-with-attribution data about NCS activity.
The skill ships a curated public seed (headline national KPIs, a resource
accounting split, sea areas, and a qualitative inventory of major fields) plus a
tolerant ingestion path for the official Sodir yearly saleable-production CSV
exports, so a full production time series and per-field figures can be refreshed
without changing any code. All content is public; no proprietary or confidential
data is included. It is a data and screening-analysis skill, not a reservoir
simulator — quantitative production forecasting must use the validated NeqSim
SimpleReservoir / runReservoir workflows.
When to Use
- When a task needs quick, offline, source-attributed NCS facts (production,
resources, exports, field counts) to frame an analysis.
- When building a production, resource-accounting, or field-inventory study of
the Norwegian shelf and you want a normalized schema plus an ingestion path
for the official Sodir/norskpetroleum.no tables.
- When an agent needs an upstream "NCS context" feed before a validated NeqSim
reservoir-depletion, production-routing, or asset-economics screening.
- When a task needs the public Norwegian carbon-cost basis (CO2 Tax Act rates,
EU ETS allowance cost, NOx Fund contribution) or a first-pass economic
screening of an emission-abatement measure (power-from-shore, waste-heat
recovery, compressor upgrade, flaring reduction) before a validated NeqSim
energy/combustion model and a qualified commercial review.
- When a task needs a screening production forecast: fit an Arps decline
(exponential/hyperbolic/harmonic) to a produced-rate series and project a
forward rate profile, remaining volume, and EUR to an economic-limit rate,
before a validated NeqSim reservoir forecast.
Inputs
- No inputs are required to load the bundled public seed.
NcsDataset.list_fields(...): optional filters sea_area, main_product
(oil/gas), status, operator.
NcsDataset.ingest_annual_production(rows): iterable of dicts with year and
either oe_mill_sm3 or component volumes (oil_mill_sm3, gas_bill_sm3,
ngl_mill_sm3_oe, condensate_mill_sm3).
NcsDataset.ingest_sodir_production_csv(path): local path to a Sodir yearly
saleable-production CSV export (read locally, no network).
NcsDataset.ingest_field_reserves(rows) / ingest_sodir_field_reserves_csv(path):
overlay per-field recoverable/remaining/produced oil-equivalent volumes from
parsed rows or a local Sodir field-reserves CSV export.
NcsDataset.ngl_tonne_to_sm3_oe(tonnes): NGL mass to o.e. (1 tonne = 1.9 Sm3 o.e.).
carbon_cost_basis(year=None): public Norwegian carbon-cost rates for a year
(default: latest known); falls back to the most recent earlier published year.
annual_carbon_cost(co2_tonnes_per_year=..., nox_tonnes_per_year=0.0, year=None, use_combined_co2_cost=True): screening annual carbon cost (NOK/year).
abatement_screening(measure=..., fuel_gas_avoided_sm3_per_year=... OR co2_avoided_tonnes_per_year=..., capex_nok=..., added_energy_cost_nok_per_year=0.0, gas_price_nok_per_sm3=0.0, horizon_years=15, discount_rate=0.08): NPV, simple
payback, and breakeven CO2 price of an emission-reduction measure.
combustion_co2_tonnes(fuel_gas_sm3_per_year) / emission_source_split(2024).
fit_arps_decline(series, from_peak=True): fit an Arps decline model to a
(time, rate) produced-rate series (best of exponential/hyperbolic/harmonic).
forecast_production(fit, economic_limit_rate=..., start_time=None, max_years=50.0, timestep_years=1.0, cumulative_to_date=None): forward rate
profile, remaining volume, years-to-limit, and EUR.
sodir_download_plan() / refresh_instructions(): offline refresh helper
(returns official download URLs + ingestion routing; no network access).
resource_remaining(total_billion_sm3_oe, produced_fraction, latest_annual_oe_mill_sm3=None).
production_trend(series), production_share(record).
Outputs
national_summary() / national_kpi(key): headline KPIs, each with value,
unit, reference year, note, and source_url.
resource_accounting(): total resources and produced/remaining fractions.
list_fields(), find_field(), field_counts(): field inventory queries and
aggregations by sea area, product, and status.
- Per-field
recoverable_oe_mill_sm3, remaining_oe_mill_sm3, and
cumulative_produced_oe_mill_sm3 on each NcsField (populated by ingestion),
with rank_fields_by_remaining() and remaining_reserves_by_area().
annual_production() / production_for_year(year): the annual o.e. series
(seed plus anything ingested).
resource_remaining(...): produced/remaining volumes, remaining fraction, and
a static reserves-to-production (R/P) horizon in years.
production_share(record): oil/gas/NGL/condensate share of total o.e.
production_trend(series): first-to-last change, CAGR, and rising/falling/flat.
fields_started_by_decade(fields): field starts grouped by decade.
carbon_cost_basis(year): a CarbonCostBasis with the CO2 tax (per Sm3 gas,
per litre oil, per tonne CO2), gas-venting tax, EU ETS allowance cost, combined
effective CO2 cost, NOx Fund rate, and the public gas combustion factor, each
with source_url and attribution.
annual_carbon_cost(...): a CarbonCost with the CO2 tax, EU ETS, combined,
and NOx components plus the total NOK/year.
abatement_screening(...): an AbatementScreening with avoided carbon cost,
avoided fuel value, added energy cost, net annual saving, simple payback,
discounted NPV, breakeven CO2 price, a verdict, and stated assumptions.
POWER_FROM_SHORE_FIELDS, CO2_SOURCE_SPLIT_2024, GAS_CO2_FACTOR_KG_PER_SM3:
bundled public context constants.
fit_arps_decline(...): an ArpsFit with the model name, b-exponent, initial
rate, nominal decline rate (1/year), R-squared, and peak time.
forecast_production(...): a ProductionForecast with the forward (time, rate) profile, remaining volume, years-to-economic-limit, cumulative-to-date,
and estimated ultimate recovery (EUR), with stated assumptions.
Engineering Method
The bundled seed encodes published headline NCS figures (e.g. 129 fields since
1971 with 97 in production at year-end 2025, 239.2 mill Sm3 o.e. produced in
2025 with more than half gas, and total resources of 15.6 billion Sm3 o.e. of
which 56 % has been produced/sold/delivered), each carrying its own reference
year and source URL. Oil-equivalent aggregation uses the standard NCS convention
1 Sm3 o.e. = 1000 Sm3 gas, so gas in billion Sm3 equals million Sm3 o.e., with
NGL and condensate taken as already in million Sm3 o.e. Resource remaining is a
simple split of the published total by the produced fraction; the R/P horizon is
a static ratio of remaining volume to the latest annual rate, not a forecast.
Production trend and share are descriptive statistics over the (seeded or
ingested) annual series.
This skill performs no reservoir, PVT, or hydraulic physics. It is a transparent
public data layer and screening calculator that must be paired with validated
NeqSim workflows for any quantitative production or forecasting use.
Python Usage Pattern
from norwegian_continental_shelf_data import (
load_dataset, resource_remaining, production_share,
)
ds = load_dataset()
print(ds.attribution) # required attribution string
prod = ds.national_kpi("annual_production_oe")
print(prod["value"], prod["unit"], prod["as_of_year"], prod["source_url"])
ra = ds.resource_accounting()
remaining = resource_remaining(
total_billion_sm3_oe=ra["total_petroleum_resources"]["value"],
produced_fraction=ra["produced_sold_delivered_fraction"]["value"],
latest_annual_oe_mill_sm3=prod["value"],
)
print(remaining.remaining_billion_sm3_oe, remaining.reserve_to_production_years)
# Field inventory queries
barents = ds.list_fields(sea_area="barents_sea")
print(ds.field_counts())
# Refresh the full production series from an official Sodir CSV export
# ds.ingest_sodir_production_csv("table_production_saleable_yearly.csv")
# Populate per-field reserves from the official Sodir field-reserves export
# ds.ingest_sodir_field_reserves_csv("field_reserves.csv")
# from norwegian_continental_shelf_data import rank_fields_by_remaining
# top = rank_fields_by_remaining(ds.fields(), top=5)
# Offline refresh plan (URLs + which ingest method to use); no network access
from norwegian_continental_shelf_data import sodir_download_plan
for target in sodir_download_plan():
print(target.dataset, target.factpages_page_url, target.ingest_with)
# Norwegian carbon-cost basis and an emission-abatement screening
from norwegian_continental_shelf_data import (
carbon_cost_basis, abatement_screening,
)
basis = carbon_cost_basis(2025)
print(basis.co2_tax_nok_per_tonne_co2, basis.combined_co2_nok_per_tonne) # 944, 1825
screen = abatement_screening(
measure="Waste-heat recovery on GT exhaust",
fuel_gas_avoided_sm3_per_year=20_000_000.0, # fuel gas no longer burnt
capex_nok=300_000_000.0,
gas_price_nok_per_sm3=2.0,
horizon_years=15,
discount_rate=0.08,
year=2025,
)
print(screen.co2_avoided_tonnes_per_year, screen.simple_payback_years,
screen.npv_nok, screen.verdict)
# Screening production forecast: fit an Arps decline and project forward
from norwegian_continental_shelf_data import (
fit_arps_decline, forecast_production,
)
series = [(0.0, 100.0), (1.0, 86.0), (2.0, 74.0), (3.0, 63.5), (4.0, 54.6)]
fit = fit_arps_decline(series) # exponential/hyperbolic/harmonic
fc = forecast_production(
fit, economic_limit_rate=10.0, max_years=40.0, cumulative_to_date=500.0,
)
print(fit.model, fit.decline_rate_per_year, fit.r_squared)
print(fc.years_to_limit, fc.remaining_volume, fc.estimated_ultimate_recovery)
Data Refresh
The seed is a snapshot. To load the full, current dataset:
- Download the official yearly production and field tables from the
norskpetroleum.no quick-downloads page
or the Sodir FactPages CSV exports. Use
sodir_download_plan() / refresh_instructions() for the entry points and
the matching ingestion method (offline; it only builds URLs).
- Ingest with
NcsDataset.ingest_sodir_production_csv(path) (yearly
production), NcsDataset.ingest_sodir_field_reserves_csv(path) (per-field
recoverable/remaining reserves), or NcsDataset.ingest_annual_production(rows)
/ ingest_field_reserves(rows) (parsed rows).
- Always keep the source attribution and reference year with any reused figure.
Validated NeqSim Path
This skill supplies public data; it does not forecast production. For
quantitative NCS production analysis use:
- NeqSim
SimpleReservoir (neqsim.process.processTools.simplereservoir) with
gas/oil/water producers and a runTransient(deltat) time loop, and the NeqSim
MCP runReservoir tool for reservoir-versus-time behaviour.
- The community
reservoir-depletion-screening and production-network-routing
skills for a screening reservoir/production chain seeded with these facts.
- The community
asset-value-npv-screening and energy-emissions-screening
skills to turn a production profile into value and emissions screening.
Neighbouring discoveries
Analogue volumes above come from discoveries, but for the area around one target use
neqsim-near-field-discoveries: status, operator, recoverable volumes and resource class, concept text and
nearest hosts for every discovery inside a radius, with a map and GeoJSON export.
Validation Checklist
Common Mistakes
| Symptom |
Cause |
Fix |
| Stale numbers |
Using only the bundled seed |
Ingest current Sodir/norskpetroleum.no tables |
| Wrong o.e. total |
Mixing gas units |
Gas in billion Sm3 equals million Sm3 o.e.; keep units consistent |
| Over-reading a field record |
Treating operator/status as current truth |
Re-verify per-field data against FactPages |
| Forecasting from R/P |
Reading the static R/P ratio as a forecast |
Use NeqSim SimpleReservoir / runReservoir |
| Undrilled licence or prospect has no data |
Looking in the field tables |
Read the neighbourhood from the Sodir FactMaps FeatureServer (below) |
Reading the neighbourhood of an undrilled licence or prospect (Sodir FactMaps)
Base https://factmaps.sodir.no/api/rest/services/Factmaps/FactMapsWGS84/FeatureServer/<layer>/query
with f=json&outSR=4326&returnGeometry=true and an envelope (geometry, geometryType=esriGeometryEnvelope,
spatialRel=esriSpatialRelIntersects). Layers: 616 licence (filter prlName='<number>'; TFO licences use the bare number),
304 facilities in place, 311 pipelines, 503 discoveries, 502 fields, 204 exploration wellbores, 201 all wellbores;
tables: 532 discovery reserves (join on dscNpdidDiscovery), 515 field reserves, 651 licence phases, 652 licence tasks.
The DataService MapServer (https://factmaps.sodir.no/api/rest/services/DataService/Data/MapServer/<id>/query) is the easier
entry for lists: facilities 6000, pipelines 6100, discoveries 7000, fields 7100.
- Facility geometry is a point (
x,y); discoveries and fields are polygons: take the minimum vertex distance, not a centroid.
- A prospect has no public volume or coordinates: use the licence polygon and a declared prior location, and report a distance
distribution to each candidate host instead of one number.
- Analogue volumes: join hosting discoveries/fields to table 532/515 recoverable volumes and fit a lognormal to the nonzero
values. State the survivor bias: analogues are discoveries.
- Formation filter: use equality, never LIKE (
wlbFormationWithHc1='LANGE FM' OR ...); a LIKE query can return an empty response.
- Geotherm: regress
wlbBottomHoleTemperature on wlbFinalVerticalDepth; BHT is a drilling temperature, so it is a lower bound
of formation temperature. Sodir has no formation pressure for an undrilled prospect: declare an EMW range instead.
- Step-out precedent: layer 205 (development wellbores) grouped on
wlbDrillingFacility, upper bound sqrt(MD^2 - TVD^2).
- The pipeline layer (311) holds trunklines only; infield line lengths are straight-line estimates to be confirmed.
- Yearly production: the factpages table view
field_production_yearly as CSV works; field names can arrive with an encoding
artefact for Oe/Ae/Aa, so decode as UTF-8 and compare diacritic-folded.
- Never turn an unnamed brief item into a Sodir field of the same name; record it as a data gap.
- A wildcat just completed in the licence (
wlbContent empty) has no public result yet: record an evidence gap, never infer the outcome.
- Operator and partner shares come from
OwnershipReader; licence operator and field operator can differ.
Limitations
- Educational public data layer and screening calculator only; not a validated
design or forecasting method.
- The bundled seed is a curated headline snapshot; per-field production/reserves
and the full annual series require ingesting official exports.
- No reservoir, PVT, hydraulic, or economic physics is performed.
- No confidential or proprietary data is included; attribution to
norskpetroleum.no / the Norwegian Offshore Directorate is required for reuse.
- The carbon-cost basis carries a small set of published annual rates; the
abatement screening is a transparent single-measure cash-flow calculation, not
a certified emission inventory, a marginal-abatement-cost curve, or a validated
energy model. It does not replace, and human review is required before, any
investment or emission-reduction decision.
- The Arps decline forecast is a transparent empirical curve fit to a produced
-rate series; it is not a reservoir simulator or a material-balance model and
does not capture drive mechanism, aquifer, or infill effects. Use validated
NeqSim
SimpleReservoir / runReservoir for quantitative forecasting.
Related NeqSim Functionality
- Other Sodir layers (wellbores, DST, tops, licences, surveys, CO2, FactPages CSV, bulk files): use
neqsim-sodir-open-data for the full catalog, recipes and traps before writing a new reader.
This skill supplies and renders public data; it feeds downstream NeqSim
workflows rather than running calculations itself:
- NeqSim Java:
neqsim.process.processTools.simplereservoir.SimpleReservoir
(runTransient) for reservoir-versus-time production, and
neqsim.process.equipment.pipeline.PipeBeggsAndBrills for flowline/riser
hydraulics downstream of the reservoir.
- NeqSim MCP tools:
runReservoir, runPipeline, runProcess,
runFieldEconomics.
- Reached from Python via
from neqsim import jneqsim (or the devtools setup).
- Community companions:
reservoir-depletion-screening,
production-network-routing, asset-value-npv-screening,
energy-emissions-screening.
- Whole-shelf system questions (which fields share which pipelines, plants and
terminals; bottlenecks; outages; shelf-wide optimisation) go to
neqsim-ncs-infrastructure-network and neqsim-ncs-value-chain-optimization.
The optimiser reuses this skill's fit_arps_decline for its field forecasts.
References
1---2name: neqsim-norwegian-continental-shelf-data-23calculation_basis: "screening"4version: "0.4.0"5description: "Public Norwegian Continental Shelf reference facts, carbon-cost basis, Arps decline forecasting and screening analysis. USE WHEN: a task needs offline, source-attributed NCS production, resource, field, carbon-cost/abatement or decline-forecast facts (norskpetroleum.no / Sodir FactPages) to orient a production, resource-accounting, field-inventory, emission-reduction or forecast screening before a validated NeqSim study."6last_verified: "2026-07-13"7requires:8 python_packages: []9 java_packages: []10 env: []11 network: []12metadata:13 source: https://skillmd.com/skills/equinor/neqsim-norwegian-continental-shelf-data-214---1516# Norwegian Continental Shelf Reference Data1718Use this skill to load a bundled, source-attributed snapshot of public19Norwegian Continental Shelf (NCS) facts and run screening-level analysis of20production, resources, and the field inventory. The data is sourced from21[norskpetroleum.no](https://www.norskpetroleum.no/en/) (Norwegian Petroleum,22run by the Norwegian Ministry of Energy and the Norwegian Offshore Directorate)23and the Norwegian Offshore Directorate (Sodir, formerly NPD) FactPages, which24publish open, reusable-with-attribution data about NCS activity.2526The skill ships a curated **public seed** (headline national KPIs, a resource27accounting split, sea areas, and a qualitative inventory of major fields) plus a28tolerant ingestion path for the official Sodir yearly saleable-production CSV29exports, so a full production time series and per-field figures can be refreshed30without changing any code. All content is public; no proprietary or confidential31data is included. It is a data and screening-analysis skill, not a reservoir32simulator — quantitative production forecasting must use the validated NeqSim33`SimpleReservoir` / `runReservoir` workflows.3435## When to Use3637- When a task needs quick, offline, source-attributed NCS facts (production,38 resources, exports, field counts) to frame an analysis.39- When building a production, resource-accounting, or field-inventory study of40 the Norwegian shelf and you want a normalized schema plus an ingestion path41 for the official Sodir/norskpetroleum.no tables.42- When an agent needs an upstream "NCS context" feed before a validated NeqSim43 reservoir-depletion, production-routing, or asset-economics screening.44- When a task needs the public Norwegian carbon-cost basis (CO2 Tax Act rates,45 EU ETS allowance cost, NOx Fund contribution) or a first-pass economic46 screening of an emission-abatement measure (power-from-shore, waste-heat47 recovery, compressor upgrade, flaring reduction) before a validated NeqSim48 energy/combustion model and a qualified commercial review.49- When a task needs a screening production forecast: fit an Arps decline50 (exponential/hyperbolic/harmonic) to a produced-rate series and project a51 forward rate profile, remaining volume, and EUR to an economic-limit rate,52 before a validated NeqSim reservoir forecast.5354## Inputs5556- No inputs are required to load the bundled public seed.57- `NcsDataset.list_fields(...)`: optional filters `sea_area`, `main_product`58 (`oil`/`gas`), `status`, `operator`.59- `NcsDataset.ingest_annual_production(rows)`: iterable of dicts with `year` and60 either `oe_mill_sm3` or component volumes (`oil_mill_sm3`, `gas_bill_sm3`,61 `ngl_mill_sm3_oe`, `condensate_mill_sm3`).62- `NcsDataset.ingest_sodir_production_csv(path)`: local path to a Sodir yearly63 saleable-production CSV export (read locally, no network).64- `NcsDataset.ingest_field_reserves(rows)` / `ingest_sodir_field_reserves_csv(path)`:65 overlay per-field recoverable/remaining/produced oil-equivalent volumes from66 parsed rows or a local Sodir field-reserves CSV export.67- `NcsDataset.ngl_tonne_to_sm3_oe(tonnes)`: NGL mass to o.e. (1 tonne = 1.9 Sm3 o.e.).68- `carbon_cost_basis(year=None)`: public Norwegian carbon-cost rates for a year69 (default: latest known); falls back to the most recent earlier published year.70- `annual_carbon_cost(co2_tonnes_per_year=..., nox_tonnes_per_year=0.0, year=None,71 use_combined_co2_cost=True)`: screening annual carbon cost (NOK/year).72- `abatement_screening(measure=..., fuel_gas_avoided_sm3_per_year=... OR73 co2_avoided_tonnes_per_year=..., capex_nok=..., added_energy_cost_nok_per_year=0.0,74 gas_price_nok_per_sm3=0.0, horizon_years=15, discount_rate=0.08)`: NPV, simple75 payback, and breakeven CO2 price of an emission-reduction measure.76- `combustion_co2_tonnes(fuel_gas_sm3_per_year)` / `emission_source_split(2024)`.77- `fit_arps_decline(series, from_peak=True)`: fit an Arps decline model to a78 `(time, rate)` produced-rate series (best of exponential/hyperbolic/harmonic).79- `forecast_production(fit, economic_limit_rate=..., start_time=None,80 max_years=50.0, timestep_years=1.0, cumulative_to_date=None)`: forward rate81 profile, remaining volume, years-to-limit, and EUR.82- `sodir_download_plan()` / `refresh_instructions()`: offline refresh helper83 (returns official download URLs + ingestion routing; no network access).84- `resource_remaining(total_billion_sm3_oe, produced_fraction, latest_annual_oe_mill_sm3=None)`.85- `production_trend(series)`, `production_share(record)`.8687## Outputs8889- `national_summary()` / `national_kpi(key)`: headline KPIs, each with value,90 unit, reference year, note, and `source_url`.91- `resource_accounting()`: total resources and produced/remaining fractions.92- `list_fields()`, `find_field()`, `field_counts()`: field inventory queries and93 aggregations by sea area, product, and status.94- Per-field `recoverable_oe_mill_sm3`, `remaining_oe_mill_sm3`, and95 `cumulative_produced_oe_mill_sm3` on each `NcsField` (populated by ingestion),96 with `rank_fields_by_remaining()` and `remaining_reserves_by_area()`.97- `annual_production()` / `production_for_year(year)`: the annual o.e. series98 (seed plus anything ingested).99- `resource_remaining(...)`: produced/remaining volumes, remaining fraction, and100 a static reserves-to-production (R/P) horizon in years.101- `production_share(record)`: oil/gas/NGL/condensate share of total o.e.102- `production_trend(series)`: first-to-last change, CAGR, and rising/falling/flat.103- `fields_started_by_decade(fields)`: field starts grouped by decade.104- `carbon_cost_basis(year)`: a `CarbonCostBasis` with the CO2 tax (per Sm3 gas,105 per litre oil, per tonne CO2), gas-venting tax, EU ETS allowance cost, combined106 effective CO2 cost, NOx Fund rate, and the public gas combustion factor, each107 with `source_url` and attribution.108- `annual_carbon_cost(...)`: a `CarbonCost` with the CO2 tax, EU ETS, combined,109 and NOx components plus the total NOK/year.110- `abatement_screening(...)`: an `AbatementScreening` with avoided carbon cost,111 avoided fuel value, added energy cost, net annual saving, simple payback,112 discounted NPV, breakeven CO2 price, a verdict, and stated assumptions.113- `POWER_FROM_SHORE_FIELDS`, `CO2_SOURCE_SPLIT_2024`, `GAS_CO2_FACTOR_KG_PER_SM3`:114 bundled public context constants.115- `fit_arps_decline(...)`: an `ArpsFit` with the model name, b-exponent, initial116 rate, nominal decline rate (1/year), R-squared, and peak time.117- `forecast_production(...)`: a `ProductionForecast` with the forward `(time,118 rate)` profile, remaining volume, years-to-economic-limit, cumulative-to-date,119 and estimated ultimate recovery (EUR), with stated assumptions.120121## Engineering Method122123The bundled seed encodes published headline NCS figures (e.g. 129 fields since1241971 with 97 in production at year-end 2025, 239.2 mill Sm3 o.e. produced in1252025 with more than half gas, and total resources of 15.6 billion Sm3 o.e. of126which 56 % has been produced/sold/delivered), each carrying its own reference127year and source URL. Oil-equivalent aggregation uses the standard NCS convention128`1 Sm3 o.e. = 1000 Sm3 gas`, so gas in billion Sm3 equals million Sm3 o.e., with129NGL and condensate taken as already in million Sm3 o.e. Resource remaining is a130simple split of the published total by the produced fraction; the R/P horizon is131a static ratio of remaining volume to the latest annual rate, not a forecast.132Production trend and share are descriptive statistics over the (seeded or133ingested) annual series.134135This skill performs no reservoir, PVT, or hydraulic physics. It is a transparent136public data layer and screening calculator that must be paired with validated137NeqSim workflows for any quantitative production or forecasting use.138139## Python Usage Pattern140141```python142from norwegian_continental_shelf_data import (143 load_dataset, resource_remaining, production_share,144)145146ds = load_dataset()147print(ds.attribution) # required attribution string148prod = ds.national_kpi("annual_production_oe")149print(prod["value"], prod["unit"], prod["as_of_year"], prod["source_url"])150151ra = ds.resource_accounting()152remaining = resource_remaining(153 total_billion_sm3_oe=ra["total_petroleum_resources"]["value"],154 produced_fraction=ra["produced_sold_delivered_fraction"]["value"],155 latest_annual_oe_mill_sm3=prod["value"],156)157print(remaining.remaining_billion_sm3_oe, remaining.reserve_to_production_years)158159# Field inventory queries160barents = ds.list_fields(sea_area="barents_sea")161print(ds.field_counts())162163# Refresh the full production series from an official Sodir CSV export164# ds.ingest_sodir_production_csv("table_production_saleable_yearly.csv")165166# Populate per-field reserves from the official Sodir field-reserves export167# ds.ingest_sodir_field_reserves_csv("field_reserves.csv")168# from norwegian_continental_shelf_data import rank_fields_by_remaining169# top = rank_fields_by_remaining(ds.fields(), top=5)170171# Offline refresh plan (URLs + which ingest method to use); no network access172from norwegian_continental_shelf_data import sodir_download_plan173for target in sodir_download_plan():174 print(target.dataset, target.factpages_page_url, target.ingest_with)175176# Norwegian carbon-cost basis and an emission-abatement screening177from norwegian_continental_shelf_data import (178 carbon_cost_basis, abatement_screening,179)180basis = carbon_cost_basis(2025)181print(basis.co2_tax_nok_per_tonne_co2, basis.combined_co2_nok_per_tonne) # 944, 1825182183screen = abatement_screening(184 measure="Waste-heat recovery on GT exhaust",185 fuel_gas_avoided_sm3_per_year=20_000_000.0, # fuel gas no longer burnt186 capex_nok=300_000_000.0,187 gas_price_nok_per_sm3=2.0,188 horizon_years=15,189 discount_rate=0.08,190 year=2025,191)192print(screen.co2_avoided_tonnes_per_year, screen.simple_payback_years,193 screen.npv_nok, screen.verdict)194195# Screening production forecast: fit an Arps decline and project forward196from norwegian_continental_shelf_data import (197 fit_arps_decline, forecast_production,198)199series = [(0.0, 100.0), (1.0, 86.0), (2.0, 74.0), (3.0, 63.5), (4.0, 54.6)]200fit = fit_arps_decline(series) # exponential/hyperbolic/harmonic201fc = forecast_production(202 fit, economic_limit_rate=10.0, max_years=40.0, cumulative_to_date=500.0,203)204print(fit.model, fit.decline_rate_per_year, fit.r_squared)205print(fc.years_to_limit, fc.remaining_volume, fc.estimated_ultimate_recovery)206```207208## Data Refresh209210The seed is a snapshot. To load the full, current dataset:2112121. Download the official yearly production and field tables from the213 [norskpetroleum.no quick-downloads page](https://www.norskpetroleum.no/en/interactive-map-quick-downloads/quick-downloads/)214 or the [Sodir FactPages](https://factpages.sodir.no/) CSV exports. Use215 `sodir_download_plan()` / `refresh_instructions()` for the entry points and216 the matching ingestion method (offline; it only builds URLs).2172. Ingest with `NcsDataset.ingest_sodir_production_csv(path)` (yearly218 production), `NcsDataset.ingest_sodir_field_reserves_csv(path)` (per-field219 recoverable/remaining reserves), or `NcsDataset.ingest_annual_production(rows)`220 / `ingest_field_reserves(rows)` (parsed rows).2213. Always keep the source attribution and reference year with any reused figure.222223## Validated NeqSim Path224225This skill supplies public data; it does not forecast production. For226quantitative NCS production analysis use:227228- NeqSim `SimpleReservoir` (`neqsim.process.processTools.simplereservoir`) with229 gas/oil/water producers and a `runTransient(deltat)` time loop, and the NeqSim230 MCP `runReservoir` tool for reservoir-versus-time behaviour.231- The community `reservoir-depletion-screening` and `production-network-routing`232 skills for a screening reservoir/production chain seeded with these facts.233- The community `asset-value-npv-screening` and `energy-emissions-screening`234 skills to turn a production profile into value and emissions screening.235236## Neighbouring discoveries237238Analogue volumes above come from discoveries, but for the area around one target use239`neqsim-near-field-discoveries`: status, operator, recoverable volumes and resource class, concept text and240nearest hosts for every discovery inside a radius, with a map and GeoJSON export.241242## Validation Checklist243244- [ ] Reused figures carry the source attribution and reference year.245- [ ] Only public data is used (no proprietary or confidential sources).246- [ ] Field operator/status are treated as a snapshot and re-verified against247 Sodir FactPages before quantitative use.248- [ ] Full production series is ingested from official exports for any analysis249 beyond the headline seed.250- [ ] Quantitative production/forecasting is escalated to validated NeqSim models.251- [ ] Carbon-cost rates (CO2 tax, EU ETS, NOx Fund) are re-verified against the252 norskpetroleum.no "Emissions to air" page for the current year before use.253- [ ] Abatement screening is treated as indicative only and escalated to a254 validated NeqSim energy/combustion model and a commercial review.255256## Common Mistakes257258| Symptom | Cause | Fix |259| --- | --- | --- |260| Stale numbers | Using only the bundled seed | Ingest current Sodir/norskpetroleum.no tables |261| Wrong o.e. total | Mixing gas units | Gas in billion Sm3 equals million Sm3 o.e.; keep units consistent |262| Over-reading a field record | Treating operator/status as current truth | Re-verify per-field data against FactPages |263| Forecasting from R/P | Reading the static R/P ratio as a forecast | Use NeqSim `SimpleReservoir` / `runReservoir` |264| Undrilled licence or prospect has no data | Looking in the field tables | Read the neighbourhood from the Sodir FactMaps FeatureServer (below) |265266### Reading the neighbourhood of an undrilled licence or prospect (Sodir FactMaps)267268Base `https://factmaps.sodir.no/api/rest/services/Factmaps/FactMapsWGS84/FeatureServer/<layer>/query`269with `f=json&outSR=4326&returnGeometry=true` and an envelope (`geometry`, `geometryType=esriGeometryEnvelope`,270`spatialRel=esriSpatialRelIntersects`). Layers: 616 licence (filter `prlName='<number>'`; TFO licences use the bare number),271304 facilities in place, 311 pipelines, 503 discoveries, 502 fields, 204 exploration wellbores, 201 all wellbores;272tables: 532 discovery reserves (join on `dscNpdidDiscovery`), 515 field reserves, 651 licence phases, 652 licence tasks.273The DataService MapServer (`https://factmaps.sodir.no/api/rest/services/DataService/Data/MapServer/<id>/query`) is the easier274entry for lists: facilities 6000, pipelines 6100, discoveries 7000, fields 7100.275276- Facility geometry is a point (`x`,`y`); discoveries and fields are polygons: take the minimum vertex distance, not a centroid.277- A prospect has no public volume or coordinates: use the licence polygon and a declared prior location, and report a distance278 distribution to each candidate host instead of one number.279- Analogue volumes: join hosting discoveries/fields to table 532/515 recoverable volumes and fit a lognormal to the nonzero280 values. State the survivor bias: analogues are discoveries.281- Formation filter: use equality, never LIKE (`wlbFormationWithHc1='LANGE FM' OR ...`); a `LIKE` query can return an empty response.282- Geotherm: regress `wlbBottomHoleTemperature` on `wlbFinalVerticalDepth`; BHT is a drilling temperature, so it is a lower bound283 of formation temperature. Sodir has no formation pressure for an undrilled prospect: declare an EMW range instead.284- Step-out precedent: layer 205 (development wellbores) grouped on `wlbDrillingFacility`, upper bound `sqrt(MD^2 - TVD^2)`.285- The pipeline layer (311) holds trunklines only; infield line lengths are straight-line estimates to be confirmed.286- Yearly production: the factpages table view `field_production_yearly` as CSV works; field names can arrive with an encoding287 artefact for Oe/Ae/Aa, so decode as UTF-8 and compare diacritic-folded.288- Never turn an unnamed brief item into a Sodir field of the same name; record it as a data gap.289- A wildcat just completed in the licence (`wlbContent` empty) has no public result yet: record an evidence gap, never infer the outcome.290- Operator and partner shares come from `OwnershipReader`; licence operator and field operator can differ.291292## Limitations293294- Educational public data layer and screening calculator only; not a validated295 design or forecasting method.296- The bundled seed is a curated headline snapshot; per-field production/reserves297 and the full annual series require ingesting official exports.298- No reservoir, PVT, hydraulic, or economic physics is performed.299- No confidential or proprietary data is included; attribution to300 norskpetroleum.no / the Norwegian Offshore Directorate is required for reuse.301- The carbon-cost basis carries a small set of published annual rates; the302 abatement screening is a transparent single-measure cash-flow calculation, not303 a certified emission inventory, a marginal-abatement-cost curve, or a validated304 energy model. It does not replace, and human review is required before, any305 investment or emission-reduction decision.306- The Arps decline forecast is a transparent empirical curve fit to a produced307 -rate series; it is not a reservoir simulator or a material-balance model and308 does not capture drive mechanism, aquifer, or infill effects. Use validated309 NeqSim `SimpleReservoir` / `runReservoir` for quantitative forecasting.310311## Related NeqSim Functionality312313- **Other Sodir layers** (wellbores, DST, tops, licences, surveys, CO2, FactPages CSV, bulk files): use314 `neqsim-sodir-open-data` for the full catalog, recipes and traps before writing a new reader.315316This skill supplies and renders public data; it feeds downstream NeqSim317workflows rather than running calculations itself:318319- NeqSim Java: `neqsim.process.processTools.simplereservoir.SimpleReservoir`320 (`runTransient`) for reservoir-versus-time production, and321 `neqsim.process.equipment.pipeline.PipeBeggsAndBrills` for flowline/riser322 hydraulics downstream of the reservoir.323- NeqSim MCP tools: `runReservoir`, `runPipeline`, `runProcess`,324 `runFieldEconomics`.325- Reached from Python via `from neqsim import jneqsim` (or the devtools setup).326- Community companions: `reservoir-depletion-screening`,327 `production-network-routing`, `asset-value-npv-screening`,328 `energy-emissions-screening`.329- Whole-shelf system questions (which fields share which pipelines, plants and330 terminals; bottlenecks; outages; shelf-wide optimisation) go to331 `neqsim-ncs-infrastructure-network` and `neqsim-ncs-value-chain-optimization`.332 The optimiser reuses this skill's `fit_arps_decline` for its field forecasts.333334## References335336- Norwegian Petroleum (facts about Norwegian petroleum activities): https://www.norskpetroleum.no/en/337- Norwegian Petroleum — Fields: https://www.norskpetroleum.no/en/facts/field/338- Norwegian Petroleum — Historical production: https://www.norskpetroleum.no/en/facts/historical-production/339- Norwegian Petroleum — Petroleum resources: https://www.norskpetroleum.no/en/petroleum-resources/340- Norwegian Petroleum — Quick downloads: https://www.norskpetroleum.no/en/interactive-map-quick-downloads/quick-downloads/341- Norwegian Petroleum — Emissions to air (CO2 tax, EU ETS, NOx Fund, power from shore): https://www.norskpetroleum.no/en/environment-and-technology/emissions-to-air/342- Norwegian Offshore Directorate — Resource accounts: https://www.sodir.no/en/facts/resource-accounts/343- Norwegian Offshore Directorate FactPages: https://factpages.sodir.no/344- NeqSim repository: https://github.com/equinor/neqsim345- NeqSim Skills Guide: https://github.com/equinor/neqsim/blob/master/docs/integration/skills_guide.md