# P-levels

Source: https://developers.novilabs.com/concepts/p-levels/

> Novi products use two opposite P-level conventions today, so read every P10 and P90 by its case label.

> **The products disagree today:**
> In the Novi Forecasts API, P10 is the Low case. In EVA charts, P10 is the High case. Read P10 and P90 by the case label, Low, Mid (P50) or High, never by the number alone.

## Two conventions

<PLevels />

| P-level | Percentile | Exceedance |
| --- | --- | --- |
| P10 | Low: 10% of outcomes fall below it | High: 10% chance of exceeding it |
| P50 | Mid, the median | Mid, the median |
| P90 | High: 90% of outcomes fall below it | Low: 90% chance of exceeding it |
| Used by | Novi Forecasts API | EVA charts. Also SPE PRMS reserves practice |

## Per product

| Product | Where P-levels appear | P10 | P90 | Status |
| --- | --- | --- | --- | --- |
| Novi Forecasts API | Bands with `bands: true` (`p10`, `p90`), export `p_levels`, curves `p_levels` | Low | High | [Available] |
| Novi EVA MCP server | `get_chart` statistics `p10`, `p50`, `p90`, and the `type_curve` preset | High | Low | [Preview] |
| Novi UDM Data (v4) | `SCENARIO` on the forecast views | The dictionary calls it optimistic | The dictionary calls it conservative | [Available] P50 only |

- **Novi Forecasts API.** Low and High are bands around one well's forecast, so a plan's summed Low is not the plan's own Low. Details: [Low, Mid and High](https://developers.novilabs.com/forecasts/guides/forecasts-and-curves/#low-mid-and-high).
- **Novi EVA MCP server.** Chart statistics pool every well in the filter. `group_by` offers an exact median (P50) and no other percentile measure. EVA treats a bare "P75" as ambiguous and asks which convention you mean.
- **Novi UDM Data (v4).** Only the P50 scenario ships, so `SCENARIO` holds `P50` on every row. The data dictionary's wording for P10 and P90 follows the exceedance direction. No P10 or P90 rows exist yet.

## How to read and move numbers

1. Read the case label: Low, Mid (P50) or High.
2. When you move a curve between products, map it by case. A Forecasts P10 is the Low case; an EVA chart P10 is the High case.
3. Label your own outputs by case, and state the convention once.
4. When you ask an agent for a P-level, name the case you want.

These docs label every P-level by case.
