dsp. MatrixViewer

Визуализация матричных данных

Описание

DSP. MatrixViewer визуализирует матричные данные путем сопоставления матричных элементов с заданным диапазоном цветов.

Для визуализации матричных данных в Matrix Viewer:

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

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

Зумирование и панорамирование

Для масштабирования осей графика можно использовать кнопку прокрутки мыши для увеличения/уменьшения масштаба графика, а также клавиши CTRL + щелчок и перетаскивание для панорамирования графика. Кроме того, можно использовать кнопки, которые появляются при наведении курсора на правый верхний угол окна печати.

- автоматическое масштабирование осей в соответствии с данными.
- Увеличьте изображение графика.
- Панорамирование вокруг осей.

Измерения курсора

Активизируйте измерения курсора, наведя курсор на просмотр матрицы и нажимая кнопку курсора.

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

Создание

Синтаксис

scope = dsp. MatrixViewer

scope = dsp. MatrixViewer (имя, значение)

Описание

scope = dsp.MatrixViewer создает системную object™ Matrix Viewer, scope.

пример

scope = dsp.MatrixViewer(Name,Value) задает свойства, используя одну или несколько пар имя-значение. Заключите каждое имя свойства в отдельные кавычки. Например, scope = dsp.MatrixViewer("AxisOrigin","Lower left corner")

Свойства

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

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

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

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

Матричная информация

`XDataMode` - режим нумерации по оси X
`"Offset and resolution"` (по умолчанию) | `"Custom"`

Укажите режим нумерации по оси X.

"Offset and resolution" - вычислить точки данных оси X из свойств XResolution и XOffset.
"Custom" - вычислять точки данных оси X с помощью свойства CustomXData.

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

`YDataMode` - режим нумерации по оси Y
`"Offset and resolution"` (по умолчанию) | `"Span and resolution"` | `"Custom"`

Укажите режим нумерации по оси Y:

"Span and resolution" - вычислить точки данных оси Y из свойств YSpan и YResolution.
"Offset and resolution" - вычислить точки данных оси Y из свойств YResolution и YOffset.
"Custom" - вычислять точки данных оси Y с помощью свойства CustomYData.

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

`CustomXData` - Пользовательские значения данных для оси X
`[1 numberOfColumns]` (по умолчанию) | `[min max]` | монотонно увеличивающийся числовой вектор

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

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

Пример: [5 156]

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

Зависимость

Чтобы включить это свойство, необходимо установить для параметра XDataMode значение "Custom".

`CustomYData` - Пользовательские значения данных для оси y
`[1 numberOfRows]` (по умолчанию) | `[min max]` | монотонно увеличивающийся числовой вектор

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

Если задан двухэлементный вектор, в качестве значений min и max оси y используются числа. Если задан вектор с более чем двумя элементами, значения должны быть монотонно увеличены, и область действия использует первое и последнее значения вектора в качестве минимального и максимального значений соответственно. Если пределы данных по оси Y не заданы, область использует количество входных строк в качестве максимального значения по оси Y.

Пример: [-130 10]

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

Зависимость

Чтобы включить это свойство, необходимо установить для YDataMode значение "Custom".

`XOffset` - Отображение смещения оси X
`0` (по умолчанию) | скаляр

Задайте смещение для отображения на оси X в виде скаляра.

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

Зависимость

Чтобы включить это свойство, необходимо установить для параметра XDataMode значение "Offset and resolution".

`XResolution` - Шаг оси X
`1` (по умолчанию) | скаляр

Укажите интервал значений вдоль оси X как скаляр.

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

Зависимость

Чтобы включить это свойство, необходимо установить для параметра XDataMode значение "Offset and resolution".

`YOffset` - Отображение смещения оси Y
`0` (по умолчанию) | скаляр

Задайте смещение для отображения на оси Y в виде скаляра.

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

Зависимость

Чтобы включить это свойство, необходимо установить для YDataMode значение "Offset and resolution".

`YResolution` - Шаг оси Y
`1` (по умолчанию) | скаляр

Задайте интервал значений вдоль оси Y как скаляр.

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

Зависимость

Чтобы включить это свойство, необходимо установить для YDataMode значение "Offset and resolution" или "Span and resolution".

`YSpan` - Пролет оси y
`100` (по умолчанию) | положительный скаляр

Укажите диапазон значений вдоль оси Y как скаляр.

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

Зависимость

Чтобы включить это свойство, необходимо установить для YDataMode значение "Span and resolution".

Визуализация

`Name` - Имя окна
`"MatrixViewer"` (по умолчанию) | символьный вектор | строковый скаляр

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

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

`AxisOrigin` - Начальное расположение участка
`"Upper left corner"` (по умолчанию) | `"Lower left corner"`

Укажите начальное расположение графика. При указании "Upper left corner"график начинается в левом верхнем углу осей и продолжается вниз.

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

`Position` - Положение окна области в пикселях
центр экрана (по умолчанию) | `[left bottom width height]`

