dsp.MatrixViewer

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

Описание

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

Визуализировать матричные данные в Матричном Средстве просмотра:

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

Чтобы узнать больше, как Системные объекты работают, смотрите то, Что Системные объекты?.

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

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

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

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

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

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

Создание

Синтаксис

scope = dsp.MatrixViewer

scope = dsp.MatrixViewer(Name,Value)

Описание

scope = dsp.MatrixViewer создает Матричную Систему Средства просмотра object™, 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 и макс. значений x - ось. Если вы задаете вектор больше чем с двумя элементами, значения должны монотонно увеличиваться, и осциллограф использует первые и последние значения вектора как минимальные и максимальные значения, соответственно. Если вы не задаете x - пределы данных оси, осциллограф использует количество входных столбцов как максимальный x - значение оси.

Пример: [5 156]

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

Зависимость

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

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

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

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

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

`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`	Отобразите окно scope
`hide`	Скройте окно scope
`isVisible`	Определите видимость осциллографа

Характерный для всех системных объектов

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

Примеры

свернуть все

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

Скрипт Open 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

Введенный в 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 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` — Определите объем положения окна в пикселях
экранируйте центр (значение по умолчанию) | `[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 числовая матрица