Skip to content

[V5] Feature: Add JODI World Oil & Gas Database#7593

Open
deeleeramone wants to merge 3 commits into
v5from
feature/v5-jodi
Open

[V5] Feature: Add JODI World Oil & Gas Database#7593
deeleeramone wants to merge 3 commits into
v5from
feature/v5-jodi

Conversation

@deeleeramone

@deeleeramone deeleeramone commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

This PR adds the JODI oil and gas databases.

The entire database is available from three compressed CSV files, so the first caller takes the loading cost of downloading and caching. PyArrow is used as a dependency to convert these into queryable parquet bundles on disk, which minimizes the memory load for lookups.

Endpoints

Each endpoint returns one presentation-ready view of the raw data, as a date-indexed table, with the series assessments and units in the results metadata.

obb.jodi.oil — JODI-Oil World Database (monthly, from January 2002)

  • balance — one country and product; one column per flow of the JODI questionnaire (production, trade, stocks, refinery activity).
  • production — one primary product; one column per reporting country.
  • demand — one refined product; one column per reporting country.
  • demand_by_product — one country; one column per refined product (the demand barrel).
  • imports / exports — one product; one column per reporting country.
  • stocks — closing stock levels of one product; one column per reporting country.

Units: kb/d, kbbl, kl, kmt, and the barrels/kmt conversion factor.

obb.jodi.gas — JODI-Gas World Database (monthly, from January 2009)

  • balance — one country; one column per flow of the JODI questionnaire.
  • production — one column per reporting country.
  • demand — gross inland deliveries (observed or calculated); one column per reporting country.
  • imports / exports — total, pipeline, or LNG; one column per reporting country.
  • stocks — closing stock levels; one column per reporting country.

Units: million m3, TJ, and kmt of LNG.

Screenshot 2026-07-15 113507

@deeleeramone deeleeramone added extensions Extension-related feature New feature V5 PRs and issues for ODP V5 labels Jul 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

extensions Extension-related feature New feature V5 PRs and issues for ODP V5

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant