sym_comp_voltage_unbalance

typhoon.test.IEC61000.sym_comp_voltage_unbalance(samples: DataFrame, nominal_grid_freq: float, reference_split: list = None)

Measures the Symmetrical components and Voltage Unbalance according to IEEE Std 1159-2019.

Parameters:

  • samples (pandas.DataFrame) – The samples of the signals in which to measure the symmetrical component, organized in columns.

  • nominal_grid_freq (float) – According to the IEC 61000-4-30 standard, this method is applied only in grids with nominal frequency of 50.0 Hz or 60.0 Hz.

  • reference_split (list, optional) – List of indices to split the sample in windows. If None, the samples will be split according to the zero-crossings of the voltage signal.

Returns:

  • ZeroPosNeg_seq_per_window_df (pandas.DataFrame) – The magnitude of the zero sequence component, magnitude of the positive sequence component, and magnitude of the negative sequence component per window.

  • voltage_unbalance_df (pandas.DataFrame) – The ratio of the magnitude of the negative sequence component to the magnitude of the positive sequence component, expressed as a percentage.

Raises:

ValueError – When the nominal_grid_freq is different from 50 Hz or 60 Hz:

Examples

>>> from typhoon.test.signals import pandas_3ph_sine
>>> from typhoon.test.IEC61000 import sym_comp_voltage_unbalance
>>>
>>> frequency = 60
>>> voltage_samples = pandas_3ph_sine(frequency=frequency)
>>>
>>> ZeroPosNeg_seq_per_window_df, voltage_unbalance_df = sym_comp_voltage_unbalance(voltage_samples, frequency)