Exponenta Banner

dsp.TimeScope

(Будет удален) Отображение и измерение сигнала временной области

развернуть все на странице

Описание

Примечание

dsp.TimeScope не рекомендуется. Использование timescope вместо этого. Для получения дополнительной информации см. «Вопросы совместимости»

The dsp.TimeScope System object™ отображает сигналы временной области. Можно использовать возможности, чтобы измерить значения сигналов, найти peaks, отобразить двухвольные измерения и статистику.

Чтобы увидеть сигналы временной области в возможности:

  1. Создайте dsp.TimeScope Объекту и установите его свойства.

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

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

Функции осциллографа:

  • Триггеры - Установите триггеры, чтобы синхронизировать повторяющиеся сигналы и приостановить отображение, когда происходят события.

  • Измерения курсора - Измерьте значения сигналов с помощью вертикальных и горизонтальных курсоров.

  • Статистика сигналов - отображение максимальных, минимальных, пиковых различий, среднего, медианного и RMS значений выбранного сигнала.

  • Пик Искателя - Найти максимумы, показывающий x значения оси, при которых они происходят.

  • Bilevel Measurements - Замерьте переходы, перерегулирования, подколы и циклы.

Для получения информации о измерениях и триггерах см. Раздел «Настройка блока Time Scope».

Функции отображения возможностей видимости:

  • Несколько сигналов - Постройте несколько сигналов на одной оси Y (отображение) с помощью нескольких входных портов.

  • Несколько осей Y (displays) - отображение нескольких осей Y. Все оси Y имеют общую временную область значений на оси X.

  • Изменение параметров - Изменение значений параметров возможностей перед и во время симуляции.

  • Автомасштабирование по оси - автоматическое сканирование во время или в конце симуляции. Поля рисуются в верхней и нижней частях осей.

Создание

Синтаксис

scope = dsp.TimeScope
scope = dsp.TimeScope(numInputs,sampleRate)
scope = dsp.TimeScope(___,Name,Value)

Описание

scope = dsp.TimeScope возвращает объект Time Scope System, scope. Этот объект отображает реальные и комплексные сигналы с плавающей и фиксированной точками во временном интервале.

scope = dsp.TimeScope(numInputs,sampleRate) создает Time Scope и устанавливает свойство NumInportPorts равным numInputs и свойство SampleRate, для sampleRate.

пример

scope = dsp.TimeScope(___,Name,Value) устанавливает свойства, заданные как «Имя», «Значения».

Свойства

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

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

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

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

Часто используемый

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

Задайте частоту дискретизации, в герцах, входных сигналов.

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

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

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

  • Минимальный предел по оси времени = min (TimeDisplayOffset)

  • Максимальный предел по временной оси = max (TimeDisplayOffset) + TimeSpan

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

Зависимости

Чтобы использовать это свойство, установите значение FrameBasedProcessing на false, или задать FrameBasedProcessing на true и TimeSpanSource для 'Property'.

Использование пользовательского интерфейса

Откройте Configuration Properties. На вкладке Time установите Time Span.

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

Задайте, как область возможностей отображает новые данные сверх видимого временного интервала.

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

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

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

Использование пользовательского интерфейса

Откройте Configuration Properties. На вкладке Time установите Time Span overrun action.

Типы данных: char | string

Укажите источник временного интервала для основанных на кадрах входных сигналов следующим образом:

  • 'Property' - Объект выводит пределы x -оси из свойств TimeDisplayOffset и TimeSpan .

  • 'Auto' - Пределы временной оси получают из TimeDisplayOffset и свойства SampleRate и FrameSize (количество строк в каждом входном сигнале). Пределы вычисляются как:

    • Минимальный предел по оси времени = min (TimeDisplayOffset)

    • Максимальный предел по временной оси = max (TimeDisplayOffset) + макс (1/ SampleRate.* FrameSize)

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

Зависимости

Чтобы использовать это свойство, задайте FrameBasedProcessing на true.

Использование пользовательского интерфейса

Откройте Configuration Properties. На вкладке Time установите Time Span.

Типы данных: char | string

Задайте, когда возможности масштабируют оси. Допустимые значения:

  • "Auto" - возможности масштабируют оси по мере необходимости, чтобы соответствовать данным, как во время, так и после симуляции.

  • "Manual" - возможности не масштабируется автоматически.

  • "OnceAtStop" - возможности масштабируют оси, когда симуляция останавливается.

  • "Updates" - возможности масштабируют оси один и только один раз после 10 обновлений.

Использование пользовательского интерфейса

Выберите Tools > Axes Scaling.

Типы данных: char | string

Расширенный

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

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

Типы данных: char | string

