dsp.TransitionMetrics

(Будет удален) Переходные метрики двухуровневых сигналов

dsp.TransitionMetrics будет удалено в следующем релизе. Вместо этого используйте функции из Импульса и Метрики Перехода. Функции в этом наборе включают falltime, overshoot, risetime, settlingtime, slewrate, и undershoot среди прочих.

Описание

The dsp.TransitionMetrics объект извлекает информацию, такую как длительность, скорость нарастания и контрольные переходы для каждого перехода, обнаруженного в двухуровневый сигнал. The dsp.TransitionMetrics объект может дополнительно возвращать предрегулирование, пострегулирование и оседание метрики для областей непосредственно до и после каждого перехода.

Чтобы получить метрики перехода для двухуровневого сигнала:

Создайте dsp.TransitionMetrics Объекту и установите его свойства.
Вызывайте объект с аргументами, как будто это функция.

Дополнительные сведения о работе системных объектов см. в разделе «Что такое системные объекты?».

Создание

Синтаксис

tm = dsp.TransitionMetrics

tm = dsp.TransitionMetrics(Name,Value)

Описание

tm = dsp.TransitionMetrics создает метрики переходов System object™, tm. Объект вычисляет время нарастания, время спада и ширину импульса. TransitionMetrics дополнительно вычисляет метрики цикла, такие как разделение импульсов, периоды и коэффициенты заполнения.

пример

tm = dsp.TransitionMetrics(Name,Value) возвращает TransitionMetrics Системный объект, tm, с каждым заданным набором свойств до заданного значения.

Свойства

расширить все

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

Если свойство настраивается, можно изменить его значение в любой момент.

Для получения дополнительной информации об изменении значений свойств смотрите Разработку системы в MATLAB Использование Системных объектов.

`MaximumRecordLength` - Максимальные выборки для сохранения
`1000` (по умолчанию) | положительное целое число

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

Зависимости

Это свойство применяется при RunningMetrics является true и настраивается.

`PercentReferenceLevels` - Базовые уровни
`[10 50 90]` (по умолчанию) | трехэлементный вектор-строка

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

Типы данных: double

`PercentStateLevelTolerance` - Допуск уровня состояния
`2` (по умолчанию) | положительная скалярная величина

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

Типы данных: double

`PostshootOutputPort` - Включите метрики аберрации постперехода
`false` (по умолчанию) | `true`

Включите метрики аберрации постперехода. Если для этого свойства задано значение trueСообщается о перерегулировании и метриках undershoot для области, определенной сразу после каждого перехода. Область аберрации постперехода определяется как интервал формы волны, который начинается в конце каждого перехода и чья длительность является значением PostshootSeekFactor умножает вычисленную длительность перехода. Если полный последующий переход обнаружен до окончания интервала, область обрезается в начале последующего перехода. Метрики вычисляются для каждого перехода, который имеет полную область аберрации постперехода.

`PostshootSeekFactor` - Коэффициент поиска после выстрела
`3` (по умолчанию) | положительная скалярная величина

Соответствует длительности поиска перерегулирования и метрик undershoot сразу после каждого перехода. Длительность выражается как фактор длительности перехода.

Настраиваемый: Да

Зависимости

Это свойство включено только, когда PostshootOutputPort для свойства задано значение true и настраивается.

Типы данных: double

`PreshootOutputPort` - Включите метрики аберрации перед перемещением
`false` (по умолчанию) | `true`

Включите метрики аберрации перед перемещением. Если на PreshootOutputPort для свойства задано значение trueСообщаются о перерегулировании и метриках undershoot для области, заданной непосредственно перед каждым переходом. Область аберрации перед перемещением определяется как интервал формы волны, который заканчивается в начале каждого перехода и длительность PreshootSeekFactor умножает вычисленную длительность перехода.

`PreshootSeekFactor` - Коэффициент Preshoot seek
`3` (по умолчанию) | положительная скалярная величина

Соответствует длительности поиска перерегулирования и метрик undershoot непосредственно перед каждым переходом. Длительность выражается как фактор длительности перехода.

Настраиваемый: Да

Зависимости

Это свойство включено только, когда PreshootOutputPort для свойства задано значение true и настраивается.

Типы данных: double

`RunningMetrics` - Включить метрики по вызовам
`false` (по умолчанию) | `true`

Включите метрики во всех вызовах алгоритма. Если RunningMetrics установлено в falseметрики вычисляются для каждого вызова алгоритма независимо. Если RunningMetrics установлено в trueметрики вычисляются через последующие вызовы алгоритма. Если недостаточно выборок для вычисления метрик, связанных с последним переходом, область аберрации постперехода или длительность поиска в текущей записи, объект откладывает сообщения обо всех метриках перехода, аберрации и установления, сопоставленных с последним переходом, пока последующий вызов алгоритма не будет выполнен с достаточным количеством данных, чтобы вычислить все включенные метрики для этого перехода.

`SampleRate` - Частота дискретизации
`1` (по умолчанию) | положительная скалярная величина

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

Зависимости

Это свойство применяется, когда TimeInputPort для свойства задано значение false.

Типы данных: double

`SettlingOutputPort` - Включите настройку метрики
`false` (по умолчанию) | `true`

Включите настройку метрики. Если SettlingOutputPort установлено значение true, для каждого перехода сообщаются метрики установления. Область, используемая для вычисления осаждающих метрик, начинается со среднекросинга и продолжается до SettlingSeekDuration прошло. Если происходит промежуточный переход, или сигнал не обосновался в PercentStateLevelTolerance окончательного уровня, NaN возвращается для каждой метрики. Если после последнего перехода не хватает выборок, чтобы выполнить SettlingSeekDurationметрики для последнего перехода не сообщаются. Метрики сообщаются для перехода при следующем вызове алгоритма, если RunningMetrics для свойства задано значение true.

`SettlingSeekDuration` - длительность поиска осадки
`0.02` (по умолчанию) | положительная скалярная величина

Длительность времени, в течение которого можно искать обоснование. Это свойство является скаляром, который задает количество времени для проверки от пересечения середины контрольного уровня (в секундах). Если переход еще не урегулирован, или за эту длительность обнаруживается последующий полный переход, TransitionMetrics отчеты объектов NaN для всех расчетных метрик.

Настраиваемый: Да

Зависимости

Это свойство применяется только при установке SettlingOutputPort свойство к true.

Типы данных: double

`StateLevels` - Уровни состояния
`[0 2.3]` (по умолчанию) | двухэлементный вектор-строка

Низко- и высокогосударственные уровни. Это свойство является двухэлементным числовым вектором-строкой, который содержит низкий и высокий уровни состояния соответственно. Эти уровни состояний соответствуют номинальной логике низких и высоких уровней импульсного сигнала.

Настраиваемый: Да

Типы данных: double

`StateLevelsSource` - Источник уровня состояния
`'Property'` (по умолчанию) | `'Auto'`

Автоматический или ручной расчет уровня состояния. Если на StateLevelsSource для свойства задано значение 'Auto', первая запись, отправленная алгоритму, использует dsp.StateLevels объект с настройками по умолчанию, чтобы определить уровни состояния входящей формы волны. Если для этого свойства задано значение 'Property'объект использует значения, заданные пользователем в StateLevels свойство.

`TimeInputPort` - Входной параметр времени
`false` (по умолчанию) | `true`

Добавьте вход, чтобы задать образец мгновений. Задайте TimeInputPort на true чтобы включить дополнительный действительный входной вектор-столбец к алгоритму, чтобы задать выборочные моменты, которые соответствуют значениям выборки. Если это свойство false, образцы мгновений строятся внутренне. Моменты расчета начинаются с нуля и увеличиваются на взаимное SampleRate свойство для последующих выборок. Экземпляры сэмпла продолжают увеличиваться, если RunningMetrics для свойства задано значение true и никаких промежуточных вызовов в reset или release встречаются методы.

Использование

Синтаксис

pulse = tm(x)

[pulse,cycle] = tm(x)

[pulse,transition] = tm(x)

[pulse,preshoot] = tm(x)

[pulse,postshoot] = tm(x)

[pulse,settling] = tm(x)

[pulse,cycle,transition,preshoot,postshoot,settling] = tm(x)

[___] = tm(x,T)

Описание

pulse = tm(x) возвращает массив структур, pulse, поля которого содержат реальные векторы-столбцы. Количество строк каждого поля соответствует количеству полных импульсов, найденных на вектор-столбец входе с реальным значением x.

[pulse,cycle] = tm(x) возвращает массив структур, cycle, когда вы устанавливаете CycleOutputPort свойство к true. Поля cycle содержат реальные векторы-столбцы. Количество строк каждого поля соответствует количеству полных импульсных периодов, найденных на вектор-столбец входе с реальным значением x.

[pulse,transition] = tm(x) возвращает массив структур, transition, когда вы устанавливаете TransitionOutputPort свойство к true. Поля transition содержат вещественные матрицы с двумя столбцами, которые соответствуют метрикам первого и второго переходов. Количество строк соответствует количеству импульсов, обнаруженных в вход форме волны.

[pulse,preshoot] = tm(x) возвращает массив структур, preshoot, когда вы устанавливаете PreshootOutputPort свойство к true. Поля preshoot содержат вещественные двухколоночные матрицы, длина строки которых соответствует количеству переходов, обнаруженных в вход сигнала. Имена полей идентичны именам postshoot структура.

[pulse,postshoot] = tm(x) возвращает массив структур, postshoot, когда вы устанавливаете PostshootOutputPort свойство к true. Поля postshoot содержат вещественные двухколоночные матрицы, длина строки которых соответствует количеству переходов, обнаруженных в вход сигнала.

[pulse,settling] = tm(x) возвращает структуру, settling, когда вы устанавливаете SettlingOutputPort свойство к true. Поля settling соответствуют метрикам установления для каждого перехода. Каждое поле является вектором-столбцом, элементы которого соответствуют отдельным установочным длительности, уровням и моментам.

[pulse,cycle,transition,preshoot,postshoot,settling] = tm(x) который возвращает pulse, cycle, transition, preshoot, postshoot, и settling массивы структур, когда CycleOutputPort, PreshootOutputPort, PostshootPort, и SettlingOutputPort свойства true. Можно включать или отключать любую комбинацию выхода портов. Однако выходные аргументы заданы в порядке, показанном здесь.

пример

[___] = tm(x,T) выполняет вышеуказанные метрики относительно дискретизированного сигнала, значения выборки которого, x, и образец мгновений, T, являются реальными векторами-столбцами той же длины. Дополнительный вход T применяется только при установке TimeInputPort свойство к true.

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

расширить все

`x` - Входной сигнал
Вектор-столбец

Входной сигнал, заданный как реальный вектор-столбец.

Типы данных: double

`T` - Моменты отбора проб
Вектор-столбец

Моменты дискретизации, заданные как реальный вектор-столбец. Задайте TimeInputPort на true чтобы включить дополнительный действительный входной вектор-столбец к алгоритму объекта, чтобы задать моменты расчета, которые соответствуют значениям выборки. Если это свойство false, образцы мгновений строятся внутренне. Моменты расчета начинаются с нуля и увеличиваются на взаимное SampleRate свойство для последующих выборок. Экземпляры сэмпла продолжают увеличиваться, если RunningMetrics для свойства задано значение true и никаких промежуточных вызовов в reset или release встречаются методы.

Зависимости

Этот вход применим, когда вы устанавливаете TimeInputPort свойство к true.

Типы данных: double

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

расширить все

`pulse` - Полные импульсы
структура

Полные импульсы, возвращенные как структура, поля которой содержат реальные векторы-столбцы. Количество строк каждого поля соответствует количеству полных импульсов, найденных на вектор-столбец входе с реальным значением x. Каждый импульс начинается с перехода полярности, заданной Polarity свойство и заканчивается переходом противоположной полярности.

The pulse выходы содержат следующие поля:

