# `pp_snv` — Standard Normal Variate (SNV)

_Group_: **Preprocessing** · _Binding_: `n4m.sklearn.SNV` · _C ABI_: `n4m_pp_snv_*`

## Description

Standard Normal Variate normalisation.

### Parameters

| Name | Type | Default |
|------|------|---------|
| `with_mean` | `bool` | `True` |
| `with_std` | `bool` | `True` |
| `ddof` | `int` | `0` |

## Explanations

### Bibliographic source

Barnes, R. J., Dhanoa, M. S. & Lister, S. J. (1989). *Standard Normal Variate Transformation and De-trending of Near-Infrared Diffuse Reflectance Spectra*. Applied Spectroscopy 43(5), 772–777.

### Mathematical principle

Each spectrum $\mathbf{x}_i$ is centred and scaled by its own row statistics: $\mathrm{SNV}(\mathbf{x}_i) = (\mathbf{x}_i - \bar{x}_i)/s_i$, where $\bar{x}_i$ and $s_i$ are the mean and standard deviation across the wavelengths of that single spectrum. This removes multiplicative scatter and additive baseline shifts on a per-sample basis without needing a reference spectrum, which is why SNV is robust to sample-to-sample path-length variation in diffuse-reflectance NIR.

### Implementation

C ABI `n4m_pp_snv_*` in libn4m (create / apply / destroy lifecycle), wrapped by `n4m.sklearn.SNV`. The same numerical kernel backs every language binding.

### Usage

```python
from n4m.sklearn import SNV
op = SNV()
X_transformed = op.fit_transform(X)
```

### Benchmarks

Adaptive wall-clock per cell measured against [`full_matrix.csv`](../benchmarks/overview.md). Only backends that implement this method are listed; libraries without the method are omitted.

**Verdict**  ·  ✓ ref / ≈ ref / ~ shape mark a reference-gate pass at strict / relaxed / qualitative tolerance  ·  ✓ bind = pls4all binding agrees with the C++ baseline  ·  ✗ divergent  ·  ⚠ error  ·  — not run. The fastest backend per column is marked 🏆.

**Reference gate**: strict — numeric equivalence (`rmse_rel_tol ≤ 1e-12`).

::::{tab-set}
:class: parity-tabs

:::{tab-item} 1 thread
:sync: threads-1

<div class="parity-table-wrap">
<table class="docutils parity-grouped">
<thead><tr><th scope="col">Backend</th><th scope="col">Parity</th><th class="size-col" scope="col">50×250 (ms)</th><th class="size-col" scope="col">250×50 (ms)</th></tr></thead>
<tbody class="lang-band lang-cpp"><tr class="lang-band-row" data-lang="cpp"><th colspan="4" scope="rowgroup"><span class="lang-band-dot"></span>C++ native · libn4m</th></tr>
<tr class="bk-row"><td class="bk-name"><code>pls4all.cpp.blas+omp</code></td><td class="parity parity-ref-strict">✓ ref</td><td class="ms">—</td><td class="ms">—</td></tr>
</tbody>
<tbody class="lang-band lang-python"><tr class="lang-band-row" data-lang="python"><th colspan="4" scope="rowgroup"><span class="lang-band-dot"></span>Python · external</th></tr>
<tr class="bk-row"><td class="bk-name"><code>ref.python_numpy</code></td><td class="parity parity-ref-source">source</td><td class="ms">—</td><td class="ms">—</td></tr>
</tbody>
</table>
</div>

:::

::::


---

_See also_: [methods index](index.md) · [interactive dashboard](../landing/dashboard.md)