ee_getHarmonics

Возвращает гармонические порядки, величины и основную частоту

Описание

пример

[harmonicOrder,harmonicMagnitude,fundamentalFrequency] =...
ee_getHarmonics(loggingNode)
вычисляет гармонические порядки, величины и основную частоту simscape.logging.Node переменной AC или периодической переменной.

Функция находит точки в ith сигнал (valueIdx), где журнал Simscape™ пересекает порог (offsetOfInterest). Он использует точки пересечения, чтобы найти необходимое количество периодов (nPeriodOfInterest), предшествующих указанному времени (tOfInterest). Затем он вводит выбранные вниз данные в алгоритм Гертцеля, который вычисляет гармонические величины до необходимого количества гармоник включительно (nHarmonic).

Вы вводите входные параметры в определенном порядке. Требуется входной параметр узла регистрации Simscape. Все другие входные параметры являются необязательными и имеют значения по умолчанию. Если вы задаете значение для последующего необязательного входного параметра, введите [] использовать значение по умолчанию для необязательного входного параметра.

Вы можете использовать ee_plotHarmonics функция для получения столбчатой диаграммы из тех же входных параметров. Можно использовать выходы этой функции как входы для ee_calculateThdPercent функция для вычисления общего процента гармонических искажений (THD).

[harmonicOrder,harmonicMagnitude,fundamentalFrequency] =...
ee_getHarmonics(loggingNode,valueIdx)
использует индекс в данные о значении.

[harmonicOrder,harmonicMagnitude,fundamentalFrequency] =...
ee_getHarmonics(loggingNode,valueIdx,tOfInterest)
использует время симуляции.

[harmonicOrder,harmonicMagnitude,fundamentalFrequency] =...
ee_getHarmonics(loggingNode,valueIdx,tOfInterest,nPeriodOfInterest)
использует количество периодов основной частоты.

[harmonicOrder,harmonicMagnitude,fundamentalFrequency] =...
ee_getHarmonics(loggingNode,valueIdx,tOfInterest,nPeriodOfInterest,...
offsetOfInterest)
использует смещение постоянного тока.

[harmonicOrder,harmonicMagnitude,fundamentalFrequency] =...
ee_getHarmonics(loggingNode,valueIdx,tOfInterest,nPeriodOfInterest,...
offsetOfInterest,nHarmonic)
использует количество гармоник.

Примеры

Анализируйте с использованием значений по умолчанию

Этот набор аргументов функции использует узел логгирования Simscape simlog_ee_harmonics_rectifier.Sensing_current.Current_Sensor.I, который содержит данные от трехфазного тока. Функция анализирует сигнал по умолчанию, который является первым, или фаза, сигналом в конечном времени симуляции. Функция использует значения по умолчанию 12 для количества периодов сигнала, 0V для смещения сигнала и 30 для количества гармоник.

open_system('ee_harmonics_rectifier')
sim('ee_harmonics_rectifier')
[~,harmonicMagnitude,~]= ee_getHarmonics(simlog_ee_harmonics_rectifier.Sensing_current.Current_Sensor.I);
%harmonicMagnitude stores the peak values of the harmonics. To get the RMS values, divide by sqrt(2)
harmonicMagnitude./sqrt(2)
ans =

   1.0e+03 *

  Columns 1 through 14

    0.0000    1.3759    0.0000    0.0000    0.0000    0.1548    0.0000    0.0748    0.0000    

    0.0000    0.0000    0.0602    0.0000    0.0407

  Columns 15 through 28

    0.0000    0.0000    0.0000    0.0357    0.0000    0.0266    0.0000    0.0000    
    
    0.0000    0.0239    0.0000    0.0187    0.0000    0.0000

  Columns 29 through 31

    0.0000    0.0170    0.0000

Анализируйте с использованием заданных значений

Этот набор аргументов функции использует узел логгирования Simscape simlog_ee_harmonics_rectifier.Sensing_current.Current_Sensor.I, который содержит данные от трехфазного тока. Функция анализирует второй, или b-фазный, сигнал во время симуляции 0.5 s. Функция использует 10 периоды сигнала, принимая смещение 1V. Функция анализирует 15 гармоника.

open_system('ee_harmonics_rectifier')
sim('ee_harmonics_rectifier')
[~,harmonicMagnitude,~]= ee_getHarmonics(simlog_ee_harmonics_rectifier.Sensing_current.Current_Sensor.I,2,0.5,10,1,15);
%harmonicMagnitude stores the peak values of the harmonics. To get the RMS values, divide by sqrt(2)
harmonicMagnitude./sqrt(2)
ans =

   1.0e+03 *

  Columns 1 through 15

    0.0000    1.3761    0.0008    0.0005    0.0006    0.1544    0.0000    0.0748    0.0003    

    0.0002    0.0003    0.0599    0.0001    0.0407    0.0004

  Column 16

    0.0003

