Stateflow.Data

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

    Описание

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

    Создание

    Описание

    пример

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

    Входные параметры

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

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

    Свойства

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

    Интерфейс

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

    Возможности объекта данных, заданная в качестве одного из следующих значений:

    • '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.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'. Для получения дополнительной информации смотрите Комплексные данные в Диаграммах Stateflow.

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

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

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

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

    Пример: 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 свойства объекта данных определяют значение этого свойства.

    Для получения дополнительной информации смотрите раздел Добавление данных в разделе Создание графиков при помощи Stateflow API.

    Метод настройки типа данных, заданный как вектор символов, который зависит от возможностей данных:

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

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

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

    Это свойство эквивалентно Mode полю помощника по типам данных в Model Explorer и диалоговом окне Свойства данных. Для получения дополнительной информации см. Раздел «Задание типа данных Stateflow».

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

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

    Пример: 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'. Для получения дополнительной информации смотрите Данные с Фиксированной Точкой в Диаграммах Stateflow.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Индекс для первого элемента объекта данных массива, заданный как вектор символов. Это свойство применяется только к данным массива в графиках, которые используют 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».

    Иерархия

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

    Машина, которая содержит объект данных, заданный как 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