# Units and conventions

Source: https://developers.novilabs.com/concepts/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

| 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.

## 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

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.

> **Caution:**
> Compare like with like. Before you set a Novi UDM Data figure beside an EVA or Forecasts figure, check the window, the oil definition and the BOE ratio.

## 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

- Novi UDM Data: [Data model, units and conventions](https://developers.novilabs.com/data/model/)
- Novi Forecasts API: [Overview, conventions](https://developers.novilabs.com/forecasts/) and `GET /conventions` on your host
- Novi EVA: [EVA MCP server, conventions](https://developers.novilabs.com/eva/mcp/)