Положение окна возможностей в пикселях, заданное размером и расположением окна возможностей как 4-элементный вектор формы [left bottom width height]. Можно поместить окно возможностей в определенное положение на экране путем изменения значений этого свойства.

По умолчанию окно появляется в центре экрана с шириной 410 пиксели и высота 300 пиксели. Точное значение положения зависит от разрешения экрана.

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

  • true - Область возможностей регистрирует данные для дальнейшего использования и периодически обновляет окно.

  • false - возможности обновляются каждый раз, когда вызываются возможности видимости.

Скорость симуляции выше, если для этого свойства задано значение true.

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

Использование пользовательского интерфейса

Выберите Simulation > Reduce Updates to Improve Performance.

Задайте размещение сетку размерностей как вектор с 2 элементами: [numberOfRows,numberOfColumns]. Можно использовать до 16 строк и 16 столбцов.

Пример: scope.LayoutDimensions = [2,4]

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

Использование пользовательского интерфейса

Выберите View > Layout.

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

Укажите тип используемого графика.

  • Line - Линейный график, подобный line или plot функция.

  • Stairs - Ступенчатый график, подобный stairs функция. Ступенчатые графы полезны для рисования временных графиков цифровых выборочных данных.

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

Использование пользовательского интерфейса

Откройте свойства Style. Установите Plot type.

Типы данных: char | string

Укажите размер буфера, который хранится в кэше памяти возможностей. Память ограничена доступной памятью в вашей системе. Если ваш сигнал имеет M строки данных и N точки данных в каждой строке, M x N является количеством точек данных за временной шаг. Умножьте этот результат на количество временных шагов для вашей модели, чтобы получить необходимую длину буфера. Например, если у вас есть 10 строк данных с каждой строкой, имеющей 100 точек данных, и ваш запуск будет 10 временных шагов, вы должны ввести 10 000 (10 x 100 x 10) в качестве длины буфера.

Использование пользовательского интерфейса

Откройте Data History Properties. Установите Buffer length.

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

  • true - Включите обработку на основе фрейма.

  • false - Включите обработку на основе выборок.

Использование пользовательского интерфейса

Откройте Configuration Properties. На вкладке Main установите Input processing.

Задайте модули, используемые для описания временной оси. Можно выбрать один из следующих опций:

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

  • Seconds - В этом режиме возможности всегда отображают модули на оси времени как секунды.

  • None - В этом режиме возможности не отображает никаких модулей измерения на оси времени. Область возможностей показывает только слово Time по оси времени.

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

Использование пользовательского интерфейса

Откройте Configuration Properties. На вкладке Time установите Time units.

Типы данных: char | string

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

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

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

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

Использование пользовательского интерфейса

Откройте Configuration Properties. На вкладке Time установите Time display offset.

Укажите, как метки оси времени должны появляться в отображениях возможностей как:

  • 'All' - Метки оси времени появляются во всех отображениях.

  • 'Bottom' - Метки оси времени появляются в нижнем отображении каждого столбца.

  • 'None' - Метки не отображаются ни на одном отображении.

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

Использование пользовательского интерфейса

Откройте Configuration Properties. На вкладке Time установите Time-axis labels.

Типы данных: char | string

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

  • "Auto" - Оси появляются максимизированными во всех отображениях, только если Title и YLabel свойства пусты для каждого отображения. Если вы вводите любое значение в любом отображении для любого из этих свойств, оси не максимизируются.

  • "On" - Оси появляются максимизированными во всех отображениях. Любые значения, введенные в Title и YLabel свойства скрыты.

  • "Off" - Ни одна из осей не выглядит максимизированной.

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

Использование пользовательского интерфейса

Откройте Configuration Properties. На вкладке Main установите Maximize axes.

Типы данных: char | string

Отображение

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

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

Использование пользовательского интерфейса

Откройте Configuration Properties. На вкладке Display установите Active Display.

Задайте заголовок отображения как вектор символов или строку.

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

Использование пользовательского интерфейса

Откройте Configuration Properties. Установите Title.

Типы данных: char | string

Чтобы показать легенду с входными именами, задайте для этого свойства значение true.

Из легенды можно управлять, какие сигналы видны. Этот элемент управления эквивалентен изменению видимости в диалоговом окне Style. В легенде возможностей щелкните имя сигнала, чтобы скрыть сигнал в возможности. Чтобы отобразить сигнал, снова щелкните имя сигнала. Чтобы показать только один сигнал, щелкните правой кнопкой мыши имя сигнала. Чтобы показать все сигналы, нажмите Esc.

Примечание

Легенда показывает только первые 20 сигналов. Никакие дополнительные сигналы не могут быть просмотрены или управлены из легенды.

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

Использование пользовательского интерфейса

Откройте Configuration Properties. На вкладке Display выберите Show legend.

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

