dsp.MatrixViewer

Визуализируйте матричные данные

Описание

dsp. MatrixViewer визуализирует матричные данные, сопоставляя элементы матрицы с заданной областью цветов.

Чтобы визуализировать матричные данные в Matrix Viewer:

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

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

Масштабирование и панорамирование

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

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

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

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

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

Создание

Синтаксис

scope = dsp.MatrixViewer

scope = dsp.MatrixViewer(Name,Value)

Описание

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 -оси, используя двухэлементный числовой вектор или числовой вектор с конечным числом элементов .

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

Пример: [5 156]

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

Зависимость

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

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

Задайте пользовательские значения для y -оси, используя двухэлементный числовой вектор или числовой вектор с конечным числом элементов .

Если вы задаете двухэлементный вектор, числа используются в качестве минимального и максимального значений 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` - Положение окна Scope в пикселях
центр экрана (по умолчанию) | `[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.

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

Чтобы использовать пользовательскую палитру, задайте трехколоночную матрицу триплетов 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(matrix)

Описание

пример

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

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

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

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

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

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

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

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

release(obj)

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

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

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

Характерно для возможностей

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

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

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

Примеры

свернуть все

Сгенерируйте спектрограмму с dsp. MatrixViewer

Открыть Live Script

В этом примере показано, как создать спектрограмму квадратичного щебета с 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 - Положение окна Scope в пикселях центр экрана (по умолчанию) | [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 System Toolbox

Поддержка

`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` - Положение окна Scope в пикселях
центр экрана (по умолчанию) | `[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 числовая матрица