Simulink.SimulationData.ModelLoggingInfo

Сигнал, регистрирующий настройки переопределения для модели

Описание

Этот класс является набором Simulink.SimulationData.SignalLoggingInfo объекты, которые задают весь сигнал, регистрирующий настройки переопределения для модели.

Используйте методы и свойства этого класса к:

  • Выключите логгирование для сигнала или блока Model.

  • Измените настройки логгирования для любых сигналов, которые отмечены для логгирования в модели.

Можно управлять, используют ли топ-модель и настройки логгирования сигнала переопределения моделей, на которые ссылаются, или настройки логгирования сигнала, заданные моделью. Используйте LoggingMode и LogAsSpecifiedByModels свойства управлять, который, регистрируя настройки, чтобы применяться.

Логгирование режима для моделейНастройки свойства

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

Установите LoggingMode к LogAllAsSpecifiedInModel.

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

Установите LoggingMode к OverrideSignals.

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

Установите LoggingMode к OverrideSignals.

Включайте модели, вы хотите проигнорировать сигнал переопределения логгирование настроек в LogAsSpecifiedByModels cellArray.

Для получения дополнительной информации и примеры, смотрите Сигнал Переопределения Регистрировать Настройки из MATLAB.

Сводные данные свойства

Имя

Описание

LoggingMode

Сигнал, регистрирующий состояние переопределения

LogAsSpecifiedByModels

Источник настроек логгирования сигнала для топ-модели или блока Model верхнего уровня

Signals

Все сигналы, которые имеют настройки переопределения сигнала

Сводные данные метода

Имя

Описание

findSignal

Найдите сигналы в Signals вектор, с помощью блока path и индекса выходного порта.

verifySignalAndModelPaths

Проверьте пути модели и сигнала для сигнала модели, регистрирующего объект переопределения.

getLogAsSpecifiedInModel

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

setLogAsSpecifiedInModel

Установите режим логгирования для топ-модели или блока Model верхнего уровня.

createFromModel

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

ModelLoggingInfo

Установите сигналы регистрировать или заменить настройки логгирования.

Свойства

LoggingMode

Описание

Сигнал, регистрирующий состояние переопределения. Значения:

  • OverrideSignals — Использование (По умолчанию) настройки логгирования для сигналов, как задано в Signals свойство. Для моделей, где getLogAsSpecifiedInModel :

    • true — Журналы все сигналы, как задано в модели.

    • false — Журналы только сигналы заданы в Signals свойство.

  • LogAllAsSpecifiedInModel — Журналы сигнализируют в топ-модели и всех моделях, на которые ссылаются, как задано в модели. Simulink® соблюдает индикаторы логгирования сигнала (синие антенны) и игнорирует Signals свойство.

Чтобы изменить режим логгирования для топ-модели или для данной модели, на которую ссылаются, используйте setLogAsSpecifiedInModel метод.

Тип данных

массив символов

Доступ

RW

LogAsSpecifiedByModels

Описание

Когда LoggingMode установлен в 'OverrideSignals', LogAsSpecifiedByModels массив ячеек задает топ-моделей и блоки Model верхнего уровня, которые игнорируют 'OverrideSignals' установка и журнал сигнализирует, как задано в блоках Model или моделях.

  • Для топ-модели и блоков Model верхнего уровня, которые включает массив ячеек, Simulink игнорирует Signals переопределения свойства.

  • Для модели или блока Model, который не включает массив ячеек, Simulink использует Signals свойство определить, который сигналы регистрировать.

Когда LoggingMode установлен в 'LogAllAsSpecifiedInModel', Simulink игнорирует LogAsSpecifiedByModels свойство.

Используйте getLogAsSpecifiedInModel метод, чтобы определить, используют ли топ-модель или логарифмические сигналы блока Model верхнего уровня, как задано в модели (логгирование значения по умолчанию), и setLogAsSpecifiedInModel поворачивать вхождение в систему по умолчанию и прочь.

Тип данных

массив ячеек — Для топ-модели, задайте имя модели. Для блоков Model задайте блок path.

Доступ

RW

Сигналы

Описание

Вектор из Simulink.SimulationData.SignalLoggingInfo объекты для всех сигналов с сигналом, регистрирующим настройки переопределения.

Тип данных

вектор из Simulink.SimulationData.SignalLoggingInfo объекты

Доступ

RW

Методы

createFromModel

Цель

Создайте Simulink.SimulationData.ModelLoggingInfo объект для топ-модели, с настройками переопределения для каждого регистрируемого сигнала в модели.

Синтаксис
model_logging_info_object = ...
Simulink.SimulationData.ModelLoggingInfo.createFromModel(...
model,options)
Входные параметры
model

