ArrayPlotConfiguration

(Не рекомендуется) Внешний вид и поведение блока печати массива управления из MATLAB

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

Описание

Объект «Конфигурация печати массива» используется для управления внешним видом и поведением блока печати массива. Создание объекта конфигурации с помощью get_param, а затем измените значения свойств с помощью объекта с точечной нотацией.

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

Создание

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

Свойства

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

Конфигурация графика

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

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

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

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

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

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

Это свойство можно задать только перед моделированием.

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

Откройте вкладку «Печать», нажмите «Параметры» и установите режим X-Data.

Типы данных: 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,...

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

Откройте вкладку «Печать», нажмите «Параметры» и задайте значение параметра «Приращение образца».

Зависимость

Чтобы использовать это свойство, установите 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,...

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

Откройте вкладку «Печать», нажмите «Параметры» и задайте значение «Смещение по оси X».

Зависимость

Чтобы использовать это свойство, установите 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)'

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

Откройте вкладку «Печать», нажмите «Параметры», установите для параметра «Режим X-данных» значение «Пользовательский» и задайте значение «Пользовательские X-данные».

Зависимость

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

`XScale` - Масштаб оси X
`"Linear"` (по умолчанию) | `"Log"`

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

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

Откройте вкладку «Печать», нажмите «Параметры» и задайте XScale.

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

`YScale` - Масштаб оси Y
`"Linear"` (по умолчанию) | `"Log"`

Укажите, является ли масштаб оси y "Linear" или "Log".

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

Откройте вкладку «Печать», нажмите «Параметры» и задайте YScale.

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

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

`PlotType` - Контрольный тип графика
`"Stem"` (по умолчанию) | `"Line"` | `"Stairs"`

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

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

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

Откройте окно «Параметры» и задайте тип печати.

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

Укажите, когда область масштабирует оси. Допустимые значения:

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

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

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

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

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

Зависимость

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Откройте вкладку «Печать», нажмите «Параметры» и задайте «Заголовок».

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

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

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

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

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

На вкладке «Печать» нажмите кнопку «Фаза величины».

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

Укажите текст области для отображения под осью X.

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

Откройте вкладку «Печать», нажмите «Параметры» и выберите «XLabel».

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

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

Укажите текст области для отображения слева от оси Y.

Зависимости

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

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

Откройте вкладку «Печать», нажмите «Параметры» и выберите «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].

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

Откройте вкладку «Печать», нажмите «Параметры» и задайте «Пределы оси Y» в качестве двухэлементного числового вектора.

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

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

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

Откройте вкладку «Печать», нажмите «Параметры» и выберите «Сетка».

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

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

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

Примечание

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

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

На вкладке «Печать» нажмите «Легенда».

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

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

Укажите имена входных каналов в виде массива ячеек символьных векторов. Имена отображаются на панелях «Легенда», «Параметры» и «Измерения». Если имена не указаны, каналы помечаются как Channel 1, Channel 2и т.д.

Зависимость

Для просмотра имен каналов установите ShowLegend кому true.

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

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

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

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

Выберите «Файл» > «Открыть в начале моделирования».

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

Примеры

свернуть все

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

Измените блок печати массива с помощью объекта конфигурации.

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

sysname='ArrayPlotExample';
new_system(sysname);

Добавьте в модель новый блок «Печать массива».

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

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

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) для просмотра и изменения свойств блока «Печать массива». Например, чтобы изменить количество входных портов, используйте эти команды.

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

См. также

Печать массива

Темы

Программные блоки области управления (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 - Положение и размер окна области в пикселях центр экрана (по умолчанию) | [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

Поддержка

`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` - Положение и размер окна области в пикселях
центр экрана (по умолчанию) | `[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` не рекомендуется