dsp.ArrayPlot

Отобразите векторы или массивы

Описание

Отобразите векторы или массивы, где данные равномерно расположены вдоль оси X.

Array Plot object window

Создание

Описание

пример

scope = dsp.ArrayPlot создает объект Array Plot, scope.

scope = dsp.ArrayPlot(Name,Value) устанавливает свойства с помощью одной или нескольких пар "имя-значение". Заключайте каждое имя свойства в кавычки. Для примера, scope = dsp.ArrayPlot("NumInputPorts",3)

Свойства

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

Большинство свойств можно изменить с dsp.ArrayPlot UI.

Построение Строения

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

Укажите, использовать ли SampleIncrement и XOffset значения свойств для определения интервалов или определения собственного пользовательского интервала. Если вы задаете "Custom", вы также должны задать CustomXData значения свойств.

Задать это свойство можно только при создании объекта.

Использование пользовательского интерфейса

Откройте вкладку Plot, нажмите Settings и установите X-Data Mode.

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

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

Задать это свойство можно только при создании объекта.

Пример: scope = dsp.ArrayPlot("XDataMode","Custom","CustomXData",logspace(0,log10(44100/2),1024))

Использование пользовательского интерфейса

Откройте вкладку Plot, нажмите Settings и установите X-Data Mode равными Custom и задайте Custom X-Data.

Зависимость

Чтобы использовать это свойство, задайте XDataMode на "Custom".

Задайте интервал между выборками вдоль оси x как конечный числовой скаляр. Входной сигнал только y данных оси. x -данные оси задаются автоматически на основе XOffset и SampleIncrement свойства.

Пример: Когда XOffset является 0 и SampleIncrement является 1, значения x -оси установлены в 0, 1, 2, 3, 4, … .

Пример: Когда XOffset является -1 и SampleIncrement является 0.25, значения x -оси установлены в -1, -0.75, -0.5, -0.25, 0, … .

Использование пользовательского интерфейса

Откройте вкладку Plot, нажмите Settings и установите Sample Increment.

Зависимость

Чтобы использовать это свойство, задайте XDataMode на 'Sample increment and X-offset'.

Отобразите смещение x -оси, заданное в виде числа. x -данные оси задаются автоматически на основе обоих SampleIncrement и XOffset значения. Смещение X представляет первое значение на оси x -.

Пример: Когда XOffset 0 и SampleIncrement равен 1, значения x-оси заданы равными 0, 1, 2, 3, 4,....

Пример: Когда XOffset -1 и SampleIncrement равен 0,25, значения x-оси установлены в -1, -0,75, -0,5, -0,25, 0,....

Использование пользовательского интерфейса

Откройте вкладку Plot, нажмите Settings и установите X-Offset.

Зависимость

Чтобы использовать это свойство, задайте XDataMode на 'Sample increment and X-offset'.

Задайте, является ли шкала оси x "Linear" или "Log". Если XOffset является отрицательным значением, вы не можете задать это свойство равным "Log".

Использование пользовательского интерфейса

Откройте вкладку Plot, нажмите Settings и установите XScale.

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

Задайте, является ли шкала оси y "Linear" или "Log".

Использование пользовательского интерфейса

Откройте вкладку Plot, нажмите Settings и установите YScale.

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

Укажите тип графика для всех входных сигналов, отображаемых в окне возможностей:

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

  • "Line" - Область возможностей отображает входной сигнал как линии, соединяющие каждое из выборочных значений.

  • "Stairs" - возможности отображают входной сигнал как ступенчатый график. Ступенчатый график состоит только из горизонтальных линий и вертикальных линий. Каждая горизонтальная линия представляет значение сигналов для дискретного периода дискретизации и соединяется с двумя вертикальными линиями. Каждая вертикальная линия представляет изменение значений, происходящих в выборке. Ступенчатые графы полезны для рисования временных графиков цифровых выборочных данных.

Использование пользовательского интерфейса

Откройте Settings и установите Plot Type.

Задайте, когда возможности масштабируют оси. Допустимые значения:

  • "Auto" - возможности масштабируют оси по мере необходимости, чтобы соответствовать данным, как во время, так и после симуляции.

  • "Manual" - возможности не масштабируется автоматически.

  • "OnceAtStop" - возможности масштабируют оси, когда симуляция останавливается.

  • "Updates" - возможности масштабируют оси один и только один раз после 10 обновлений.