Укажите в пикселях размер и расположение окна области в виде четырехэлементного вектора формы [left bottom width height]. По умолчанию окно области отображается в центре экрана шириной 410 пикселы и высота 300 пикселы. Значения по умолчанию для этого свойства могут изменяться в зависимости от разрешения экрана.

`Title` - Заголовок дисплея
`""` (по умолчанию) | символьный вектор | строковый скаляр

Укажите заголовок графика в виде символьного вектора или строки. По умолчанию заголовок отсутствует.

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

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

`XLabel` - метка оси X
`""` (по умолчанию) | символьный вектор | строка

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

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

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

`YLabel` - метка оси Y
`""` (по умолчанию) | символьный вектор | строка

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

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

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

`ColorBarLabel` - Метка цветовой панели
`""` (по умолчанию) | символьный вектор | строка

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

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

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

`Colormap` - Цветовая гамма
`"parula"` (по умолчанию) | имя карты цветов | трехколонная матрица триплетов RGB

Цветовая схема карты цветов, заданная как предопределенное имя карты цветов или трехстолбцовая матрица RGB-триплетов.

Список допустимых имен карт цветов см. в разделе map.

Чтобы использовать пользовательскую карту цветов, укажите трехстолбцовую матрицу RGB-триплетов. Матрицу RGB можно создать самостоятельно или вызвать предопределенную функцию карты цветов, например: colormap, для создания матрицы.

`ColorLimits` - Пределы полосы цветов
минимальное и максимальное значения матрицы (по умолчанию) | двухэлементный числовой вектор `[min max]`

Задание пределов полосы цветов в виде двухэлементного числового вектора [min max]. По умолчанию предельные значения задаются как минимальное и максимальное значения входной матрицы.

Пример: [1 80]

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

`ColorBarLocation` - Расположение цветовой панели
`"eastoutside"` (по умолчанию) | `"northoutside"` | `"southoutside"` | `"westoutside"`

Расположение цветовой полосы относительно осей.

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

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

`ShowColorBar` - Видимость цветовой полосы
`true` (по умолчанию) | `false`

Установить для этого свойства значение false скрытие цветовой полосы на графике.

`ShowGrid` - Видимость сетки
`true` (по умолчанию) | `false`

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

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

`ShowTicks` - Видимость засечек осей
`true` (по умолчанию) | `false`

Установить для этого свойства значение false скрытие засечек на осях X и Y.

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

Синтаксис

scope (матрица)

Описание

пример

scope(matrix) отображает matrix путем сопоставления значений элементов матрицы с диапазоном цветов.

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

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

`matrix` - Матрица для визуализации
Числовая матрица n-by-m

Укажите числовую матрицу n-by-m для визуализации.

Пример: scope(rand(3,5))

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

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

release(obj)

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

Специфично для dsp. MatrixViewer

setCursorDataLabels Настройка меток данных для измерений курсора

Специфично для областей

`show`	Окно области просмотра
`hide`	Скрыть окно области
`isVisible`	Определение видимости объема работ

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

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

Примеры

свернуть все

Создать спектрограмму с dsp. MatrixViewer

Открыть сценарий в реальном времени

В этом примере показано, как создать спектрограмму квадратичной чирпы с помощью dsp.MatrixViewer Системный объект.

Настройка частоты дискретизации и сигнала частотной частоты.

Fs = 233e3;
frameSize = 20e3;
chirp = dsp.Chirp("SampleRate",Fs,"SamplesPerFrame",frameSize,...
  "InitialFrequency",11e3,"TargetFrequency",11e3+55e3,...
  "Type","Quadratic");

Создать dsp.MatrixViewer сфера применения. Задайте метки осей, выберите карту цветов и задайте границы карты цветов.

scope = dsp.MatrixViewer(...
    "ColorBarLabel","Power/Frequency (dB/Hz)",...
    "XLabel","Frequency (Hz)",...
    "YLabel","Time (secs)",...
    "Colormap","hsv",...
    "ColorLimits",[-100,-30]);

Визуализируйте спектрограмму сигнала чирпа в области видимости.