Анализируйте с использованием значений по умолчанию и заданных значений

Этот набор аргументов функции использует узел логгирования Simscape simlog_ee_harmonics_rectifier.Sensing_current.Current_Sensor.I, который содержит данные от трехфазного тока. Функция анализирует первый, или фаза, сигнал во время симуляции 0.5 s. Функция использует 12 периоды сигнала, принимая смещение 1V. Функция анализирует число по умолчанию, 30, гармоник.

open_system('ee_harmonics_rectifier')
sim('ee_harmonics_rectifier')
[~,harmonicMagnitude,~]= ee_getHarmonics(simlog_ee_harmonics_rectifier.Sensing_current.Current_Sensor.I,[],0.5,[],1);
%harmonicMagnitude stores the peak values of the harmonics. To get the RMS values, divide by sqrt(2)
harmonicMagnitude./sqrt(2)
ans =

   1.0e+03 *

  Columns 1 through 15

    0.0000    1.3759    0.0000    0.0000    0.0000    0.1548    0.0000    0.0748    0.0000 
 
    0.0000    0.0000    0.0602    0.0000    0.0407    0.0000

  Columns 16 through 30

    0.0000    0.0000    0.0357    0.0000    0.0266    0.0000    0.0000    0.0000    0.0239   

    0.0000    0.0187    0.0000    0.0000    0.0000    0.0170

  Column 31

    0.0000

Входные параметры

свернуть все

Узел логгирования Simscape, заданный как simscape.logging.Node 1 на 1. Вы создаете simscape.logging.Node путем выполнения симуляции с включенным логгированием Simscape. Для получения дополнительной информации смотрите Включить ведение журнала данных для всей модели.

Пример: simlog.Load.V

Журнал симуляции узла логгирования Simscape. Load.V содержит данные трехфазного напряжения.

Индекс в данные значения, заданный как скаляр. Задает ith переменная интереса в журнале Simscape.

Пример: 2

Задайте b-фазу, которая является вторым сигналом от трехфазного напряжения.

Пример: []

Используйте [], чтобы задать значение по умолчанию для 1. Фаза, которая является первым сигналом от трехфазного напряжения, является интересующим сигналом по умолчанию.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Интересующее время симуляции для гармонического анализа, заданное как скаляр.

Пример: 0.5

Задайте время симуляции 0,5 с.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Количество периодов основной частоты, подлежащих включению в гармонический анализ, заданное как скаляр.

Пример: 10

Задайте 10 периоды сигнала.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Смещение постоянного тока в входном сигнале, задается как скаляр. Функция использует это значение для поиска интересующих периодов.

Пример: 1

Задайте смещение 1 V для сигнала.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Количество гармоник для включения в анализ, заданное как скаляр.

Пример: 15

Укажите, что количество анализируемых гармоник 15.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Выходные аргументы

свернуть все

Гармонические порядки от 0 до и включая количество гармоник, используемых в анализе, возвращаются в качестве вектора.

Гармонические величины от 0th гармоника до и включая количество гармоник, используемых в анализе, возвращенная в качестве вектора.

Основная частота в области значений выбранных вниз входных данных, возвращенная в виде скаляра.

Ограничения

  • Эта функция требует, чтобы вы использовали решатель с фиксированным шагом для сети Simscape Electrical™ Power Systems, которую вы анализируете. Чтобы задать решатель с фиксированным шагом для физической сети, используйте одну из комбинаций строения в таблице.

    Комбинация строенийГлобальные Строения решателяЛокальный решатель Строения
    Глобальная переменная - шаг с локальным фиксированным шагомУстановите Type значение Variable-stepВключите опции для Use local solver и Use fixed-cost runtime consistency iterations
    Глобальный и локальный фиксированный шагУстановите Type значение Fixed-stepВключите опции для Use local solver и Use fixed-cost runtime consistency iterations
    Глобальный фиксированный шагУстановите Type значение Fixed-stepОчистить опцию для Use local solver

  • Эта функция использует пороговые точки пересечения, чтобы определить основную частоту данных. Если ваши входные данные зашумлены или пересекают порог чаще, чем половина основного периода, фильтруйте его, прежде чем использовать эту функцию для анализа.

  • Эта функция требует минимального количества периодов. Если минимальное число не достигнуто, функция генерирует предупреждающее сообщение. Чтобы увеличить количество периодов, используйте один или оба из следующих методов:

    • Увеличьте время симуляции.

    • Увеличьте частоту переключения.

Введенный в R2014a