# 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[source]

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.