dsp.MatrixViewer

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

Описание

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

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

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

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

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

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

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

  • — Автомасштабируйте оси, чтобы соответствовать данным.

  • — Увеличьте масштаб к графику.

  • — Панорамирование вокруг осей.

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

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

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

Создание

Описание

scope = dsp.MatrixViewer создает Матричную Систему Средства просмотра object™, scope.

пример

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

Свойства

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

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

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

Для получения дополнительной информации об изменении значений свойств смотрите Разработку системы в 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 'pixels'. Значения по умолчанию для этого свойства могут измениться в зависимости от вашего разрешения экрана.

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

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

Типы данных: 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) отображает matrix путем отображения значений элемента матрицы с областью значений цветов.

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

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

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

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

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

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

Чтобы использовать объектную функцию, задайте Системный объект как первый входной параметр. Например, чтобы выпустить системные ресурсы Системного объекта под названием 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

Введенный в R2019a