Документация Engee

frd

Страница в процессе разработки.

Частотная передаточная функция.

Библиотека

EngeeControlSystems

Описание

Функция создает модель динамической системы в виде частотной передаточной функции (частотной характеристики), которая задается с помощью наборов частот и комплексных чисел, выражающих реакцию системы на этих частотах. Модели могут описывать как одномерные (SISO), так и многомерные (MIMO) динамические системы. Модели могут быть как непрерывными, так и дискретными.

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

Синтаксис

Вызов функции

  • sys = frd() создает частотную передаточную функцию, заданную на одной частоте ω = 0. Ее значение также равно нулю. Вы можете изменить значения входных аргументов с помощью функции setproperty!.

  • sys = frd(response, frequency) создает частотную передаточную функцию, заданную наборами комплексных чисел response и частот frequency.

  • sys = frd(response, frequency, ts) создает частотную передаточную функцию дискретной системы, заданную наборами комплексных чисел response и частот frequency.

  • sys = frd(response, frequency, ts; timeunit) создает частотную передаточную функцию дискретной системы, заданную наборами комплексных чисел response и частот frequency. При этом единица измерения времени timeunit указывается явно.

  • sys = frd(response, frequency, ts; timeunit, frequencyunit) создает частотную передаточную функцию дискретной системы, заданную наборами комплексных чисел response и частот frequency. При этом единицы измерения времени timeunit и частоты frequencyunit указываются явно.

Аргументы

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

# response — частотный отклик
0.0 + 0.0im (по умолчанию) | скаляр | вектор | N-мерный массив

Details

Комплексное число или массив комплексных чисел, характеризующих реакцию системы на гармонические сигналы частот frequency.

Для SISO-систем частотный отклик задается в виде скаляра или вектора комплексных чисел. Количество элементов вектора должно быть равно количеству частот.

Для MIMO-систем частотный отклик задается в виде массива комплексных чисел размера , где — количество выходов системы, — количество входов системы, — количество частот.

Для массива систем с ny числом выходов и nu числом входов размера частотный отклик задается в виде массива комплексных чисел размера , где — количество частот. Например, массив комплексных чисел размера задает частотный отклик массива систем размера . Каждая система в массиве имеет выходов и входов.

Типы данных

Complex
Поддержка комплексных чисел

Да

# frequency — частоты входного сигнала
0.0 (по умолчанию) | скаляр | вектор

Details

Частота или набор частот гармонического сигнала, подаваемого на вход системы. Значения частот могут быть как положительными, так и отрицательными.

Типы данных

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64
Поддержка комплексных чисел

Нет

# ts — период дискретизации
nothing (по умолчанию) | скаляр

Details

Период частотной передаточной функции.

Типы данных

Nothing, Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64
Поддержка комплексных чисел

Нет

# timeunit — единица измерения времени
seconds (по умолчанию) | nanoseconds | microseconds | milliseconds | minutes | hours | days | weeks | months | years

Details

Единица измерения времени.

Аргумент принимает следующие значения:

  • "nanoseconds" — наносекунды;

  • "microseconds" — микросекунды;

  • "milliseconds" — миллисекунды;

  • "minutes" — минуты;

  • "hours" — часы;

  • "days" — дни;

  • "weeks" — недели;

  • "months" — месяцы;

  • "years" — годы.

Типы данных

String

# frequencyunit — единица измерения частоты
rad/timeunit (по умолчанию) | cycles/timeunit | rad/s | Hz | kHz | MHz | GHz | rpm

Details

Единица измерения частоты.

Аргумент принимает следующие значения:

  • rad/timeunit — рад/<единица_измерения_времени>;

  • "cycles/timeunit" — об/<единица_измерения_времени>;

  • "rad/s" — рад/c;

  • "Hz" — Гц;

  • "kHz" — кГц;

  • "MHz" — МГц;

  • "GHz" — ГГц;

  • "rpm" — об/мин;

Типы данных

String

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

# sys — частотная передаточная функция
frd

Details

Частотная передаточная функция.

Типы данных

frd