ArrayPlotConfiguration

(Не рекомендуемый) Управляйте видом и поведением блока Array Plot из MATLAB

ArrayPlotConfiguation не рекомендуется. Использовать get_param (Simulink) и set_param (Simulink), чтобы изменить свойства блока Array Plot. Для получения дополнительной информации см. «Вопросы совместимости»

Описание

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

Можно также изменить свойства блока Array Plot с помощью get_param (Simulink) и set_param (Simulink).

Создание

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

Свойства

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

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

`NumInputPorts` - Количество входных портов
`'1'` (по умолчанию) | вектор символов

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

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

Смотрите Количество входа портов.

`XDataMode` - Источник интервала между x -данные
`'Sample increment and X-offset'` (по умолчанию) | `'Custom'`

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

Задать это свойство можно только перед симуляцией.

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

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

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

`SampleIncrement` - x -разнесение осей
`'1'` (по умолчанию) | вектор символов

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

`XOffset` - Отобразить смещение x оси
`'0'` (по умолчанию) | вектор символов

Отобразите смещение 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'.

`CustomXData` - x -данные значения
`'[]'` (по умолчанию) | вектор символов

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

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

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

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

Зависимость

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

`XScale` - Шкала оси X
`"Linear"` (по умолчанию) | `"Log"`

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

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

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

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

`YScale` - Шкала y -оси
`"Linear"` (по умолчанию) | `"Log"`

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

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

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

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

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

`PlotType` - Тип графика управления
`"Stem"` (по умолчанию) | `"Line"` | `"Stairs"`

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

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

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

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

`AxesScaling` - Режим масштабирования осей
`"OnceAtStop"` (по умолчанию) | `"Auto"` | `"Manual"` | `"Updates"`

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

"Auto" - возможности масштабируют оси по мере необходимости, чтобы соответствовать данным, как во время, так и после симуляции.
"Manual" - возможности не масштабируется автоматически.
"OnceAtStop" - возможности масштабируют оси, когда симуляция останавливается.
"Updates" - возможности масштабируют оси один и только один раз после заданного количества обновлений. Чтобы указать количество обновлений, используйте AxesScalingNumUpdates свойство.

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

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

`AxesScalingNumUpdates` - Количество обновлений перед масштабированием
`"10"` (по умолчанию) | целочисленный вектор символов | целый строковый скаляр

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

Зависимость

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

`Name` - Имя окна
`'Array Plot'` (по умолчанию) | символьный вектор | строковый скаляр

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

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

`Position` - Положение окна Scope и размер в пикселях
центр экрана (по умолчанию) | `[left bottom width height]`

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

`MaximizeAxes` - Максимизируйте управление осями
`"Auto"` (по умолчанию) | `"On"` | `"Off"`

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

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

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

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

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

`Title` - Отобразить заголовок
`''` (по умолчанию) | символьный вектор | строковый скаляр

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

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

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

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

`PlotAsMagnitudePhase` - Постройте график как величину и фазу
`false` (по умолчанию) | `true`

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

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

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

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

`XLabel` - x -метка оси
`""` (по умолчанию) | символьный вектор | строковый скаляр

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

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

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

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

`YLabel` - y -метка оси
`"Amplitude"` (по умолчанию) | символьный вектор | строковый скаляр

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

Зависимости

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

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

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

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

`YLimits` - y -лимиты по оси
`[-10,10]` (по умолчанию) | `[ymin, ymax]`

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

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

Зависимости

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

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

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

`ShowGrid` - Отобразить сетку
`true` (по умолчанию) | `false`

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

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

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

`ShowLegend` - Показать легенду
`false` (по умолчанию) | `true`

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

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

Примечание

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

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

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

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

`ChannelNames` - Имена каналов
пустая камера (по умолчанию) | массив ячеек из векторов символов

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

Зависимость

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

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

`OpenAtSimulationStart` - Откройте возможности при запуске симуляции
`true` (по умолчанию) | `false`

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

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

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

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

Примеры

свернуть все

Измените заголовок блока графика массива и масштабирование из командной строки

Измените блок Array Plot с объектом строения.

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

sysname='ArrayPlotExample';
new_system(sysname);

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

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

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

scopeConfig = get_param([sysname,'/ArrayPlot'],'ScopeConfiguration')

scopeConfig = 
  ArrayPlotConfiguration with properties:

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

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

scopeConfig.Title = 'My Array Plot';
scopeConfig.AxesScaling = 'Manual'

scopeConfig = 
  ArrayPlotConfiguration with properties:

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

Вопросы совместимости

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

`ArrayPlotConfiguation` не рекомендуется

Не рекомендуемый запуск в R2021a

Вместо ArrayPlotConfiguation объект, использование get_param (Simulink) и set_param (Simulink), чтобы просмотреть и изменить свойства блока Array Plot. Для примера, чтобы изменить количество входа портов, используйте эти команды.

modelname='ArrayPlotExample';
new_system(modelname);
add_block('built-in/ArrayPlot',[sysname,'/ArrayPlot'])
set_param([modelname,'/ArrayPlot'],'NumInputPorts','4')

См. также

Array Plot

Темы

