Skip to content
Developers
Get an API token

Units and conventions

Volumes, BOE, depths, coordinates, dates and time grain in each Novi product, side by side.

View MarkdownOpen in Claude(opens in a new tab)

Check units, BOE, dates and time grain here before you combine numbers across products. Novi UDM Data and the Novi Forecasts API use fixed field units; the EVA MCP server lets you choose a unit system.

Topic Novi UDM Data (v4) Novi Forecasts API Novi EVA MCP server
Oil and water bbl. Condensate and NGL in bbl too bbl hybrid units, the default: oil in Mbbl
Gas Mcf mcf hybrid: MMcf
Unit system One One. Field names and descriptions carry the unit options.units: hybrid, si or imperial. Results label their units
BOE 6 Mcf = 1 BOE Oil plus gas at 6 mcf per bbl 6:1 in charts. Stored BOE columns use the 6:1 or 20:1 ratio the column names
Depths and lengths ft ft hybrid: lateral length in m
Coordinates Decimal degrees, WGS 84 (EPSG:4326) [lng, lat] in request bodies, "lng,lat" in query strings, WGS 84 degrees Polygon filters take one closed WGS 84 ring
Dates PRODUCTION_DATE is the first day of the month. Events carry EVENT_DT (when it happened) and EFFECTIVE_DT (when it counts) YYYY-MM-DD, or a date-time with a zone YYYY-MM-DD in filters. between includes the lower bound and excludes the upper
Time grain Monthly and weekly rows. Filter on PERIOD_GRANULARITY = 'monthly' Cumulative volume by ip_day, the days since first production. Curves every 30 days to EUR, or by calendar month with start_date Production charts by producing month or by date. Calendar-year volumes with volume_years
Month counter MONTHS_ON_PRODUCTION starts at 1 and counts calendar months from first production, shut-in months included Curve point cum[m-1] is the cumulative at day 30·m Producing months: a month with no oil, gas or water is skipped
Percentages Fractions: 0.18 means 18% Not published yet Not published yet

The EVA REST API does not publish its units yet.

Product What goes into BOE
Novi UDM Data (v4) Reported BOE cumulatives hold oil, condensate and gas at 6 Mcf = 1 BOE. They exclude NGL
Novi Forecasts API Oil plus gas divided by 6
Novi EVA MCP server Charts: oil plus gas divided by 6. Stored cumulative BOE columns: oil, condensate, NGL and gas at the column’s stated ratio

The same well can show three different 12-month cumulatives.

Product Window Where
Novi UDM Data (v4) Months 1 to 12 on production, shut-in months included. Reported values; null when the well has no producing month at month 12 or later CUM_OIL_12_REPORTED and its siblings
Novi Forecasts API Day 0 to day 360 of the forecast cum[11] on a curve
Novi EVA MCP server The first 12 producing months. Null when the well has fewer Production_Summary.Cumulative12MonthsOil and its siblings

Oil differs too. Novi UDM Data’s reported oil cumulatives may include condensate. In EVA, stored cumulative oil is reported oil only, while chart oil includes condensate.

In EVA, a year with no other qualifier means production vintage (Dates.Vintage_Year), not completion year. In Novi UDM Data, first production and completion are events in WELL_EVENT. WELL_DETAIL carries FIRST_PRODUCTION_DATE and COMPLETION_DATE per wellbore.