Имя топ-модели, для которой можно создать Simulink.SimulationData.ModelLoggingInfo объект.

options

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

  • FollowLinks

    • on — (Значение по умолчанию) Включает регистрируемые сигналы изнутри библиотек.

    • off — Пропустите все библиотеки.

  • LookUnderMasks

    • all — (Значение по умолчанию) Включает регистрируемые сигналы от всех подсистем маскированных.

    • none — Пропустите все подсистемы маскированные.

    • graphical — Включайте регистрируемые сигналы от подсистем маскированных, которые не имеют рабочей области или диалогового окна.

    • functional — Включайте регистрируемые сигналы от подсистем маскированных, которые не имеют диалогового окна.

  • Variants

    • ActiveVariants — (Значение по умолчанию) Включает регистрируемые сигналы только от активной подсистемы и вариантов модели.

    • AllVariants — Включайте регистрируемые сигналы от всей подсистемы и вариантов модели.

  • RefModels

    • on — (Значение по умолчанию) Включает регистрируемые сигналы из моделей, на которые ссылаются.

    • off — Пропустите все модели, на которые ссылаются.

Если вы выбираете больше чем одну опцию, то созданный Simulink.SimulationData.ModelLoggingInfo объект включает сигналы, которые соответствуют комбинациям (“AND”) заданных опций. Например, если вы устанавливаете FollowLinks к on и набор RefModels к off, затем сигнал модели, регистрирующий объект переопределения, не включает сигналы от ссылок библиотеки, которые существуют в моделях, на которые ссылаются.

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

Simulink.SimulationData.ModelLoggingInfo объект для топ-модели.

Описание

model_logging_info_object = Simulink.SimulationData.ModelLoggingInfo.createFromModel(model) создает Simulink.SimulationData.ModelLoggingInfo объект для модели, которая включает регистрируемые сигналы для следующих видов систем:

  • Библиотеки

  • Подсистемы маскированные

  • Модели, на которые ссылаются,

  • Активные варианты

model_logging_override_object = Simulink.SimulationData.ModelLoggingInfo.createFromModel(model, options) создает Simulink.SimulationData.ModelLoggingInfo объект для модели. Включенные регистрируемые сигналы отражают настройки опций для следующих видов систем:

  • Библиотеки

  • Подсистемы маскированные

  • Модели, на которые ссылаются,

  • Варианты

Примеры

Следующий пример создает модель, регистрирующую объект переопределения для sldemo_mdlref_bus модель и автоматически добавляет каждый регистрируемый сигнал в модели к тому объекту:

mi = Simulink.SimulationData.ModelLoggingInfo.createFromModel(...
'sldemo_mdlref_bus')
mi = 

  ModelLoggingInfo with properties:

                     Model: 'sldemo_mdlref_bus'
               LoggingMode: 'OverrideSignals'
    LogAsSpecifiedByModels: {}
                   Signals: [1x3 Simulink.SimulationData.SignalLoggingInfo]

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

set_param(sldemo_mdlref_bus,'DataLoggingOverride',mi);

Можно использовать опции для createFromModel метод, чтобы задать, как метод должен обработать компоненты модели как варианты и модели - ссылки. Например, используйте Variants опция, чтобы создать model_logging_override объект, который включает регистрируемые сигналы во все варианты sldemo_variant_subsystems модель.

По умолчанию, sldemo_variant_subsystems модель не регистрирует сигналов. Запустите путем конфигурирования выходных сигналов Linear Controller и Nonlinear Controller подсистемы для логгирования.

% Open the sldemo_variant_subsystems model
sldemo_variant_subsystems;

% Mark the output of the Linear Controller subsystem for logging
ph = get_param('sldemo_variant_subsystems/Controller/Linear Controller',...
    'PortHandles');
set_param(ph.Outport(1),'DataLogging','on');

% Mark the output of the Nonlinear Controller subsystem for logging
ph1 = get_param('sldemo_variant_subsystems/Controller/Nonlinear Controller',...
    'PortHandles');
set_param(ph1.Outport(1),'DataLogging','on');

Затем используйте createFromModel метод, чтобы создать model_logging_override объект, который включает сигналы, вошел в систему все различные подсистемы sldemo_variant_subsystems модель.

% Create a model_logging_override object for the model including all variants
mi = Simulink.SimulationData.ModelLoggingInfo.createFromModel(...
'sldemo_variant_subsystems', 'Variants', 'AllVariants')
mi = 

  ModelLoggingInfo with properties:

                     Model: 'sldemo_variant_subsystems'
               LoggingMode: 'OverrideSignals'
    LogAsSpecifiedByModels: {}
                   Signals: [1×2 Simulink.SimulationData.SignalLoggingInfo]

ModelLoggingInfo