Задать это свойство можно только при создании объекта.

Использование пользовательского интерфейса

Наведите на график массива, чтобы увидеть Zoom iconPanning iconautoscale iconкнопки масштаба, панорамирования и автошкалы. Вы также можете масштабировать и панорамирование, используя мышь.

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

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

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

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

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

Укажите, отображать ли возможности в режиме максимальных осей. В этом режиме оси расширяются так, чтобы они помещались во всём отображении. Чтобы сохранить пространство, метки не появляются на каждом отображении. Вместо этого значения отметки деления появляются поверх нанесенных на график данных. Можно выбрать один из следующих опций:

  • "Auto" - Оси появляются максимизированными во всех отображениях, только если Title и YLabel свойства пусты для каждого отображения. Если вы вводите любое значение в любом отображении для любого из этих свойств, оси не максимизируются.

  • "On" - Оси появляются максимизированными во всех отображениях. Любые значения, введенные в Title и YLabel свойства скрыты.

  • "Off" - Ни одна из осей не выглядит максимизированной.

Использование пользовательского интерфейса

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

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

Задайте заголовок отображения как вектор символов или строку.

Использование пользовательского интерфейса

Откройте вкладку Plot, нажмите Settings и установите Title.

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

Чтобы показать легенду с входными именами, задайте для этого свойства значение true.

Из легенды можно управлять, какие сигналы видны. Этот элемент управления эквивалентен изменению видимости в диалоговом окне Style. В легенде возможностей щелкните имя сигнала, чтобы скрыть сигнал в возможности. Чтобы отобразить сигнал, снова щелкните имя сигнала. Чтобы показать только один сигнал, щелкните правой кнопкой мыши имя сигнала. Чтобы показать все сигналы, нажмите Esc.

Примечание

Легенда показывает только первые 20 сигналов. Никакие дополнительные сигналы не могут быть просмотрены или управлены из легенды.

Использование пользовательского интерфейса

На вкладке Plot нажмите Legend.

Типы данных: logical

Задайте имена входных каналов как массив ячеек из векторов символов. Имена появляются в панелях легенды, Settings и Measurements. Если вы не задаете имена, каналы помечаются как Channel 1, Channel 2, и т.д.

Зависимость

Чтобы увидеть имена каналов, задайте ShowLegend на true.

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

Установите это свойство на true отображение линий сетки на графике.

Использование пользовательского интерфейса

Откройте вкладку Plot, нажмите Settings и выберите Grid.

  • true - возможности строят графики величины и фазы входного сигнала на двух отдельных осях в пределах одного активного отображения.

  • false - возможности видимости строят график действительной и мнимой частей входного сигнала на двух отдельных осях в пределах одного активного отображения.

Это свойство полезно для комплексных входных сигналов. Включение этого свойства влияет на фазу для реальных входных сигналов. Когда амплитуда входного сигнала неотрицательная, фаза составляет 0 степени. Когда амплитуда входного сигнала отрицательная, фаза составляет 180 степени.

Использование пользовательского интерфейса

На вкладке Plot нажмите кнопку Magnitude Phase.

Задайте текст для возможностей, которая будет отображаться под осью x -.

Использование пользовательского интерфейса

Откройте вкладку Plot, нажмите Settings и установите XLabel.

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

Задайте текст области видимости слева от оси y .

Зависимости

Это свойство применяется только тогда, когда PlotAsMagnitudePhase является false. Когда PlotAsMagnitudePhase является trueдве y метки -оси являются значениями, доступными только для чтения "Magnitude" и "Phase", для графика величины и фазы, соответственно.

Использование пользовательского интерфейса

Откройте вкладку Plot, нажмите Settings и установите YLabel.

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

Задайте y пределы по осям как двухэлементный числовой вектор, [ymin, ymax].

Если PlotAsMagnitudePhase является false, по умолчанию является [-10,10]. Если PlotAsMagnitudePhase является true, по умолчанию является [0,10].

Зависимости

