aug_magnitude_warp — Smooth multiplicative magnitude warp¶
Group: Augmentation · C ABI: n4m_augmentation_magnitude_warp_*
Description¶
Smooth multiplicative magnitude warp.
Parameters¶
Name |
Type |
Default |
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
API and bindings¶
C ABI (ABI 2): n4m_augmentation_magnitude_warp_apply · n4m_augmentation_magnitude_warp_create · n4m_augmentation_magnitude_warp_destroy. Use the linked public header for the exact signature, configuration, and result handles.
Python (verified public re-export):
from n4m.augmentation.spectral import MagnitudeWarp
Source signature: MagnitudeWarp(n_control_points: int = 5, gain_lo: float = 0.9, gain_hi: float = 1.1, wavelengths = None, rng: Optional[PCG64] = None, seed: int = 0).
R: no current source-verified entry point was found for this catalog method.
MATLAB / Octave: no current source-verified entry point was found for this catalog method.
Explanations¶
Bibliographic source¶
No paper is canonical for this exact spectral warp. The current native linear interpolation path is the normative algorithm.
Mathematical principle¶
At equally spaced control wavelengths draw gains from \(U(\text{gain_lo},\text{gain_hi})\), linearly interpolate a gain field \(g_i(\lambda)\), and return \(X'_i(\lambda)=g_i(\lambda)X_i(\lambda)\). n_control_points controls the field’s spatial frequency.
Appropriate uses¶
Simulating smooth wavelength-dependent sensitivity or multiplicative scatter drift.
Limits and validation¶
The C path is piecewise linear and intentionally differs from the historical cubic-spline oracle. Gains are unconstrained beyond user bounds and may cross zero.
Implementation¶
Python role API n4m.augmentation.spectral.MagnitudeWarp; ABI 2 family n4m_augmentation_magnitude_warp_{create,apply,destroy}.
The ABI-2 implementation is the n4m_augmentation_magnitude_warp_* lifecycle in libn4m.
Sources and provenance¶
See also: methods index · interactive dashboard