nibcq.measurement.SMUMeasurement
================================

.. py:class:: nibcq.measurement.SMUMeasurement

   Container for raw voltage and current waveform data from SMU measurements.

   This dataclass stores the time-domain measurement data acquired from a Source
   Measure Unit (SMU) during AC impedance measurements. It contains the raw voltage
   and current waveforms along with the frequency information, providing the
   fundamental data needed for impedance calculations via DFT analysis.

   The voltage and current values represent time-series data sampled at regular
   intervals during the AC excitation. This raw data is subsequently processed
   through DFT analysis to extract the impedance characteristics of the DUT.

   .. attribute:: tone_frequency

      The excitation frequency in Hz for this measurement.
      Should match the frequency of the generated AC signal.

   .. attribute:: voltage_values

      List of measured voltage samples in Volts, sampled at regular
      time intervals during the AC excitation. Used for DFT analysis
      to extract voltage phasor information.

   .. attribute:: current_values

      List of measured current samples in Amperes, sampled at regular
      time intervals during the AC excitation. Used for DFT analysis
      to extract current phasor information.

   .. rubric:: Example

   >>> measurement = SMUMeasurement(
   ...     tone_frequency=1000.0,
   ...     voltage_values=[4.0, 4.1, 4.0, 3.9, 4.0],  # Simplified example
   ...     current_values=[0.1, 0.105, 0.1, 0.095, 0.1]
   ... )
   >>> print(f"Measured {len(measurement.voltage_values)} samples "
   ...       f"at {measurement.tone_frequency} Hz")