Engineering Python library · oil and gas

Inspect the math.
See it work first.

Batch forecasting, data cleanup, decline fitting, EUR ranges, type curves, well economics, well spacing and statistical normalization, written in Python your engineers can read, change and extend. Try every workflow below, then decide.

Annual subscription No black box Updates and support are included. Contact our team to talk through your wells. Contact our team
Interactive demo · public well records

Every workflow in the library, live

Seven tabs, one for each part of the library. Each runs a live calculation in your browser on real, public production and well records for horizontal wells in the Wattenberg field (Weld County, Colorado), from the Colorado Energy and Carbon Management Commission. Change the inputs and watch the result move. The library does the same work in Python on your own data.

Batch forecast with data cleanup

Six public horizontal wells forecast in one pass. Before fitting, each history is screened: down months are dropped, outliers are flagged, shut-ins of two months or more split the history into segments, and the fit starts at the peak of the current segment. Click a well to see what was flagged.

Public ECMC monthly oil, shown as bbl per producing day, log scale. Orange marks are flagged outliers; grey marks were not used in the fit.

WellMonthsFlaggedSegmentqiDi/yrbEUR, Mbbl
Selected well
EUR with these settings
EUR with no cleanup
Difference

Turn the cleanup off and watch the shut-in well's EUR move. That is why the library screens every history before it fits, and reports what it removed so an engineer can review the exceptions.

Source: public production, permit and completion records from the Colorado Energy and Carbon Management Commission (COGIS database), Wattenberg field, accessed November 2026. Wells are shown by API number. This page runs standard decline, sampling, cash-flow, geometry and statistics math in your browser to show each workflow. It is a preview, not the library itself, and it is not a forecast or valuation of any well. Economic inputs are illustrative.

Annual subscription

Everything inside the library

Ten Python modules. Every calculation can be inspected, tested and extended by your own engineers.

CapabilityWhat it doesGoes inComes outDemo
Batch forecastingA consistent first-pass decline workflow across a selected well set, with exceptions to reviewWell IDs, production dates, oil and gas history, units, fitting settingsRates, curves, cumulative volumes, model parameters per well01
Production preprocessingDrops nonpositive records, flags outliers, detects start, stop and production segments before fittingRaw monthly productionMasks, segments, cleaned series01
Arps decline, auto and manualAutomatic fitting, plus manual fits when engineering judgment calls for itProduction history, fit settings or chosen parametersForecast rates, cumulative volumes, EUR02
MCMC sampling and EURMarkov Chain Monte Carlo sampler with parameter bounds, so recovery is a rangeProduction history, bounds, proposal settingsSampled parameters, sampled EURs, acceptance reporting03
Type curvesMean, median, percentile or sum type curves, with lateral-length normalizationSelected wells, lateral lengths, target lengthAggregated and fitted type curve, normalized comparison04
Well economicsRevenue, LOE, variable costs, investment and tax into monthly cash flowForecasts, price deck, interests, costs, investment dates, taxMonthly cash-flow tables, NPV, IRR, payout05
Remaining-life economicsValues producing wells from an evaluation date without replaying their full livesForecast, evaluation window, costsGo-forward cash flow and metrics05
Well spacing and overlapDirectional-survey geometry, horizontal interval selection, well-pair screening and geometric overlapWell IDs, latitude, longitude, TVD, survey headers, radiiWell-pair detail, distances, overlap summaries, gunbarrel tables06
PCA and regression normalizationExplores how well attributes relate to a production or recovery targetSelected well attributes and a targetLoadings, predictions, residuals07
Time series and discountingMonthly alignment, shifting, arithmetic, discounting and date conversion behind the economicsMonthly seriesAligned, discounted series05
Spotfire integrationReads typed parameters from Spotfire document properties; Spotfire output adaptersSpotfire data functionsTables back into Spotfire–
Utilities and custom modulesLocal caching, run logs, an optional SQLite helper, and well and model collections to combine and extend calculationsYour own workflowsRepeatable runs–

Outputs are pandas DataFrames, so results drop into Spotfire, Power BI, a notebook or an AI assistant's workflow.

Buying it

How a purchase works

  1. 15-minute fit call. Tell us one engineering question you want to answer and what tools your team uses. We confirm your environment before you buy.
  2. Subscribe. An annual subscription for your team.
  3. Optional customer-data setup. Setup is separate from the subscription and available in prepaid 20-hour consulting blocks.
  4. Optional setup block. Want us to connect it to your own wells, production and price data? Add a 20-hour block.
Annual subscription
Built for your engineers
  • Every calculation open to inspect, for every module above
  • Updates and support during your annual subscription
Optional setup. We connect the library to your own wells, production and price data.

For pricing, contact our team. Most conversations start with a 15-minute call.

Contact our team
Questions

Before you buy

Is this a black box?

No. Every calculation is open to inspect. Your engineers can read it, check it against their own methods and extend it.

Do we need Spotfire?

Not necessarily. It was built to run inside Spotfire, and its outputs are standard Python DataFrames you can use in notebooks, Power BI or with an AI assistant. We confirm your setup on the fit call, before you buy.

Is the demo on this page the library?

No. The demo runs standard math in your browser on public Colorado well records so you can see each workflow. The library does this in Python on your data, at the scale of your well set.

Does it replace ARIES, PHDwin or ComboCurve?

It is not a reserves system. It gives your engineers inspectable Python for the analysis around those systems: testing assumptions, putting ranges on EUR, comparing wells fairly, checking spacing and tracing a forecast into cash flow.

Is the spacing tool a fracture model?

No. It is survey geometry: distances, side-by-side length and geometric overlap for a radius you set. It helps you screen and compare well pairs quickly.

Who is behind it?

Blue River Analytics, Denver. Analytics for oil and gas since 2014, more than 300 clients and hundreds of Spotfire projects.

Tell us the question you want to answer

Send one engineering question and a rough idea of your well count. Our team will tell you which part of the library fits and what a first project looks like.

Use the contact form on the main website
303-248-6424

Blue River Analytics team