[V5] Feature: Add JODI World Oil & Gas Database#7593
Open
deeleeramone wants to merge 3 commits into
Open
Conversation
added 2 commits
July 15, 2026 11:24
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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.