Управляйте блоками возможностей (Simulink)

Введенный в R2013a

Документация

ArrayPlotConfiguration

Описание

Создание

Свойства

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

NumInputPorts - Количество входных портов '1' (по умолчанию) | вектор символов

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

XDataMode - Источник интервала между x -данные 'Sample increment and X-offset' (по умолчанию) | 'Custom'

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

SampleIncrement - x -разнесение осей '1' (по умолчанию) | вектор символов

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

Зависимость

XOffset - Отобразить смещение x оси '0' (по умолчанию) | вектор символов

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

Зависимость

CustomXData - x -данные значения '[]' (по умолчанию) | вектор символов

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

Зависимость

XScale - Шкала оси X "Linear" (по умолчанию) | "Log"

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

YScale - Шкала y -оси "Linear" (по умолчанию) | "Log"

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

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

PlotType - Тип графика управления "Stem" (по умолчанию) | "Line" | "Stairs"

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

AxesScaling - Режим масштабирования осей "OnceAtStop" (по умолчанию) | "Auto" | "Manual" | "Updates"

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

AxesScalingNumUpdates - Количество обновлений перед масштабированием "10" (по умолчанию) | целочисленный вектор символов | целый строковый скаляр

Зависимость

Name - Имя окна 'Array Plot' (по умолчанию) | символьный вектор | строковый скаляр

Position - Положение окна Scope и размер в пикселях центр экрана (по умолчанию) | [left bottom width height]

MaximizeAxes - Максимизируйте управление осями "Auto" (по умолчанию) | "On" | "Off"

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

Title - Отобразить заголовок '' (по умолчанию) | символьный вектор | строковый скаляр

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

PlotAsMagnitudePhase - Постройте график как величину и фазу false (по умолчанию) | true

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

XLabel - x -метка оси "" (по умолчанию) | символьный вектор | строковый скаляр

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

YLabel - y -метка оси "Amplitude" (по умолчанию) | символьный вектор | строковый скаляр

Зависимости

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

YLimits - y -лимиты по оси [-10,10] (по умолчанию) | [ymin, ymax]

Зависимости

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

ShowGrid - Отобразить сетку true (по умолчанию) | false

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

ShowLegend - Показать легенду false (по умолчанию) | true

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

ChannelNames - Имена каналов пустая камера (по умолчанию) | массив ячеек из векторов символов

Зависимость

OpenAtSimulationStart - Откройте возможности при запуске симуляции true (по умолчанию) | false

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

Примеры

Измените заголовок блока графика массива и масштабирование из командной строки

Вопросы совместимости

ArrayPlotConfiguation не рекомендуется

См. также

Темы

Документация DSP System Toolbox

Поддержка

`NumInputPorts` - Количество входных портов
`'1'` (по умолчанию) | вектор символов

`XDataMode` - Источник интервала между x -данные
`'Sample increment and X-offset'` (по умолчанию) | `'Custom'`

`SampleIncrement` - x -разнесение осей
`'1'` (по умолчанию) | вектор символов

`XOffset` - Отобразить смещение x оси
`'0'` (по умолчанию) | вектор символов

`CustomXData` - x -данные значения
`'[]'` (по умолчанию) | вектор символов

`XScale` - Шкала оси X
`"Linear"` (по умолчанию) | `"Log"`

`YScale` - Шкала y -оси
`"Linear"` (по умолчанию) | `"Log"`

`PlotType` - Тип графика управления
`"Stem"` (по умолчанию) | `"Line"` | `"Stairs"`

`AxesScaling` - Режим масштабирования осей
`"OnceAtStop"` (по умолчанию) | `"Auto"` | `"Manual"` | `"Updates"`

`AxesScalingNumUpdates` - Количество обновлений перед масштабированием
`"10"` (по умолчанию) | целочисленный вектор символов | целый строковый скаляр

`Name` - Имя окна
`'Array Plot'` (по умолчанию) | символьный вектор | строковый скаляр

`Position` - Положение окна Scope и размер в пикселях
центр экрана (по умолчанию) | `[left bottom width height]`

`MaximizeAxes` - Максимизируйте управление осями
`"Auto"` (по умолчанию) | `"On"` | `"Off"`

`Title` - Отобразить заголовок
`''` (по умолчанию) | символьный вектор | строковый скаляр

`PlotAsMagnitudePhase` - Постройте график как величину и фазу
`false` (по умолчанию) | `true`

`XLabel` - x -метка оси
`""` (по умолчанию) | символьный вектор | строковый скаляр

`YLabel` - y -метка оси
`"Amplitude"` (по умолчанию) | символьный вектор | строковый скаляр

`YLimits` - y -лимиты по оси
`[-10,10]` (по умолчанию) | `[ymin, ymax]`

`ShowGrid` - Отобразить сетку
`true` (по умолчанию) | `false`

`ShowLegend` - Показать легенду
`false` (по умолчанию) | `true`

`ChannelNames` - Имена каналов
пустая камера (по умолчанию) | массив ячеек из векторов символов

`OpenAtSimulationStart` - Откройте возможности при запуске симуляции
`true` (по умолчанию) | `false`

`ArrayPlotConfiguation` не рекомендуется