Simulink.Breakpoint class

Пакет: Simulink
Суперклассы:

Сохраните и поделитесь данными для набора точек по оси Х, сконфигурируйте данные для генерации кода ASAP2 и AUTOSAR

Описание

Объект Simulink.Breakpoint класс хранит данные набора точек по оси Х для интерполяционной таблицы. Можно использовать эти данные в одном или нескольких блоках Prelookup. С помощью объекта можно задать тип данных и настройки генерации кода для набора точек по оси Х и совместно использовать набор между несколькими интерполяционными таблицами. Использование Simulink.Breakpoint объекты и Simulink.LookupTable объекты, чтобы сконфигурировать генерацию кода COM_AXIS для калибровки.

Код, сгенерированный для Simulink.Breakpoint объект является массивом или структурой с двумя полями. Если вы конфигурируете объект как структуру, одно поле хранит указанные данные набора точек по оси Х, а одно скалярное поле хранит количество элементов в данных набора точек Х. Вы можете сконфигурировать имя типа структуры, имя поля и другие характеристики с помощью свойств объекта.

Чтобы упаковать данные интерполяционной таблицы и набора точек по оси Х в одну структуру в сгенерированном коде, например, для генерации кода STD_AXIS, используйте Simulink.LookupTable объект для хранения всех данных. Смотрите Общие данные точек по оси Х и Данные таблицы для интерполяционных таблиц.

В подкласс из Simulink.Breakpoint и наследовать от этого базового класса, введите этот синтаксис как первую линию вашего файла определения класса, где myBreakpoint является именем вашего нового класса:

classdef myBreakpoint < Simulink.Breakpoint

Пример для подклассирования см. в разделе Определение классов данных.

Если вы добавляете свойства к подклассу, вы можете увидеть их, отобразив объект подкласса в MATLAB® командная строка. В диалоговом окне свойств эти свойства отображаются на новой вкладке.

Конструкция

BpSet = Simulink.Breakpoint возвращает Simulink.Breakpoint объект с именем BpSet со значениями свойств по умолчанию.

Как создать Simulink.Breakpoint используя Model Explorer, используйте кнопку на панели инструментов. Имя по умолчанию для объекта Object.

Диалоговое окно свойств

Breakpoints

Информация о наборе точек по оси Х. Можно сконфигурировать следующие характеристики:

Support tunable size

Спецификация, позволяющая настраивать эффективный размер таблицы в сгенерированном коде. Если вы выбираете эту опцию, в сгенерированном коде Simulink.Breakpoint объект появляется как структурная переменная. Структура имеет одно поле для хранения данных вектора точек по оси Х и одно поле для хранения количества элементов в векторе точек Х. Можно изменить значение второго поля, чтобы настроить эффективный размер таблицы.

Если удалить эту опцию, Simulink.Breakpoint объект появляется в сгенерированном коде как отдельная переменная массива вместо структуры.

Value

Данные набора точек по оси Х. Задайте вектор с как минимум двумя элементами.

Можно также использовать выражение с математическими операторами, такими как sin(1:0.5:30) пока выражение возвращает числовой вектор. При клике Apply или OK объект выполняет выражение и использует результат, чтобы задать значение этого свойства.

Когда вы задаете Data type auto, чтобы задать Value, используйте типизированное выражение, такое как single([1 2 3]) или использовать fi (Fixed-Point Designer) конструктор для встраивания fi объект.

Вы можете редактировать эти данные с помощью более интуитивно понятного интерфейса в блоке интерполяционной таблицы. См. «Импорт данных интерполяционной таблицы из MATLAB».

Data type

Тип данных набора точек по оси Х. Настройкой по умолчанию является auto, что означает, что набор точек по оси Х получает тип данных от значения, заданного в Value. Если вы используете нетиповое выражение, такое как [1 2 3] чтобы задать Value, данные точек по оси Х используют тип данных double. Если вы задаете типизированное выражение, такое как single([1 2 3]) или fi объект, данные точек по оси Х используют тип данных, заданный выражением или объектом. Также поддерживаются перечисленные типы данных.

Можно явным образом задать целочисленный тип данных, половинный тип данных, тип данных с плавающей точкой, тип данных с фиксированной точкой или выражение типа данных, такое как имя Simulink.AliasType объект.

Для получения дополнительной информации о типах данных в Simulink®, см. Типы данных, поддерживаемые Simulink. Чтобы решить, как управлять типами данных таблицы и данных точек по оси Х в Simulink.LookupTable и Simulink.Breakpoint объекты, см. «Типы управляющих данных объектов интерполяционной таблицы (Simulink Coder)».

Dimensions

Размерности набора точек останова.