PositiveCross - Моменты, когда положительные переходы пересекают средний базовый уровень каждого импульса
NegativeCross - Моменты, где отрицательные переходы пересекают средний базовый уровень каждого импульса
Width - Абсолютное различие между PositiveCross и NegativeCross каждого импульса
RiseTime - Длительность между линейно-интерполированными моментами, когда положительный (растущий) переход каждого импульса пересекает нижний и верхний эталонные уровни
FallTime - Длительность между линейно-интерполированными моментами, когда отрицательный (падающий) переход каждого импульса пересекает верхний и нижний эталонные уровни

Типы данных: struct

`cycle` - Завершение импульсных периодов
структура

Завершите импульсные периоды, возвращенные, когда вы устанавливаете CycleOutputPort свойство к true. Импульсные периоды возвращаются как структура, поля которой содержат реальные векторы-столбцы. Количество строк каждого поля соответствует количеству полных импульсных периодов, найденных на вектор-столбец входе с реальным значением x. Вам нужно как минимум три последовательных чередующихся перехода полярности, которые начало и конец с той же полярностью, что и значение Polarity свойство, если необходимо вычислить метрики цикла. Если последний переход найден в входе x не соответствует полярности Polarity свойство, импульсное разделение, период, частота и коэффициент заполнения не сообщаются для последнего импульса. Если на RunningMetrics для свойства задано значение true Когда это происходит, все импульсы, циклы, переходы, предварительный перерегулирование, пострегулирование и установление метрики, сопоставленные с последним импульсом, откладываются до тех пор, пока последующий вызов алгоритма не обнаружит следующий переход.

The cycle выходы содержат следующие поля:

Period - длительность между первым переходом импульса тока и первым переходом следующего импульса.
Frequency - Взаимность периода.
Separation - Продолжительность между пересечениями середины контрольного уровня первого и второго переходов каждого импульса.
Width - Продолжительность между пересечениями середины контрольного уровня первого и второго переходов каждого импульса. Это эквивалентно параметру ширины pulse структура.
DutyCycle - Отношение ширины к периоду для каждого импульса.

Типы данных: struct

`transition` - Метрики переходов
структура

Метрики перехода, возвращенные как массив структур, когда вы устанавливаете TransitionOutputPort свойство к true. Поля transition содержат вещественные матрицы с двумя столбцами, которые соответствуют метрикам первого и второго переходов. Количество строк соответствует количеству импульсов, обнаруженных в вход форме волны.

The transition выходы содержат следующие поля:

Duration - Количество времени между интерполированными моментами, где переход пересекает нижний и верхний эталонные уровни
SlewRate - Отношение абсолютного различия между верхним и нижним базовыми уровнями к длительности перехода
MiddleCross - Линейно интерполированный момент, где переход сначала пересекает средний эталонный уровень
LowerCross - Линейно интерполированный момент, где сигнал пересекает нижний эталонный уровень
UpperCross - Линейно интерполированный момент, где сигнал пересекает верхний эталонный уровень

Типы данных: struct

`preshoot` - Предварительные метрики
структура

Предварительные метрики, возвращенные как массив структур, когда вы устанавливаете PreshootOutputPort свойство к true. Поля preshoot содержат вещественные двухколоночные матрицы, длина строки которых соответствует количеству переходов, обнаруженных в вход сигнала.

The preshoot выходы содержат следующие поля:

Overshoot - перерегулирование необходимой области, выраженное в процентах от амплитуды формы волны
Undershoot - Недорегулирование необходимой области, выраженное в процентах от амплитуды формы волны
OvershootLevel - Уровень перерегулирования
UndershootLevel - Уровень подколенного слоя
OvershootInstant - Мгновенный, который соответствует перерегулированию
UndershootInstant - Мгновенный, который соответствует подрезу

Типы данных: struct

`postshoot` - Метрики постсимметрии
структура

Метрики postshoot, возвращенные как массив структур, когда вы устанавливаете PostshootOutputPort свойство к true. Поля postshoot содержат вещественные двухколоночные матрицы, длина строки которых соответствует количеству переходов, обнаруженных в вход сигнала.