Когда вы устанавливаете это свойство на trueобласть возможностей отображает метку оси времени. Когда вы устанавливаете это свойство на falseОбласть возможностей не отображает метку оси времени, но все еще отображает отметки деления и другие элементы временной оси. Это свойство применяется только в том случае, если TimeAxisLabels свойство All или Bottom.

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

Зависимость

Чтобы контролировать, какая ось отображения маркирована, используйте ActiveDisplay свойство.

Использование пользовательского интерфейса

Откройте Configuration Properties. На вкладке Time установите Show time-axis label.

Задайте имена входных каналов как массив ячеек из векторов символов. Имена появляются в легенде, Style диалоговом окне и Measurements панелях. Если вы не задаете имена, каналы помечаются как Channel 1, Channel 2, и т.д.

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

Зависимость

Чтобы увидеть имена каналов, задайте ShowLegend на true.

Использование пользовательского интерфейса

В легенде дважды кликните имя канала.

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

Установите это свойство на true отображение линий сетки на графике.

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

Использование пользовательского интерфейса

Откройте Configuration Properties. На вкладке Display установите Show grid.

Когда вы устанавливаете это свойство на trueобласть возможностей строит графики величины и фазы входного сигнала на двух отдельных осях в одном и том же активном отображении. Когда вы устанавливаете это свойство на falseобласть возможностей строит график действительной и мнимой частей входного сигнала на двух отдельных осях в одном и том же активном отображении.

Это свойство полезно для комплексных входных сигналов. Включение этого свойства влияет на фазу для реальных входных сигналов. Когда амплитуда входного сигнала неотрицательная, фаза составляет 0 степени. Когда амплитуда входного сигнала отрицательная, фаза составляет 180 степени.

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

Использование пользовательского интерфейса

Откройте Configuration Properties. На вкладке Display выберите Plot signals as magnitude and phase.

Задайте y пределы по осям как двухэлементный числовой вектор, [ymin, ymax].

Если PlotAsMagnitudePhase является false, по умолчанию является [-10,10]. Если PlotAsMagnitudePhase является true, по умолчанию является [0,10].

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

Зависимости

Когда PlotAsMagnitudePhase является trueэто свойство задает y пределы оси только для графика величины. Пределы y-оси фазового графика всегда [-180,180].

Использование пользовательского интерфейса

Откройте Configuration Properties. На вкладке Display установите Y-limits (Minimum) и Y-limits (Maximum).

Задайте текст области видимости слева от оси y .

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

Зависимости

Это свойство применяется только тогда, когда PlotAsMagnitudePhase является false. Когда PlotAsMagnitudePhase является trueдве y метки -оси являются значениями, доступными только для чтения. Для меток y-оси задано значение "Magnitude" и "Phase" для графика величины и фазы, соответственно.

Использование пользовательского интерфейса

Откройте Configuration Properties. На вкладке Display установите Y-Label.

Типы данных: char | string

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

Синтаксис

scope(signal)
scope(signal,signal2,...,signalN)

Описание

scope(signal) отображает сигнал, signal, во временных возможностях отображения.

scope(signal,signal2,...,signalN) отображает сигналы signal, signal2..., signalN во временных возможностях отображения, когда вы устанавливаете NumInputPorts свойство к N. В этом случае signal1, signal2..., signalN может иметь различные типы данных и размерности.

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

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

Задайте один или несколько входных сигналов для визуализации в dsp.TimeScope. Сигналы могут иметь различные типы данных и размерности.

Пример: scope(signal1,signal2)

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

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

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

release(obj)

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

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

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

Примеры

свернуть все

Создание dsp.SineWave и dsp.TimeScope объекты. Запустите возможности, чтобы отобразить сигнал

sine = dsp.SineWave('Frequency',100,'SampleRate',1000);
sine.SamplesPerFrame = 10;
scope = dsp.TimeScope('SampleRate',sine.SampleRate,'TimeSpan',0.1);
for ii = 1:10
     x = sine();
     scope(x);
end

Запуск release метод, позволяющий изменять значения свойств и входные характеристики. Область возможностей автоматически масштабирует оси.

release(scope)

Совет

  • Чтобы закрыть окно возможностей и очистить связанные с ним данные, используйте MATLAB® clear функция.

  • Чтобы скрыть или показать окно возможностей, используйте hide и show функций.

  • Используйте MATLAB mcc функция для компиляции кода, содержащего возможности.

    Вы не можете открыть диалоговые окна строения возможностей, если в приложении есть несколько скомпилированных компонентов.

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

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

Предупреждает, начиная с R2021a

Расширенные возможности

.

См. также

Объекты

Объекты

Блоки

Темы

Введенный в R2011a

Документация DSP System Toolbox

Поддержка