for idx = 1:50
    y = chirp() + 0.05*randn(frameSize,1);
    [~,~,~,Ps] = spectrogram(y,128,120,128,1e3);
    val = 10*log10(abs(Ps)'+eps);
    scope(val);
end

См. также

dsp.DynamicFilterVisualizer | dsp.LogicAnalyzer | dsp.SpectrumAnalyzer | timescope

Представлен в R2019a

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

dsp. MatrixViewer

Описание

Зумирование и панорамирование

Измерения курсора

Создание

Синтаксис

Описание

Свойства

Матричная информация

XDataMode - режим нумерации по оси X "Offset and resolution" (по умолчанию) | "Custom"

YDataMode - режим нумерации по оси Y "Offset and resolution" (по умолчанию) | "Span and resolution" | "Custom"

CustomXData - Пользовательские значения данных для оси X [1 numberOfColumns] (по умолчанию) | [min max] | монотонно увеличивающийся числовой вектор

Зависимость

CustomYData - Пользовательские значения данных для оси y [1 numberOfRows] (по умолчанию) | [min max] | монотонно увеличивающийся числовой вектор

Зависимость

XOffset - Отображение смещения оси X 0 (по умолчанию) | скаляр

Зависимость

XResolution - Шаг оси X 1 (по умолчанию) | скаляр

Зависимость

YOffset - Отображение смещения оси Y 0 (по умолчанию) | скаляр

Зависимость

YResolution - Шаг оси Y 1 (по умолчанию) | скаляр

Зависимость

YSpan - Пролет оси y 100 (по умолчанию) | положительный скаляр

Зависимость

Визуализация

Name - Имя окна "MatrixViewer" (по умолчанию) | символьный вектор | строковый скаляр

AxisOrigin - Начальное расположение участка "Upper left corner" (по умолчанию) | "Lower left corner"

Position - Положение окна области в пикселях центр экрана (по умолчанию) | [left bottom width height]

Title - Заголовок дисплея "" (по умолчанию) | символьный вектор | строковый скаляр

XLabel - метка оси X "" (по умолчанию) | символьный вектор | строка

YLabel - метка оси Y "" (по умолчанию) | символьный вектор | строка

ColorBarLabel - Метка цветовой панели "" (по умолчанию) | символьный вектор | строка

Colormap - Цветовая гамма "parula" (по умолчанию) | имя карты цветов | трехколонная матрица триплетов RGB

ColorLimits - Пределы полосы цветов минимальное и максимальное значения матрицы (по умолчанию) | двухэлементный числовой вектор [min max]

ColorBarLocation - Расположение цветовой панели "eastoutside" (по умолчанию) | "northoutside" | "southoutside" | "westoutside"

ShowColorBar - Видимость цветовой полосы true (по умолчанию) | false

ShowGrid - Видимость сетки true (по умолчанию) | false

ShowTicks - Видимость засечек осей true (по умолчанию) | false

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

Синтаксис

Описание

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

matrix - Матрица для визуализации Числовая матрица n-by-m

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

Специфично для dsp. MatrixViewer

Специфично для областей

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

Примеры

Создать спектрограмму с dsp. MatrixViewer

См. также

Документация по системной панели инструментов DSP

Поддержка

`XDataMode` - режим нумерации по оси X
`"Offset and resolution"` (по умолчанию) | `"Custom"`

`YDataMode` - режим нумерации по оси Y
`"Offset and resolution"` (по умолчанию) | `"Span and resolution"` | `"Custom"`

`CustomXData` - Пользовательские значения данных для оси X
`[1 numberOfColumns]` (по умолчанию) | `[min max]` | монотонно увеличивающийся числовой вектор

`CustomYData` - Пользовательские значения данных для оси y
`[1 numberOfRows]` (по умолчанию) | `[min max]` | монотонно увеличивающийся числовой вектор

`XOffset` - Отображение смещения оси X
`0` (по умолчанию) | скаляр

`XResolution` - Шаг оси X
`1` (по умолчанию) | скаляр

`YOffset` - Отображение смещения оси Y
`0` (по умолчанию) | скаляр

`YResolution` - Шаг оси Y
`1` (по умолчанию) | скаляр

`YSpan` - Пролет оси y
`100` (по умолчанию) | положительный скаляр

`Name` - Имя окна
`"MatrixViewer"` (по умолчанию) | символьный вектор | строковый скаляр

`AxisOrigin` - Начальное расположение участка
`"Upper left corner"` (по умолчанию) | `"Lower left corner"`

`Position` - Положение окна области в пикселях
центр экрана (по умолчанию) | `[left bottom width height]`

`Title` - Заголовок дисплея
`""` (по умолчанию) | символьный вектор | строковый скаляр

`XLabel` - метка оси X
`""` (по умолчанию) | символьный вектор | строка

`YLabel` - метка оси Y
`""` (по умолчанию) | символьный вектор | строка

`ColorBarLabel` - Метка цветовой панели
`""` (по умолчанию) | символьный вектор | строка

`Colormap` - Цветовая гамма
`"parula"` (по умолчанию) | имя карты цветов | трехколонная матрица триплетов RGB

`ColorLimits` - Пределы полосы цветов
минимальное и максимальное значения матрицы (по умолчанию) | двухэлементный числовой вектор `[min max]`

`ColorBarLocation` - Расположение цветовой панели
`"eastoutside"` (по умолчанию) | `"northoutside"` | `"southoutside"` | `"westoutside"`

`ShowColorBar` - Видимость цветовой полосы
`true` (по умолчанию) | `false`

`ShowGrid` - Видимость сетки
`true` (по умолчанию) | `false`

`ShowTicks` - Видимость засечек осей
`true` (по умолчанию) | `false`

`matrix` - Матрица для визуализации
Числовая матрица n-by-m