Units and conventions
Volumes, BOE, depths, coordinates, dates and time grain in each Novi product, side by side.
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.
Per product
Section titled “Per product”| 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.: 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, in request bodies, "lng, in query strings, WGS 84 degrees |
Polygon filters take one closed WGS 84 ring |
| Dates | PRODUCTION_ is the first day of the month. Events carry EVENT_ (when it happened) and EFFECTIVE_ (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_ |
Cumulative volume by ip_, the days since first production. Curves every 30 days to EUR, or by calendar month with start_ |
Production charts by producing month or by date. Calendar-year volumes with volume_ |
| Month counter | MONTHS_ 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.
BOE is not built the same way
Section titled “BOE is not built the same way”| 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 |
“First 12 months” differs by product
Section titled ““First 12 months” differs by product”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_ 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_ 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.
Cohort years
Section titled “Cohort years”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.
More detail
Section titled “More detail”- Novi UDM Data: Data model, units and conventions
- Novi Forecasts API: Overview, conventions and
GET /conventionson your host - Novi EVA: EVA MCP server, conventions