ArrayPlotConfiguration

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

Описание

Свойства 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.

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

  • лестница Осциллограф отображает входной сигнал как ступенчатый график. Ступенчатый график составлен только из горизонтальных строк и вертикальных строк. Каждая горизонтальная строка представляет значение сигналов в течение дискретного демонстрационного периода и соединяется с двумя вертикальными строками. Каждая вертикальная строка представляет изменение в значениях, происходящих на выборке. Эта опция подобна функции 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

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