convert_amplitude()

convert_amplitude(

value: float,

from_unit: AmplitudeMeasurementUnit,

to_unit: AmplitudeMeasurementUnit,

waveform: Sine | Square | Sawtooth | Triangle | Pulse | Arbitrary | StaticValue,

impedance_ohms: float | None = None,

) → float

Convert an amplitude value between measurement units for a waveform shape.

VPP/VP/VRMS conversions depend on the waveform’s crest factor, which is universal math shared across every driver. DBM additionally requires impedance_ohms (the load the instrument drives), since power depends on it.