The postshoot выходы содержат следующие поля:

Overshoot - перерегулирование необходимой области, выраженное в процентах от амплитуды формы волны
Undershoot - Недорегулирование необходимой области, выраженное в процентах от амплитуды формы волны
OvershootLevel - Уровень перерегулирования
UndershootLevel - Уровень подколенного слоя
OvershootInstant - Мгновенный, который соответствует перерегулированию
UndershootInstant - Мгновенный, который соответствует подрезу

Типы данных: struct

`settling` - Метрики расчета
структура

Определение метрики для каждого перехода, возвращаемое как массив структур, когда вы устанавливаете SettlingOutputPort свойство к true. Поля settling соответствуют метрикам установления для каждого перехода. Каждое поле является вектором-столбцом, элементы которого соответствуют отдельным установочным длительности, уровням и моментам.

The settling выходы содержат следующие поля:

Duration - Количество времени, с которого сигнал пересекает средний эталонный уровень, до времени, когда сигнал входит и остается в пределах заданного PercentStateLevelTolerance амплитуды формы волны на заданную длительность поиска осаждения
Instant - мгновенно, когда сигнал входит и остается в пределах заданного допуска.
Level - Уровень формы волны, где он входит и остается в пределах заданного допуска.

Типы данных: struct

Функции объекта

Чтобы использовать функцию объекта, задайте системный объект в качестве первого входного параметра. Например, чтобы освободить системные ресурсы системного объекта с именем obj, используйте следующий синтаксис:

release(obj)

расширить все

Характерно для `dsp.TransitionMetrics`

plot (Будет удален) Постройте график импульсного сигнала и метрики

Общий для всех системных объектов

`step`	Запуск алгоритма системного объекта
`release`	Отпустите ресурсы и допустите изменения в значениях свойств системного объекта и входных характеристиках
`reset`	Сброс внутренних состояний Системного объекта

Примеры

свернуть все

Информация о переходе и предварительном перемещении волны 2.3 V Step

Примечание.Если вы используете R2016a или более ранний релиз, замените каждый вызов объекта эквивалентным синтаксисом шага. Для примера, obj(x) становится step(obj,x).

Вычислите переходную и предварительную информацию о шаговой форме волны 2,3 В, дискретизированной на 4 МГц. Загрузите данные.

load('transitionex.mat','x');

Создайте dsp.TransitionMetrics объект. Установите SampleRate свойство к 4 MHz и StateLevelsSource свойство к 'Auto' для оценки уровней состояния из данных. Установите PreshootOutputPort свойство к true выводить метрики аберрации перед перемещением при вызове объекта.

tm = dsp.TransitionMetrics('SampleRate',4e6, ...
                                 'StateLevelsSource','Auto', ...
                                 'PreshootOutputPort',true)

tm = 
  dsp.TransitionMetrics with properties:

             StateLevelsSource: 'Auto'
                   StateLevels: [0 2.3000]
    PercentStateLevelTolerance: 2
        PercentReferenceLevels: [10 50 90]
                RunningMetrics: false
                 TimeInputPort: false
                    SampleRate: 4000000
            PreshootOutputPort: true
            PreshootSeekFactor: 3
           PostshootOutputPort: false
            SettlingOutputPort: false

Вызовите объект, чтобы вычислить информацию о переходе и предварительном перемещении. Постройте график результата.

[transition,preshoot] = tm(x)

transition = struct with fields:
       Duration: 1.7800e-07
       Polarity: 1
       SlewRate: 1.0310e+07
    MiddleCross: 5.1250e-06
     LowerCross: 5.0360e-06
     UpperCross: 5.2140e-06

preshoot = struct with fields:
            Overshoot: 4.8050
           Undershoot: 6.1798
       OvershootLevel: 0.1020
      UndershootLevel: -0.1500
     OvershootInstant: 4.7500e-06
    UndershootInstant: 5.0000e-06

plot(tm)

Вопросы совместимости

расширить все