Когда PlotAsMagnitudePhase является trueэто свойство задает y пределы оси только для графика величины. Пределы y-оси фазового графика всегда [-180,180].

Использование пользовательского интерфейса

Откройте вкладку Plot, нажмите Settings и установите Y-Axis Limits как двухэлементный числовой вектор.

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

Описание

пример

scope(signal) отображает сигнал на графике массивов.

scope(signal1,signal2,...,signalN) отображает несколько сигналов на графике массивов. Сигналы должны иметь ту же длину системы координат, но могут варьироваться в количестве каналов. Вы должны задать NumInputPorts свойство для включения нескольких входных сигналов.

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

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

Задайте один или несколько входных сигналов для визуализации в dsp.ArrayPlot. Сигналы могут иметь разное количество каналов, но они должны иметь одинаковую длину системы координат.

Пример: scope(signal1, signal2)

Индивидуальная настройка пользовательского интерфейса

Чтобы настроить стиль сигналов на графике массива, откройте Settings и используйте нижнюю строку опций, чтобы выбрать сигнал и изменить стиль, ширину, цвет и тип маркера.

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

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

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

generateScriptСгенерируйте скрипт MATLAB, чтобы создать возможности с текущими настройками
hideСкрыть окно возможностей
showОтобразить окно возможностей
isVisibleОпределите видимость возможностей
stepЗапуск алгоритма системного объекта
releaseОтпустите ресурсы и допустите изменения в значениях свойств системного объекта и входных характеристиках
resetСброс внутренних состояний Системного объекта

Примеры

свернуть все

Примечание.Этот пример выполняется только в R2016b или более поздней версии. Если вы используете более ранний релиз, замените каждый вызов объекта эквивалентным step синтаксис. Для примера, myObject(x) становится step(myObject,x).

Создайте новый объект Array Plot.

scope = dsp.ArrayPlot;

Сконфигурируйте свойства объекта Array Plot для Гауссова распределения.

scope.YLimits = [0 1];
scope.XOffset = -2.5;
scope.SampleIncrement = 0.1;
scope.Title = 'Gaussian distribution';
scope.XLabel = 'X';
scope.YLabel = 'f(X)';

Вызовите объект Array Plot, чтобы построить график Гауссова распределения.

scope(exp(-(-2.5:.1:2.5).*(-2.5:.1:2.5))')

Примечание.Этот пример выполняется только в R2016b или более поздней версии. Если вы используете более ранний релиз, замените каждый вызов объекта эквивалентным step синтаксис. Для примера, myObject(x) становится step(myObject,x).

Просмотрите веса адаптивного фильтра методом наименьших средних квадратов (LMS) на рисунке Array Plot. Наблюдайте, как изменяются веса фильтров, когда они адаптируются для фильтрации шумного входного сигнала.

Создайте адаптивный фильтр LMS Системного объекта.

lmsFilter = dsp.LMSFilter(40,'Method','Normalized LMS','StepSize',0.002);

Создайте и сконфигурируйте dsp. AudiFileReader Системного объекта считать входной сигнал от указанного аудио файла.

signalSource = dsp.AudioFileReader('dspafxf_8000.wav',...
    'SamplesPerFrame',40, ...
    'PlayCount',Inf,...
    'OutputDataType','double');

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

firFilter = dsp.FIRFilter('Numerator',fir1(39,0.25));

Создайте и сконфигурируйте объект Array Plot System, чтобы отобразить веса адаптивных фильтров.

scope = dsp.ArrayPlot('XLabel','Filter Tap', ...
    'YLabel','Filter Weight', ...
    'YLimits',[-0.05 0.2]');

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

numplays = 0;
while numplays < 3
    [y, eof]    = signalSource();
    noise       = rand(40,1);
    noisefilt   = firFilter(noise);
    desired     = y + noisefilt;
    [~, ~, wts] = lmsFilter(noise,desired);
    scope(wts);
    numplays = numplays + eof;
end

Совет

  • Чтобы закрыть окно Array Plot и очистить связанные с ним данные, используйте MATLAB® clear функция.

  • Чтобы скрыть или показать окно График массива, используйте hide и show функций.

Расширенные возможности

.
Введенный в R2013a
Для просмотра документации необходимо авторизоваться на сайте