Цель

Задайте сигналы регистрировать или заменить настройки логгирования.

Синтаксис
model_logging_override_object = ....
Simulink.SimulationData.ModelLoggingInfo(model)
Входные параметры
model

Имя топ-модели, для которой можно создать Simulink.SimulationData.ModelLoggingInfo объект

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

Simulink.SimulationData.ModelLoggingInfo объект создается для заданной топ-модели.

Описание

model_logging_override_object= Simulink.SimulationData.ModelLoggingInfo(model) создает Simulink.SimulationData.ModelLoggingInfo объект для заданной топ-модели.

Если вы используете Simulink.SimulationData.ModelLoggingInfo конструктор, задайте Simulink.SimulationData.SignalLoggingInfo объект для каждого регистрируемого сигнала, для которого вы хотите заменить настройки логгирования.

Чтобы проверять, что вы задали допустимый сигнал, регистрирующий настройки переопределения для модели, используйте verifySignalAndModelPaths метод с Simulink.SimulationData.ModelLoggingInfo объект для модели.

Примеры

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

mi = Simulink.SimulationData.ModelLoggingInfo('sldemo_mdlref_bus');
mi.LoggingMode = 'LogAllAsSpecifiedInModel'
mi = 

  ModelLoggingInfo with properties:

                     Model: 'sldemo_mdlref_bus'
               LoggingMode: 'LogAllAsSpecifiedInModel'
    LogAsSpecifiedByModels: {}
                   Signals: []

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

set_param(sldemo_mdlref_bus, 'DataLoggingOverride', mi);

Следующий пример показывает, как регистрировать только сигналы в топ-модели:

mi = ...
Simulink.SimulationData.ModelLoggingInfo('sldemo_mdlref_bus');
mi.LoggingMode = 'OverrideSignals';
mi = mi.setLogAsSpecifiedInModel('sldemo_mdlref_bus', true); 
set_param('sldemo_mdlref_bus', 'DataLoggingOverride', mi);

findSignal

Цель

Найдите сигналы в Signals вектор, с помощью блока path и опционально индекса выходного порта.

Синтаксис
signal_indices = ...
      model_logging_override_object.findSignal(block_path)
signal_indices = ...
      model_logging_override_object.findSignal(...
      block_path, port_index)
Входные параметры
block_path

Исходный блок, чтобы искать. block_path должно быть одно из следующего:

  • Символьный вектор

  • Массив ячеек из символьных векторов

  • Simulink.BlockPath объект

port_index

Индекс выходного порта, чтобы искать. Задайте скаляр, больше, чем, или равный, 1.

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

Вектор из числовых индексов в вектор сигналов из Simulink.SimulationData.ModelLoggingInfo объект.

Описание

signal_indices = model_logging_override_object.findSignal(block_path) находит индексы сигналов для блока path, что вы задаете.

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

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

Чтобы найти регистрируемый график сигнализируют в рамках Stateflow® стройте диаграмму, используйте Simulink.BlockPath объект и набор SubPath свойство к имени сигнала диаграммы Stateflow.

signal_indices = model_logging_override_object.findSignal(block_path, port_index) находит индексы выходного сигнала для порта, который вы задаете для блока path, который вы задаете.

Не используйте port_index аргумент для сигналов диаграммы Stateflow.

Примеры

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

open_system(docpath(fullfile(docroot,'toolbox','simulink','examples','ex_bus_logging')))
% Open the referenced model
ex_mdlref_counter_bus
mi = Simulink.SimulationData.ModelLoggingInfo.createFromModel(... 
     'ex_bus_logging');
% Click the COUNTERBUSCreator block that is the source of 
% the logged COUNTERBUS signal
signal_index = mi.findSignal(gcb)
signal_index =

     1

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

signal_index = mi.findSignal({'ex_bus_logging/CounterA', ...
'ex_mdlref_counter_bus/Bus Creator'})
signal_index =

     4

Для примера, который использует findSignal метод с диаграммой Stateflow, смотрите Override Logging Properties с API Командной строки (Stateflow).

getLogAsSpecifiedInModel

Цель

Определите, заменяют ли журналы модели, как задано в модели или использовании настройки.

Синтаксис
logging_mode = ...
getLogAsSpecifiedInModel(model_logging_override_object, path)
Входные параметры
model_logging_override_object

Simulink.SimulationData.ModelLoggingInfo объект.

path

path вектор символов, который задает одно из следующего:

  • Имя топ-модели

  • Блок path блока Model в топ-модели

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

logging_mode :

  • true, если модель задана path регистрируется, как задано в модели.

  • false, если модель задана path регистрируется с помощью настроек переопределения, заданных в Signals свойство.

Описание

