NCS Ownership and Equity
This skill answers "who owns what share of this asset?" for the Norwegian
Continental Shelf and hands the answer to field evaluation and economics. It
reads the Sodir DataService, which publishes ownership openly (NLOD 2.0), and
needs no key.
| Asset |
Public? |
How it is read |
| Field |
Yes |
Sodir field_licensee_hst (layer 7108): company, share %, owner (licence or unit), valid dates |
| Discovery |
Yes, via its owner |
Sodir discovery_owner_hst (7007) gives the owning licence or unit; that owner's licensees (3007 licence, 3304 unit) give the shares |
| Production licence |
Yes |
Sodir licence_licensee_hst (3007); operator flagged by prlOperDateValid* |
| Prospect |
No |
Not published at prospect level. Use the user's own figures, or the licence it sits in as a labelled proxy |
It is a lookup and arithmetic skill. It does not compute volumes, prices, fiscal
terms or NPV; it supplies the equity fractions those steps multiply by.
When to Use
- A field or discovery evaluation needs the partners and their working interests.
- A company wants its net share of gross volumes, revenue, capex, opex or cash flow.
- A portfolio view is needed: every field and discovery in which one company holds an interest.
- An equity assumption in a model must be checked against the public record.
- A prospect needs an equity table. The skill validates user figures or shows the licence proxy.
- Ownership changed (sale, merger, unitisation) and the history matters for a back-cast.
Inputs
OwnershipReader() reads live Sodir. Pass fetch= to run offline.
- Names resolve loosely and case-insensitively:
"Troll", "Wisting",
"7324/8-1 (Wisting)". Several matches raise OwnershipError listing the candidates.
- Production licences are named by the bare number:
reader.licence("1252") works,
"PL1252" raises no production licence named 'PL1252' (verified 2026-10-09).
as_of is a date (default today). Interests are valid from the start date to the
inclusive end date; an empty end is open.
- Companies for
portfolio() are a name or a Sodir company id. An ambiguous name
(for example two Equinor entities) raises with the ids to choose from.
Outputs
OwnershipRecord with kind, name, as_of, basis, stakes (company, id,
interest %, operator flag, valid dates), owner_kind, owner_name, operator,
included_in_field, last_updated, total_pct, is_complete and warnings.
fractions(), fraction_of(company), find(company)
allocate(gross) for every partner, net(gross, company) for one; lists or
{year: value} mappings both work
to_economics_handoff(company): equity fractions, caveats and a scaling note
portfolio_net([(record, gross), ...], company): sums a company's net over assets
OwnershipReader.history("field" | "licence", name): ownership periods, oldest first
portfolio(company, as_of): every field and discovery held, with interest %
licence_milestones(licence): the licence work obligations (drill-or-drop, decision to continue, plan for
development) with deadlines as local Europe/Oslo dates. Sodir stores a deadline as local midnight, so reading the
epoch as UTC (to_date) gives the previous day; use to_local_date for deadlines.
basis is sodir_public, licence_proxy or user_provided. Carry it into any
report so the reader knows how firm the equity is.
Engineering Method
- Resolve the name against the field or discovery layer (exact match first,
then substring); stop on ambiguity.
- Fields: read the licensee history, keep the rows valid on
as_of, take the
operator from the field operator history.
- Discoveries: read the owner history, keep the owner valid on
as_of, read
the owner id from its Sodir URL, then read that licence's or unit's licensees.
The operator comes from the discovery operator history.
- Check that the interests add up to 100 %. A shortfall is a warning, not a
silent fix.
- Apply equity by multiplying gross volumes, revenue, capex and opex by the
fraction. Tax is a per-company calculation on the net cash flow: do not scale a
gross tax figure.
Python Usage Pattern
from datetime import date
from ncs_ownership_equity import OwnershipReader, portfolio_net
reader = OwnershipReader()
alvheim = reader.field("Alvheim") # equity today
alvheim.fractions() # {'Aker BP ASA': 0.8, 'ConocoPhillips ...': 0.2}
wisting = reader.discovery("Wisting") # via licence 537
wisting.operator, wisting.is_complete
gross_capex = {2028: 12000.0, 2029: 18000.0} # MNOK, gross
wisting.net(gross_capex, "Aker BP") # Aker BP's share
# Prospect: Sodir has no prospect equity. Enter your own, or show the licence proxy.
prospect = OwnershipReader.prospect("Delta", {"Opco AS": 60, "Partner AS": 40}, operator="Opco AS",
source="licence group agreement 2026-05")
proxy = reader.prospect_from_licence("Delta", "537") # basis = licence_proxy, with a warning
# Company view: portfolio and a net cash-flow roll-up
reader.portfolio("Aker BP ASA")["items"][:5]
portfolio_net([(alvheim, alvheim_cash), (wisting, wisting_cash)], "Aker BP")
# Back-cast an earlier equity
reader.field("Alvheim", date(2019, 1, 1)).fractions()
Hand-offs
- Gross volumes and reserves:
neqsim-norwegian-continental-shelf-data and
neqsim-resource-classification-screening.
- Economics: pass
to_economics_handoff() or the net series to
neqsim-asset-value-npv-screening, neqsim-field-economics and
neqsim-capex-opex-screening.
- Tie-in and host studies:
neqsim-ncs-infrastructure-network for hosts and
routes; equity decides who carries the tariff and host costs.
- Governed internal sources (portfolio registers, signed agreements) belong to
the enterprise layer and override the public record where they differ.
Validation Checklist
Common Mistakes
- Using the licence equity for a field that has been unitised: the unit equity differs
after redetermination. Read the field, not the licence.
- Reading a discovery that is already part of a field as a standalone asset.
- Treating
sdfi_pct as extra: it sits inside a partner's share and is informational.
- Scaling a gross tax number by equity instead of taxing each company's net flow.
- Using a company name that matches two legal entities; pass the company id.
- Assuming a pending sale is in the data. Sodir shows approved transfers only.
- Presenting the licence proxy as prospect equity.
Limitations
- Sodir publishes approved ownership; announced or pending transfers, farm-in
carries, back-in rights and private side agreements are not in it.
- Prospect-level equity and cost-sharing are not public.
- Norwegian shelf only. Other provinces need their own source.
- Data currency follows Sodir's update date (
last_updated).
- Screening only: a qualified commercial review is required before any investment use.
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.
neqsim.process.fielddevelopment.economics classes (cash flow, fiscal regime) accept the
net series; equity itself is bookkeeping and has no Java counterpart.
References
- Sodir DataService (ArcGIS REST), layers 3003, 3007, 3304, 7000, 7006, 7007, 7100, 7108, 7110;
FactPages tables
field_licensee_hst, licence_licensee_hst. NLOD 2.0.
- Sodir FactPages sections: application, wellbore, storage, licence, bsns_arr_area,
field, discovery, company, survey, facility, tuf, strat (no prospect section).
1---2name: neqsim-ncs-ownership-equity3calculation_basis: "screening"4version: "0.1.0"5description: "Reads who owns Norwegian Continental Shelf fields, discoveries and licences from Sodir (partners, equity %, operator, history, company portfolio) and turns it into net-equity inputs for field evaluation and economics. Prospect equity is not public: user-supplied or a labelled licence proxy. USE WHEN: an evaluation needs partners and working interests, a net-to-company view of volumes, capex, opex or cash flow, a portfolio roll-up, or a check of an equity assumption."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-ncs-ownership-equity14---1516# NCS Ownership and Equity1718This skill answers "who owns what share of this asset?" for the Norwegian19Continental Shelf and hands the answer to field evaluation and economics. It20reads the Sodir DataService, which publishes ownership openly (NLOD 2.0), and21needs no key.2223| Asset | Public? | How it is read |24|-------|---------|----------------|25| Field | Yes | Sodir `field_licensee_hst` (layer 7108): company, share %, owner (licence or unit), valid dates |26| Discovery | Yes, via its owner | Sodir `discovery_owner_hst` (7007) gives the owning licence or unit; that owner's licensees (3007 licence, 3304 unit) give the shares |27| Production licence | Yes | Sodir `licence_licensee_hst` (3007); operator flagged by `prlOperDateValid*` |28| Prospect | **No** | Not published at prospect level. Use the user's own figures, or the licence it sits in as a labelled proxy |2930It is a lookup and arithmetic skill. It does not compute volumes, prices, fiscal31terms or NPV; it supplies the equity fractions those steps multiply by.3233## When to Use3435- A field or discovery evaluation needs the partners and their working interests.36- A company wants its net share of gross volumes, revenue, capex, opex or cash flow.37- A portfolio view is needed: every field and discovery in which one company holds an interest.38- An equity assumption in a model must be checked against the public record.39- A prospect needs an equity table. The skill validates user figures or shows the licence proxy.40- Ownership changed (sale, merger, unitisation) and the history matters for a back-cast.4142## Inputs4344- `OwnershipReader()` reads live Sodir. Pass `fetch=` to run offline.45- Names resolve loosely and case-insensitively: `"Troll"`, `"Wisting"`,46 `"7324/8-1 (Wisting)"`. Several matches raise `OwnershipError` listing the candidates.47- Production licences are named by the bare number: `reader.licence("1252")` works,48 `"PL1252"` raises `no production licence named 'PL1252'` (verified 2026-10-09).49- `as_of` is a date (default today). Interests are valid from the start date to the50 inclusive end date; an empty end is open.51- Companies for `portfolio()` are a name or a Sodir company id. An ambiguous name52 (for example two Equinor entities) raises with the ids to choose from.5354## Outputs5556`OwnershipRecord` with `kind`, `name`, `as_of`, `basis`, `stakes` (company, id,57interest %, operator flag, valid dates), `owner_kind`, `owner_name`, `operator`,58`included_in_field`, `last_updated`, `total_pct`, `is_complete` and `warnings`.5960- `fractions()`, `fraction_of(company)`, `find(company)`61- `allocate(gross)` for every partner, `net(gross, company)` for one; lists or62 `{year: value}` mappings both work63- `to_economics_handoff(company)`: equity fractions, caveats and a scaling note64- `portfolio_net([(record, gross), ...], company)`: sums a company's net over assets65- `OwnershipReader.history("field" | "licence", name)`: ownership periods, oldest first66- `portfolio(company, as_of)`: every field and discovery held, with interest %67- `licence_milestones(licence)`: the licence work obligations (drill-or-drop, decision to continue, plan for68 development) with deadlines as local Europe/Oslo dates. Sodir stores a deadline as local midnight, so reading the69 epoch as UTC (`to_date`) gives the previous day; use `to_local_date` for deadlines.7071`basis` is `sodir_public`, `licence_proxy` or `user_provided`. Carry it into any72report so the reader knows how firm the equity is.7374## Engineering Method75761. **Resolve the name** against the field or discovery layer (exact match first,77 then substring); stop on ambiguity.782. **Fields:** read the licensee history, keep the rows valid on `as_of`, take the79 operator from the field operator history.803. **Discoveries:** read the owner history, keep the owner valid on `as_of`, read81 the owner id from its Sodir URL, then read that licence's or unit's licensees.82 The operator comes from the discovery operator history.834. **Check** that the interests add up to 100 %. A shortfall is a warning, not a84 silent fix.855. **Apply equity** by multiplying gross volumes, revenue, capex and opex by the86 fraction. Tax is a per-company calculation on the net cash flow: do not scale a87 gross tax figure.8889## Python Usage Pattern9091```python92from datetime import date93from ncs_ownership_equity import OwnershipReader, portfolio_net9495reader = OwnershipReader()96alvheim = reader.field("Alvheim") # equity today97alvheim.fractions() # {'Aker BP ASA': 0.8, 'ConocoPhillips ...': 0.2}98wisting = reader.discovery("Wisting") # via licence 53799wisting.operator, wisting.is_complete100101gross_capex = {2028: 12000.0, 2029: 18000.0} # MNOK, gross102wisting.net(gross_capex, "Aker BP") # Aker BP's share103104# Prospect: Sodir has no prospect equity. Enter your own, or show the licence proxy.105prospect = OwnershipReader.prospect("Delta", {"Opco AS": 60, "Partner AS": 40}, operator="Opco AS",106 source="licence group agreement 2026-05")107proxy = reader.prospect_from_licence("Delta", "537") # basis = licence_proxy, with a warning108109# Company view: portfolio and a net cash-flow roll-up110reader.portfolio("Aker BP ASA")["items"][:5]111portfolio_net([(alvheim, alvheim_cash), (wisting, wisting_cash)], "Aker BP")112113# Back-cast an earlier equity114reader.field("Alvheim", date(2019, 1, 1)).fractions()115```116117## Hand-offs118119- **Gross volumes and reserves:** `neqsim-norwegian-continental-shelf-data` and120 `neqsim-resource-classification-screening`.121- **Economics:** pass `to_economics_handoff()` or the net series to122 `neqsim-asset-value-npv-screening`, `neqsim-field-economics` and123 `neqsim-capex-opex-screening`.124- **Tie-in and host studies:** `neqsim-ncs-infrastructure-network` for hosts and125 routes; equity decides who carries the tariff and host costs.126- **Governed internal sources** (portfolio registers, signed agreements) belong to127 the enterprise layer and override the public record where they differ.128129## Validation Checklist130131- [ ] `basis` and `as_of` are stated in the report.132- [ ] `is_complete` is true, or the shortfall is explained.133- [ ] A discovery with `included_in_field` was evaluated through the field's equity.134- [ ] Unit (business arrangement area) equity was used, not the pre-unit licence equity.135- [ ] Prospect equity is labelled user-provided or licence proxy, never public.136- [ ] `last_updated` is recent; any known pending transfer is noted separately.137- [ ] Net figures sum back to the gross figure across all partners.138139## Common Mistakes140141- Using the licence equity for a field that has been unitised: the unit equity differs142 after redetermination. Read the field, not the licence.143- Reading a discovery that is already part of a field as a standalone asset.144- Treating `sdfi_pct` as extra: it sits inside a partner's share and is informational.145- Scaling a gross tax number by equity instead of taxing each company's net flow.146- Using a company name that matches two legal entities; pass the company id.147- Assuming a pending sale is in the data. Sodir shows approved transfers only.148- Presenting the licence proxy as prospect equity.149150## Limitations151152- Sodir publishes approved ownership; announced or pending transfers, farm-in153 carries, back-in rights and private side agreements are not in it.154- Prospect-level equity and cost-sharing are not public.155- Norwegian shelf only. Other provinces need their own source.156- Data currency follows Sodir's update date (`last_updated`).157- Screening only: a qualified commercial review is required before any investment use.158159## Related NeqSim Functionality160161- **Other Sodir layers** (wellbores, DST, tops, licences, surveys, CO2, FactPages CSV, bulk files): use162 `neqsim-sodir-open-data` for the full catalog, recipes and traps before writing a new reader.163164`neqsim.process.fielddevelopment.economics` classes (cash flow, fiscal regime) accept the165net series; equity itself is bookkeeping and has no Java counterpart.166167## References168169- Sodir DataService (ArcGIS REST), layers 3003, 3007, 3304, 7000, 7006, 7007, 7100, 7108, 7110;170 FactPages tables `field_licensee_hst`, `licence_licensee_hst`. NLOD 2.0.171- Sodir FactPages sections: application, wellbore, storage, licence, bsns_arr_area,172 field, discovery, company, survey, facility, tuf, strat (no prospect section).