Чтобы использовать символические размерности, задайте вектор символов. Смотрите Реализуйте Варианты Размерности для Размеров Массивов в Сгенерированном Коде (Embedded Coder).

Min

Минимальное значение элементов в наборе точек по оси Х. Значение по умолчанию пустое, []. Можно задать числовое, действительное значение.

Для получения дополнительной информации о том, как Simulink использует это свойство, смотрите Задайте Минимальное и Максимальное Значения для Параметров блоков.

Max

Максимальное значение элементов в наборе точек по оси Х. Значение по умолчанию пустое, []. Можно задать числовое, действительное значение.

Для получения дополнительной информации о том, как Simulink использует это свойство, смотрите Задайте Минимальное и Максимальное Значения для Параметров блоков.

Stored Int Min

Для Simulink.Breakpoint объекты с типом данных с фиксированной точкой, минимальным значением элементов в наборе точек по оси Х, заданным как сохраненное целое число. Значение определяется из реальной Min значений. Это свойство доступно только в диалоговом окне свойств.

Stored Int Max

Для Simulink.Breakpoint объекты с типом данных с фиксированной точкой, максимальным значением элементов в наборе точек по оси Х, заданным как сохраненное целое число. Значение определяется из реальной Max значений. Это свойство доступно только в диалоговом окне свойств.

Unit

Физическая единица измерения элементов в наборе точек по оси Х. Вы можете задать текст, такой как degC. См. Спецификацию единиц измерения в моделях Simulink.

Field name

Имя поля структуры в сгенерированном коде. В этом поле хранятся данные набора точек по оси Х. Значение по умолчанию BP. Чтобы изменить имя поля, укажите текст.

Этот столбец появляется только при выборе Support tunable size.

Tunable size name

Имя поля структуры в сгенерированном коде. Это скалярное поле хранит длину набора точек по оси Х (количество элементов), который алгоритм сгенерированного кода использует для определения размера таблицы. Чтобы настроить эффективный размер таблицы во время выполнения кода, измените значение этого поля структуры в памяти. Имя по умолчанию N. Чтобы изменить имя поля, укажите текст.

Этот столбец появляется только при выборе Support tunable size.

Description

Описание набора точек по оси Х. Вы можете задать текст, такой как This breakpoint set represents the pressure input.

Data definition: Storage class

Класс памяти структурной переменной (если вы выбираете Support tunable size) или переменной массива в сгенерированном коде. Переменная хранит данные набора точек по оси Х. Настройкой по умолчанию является Auto.

Для получения дополнительной информации о классах памяти смотрите Строение Генерации кода C для Элементов Интерфейса Модели (Simulink Coder).

Если у вас есть Embedded Coder®можно выбрать пользовательский класс памяти. Для получения дополнительной информации о пользовательских классах памяти смотрите Организовать данные параметра в структуру при помощи класса Struct Storage Class (Embedded Coder).

Data definition: Identifier

Альтернативное имя переменной в сгенерированном коде. Значение по умолчанию пусто, и в этом случае сгенерированный код использует имя Simulink.Breakpoint объект как имя переменной. Чтобы задать идентификатор, задайте текст.

Чтобы включить это свойство, установите для Data definition: Storage class значение, отличное от Auto.

Data definition: Alignment

Контур выравнивания данных в сгенерированном коде. Начальный адрес памяти для данных, выделенных для структуры или переменной массива, является кратным заданному значению. Значение по умолчанию -1, что позволяет генератору кода определить оптимальное выравнивание на основе использования.

Задайте положительное целое число, которое является степенью 2, не превышающей 128. Дополнительные сведения об использовании выравнивания данных для замены кода см. в разделе Выравнивание данных для замены кода (Embedded Coder).

Struct Type definition: Name

Имя типа структуры, используемый структурной переменной в сгенерированном коде. Значение по умолчанию пустое. Задайте текст.

Это свойство появляется только при выборе Support tunable size.

Struct Type definition: Data scope

Возможности типа структуры (импортирована из рукописного кода или экспортирована из сгенерированного кода). Значение по умолчанию Auto. Когда вы выбираете Auto:

  • Если вы не задаете значение в Struct Type definition: Header file поле, сгенерированный код экспортирует определение типа структуры в файл model_types.h. model - имя модели.

  • Если вы задаете значение в Struct Type definition: Header file поле, например myHdr.hсгенерированный код импортирует определение типа структуры из myHdr.h.

Чтобы явным образом задать возможности данных:

  • Чтобы импортировать определение типа структуры в сгенерированный код из пользовательского кода, выберите Imported.

  • Чтобы экспортировать определение типа структуры из сгенерированного кода, выберите Exported.