logging_mode = model_logging_override_object.getLogAsSpecifiedInModel(path) возвращается:

  • true, если модель задана path регистрируется, как задано в модели.

  • false, если модель задана path регистрируется с помощью настроек переопределения, заданных в Signals свойство.

Примеры

В следующем примере, Simulink.SimulationData.ModelLoggingInfo объект mi использует настройки переопределения, заданные в его Signals свойство.

mi = Simulink.SimulationData.ModelLoggingInfo('sldemo_mdlref_bus');
logging_mode = getLogAsSpecifiedInModel(mi, 'sldemo_mdlref_bus')
logging_mode =

     0

setLogAsSpecifiedInModel

Цель

Установите режим логгирования для топ-модели или блока Model верхнего уровня

Синтаксис
setLogAsSpecifiedInModel(override_object, path)
Входные параметры
override_object

Simulink.SimulationData.ModelLoggingInfo объект.

path

Вектор символов, который задает одно из следующего:

  • Имя топ-модели

  • Блок path блока Model в топ-модели

value

Режим Logging:

  • true, если модель задана path регистрируется, как задано в модели

  • false, если модель задана path регистрируется с помощью настроек переопределения, заданных в Signals свойство.

Описание

setLogAsSpecifiedInModel(override_object, path, value) устанавливает свойство LoggingMode для топ-модели или блока Model в топ-модели.

Пример

Следующий пример показывает, как регистрировать только сигналы в топ-модели, с помощью настроек логгирования, заданных в той модели:

sldemo_mdlref_bus;
mi = Simulink.SimulationData.ModelLoggingInfo('sldemo_mdlref_bus');
mi.LoggingMode = 'OverrideSignals';
mi = setLogAsSpecifiedInModel(mi, 'sldemo_mdlref_bus', true); 
set_param('sldemo_mdlref_bus', 'DataLoggingOverride', mi);

verifySignalAndModelPaths

Цель

Проверьте пути в Simulink.SimulationData.ModelLoggingInfo объект.

Синтаксис
verified_object = verifySignalAndModelPaths...
     (model_logging_override_object, action)
Входные параметры
model_logging_override_object

Simulink.SimulationData.ModelLoggingInfo объект проверить. Этот аргумент требуется.

action

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

  • error — Бросок (по умолчанию) ошибка, когда верификация перестала работать

  • warnAndRemove — Выдайте предупреждение, когда сбои верификации и обновят Simulink.SimulationData.ModelLoggingInfo объект.

  • remove — Тихо обновите Simulink.SimulationData.ModelLoggingInfo объект.

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

Если метод не обнаруживает недопустимых путей, он возвращает подтвержденный объект. Например:

verified_object = 

  Simulink.SimulationData.ModelLoggingInfo
  Package: Simulink.SimulationData

  Properties:
                     Model: 'logging_top'
               LoggingMode: 'OverrideSignals'
    LogAsSpecifiedByModels: {}
                   Signals: [1x11 Simulink.SimulationData.SignalLoggingInfo]

Если метод обнаруживает недопустимый путь, он выполняет действие, заданное action аргумент. По умолчанию это выдает ошибку сообщение.

Описание

verified_object = verifySignalAndModelPaths(model_logging_override_object, action)

Для Simulink.SimulationData.ModelLoggingInfo возразите, проверьте что:

  • Все векторы символов в LogAsSpecifiedByModels свойство является или именем топ-модели или блоком path блока Model в топ-модели.

  • Пути к блоку для сигналов в Signals свойство относится к допустимым блокам в иерархии топ-модели.

  • OutputPortIndex свойство для всех сигналов в Signals свойство допустимо для данного блока.

  • Все сигналы в Signals свойство относится к регистрируемым сигналам.

action аргумент задает, какое действие метод выполняет. По умолчанию метод возвращает ошибку, если он обнаруживает недопустимый путь.

Если вы используете Simulink.SimulationData.ModelLoggingInfo конструктор и задает Simulink.SimulationData.SignalLoggingInfo объект для каждого сигнала, затем рассмотрите использование verifySignalAndModelPaths метод, чтобы проверить, что ваши определения объектов допустимы.

Пример

Следующий пример показывает, как подтвердить сигнал и пути к блоку в Simulink.SimulationData.ModelLoggingInfo объект. Поскольку action аргументом является warnAndRemove, если валидация перестала работать, verifySignalAndModelPaths метод выдает предупреждение и обновляет Simulink.SimulationData.ModelLoggingInfo объект.

mi = Simulink.SimulationData.ModelLoggingInfo('sldemo_mdlref_bus');
verified_object = verifySignalAndModelPaths...
     (mi, 'warnAndRemove')
Представленный в R2012b
Для просмотра документации необходимо авторизоваться на сайте