Exponenta Banner
exponenta event banner

dsp. TimeScope

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

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

Описание

Примечание

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

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

Для просмотра сигналов временной области в области:

  1. Создать dsp.TimeScope и задайте его свойства.

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

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

Особенности осциллографа:

  • Триггеры - установка триггеров для синхронизации повторяющихся сигналов и приостановка отображения при возникновении событий.

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

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

  • Пиковый поиск (Peak Finder) - поиск максимумов, показывающих значения по оси X, при которых они возникают.

  • Двухуровневые измерения (Bilevel Measurements) - измерение переходов, перегрузок, недоработок и циклов.

Сведения об измерениях и триггерах см. в разделе Настройка блока временной области.

Функции отображения области:

  • Множественные сигналы - постройте график множественных сигналов на одной оси Y (дисплей) с использованием нескольких входных портов.

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

  • Изменить параметры - изменение значений параметров области до и во время моделирования.

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

Создание

Синтаксис

scope = dsp. TimeScope
scope = dsp. TimeScope (numInputs, sampleRate)
scope = dsp. TimeScope (___, имя, значение)

Описание

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

scope = dsp.TimeScope(numInputs,sampleRate) создает временную область и устанавливает для свойства NumInputPorts значение numInputs и свойство SampleRate для sampleRate.

пример

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

Свойства

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

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

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

Дополнительные сведения об изменении значений свойств см. в разделе Проектирование системы в MATLAB с использованием системных объектов.

Часто используется

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

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

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

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

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

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

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

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

Зависимости

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

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

Откройте окно «Свойства конфигурации». На вкладке Время установите Интервал времени.

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

Укажите способ отображения в области новых данных за пределами видимого интервала времени.

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

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

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

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

Откройте окно «Свойства конфигурации». На вкладке Время задайте действие Превышение интервала времени.

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

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

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

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

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

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

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

Зависимости

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

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

Откройте окно «Свойства конфигурации». На вкладке Время установите Интервал времени.

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

Укажите, когда область масштабирует оси. Допустимые значения:

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

  • "Manual" - Область не масштабирует оси автоматически.

  • "OnceAtStop" - Область масштабирования осей при остановке моделирования.

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

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

Выберите «Сервис» > «Масштабирование осей».

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

Расширенный

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

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

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

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

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

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

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

  • false - Область обновляется при каждом вызове области.

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

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

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

Выберите меню «Моделирование» > «Уменьшить обновления для повышения производительности».

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

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

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

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

Выберите меню «Вид» > «Макет».

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

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

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

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

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

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

Откройте свойства «Стиль». Задать тип печати.

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

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

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

Откройте окно Свойства истории данных. Задать длину буфера.

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

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

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

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

Откройте окно «Свойства конфигурации». На вкладке Главная (Main) установите параметр Обработка ввода (Input processing).

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

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

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

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

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

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

Откройте окно «Свойства конфигурации». На вкладке Время (Time) задайте Единицы времени (Time units).

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

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

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

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

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

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

Откройте окно «Свойства конфигурации». На вкладке Время (Time) задайте смещение отображения времени.

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

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

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

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

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

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

Откройте окно «Свойства конфигурации». На вкладке Время (Time) задайте метки оси времени.

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

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

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

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

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

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

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

Откройте окно «Свойства конфигурации». На вкладке Главная (Main) установите флажок Максимизировать оси (Maximize axes).

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

Показ

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

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

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

Откройте окно «Свойства конфигурации». На вкладке Отображение (Display) установите значение Активное отображение (Active Display).

Укажите заголовок отображения в виде символьного вектора или строки.

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

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

Откройте окно «Свойства конфигурации». Задать заголовок.

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

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

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

Примечание

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

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

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

Откройте окно «Свойства конфигурации». На вкладке «Отображение» выберите «Показать легенду».

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

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

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

Зависимость

Для управления тем, какая ось дисплея помечена, используйте ActiveDisplay собственность.

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

Откройте окно «Свойства конфигурации». На вкладке Время (Time) установите флажок Показать метку оси времени (Show time-axis label).

Укажите имена входных каналов в виде массива ячеек символьных векторов. Имена отображаются в легенде, диалоговом окне «Стиль» и на панелях «Измерения». Если имена не указаны, каналы помечаются как Channel 1, Channel 2и т.д.

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

Зависимость

Для просмотра имен каналов установите ShowLegend кому true.

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

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

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

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

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

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

Откройте окно «Свойства конфигурации». На вкладке Отображение (Display) задайте Показать сетку (Show grid).

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

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

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

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

Откройте окно «Свойства конфигурации». На вкладке Отображение (Display) выберите Сигнал графика (Plot signals) в качестве величины и фазы.

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

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

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

Зависимости

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

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

Откройте окно «Свойства конфигурации». На вкладке «Отображение» задайте Y-пределы (минимальные) и Y-пределы (максимальные).

Укажите текст области для отображения слева от оси Y.

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

Зависимости

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

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

Откройте окно «Свойства конфигурации». На вкладке «Отображение» установите значение «Y-Label».

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

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

Синтаксис

объем (сигнал)
объем (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

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

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

release(obj)

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

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

Если вы хотите перезапустить моделирование с самого начала, позвоните 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

Поддержка