Если вы не задаете значение в Struct Type definition: Header file поле, сгенерированный код импортирует или экспортирует определение типа из или в StructName.h. StructName - имя, заданное с помощью Struct Type definition: Name свойства.

Это свойство появляется только при выборе Support tunable size.

Struct Type definition: Header file

Имя файла заголовка, содержащего определение типа структуры. Можно импортировать определение из созданного файла заголовка или экспортировать определение в сгенерированный файл заголовка. Чтобы контролировать возможности типа структуры, измените настройку свойства Struct Type definition: Data scope.

Это свойство появляется только при выборе Support tunable size.

Свойства

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

Данные набора точек по оси Х, заданные как Simulink.lookuptable.Breakpoint объект. Этот встроенный объект используется для конфигурирования имен и характеристик структурных полей данных набора точек по оси Х, таких как значения точек по оси Х, тип данных и размерностей.

Настройки генерации кода для структурной переменной (если вы задаете SupportTunableSize на true) или переменная массива (false), который хранит данные набора точек по оси Х, заданные как Simulink.CoderInfo объект. Можно задать класс памяти или пользовательский класс памяти с помощью этого встроенного объекта. Для получения дополнительной информации смотрите Simulink.CoderInfo.

Параметры настройки для типа структуры, которую использует структурная переменная в сгенерированном коде, заданные как Simulink.lookuptable.StructTypeInfo объект.

Если вы задаете SupportTunableSize на false, а Simulink.Breakpoint объект не отображается в сгенерированном коде как структура. Генератор кода игнорирует это свойство.

Опция для генерации кода, которая позволяет настраивать эффективный размер таблицы, заданный как true или false. Смотрите параметр Support Tunable Size.

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

Копировать семантику

Указатель. Чтобы узнать, как классы handle влияют на операции копирования, см. раздел «Копирование объектов».

Примеры

Совместное использование данных точек по оси Х между одномерными интерполяционными таблицами

  1. Создайте Simulink.Breakpoint объект с именем myBpSet.

    myBpSet = Simulink.Breakpoint

  2. Укажите данные точек по оси Х.

    myBpSet.Breakpoints.Value = [-2 -1 0 1 2];

  3. Создайте Simulink.LookupTable объект с именем FirstLUTObj.

    FirstLUTObj = Simulink.LookupTable;

  4. Задайте данные таблицы.

    FirstLUTObj.Table.Value = [1.1 2.2 3.3 4.4 5.5];

  5. Установите первый FirstLUTObj на Reference.

    FirstLUTObj.BreakpointsSpecification = 'Reference'; 
  6. Сконфигурируйте объект интерполяционной таблицы для ссылки на объект набора точек по оси Х.

    FirstLUTObj.Breakpoints = {'myBpSet'};

  7. Создайте другую Simulink.LookupTable объект для хранения другого набора данных таблицы. Сконфигурируйте объект интерполяционной таблицы для ссылки на тот же объект набора точек по оси Х.

    SecondLUTObj = Simulink.LookupTable;
    SecondLUTObj.Table.Value = [1.2 2.3 3.4 4.5 5.6];
    SecondLUTObj.BreakpointsSpecification = 'Reference'; 
    SecondLUTObj.Breakpoints = {'myBpSet'};

Можно использовать FirstLUTObj и SecondLUTObj для задания данных таблицы в двух разных блоках Interpolation Using Prelookup. Использование myBpSet чтобы задать данные набора точек по оси Х в одном или двух блоках Prelookup, которые обеспечивают входы для блоков Interpolation Using Prelookup.

Ограничения

  • Вы не можете использовать Simulink.Breakpoint объекты или Simulink.LookupTable объекты, которые ссылаются на Simulink.Breakpoint объекты как специфичные для экземпляра данные параметра для переиспользуемых компонентов. Например, вы не можете использовать один из следующих объектов как:

    • Аргумент модели в рабочем пространстве модели или значение аргумента модели в блоке Model.

    • Значение параметра маски на блоке CodeReuse Subsystem.

    • Значение параметра маски в подсистеме, которую вы повторно используете, создав пользовательскую библиотеку.

    Однако можно использовать автономные Simulink.LookupTable объекты, которые не относятся к Simulink.Breakpoint объекты, этими способами.

  • Вы не можете сгенерировать код в соответствии со стилем FIX_AXIS.

  • Когда блоки в подсистеме используют Simulink.LookupTable или Simulink.Breakpoint объекты, переопределение типа данных (см. «Управление Инструментирования с фиксированной точкой» и «Переопределение типа данных») нельзя задать только в подсистеме. Вместо этого установите переопределение типа данных на всей модели.

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