exponenta event banner

Stateflow. Данные

Данные в диаграмме, состоянии, поле или функции

    Описание

    Использовать Stateflow.Data объекты для хранения значений, видимых на определенном уровне иерархии Stateflow ®. Дополнительные сведения см. в разделах Добавление данных Stateflow и Задание свойств данных.

    Создание

    Описание

    пример

    data = Stateflow.Data(parent) создает Stateflow.Data в родительской диаграмме, состоянии, поле или функции.

    Входные аргументы

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

    Родительский элемент для нового объекта данных, указанного как объект API Stateflow одного из следующих типов:

    Свойства

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

    Интерфейс

    Имя объекта данных, указанное как символьный вектор.

    Область объекта данных, указанная как одно из следующих значений:

    • 'Local'

    • 'Input'

    • 'Output'

    • 'Constant'

    • 'Parameter'

    • 'Data Store Memory'

    • 'Temporary'

    • 'Imported'

    • 'Exported'

    Дополнительные сведения см. в разделе Область.

    Индекс порта для объекта данных, заданный как целочисленный скаляр. Это свойство применяется только к входным и выходным данным. Дополнительные сведения см. в разделе Порт.

    Метод обновления объекта данных, указанный как 'Discrete' или 'Continuous'. Это свойство применяется только в том случае, если ChartUpdate свойство диаграммы, содержащей данные: 'CONTINUOUS'. Дополнительные сведения см. в разделе Непрерывное моделирование времени в Stateflow.

    Метод инициализации значения объекта данных, заданного как символьный вектор, зависящий от области данных:

    • Для локальных и выходных данных используйте 'Expression' или 'Parameter'.

    • Для постоянных данных используйте 'Expression'.

    • Для входных данных, параметров и памяти хранения данных используйте 'Not Needed'.

    Это свойство эквивалентно ниспадающему списку Начальное значение (Initial Value) в Обозревателе моделей (Model Explorer) и диалоговом окне Свойства данных (Data properties). Дополнительные сведения см. в разделе Начальное значение.

    Начальное значение объекта данных, указанное как символьный вектор. Дополнительные сведения см. в разделе Начальное значение.

    Пример: data.Props.InitialValue = '1.5';

    Максимальное значение для объекта данных, указанное как символьный вектор. Дополнительные сведения см. в разделе Предельный диапазон.

    Пример: data.Props.Range.Maximum = '1024';

    Минимальное значение для объекта данных, указанное как символьный вектор. Дополнительные сведения см. в разделе Предельный диапазон.

    Пример: data.Props.Range.Minimum = '0';

    Сохранять ли значение объекта данных в переменной с тем же именем в базовой рабочей области MATLAB ® в конце моделирования, указанной как числовой или логический 1 (true) или 0 (false). Это свойство применяется только к данным в диаграммах, которые используют C в качестве языка действий. Дополнительные сведения см. в разделе Сохранение окончательного значения в базовом рабочем пространстве.

    Является ли объект данных настраиваемым параметром, указанным как числовой или логический 1 (true) или 0 (false). Во время моделирования можно изменять только настраиваемые параметры. Это свойство применяется только к данным параметров.

    Принимает ли объект данных комплексные значения, указанные как 'On' или 'Off'. Дополнительные сведения см. в разделе Сложные данные в диаграммах потока состояний.

    Пример: data.Props.Complexity = 'On';

    Разрешается ли объект данных в Simulink.Signal объект, определенный в модели или базовой рабочей области, указанный как числовой или логический 1 (true) или 0 (false). Дополнительные сведения см. в разделе Разрешение свойств данных из сигнальных объектов Simulink.

    Пример: data.Props.ResolveToSignalObject = true;

    Единица измерения для объекта данных, заданная как символьный вектор. Это свойство применяется только к данным в диаграммах, которые используют C в качестве языка действий. Дополнительные сведения см. в разделе Указание единиц измерения для данных потока состояний.

    Пример: data.Props.Unit.Name = 'm';

    Тип данных

    Тип объекта данных, указанный как символьный вектор, который зависит от Props.Type.Method свойство объекта данных:

    • Если Props.Type.Method свойство объекта данных 'Inherit', значение этого свойства равно 'Inherit: From definition in chart' для локальных данных и 'Inherit: Same as Simulink' для входных, выходных и параметрических данных.

    • Если Props.Type.Method свойство объекта данных 'Built-in', это свойство можно задать с помощью одного из следующих параметров:

      • 'double'

      • 'single'

      • 'int8'

      • 'int16'

      • 'int32'

      • 'int64'

      • 'uint8'

      • 'uint16'

      • 'uint32'

      • 'uint64'

      • 'boolean'

      • 'ml' (Поддерживается только в диаграммах, использующих C в качестве языка действий)

      • 'string' (Поддерживается только в диаграммах, использующих C в качестве языка действий)

    • В противном случае Props.Type свойства объекта данных определяют значение этого свойства.

    Дополнительные сведения см. в разделе Добавление данных в диаграммы с помощью API Stateflow.

    Метод установки типа данных, определяемый как символьный вектор, зависящий от объема данных:

    • Для локальных, входных, выходных или параметрических данных используйте 'Inherited', 'Built-in', 'Bus Object', 'Enumerated', 'Expression', или 'Fixed point'.

    • Для постоянных данных используйте 'Built-in', 'Expression', или 'Fixed point'.

    • Для хранения данных в памяти используйте 'Inherited'.

    Это свойство эквивалентно полю Режим (Mode) Ассистента типов данных (Data Type Assistant) в Обозревателе моделей (Model Explorer) и диалоговом окне Свойства данных (Data properties). Дополнительные сведения см. в разделе Указание типа данных потока состояний.

    Пример: data.Props.Method = 'Built-in';

    Название Simulink.Bus объект, определяющий объект данных, указанный как символьный вектор. Это свойство применяется только в том случае, если Props.Type.Method свойство объекта данных 'Bus Object'. Дополнительные сведения см. в разделе Доступ к сигналам шины через структуры потока состояний.

    Пример: data.Props.Type.BusObject = 'COUNTERBUS';

    Имя перечисляемого типа, определяющего объект данных, указанный как символьный вектор. Это свойство применяется только в том случае, если Props.Type.Method свойство объекта данных 'Enumerated'. Дополнительные сведения см. в разделе Ссылочные значения по имени с использованием перечисляемых данных.

    Пример: data.Props.Type.EnumType = 'BasicColors';

    Выражение, которое вычисляет тип данных объекта данных, указанный как символьный вектор. Это свойство применяется только в том случае, если Props.Type.Method свойство объекта данных 'Expression'. Дополнительные сведения см. в разделе Задание свойств данных с помощью выражений MATLAB.

    Пример: data.Props.Type.Expression = 'type(y)';

    Подпись объекта данных с фиксированной точкой, указанного как числовой или логический 1 (true) или 0 (false). Это свойство применяется только в том случае, если Props.Type.Method свойство объекта данных 'Fixed point'. Дополнительные сведения см. в разделе Фиксированные данные в диаграммах потока состояний.

    Пример: data.Props.Type.Signed = false;

    Длина слова в битах объекта данных с фиксированной точкой, заданного как символьный вектор. Это свойство применяется только в том случае, если Props.Type.Method свойство объекта данных 'Fixed point'. Дополнительные сведения см. в разделе Фиксированные данные в диаграммах потока состояний.

    Пример: data.Props.Type.WordLength = '32';

    Метод масштабирования объекта данных с фиксированной точкой, указанный как 'Binary point', 'Slope and bias', или 'None'. Это свойство применяется только в том случае, если Props.Type.Method свойство объекта данных 'Fixed point'. Дополнительные сведения см. в разделе Фиксированные данные в диаграммах потока состояний.

    Пример: data.Props.Type.Fixpt.ScalingMode = 'Binary point';

    Длина дроби в битах объекта данных с фиксированной точкой, заданного как символьный вектор. Это свойство применяется только к данным с фиксированной точкой, если Props.Type.Fixpt.ScalingMode свойство - 'Binary point'. Дополнительные сведения см. в разделе Фиксированные данные в диаграммах потока состояний.

    Пример: data.Props.Type.Fixpt.FractionLength = '2';

    Наклон объекта данных с фиксированной точкой, заданный как символьный вектор. Это свойство применяется только к данным с фиксированной точкой, если Props.Type.Fixpt.ScalingMode свойство - 'Slope and bias'. Дополнительные сведения см. в разделе Фиксированные данные в диаграммах потока состояний.

    Пример: data.Props.Type.Fixpt.Slope = '2^-2';

    Смещение объекта данных с фиксированной точкой, заданного как символьный вектор. Это свойство применяется только к данным с фиксированной точкой, если Props.Type.Fixpt.ScalingMode свойство - 'Slope and bias'. Дополнительные сведения см. в разделе Фиксированные данные в диаграммах потока состояний.

    Пример: data.Props.Type.Fixpt.Bias = '0';

    Следует ли запретить замену типа фиксированной точки объекта данных автоматически масштабированным типом, выбранным инструментом Fixed-Point Tool (Fixed-Point Designer), указанным как числовой или логический 1 (true) или 0 (false). Дополнительные сведения см. в разделе Автоматическое масштабирование с помощью инструмента «Фиксированная точка» (Fixed-Point Designer).

    Пример: data.Props.Type.Fixpt.Lock = true;

    Это свойство доступно только для чтения.

    Тип данных, определяемый компилятором, определяемый как символьный вектор.

    Размер данных

    Размер объекта данных, указанный как символьный вектор. Дополнительные сведения см. в разделе Задание размера данных потока состояний.

    Имеет ли объект данных переменный размер, указанный как числовой или логический 1 (true) или 0 (false). Только данные переменного размера могут изменять размер во время моделирования. Это свойство применяется только к входным и выходным данным и эквивалентно флажку «Размер переменной» в диалоговом окне «Свойства данных». Дополнительные сведения см. в разделе Объявление данных переменного размера в диаграммах потока состояний.

    Индекс для первого элемента объекта данных массива, заданного как символьный вектор. Это свойство применяется только к данным массива в диаграммах, использующих C в качестве языка действий. Дополнительные сведения см. в разделе Сохранение окончательного значения в базовом рабочем пространстве.

    Это свойство доступно только для чтения.

    Размер данных, определяемый компилятором, определяемый как символьный вектор.

    Выход активного состояния

    Это свойство доступно только для чтения.

    Состояние или диаграмма, контролируемые объектом данных, указанные как пустой массив или Stateflow.AtomicSubchart, Stateflow.Chart, Stateflow.SimulinkBasedState, Stateflow.State, или Stateflow.StateTransitionTableChart объект. Дополнительные сведения см. в разделе Мониторинг активности состояния через данные активного состояния.

    Регистрация сигналов

    Включение регистрации сигналов для объекта данных, указанного как числовой или логический 1 (true) или 0 (false). Дополнительные сведения см. в разделе Выходные данные моделирования журнала для состояний и данных.

    Пример: data.LoggingInfo.DataLogging = true;

    Следует ли ограничивать объем регистрируемых данных, указанный как числовой или логический 1 (true) или 0 (false). Когда это свойство true, регистрация сигналов пропускает выборки, используя размер интервала, заданный LoggingInfo.Decimation собственность. Дополнительные сведения см. в разделе Прореживание.

    Пример: data.LoggingInfo.DeimateData = true;

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

    Пример: data.LoggingInfo.Decimation = 5;

    Следует ли ограничивать число точек данных для регистрации, указанных как числовые или логические 1 (true) или 0 (false). Когда это свойство true, регистрация сигнала ограничивает количество точек данных с помощью значения, указанного в LoggingInfo.MaxPoints собственность. Дополнительные сведения см. в разделе Ограничение количества точек данных до последнего.

    Пример: data.LoggingInfo.LimitDataPoints = true;

    Максимальное количество точек данных в журнале, указанное как целочисленный скаляр. Значение по умолчанию 5000 означает, что диаграмма регистрирует последние 5000 точек данных, сгенерированных при моделировании. Дополнительные сведения см. в разделе Ограничение количества точек данных до последнего.

    Пример: data.LoggingInfo.MaxPoints = 100;

    Источник имени сигнала, используемого для регистрации объекта данных, указанного как одно из следующих значений:

    • 'SignalName' - использовать имя объекта данных.

    • 'Custom' - Использовать имя пользовательского сигнала, указанное в LoggingInfo.LoggingName собственность.

    Дополнительные сведения см. в разделе Имя журнала.

    Пример: data.LoggingInfo.NameMode = 'Custom';

    Имя пользовательского сигнала, используемое для регистрации объекта данных, заданного как символьный вектор. Это свойство применяется только в том случае, если LoggingInfo.NameMode свойство - 'Custom'. Дополнительные сведения см. в разделе Имя журнала.

    Пример: data.LoggingInfo.LoggingName = 'Data';

    Отладка

    Следует ли отслеживать значение объекта данных в окне Breakpoints and Watch, указанное как числовое или логическое 1 (true) или 0 (false). Дополнительные сведения см. в разделе Просмотр данных в окне точек останова и наблюдения.

    Следует ли задавать объект данных как тестовую точку, заданную как числовой или логический 1 (true) или 0 (false). Дополнительные сведения см. в разделе Мониторинг контрольных точек в диаграммах потока состояний.

    Иерархия

    Это свойство доступно только для чтения.

    Компьютер, содержащий объект данных, указанный как Stateflow.Machine объект.

    Это свойство доступно только для чтения.

    Расположение родительского объекта данных в иерархии модели, указанное как символьный вектор.

    Идентификация

    Описание объекта данных, заданного как символьный вектор.

    Ссылка на документ для объекта данных, указанная как символьный вектор.

    Определяемый пользователем тег для объекта данных, указанный как данные любого типа.

    Это свойство доступно только для чтения.

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

    Это свойство доступно только для чтения.

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

    Функции объекта

    classhandleПредоставить дескриптор класса для объекта
    dialogДиалоговое окно «Открыть свойства»
    getВозврат структуры MATLAB, содержащей параметры свойств объекта или массива объектов
    setЗадать свойства с заданными значениями
    upВозврат родителя объекта
    viewЭкранный объект в среде редактирования

    Примеры

    свернуть все

    Добавление объекта данных в диаграмму ch. Укажите его имя, область и тип данных.

    data = Stateflow.Data(ch);
    data.Name = 'x';
    data.Scope = 'Input';
    data.Props.Type.Method = 'Built-in';
    data.DataType = 'single';
    Представлен до R2006a