nibcq.measurement.SMUResult

class nibcq.measurement.SMUResult

Container class for SMU impedance measurement results.

This dataclass encapsulates the complete set of results from a Source Measure Unit (SMU) impedance measurement, providing both complex impedance representation and derived quantities in multiple formats for convenience and compatibility with different analysis tools.

The results include the fundamental complex impedance value along with separated real/imaginary components, magnitude/phase representation, and the measured frequency. This comprehensive result set supports various analysis workflows and visualization requirements.

measured_frequency

The actual frequency measured during the test in Hz. May differ slightly from requested frequency due to hardware limitations or timing constraints.

impedance

Complex impedance value in Ohms (Z = R + jX format). Primary result containing both magnitude and phase information.

r

Real part of impedance (resistance) in Ohms. Represents the resistive component of the impedance, related to energy dissipation.

x

Imaginary part of impedance (reactance) in Ohms. Represents the reactive component, related to energy storage (positive for inductive, negative for capacitive behavior).

z

Magnitude of impedance in Ohms (abs(Z) = sqrt(R² + X²)). Represents the overall impedance magnitude.

theta

Phase angle of impedance in degrees. Represents the phase relationship between voltage and current (positive for inductive, negative for capacitive behavior).

Example

>>> result = SMUResult(
...     measured_frequency=1000.0,
...     impedance=10.0+5.0j,
...     r=10.0,
...     x=5.0,
...     z=11.18,
...     theta=26.57
... )
>>> print(f"Impedance: {result.z:.2f} Ohms at {result.theta:.1f} degrees")