dsp. MatrixViewer

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

Описание

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

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

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

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

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

Создание

Синтаксис

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 Используя Системные объекты (MATLAB).

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

Задайте x - режим нумерации оси.

  • "Offset and resolution" – Вычисляет x - точки данных оси из свойств XResolution и XOffset.

  • "Custom" – Вычисляет x - точки данных оси с помощью свойства CustomXData.

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

Задайте y - режим нумерации оси:

  • "Span and resolution" – Вычисляет y - точки данных оси из свойств YSpan и YResolution.

  • "Offset and resolution" – Вычисляет y - точки данных оси из свойств YResolution и YOffset.

  • "Custom" – Вычисляет y - точки данных оси с помощью свойства CustomYData.

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

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

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

Пример: [5 156]

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

Зависимость

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

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

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

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

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

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

Зависимость

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

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

Задайте смещение, чтобы отобразиться на x - ось как скаляр.

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

Зависимость

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

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

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

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

Зависимость

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

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

Задайте смещение, чтобы отобразиться на y - ось как скаляр.

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

Зависимость

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

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

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

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

Зависимость

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

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

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

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

Зависимость

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

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

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

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

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

Задайте стартовое местоположение графика. Если вы задаете "Upper left corner", график запускается в левом верхнем угле осей и продолжается вниз.

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

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

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

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

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

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

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

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

Задайте текст для осциллографа, чтобы отобразиться слева от y - ось. По умолчанию, оси не маркирован.

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

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

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

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

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

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

Для списка приемлемых имен палитры см. карту.

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

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

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

Пример: [1 80]

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

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

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

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

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

Установите это свойство на false скрывать цветную полосу на графике.

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

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

Установите это свойство на false скрывать метки деления на x - ось и y - ось.

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

Синтаксис

scope(matrix)

Описание

пример

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

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

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

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

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

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | логический

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

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

release(obj)

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

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

Примеры

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

Этот пример показывает, как создать спектрограмму квадратичного щебета с Системным объектом 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

Введенный в R2018b