aug_linear_drift — Linear baseline-drift augmentation

Group: Augmentation · Binding: n4m.sklearn.LinearBaselineDrift · C ABI: n4m_aug_linear_drift_*

Description

Add random offset and linear slope drift.

Parameters

Name

Type

Default

offset_min

float

-0.05

offset_max

float

0.05

slope_min

float

-0.01

slope_max

float

0.01

rng

Optional[PCG64]

None

seed

int

0

Explanations

Bibliographic source

Physical baseline-perturbation augmentation; see the nirs4all augmentation handbook.

Mathematical principle

Adds a random linear ramp \(a + b\,\boldsymbol{\lambda}\) across the wavelength axis, emulating instrument baseline drift and temperature-dependent offsets so that downstream models learn drift invariance.

Implementation

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

Usage

from n4m.sklearn import LinearBaselineDrift
op = LinearBaselineDrift()
X_transformed = op.fit_transform(X)

Benchmarks

Adaptive wall-clock per cell measured against full_matrix.csv. 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  ·  ⇄ cross-check = documented by-design selector/RNG/model, noncanonical API/facade convention, or secondary oracle  ·  ✗ divergent  ·  ⚠ error  ·  — not run. The fastest backend per column is marked 🏆.

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

BackendParity50×250 (ms)250×50 (ms)
C++ native · libn4m
pls4all.cpp.blas✓ ref
pls4all.cpp.blas+omp✓ ref0.01 ms🏆0.01 ms🏆
pls4all.cpp.omp✓ ref
pls4all.cpp.ref✓ ref0.01 ms0.01 ms
Python · pls4all
pls4all.python✓ bind0.01 ms0.01 ms
pls4all.sklearn✓ bind0.01 ms0.02 ms

See also: methods index · interactive dashboard