> ## Documentation Index
> Fetch the complete documentation index at: https://docs.priorlabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> TabPFN-3 and later versions support up to 1,000,000 rows, subject to feature count and checkpoint/API limits.
> For large datasets, use per-estimator subsampling, e.g. inference_config={"SUBSAMPLE_SAMPLES": 100_000}, in TabPFNClassifier or TabPFNRegressor from tabpfn or tabpfn_client.
> Pass raw pandas DataFrames to fit and predict. Categorical strings/categories, raw text, and missing feature values are handled automatically; no manual integer/one-hot encoding, imputation, scaling, or outlier removal is needed.

# Predictive distributions

> Plot the predicted target distribution for a single sample.

<Info>
  Looking for usage documentation? Check out [Predictive distribution](/capabilities/predictive-distribution).
</Info>

<div className="python-reference-heading">
  <h2 id="plot-regression-distribution">
    `plot_regression_distribution`
  </h2>

  <a className="python-reference-source" href="https://github.com/PriorLabs/TabPFN/blob/c70b6ef0488858d32244c52222abfc0c5be207d6/src/tabpfn/visualisation/regression_distribution.py#L59" aria-label="View source for plot_regression_distribution"><span aria-hidden="true">\</></span> View source <span aria-hidden="true">↗</span></a>
</div>

Plot the predicted target distribution for a single sample.

```python theme={null}
plot_regression_distribution(
    prediction: FullOutputDict,
    *,
    sample_idx: int = 0,
    statistics: Sequence[str] = ("mean", "median", "mode"),
    quantile_interval: tuple[float, float] | None = (0.1, 0.9),
    zoom_quantile: float | None = 0.99,
    smooth: float = 0.005,
    ax: plt.Axes | None = None,
    color: str = "#1f77b4",
) -> plt.Axes
```

**Parameters**

<div className="python-reference-table">
  | Parameter | Type | Default | Description |
  | - | - | - | - |
  | <span id="plot-regression-distribution--prediction" /><code className="python-reference-parameter">prediction</code> | <code className="python-reference-type"><a href="https://github.com/PriorLabs/TabPFN/blob/c70b6ef0488858d32244c52222abfc0c5be207d6/src/tabpfn/regressor.py#L164">Full<wbr />Output<wbr />Dict</a></code> | Required | Output of `regressor.predict(X, output_type="full")`. It may hold several samples; pick the one to plot with `sample_idx`. |
  | <span id="plot-regression-distribution--sample-idx" /><code className="python-reference-parameter">sample\_<wbr />idx</code> | <code className="python-reference-type">int</code> | `0` | Index of the sample to plot within `prediction`. |
  | <span id="plot-regression-distribution--statistics" /><code className="python-reference-parameter">statistics</code> | <code className="python-reference-type">Sequence\[str]</code> | `("mean", "median", "mode")` | Point statistics to mark with a vertical line. Any of `"mean"`, `"median"`, `"mode"`. |
  | <span id="plot-regression-distribution--quantile-interval" /><code className="python-reference-parameter">quantile\_<wbr />interval</code> | <code className="python-reference-type">tuple\[float, float] \| None</code> | `(0.1, 0.9)` | Central interval to shade, e.g. `(0.1, 0.9)` for the 80% interval. Pass `None` to disable. |
  | <span id="plot-regression-distribution--zoom-quantile" /><code className="python-reference-parameter">zoom\_<wbr />quantile</code> | <code className="python-reference-type">float \| None</code> | `0.99` | Fraction of probability mass to keep in view, centred on the median. Pass `None` to show the full support. |
  | <span id="plot-regression-distribution--smooth" /><code className="python-reference-parameter">smooth</code> | <code className="python-reference-type">float</code> | `0.005` | Width of the display-only moving average over the density, as a fraction of the number of bars. Pass `0` to show the raw bar density. |
  | <span id="plot-regression-distribution--ax" /><code className="python-reference-parameter">ax</code> | <code className="python-reference-type">plt.Axes \| None</code> | `None` | Existing axes to draw on. A new figure is created if omitted. |
  | <span id="plot-regression-distribution--color" /><code className="python-reference-parameter">color</code> | <code className="python-reference-type">str</code> | `"#1f77b4"` | Base colour of the density curve. |
</div>

**Returns**

<div className="python-reference-table python-reference-returns">
  | Type | Description |
  | - | - |
  | <code className="python-reference-type">plt.Axes</code> | The matplotlib axes containing the plot. |
</div>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.