dsp.ArrayPlot

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

Описание

dsp. Векторы отображений объекта ArrayPlot или массивы, где данные расположены равными интервалами вдоль оси X.

Отобразить векторы или массив на Графике Массивов:

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

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

Создание

Описание

пример

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

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

Свойства

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

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

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

Для получения дополнительной информации об изменении значений свойств смотрите Разработку системы в MATLAB Используя Системные объекты (MATLAB).

Постройте настройку

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

Задайте, использовать ли 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, и т.д. Если вы устанавливаете SampleIncrement к 0,25, x - данные оси становятся 0, 0.25, 0.5, 0.75, 1, и т.д.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Задайте тип графика использовать во всех входных сигналах, отображенных в окне scope:

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

  • "Line" – Осциллограф отображает входной сигнал как линии, соединяющие каждое из произведенных значений. Эта опция похожа на line или plot функции.

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

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

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

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

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

  • "Auto" — Осциллограф масштабирует оси по мере необходимости, чтобы соответствовать данным, обоим в течение и после симуляции.

  • "Manual" — Осциллограф не масштабирует оси автоматически.

  • "OnceAtStop" — Осциллограф масштабирует оси, когда симуляция останавливается.

  • "Updates" — Осциллограф масштабирует оси однажды и только однажды после 10 обновлений.

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

Наведите на график массивов видеть изменение масштаба, панорамирование и кнопки автошкалы. Можно также масштабировать и панорамирование с помощью мыши.

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

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

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

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

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

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

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

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

  • "Off" — Ни одна из осей не кажется максимизируемой.

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

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

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

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

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

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

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

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

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

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

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

Примечание

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

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

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

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

Типы данных: логический

Задайте входные названия канала как массив ячеек из символьных векторов. Имена появляются в легенде, диалоговом окне Style и панелях 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 - подписи по осям являются значениями только для чтения. 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

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

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

generateScriptСгенерируйте скрипт MATLAB, чтобы создать осциллограф с текущими настройками
showОтобразите окно scope
hideСкройте окно scope
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) адаптивные веса фильтра на фигуре Графика Массивов. См., что веса фильтра изменяются, когда они адаптируются, чтобы отфильтровать шумный входной сигнал.

Создайте адаптивный Системный объект фильтра 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));

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

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 функция.

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

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

Введенный в R2013a