ArrayPlotConfiguration

Внешний вид и поведение блока Control Array Plot из MATLAB

Описание

Свойства Array Plot Configuration управляют внешним видом и поведением блока Array Plot. Создайте объект настройки с get_param, и затем измените значения свойств с помощью объекта с записью через точку.

Создание

MyScopeConfiguration = get_param(gcbh,'ScopeConfiguration') создает новый объект Array Plot Configuration. Если вы не предоставляете полный путь блоку, необходимо сначала выбрать блок в модели.

Свойства

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

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

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

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

Количество входных портов на блоке scope, заданном как вектор символов. Максимальное количество входных портов равняется 96.

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

Выберите File> Number of Input Ports.

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

Установите это свойство на true открыть осциллограф, когда симуляция запускается. Установите это свойство на false препятствовать тому, чтобы осциллограф открылся в начале симуляции.

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

Выберите File> Open at Start of Simulation.

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

Задайте, использовать ли SampleIncrement и значения свойств XOffset, чтобы определить интервал или задать ваш собственный интервал. Если вы задаете 'Custom', также необходимо задать значения свойств CustomXData.

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

Откройте Configuration Properties. На вкладке Main, набор X-data mode.

Интервал между выборками вдоль 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, и так далее.

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

Откройте Configuration Properties. На вкладке Main, набор Sample increment.

Зависимость

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

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

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

Откройте Configuration Properties. На вкладке Main, набор X-offset.

Зависимость

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

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

Пример: scopeConfiguration.XDataMode = 'Custom'; scopeConfiguration.CustomXData = 'logspace(0,log10(44100/2),1024)'

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

Откройте Configuration Properties. На вкладке Main, набор Custom X-Data.

Зависимость

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

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

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

Откройте Configuration Properties. На вкладке Main, набор X-axis scale.

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

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

Откройте Configuration Properties. На вкладке Main, набор Y-axis scale.

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

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

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

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

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

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

Откройте Configuration Properties. На вкладке Main, набор Maximize axes.

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

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

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

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

Откройте Configuration Properties. Установите Title.

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

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

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

Примечание

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

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

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

Откройте Configuration Properties. На вкладке Display выберите Show legend.

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

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

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

Зависимость

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

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

На легенде дважды кликните название канала.

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

Установите это свойство на true показать линии сетки на графике.

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

Откройте Configuration Properties. На вкладке Display, набор Show grid.

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

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

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

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

Откройте Configuration Properties. На вкладке Display выберите Plot signals as magnitude and phase.

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

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

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

Откройте Configuration Properties. На вкладке Display, набор X-label.

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

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

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

Зависимости

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

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

Откройте Configuration Properties. На вкладке Display, набор Y-Label.

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

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

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

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

Зависимости

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

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

Откройте Configuration Properties. На вкладке Display, набор Y-limits (Minimum) и Y-limits (Maximum).

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

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

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

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

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

Откройте диалоговое окно Style и установите Plot type.

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

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

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

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

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

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

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

Выберите Tools> Axes Scaling.

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

Установите это свойство задержать автоматическое масштабирование оси Y.

Зависимость

Чтобы включить это свойство, установите AxesScaling к "Updates".

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

Откройте диалоговое окно Axes Scaling и установите Number of updates.

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

Примеры

свернуть все

Создайте новую модель Simulink® со случайным образом сгенерированным именем.

sysname='ArrayPlotExample';
new_system(sysname);

Добавьте новый блок Array Plot в модель.

add_block('built-in/ArrayPlot',[sysname,'/ArrayPlot'])

Вызовите get_param функция, чтобы получить свойства настройки блока Array Plot по умолчанию.

scopeConfig = get_param([sysname,'/ArrayPlot'],'ScopeConfiguration')
scopeConfig = 
  ArrayPlotConfiguration with properties:

                     Name: 'ArrayPlot'
            NumInputPorts: '1'
    OpenAtSimulationStart: 1
                  Visible: 0
                 Position: [240 287 800 450]
                XDataMode: 'Sample increment and X-offset'
          SampleIncrement: '1'
                  XOffset: '0'
              CustomXData: '[]'
                   XScale: 'Linear'
                   YScale: 'Linear'
             MaximizeAxes: 'Auto'
                    Title: ''
               ShowLegend: 0
             ChannelNames: {''}
                 ShowGrid: 1
     PlotAsMagnitudePhase: 0
                   XLabel: ''
                   YLabel: 'Amplitude'
                  YLimits: [-10 10]
                 PlotType: 'Stem'
              AxesScaling: 'Manual'
    AxesScalingNumUpdates: '10'

В этом примере показано, как изменить поведение блока Array Plot и внешний вид из командной строки MATLAB.

Откройте модель и создайте объект настройки блока Array Plot.

model = 'zoomfftExample';
open_system(model)
sim(model)
open_system([model '/View Spectrum'])
ArrayPlotConfiguration = get_param([model '/View Spectrum'],'ScopeConfiguration');

Измените заголовок Графика Массивов и масштабирования осей.

ArrayPlotConfiguration.Title = 'My Array Plot';
ArrayPlotConfiguration.AxesScaling = 'Manual';
ArrayPlotConfiguration.YLimits = [-1 100];

Введенный в R2013a

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