slreportgen.finder. Класс DiagramElementFinder

Пакет: slreportgen.finder
Суперклассы:

Создайте объект средства поиска элемента диаграммы

Описание

Находит элементы в блоке Simulink® или схеме графика Stateflow®.

Конструкция

finder = DiagramElementFinder(diagram) создает средство поиска, которое находит элементы схемы блока Simulink или диаграммы Stateflow. По умолчанию это средство поиска находит блоки, аннотации, строки, состояния и другие элементы в схеме. Используйте свойства средства поиска ограничить поиск к определенным типам элементов.

Примечание

Это средство поиска имеет два способа найти, что объекты — находят режим итератора и режим. В режиме находки используйте его метод find, чтобы возвратить результаты поиска как массив результатов. Затем используйте цикл for, чтобы обработать результаты. В режиме итератора используйте его hasNext и методы next, чтобы возвратить результаты поиска по одному. Используя эти методы итератора, используйте некоторое время цикл, чтобы обработать результаты. Ни один из этих методов не имеет преимущество производительности перед другим, так используйте или режим в зависимости от того, предпочитаете ли вы в то время как или циклы for.

finder = DiagramElementFinder(Name,Value) свойства наборов с помощью пар "имя-значение". Можно задать несколько аргументов пары "имя-значение" в любом порядке. Заключите каждое имя свойства в одинарные кавычки.

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

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

Свойство See Container.

Свойства

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

Схематически изобразите, в котором можно искать, заданный как одно из этих значений:

  • Обработайте к блоку Simulink

  • Путь к блоку Simulink

  • Обработайте к блоку диаграммы Stateflow

  • Путь к блоку диаграммы Stateflow

  • ID диаграммы Stateflow

  • Объект диаграммы Stateflow

Типы Simulink или элементов диаграммы Stateflow, чтобы найти, заданный как строка, символьный массив, массив строк или массив ячеек символьных массивов. Если тип является массивом, он задает набор типов элемента. Значением по умолчанию является All или all, который находит все элементы во всех схемах. Используйте одно из этих значений, чтобы ограничить поиск к определенным типам элемента диаграммы. Можно использовать или полностью определенное имя или краткое название.

Полностью определенное имяКраткое название
Allall
Simulink.Annotationannotation
Simulink.Blockblock
Simulink.Segmentline
Simulink.Portport
Stateflow.Annotationsf_annotation
Stateflow.Boxbox
Stateflow.EMFunctionemfunction
Stateflow.Functionfunction
Stateflow.Junctionjunction
Stateflow.SLFunctionslfunction
Stateflow.Statestate
Stateflow.Transitiontransition
Stateflow.TruthTabletruthtable

Выбор включать прокомментированные элементы диаграммы в результаты поиска, заданные как логическое. Если false, прокомментированные элементы исключены из результатов поиска.

Варианты, чтобы искать схемы, заданные как строка или вектор символов. Значением по умолчанию является Active. Допустимые значения:

  • Все Все варианты

  • Active — Только активные варианты

  • ActivePlusCode — Все активные варианты и варианты кода

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

Пример: finder.Properties = {'Gain','5'}

Методы

results = find(finder) находит элементы диаграммы в diagram заданными средством поиска. Этот метод возвращает элементы диаграммы, которые он находит перенесенным в объекты результата типа slreportgen.finder.DiagramElementResult. Чтобы добавить таблицы свойств элемента диаграммы, добавьте объекты результатов непосредственно в отчет или добавьте их в генератор отчетов, который вы затем добавляете в отчет. Отчеты, в которые можно добавить results этого метода, должны быть отчетами типа slreportgen.report.Report.

tf = hasNext(finder) определяет, если схема, что поисковые запросы средства поиска содержат по крайней мере один элемент. Если схема имеет по крайней мере один элемент, очереди метода hasNext, что элемент как следующий элемент, который возвратит метод next. Метод hasNext затем возвращает true. Используйте метод next, чтобы получить тот элемент. На последующих вызовах метод hasNext определяет, имеет ли схема элемент, который еще не получил метод next. Это ставит элемент в очередь для метода next, чтобы получить и возвращает true. Если больше нет элементов, существуют, чтобы быть полученным, этот метод возвращает false. Чтобы прогрессивно искать схему элементы, используйте метод hasNext с методом next в цикле while.

result = next(finder) возвращает следующий поисковый result в очереди результата, которую создал метод hasNext. Этот метод возвращает элемент диаграммы, который он находит перенесенным в объект результата типа slreportgen.finder.DiagramElementResult. Чтобы добавить таблицы свойств элемента диаграммы, добавьте объекты результатов непосредственно в отчет или добавьте их в генератор отчетов, который вы затем добавляете в отчет. Отчеты, в которые можно добавить results этого метода, должны иметь тип slreportgen.report.Report.

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

Указатель. Чтобы изучить, как классы Handle влияют на операции копии, смотрите Копирование Объектов (MATLAB).

Примеры

Найдите блок, аннотацию и линейные элементы

Найдите блок, аннотацию и элементы диаграммы строки на поисковую глубину 1 в модели f14.

import mlreportgen.report.*
import slreportgen.report.*
import slreportgen.finder.*

model_name = 'f14';
load_system(model_name);

rpt = slreportgen.report.Report('output','pdf');
add(rpt, TitlePage("Title",sprintf('%s Model',...
    model_name)));
add(rpt, TableOfContents);

diagFinder = SystemDiagramFinder("Container", ...
     model_name,"SearchDepth",1);
while hasNext(diagFinder)
    system = next(diagFinder);
    chapter = Chapter("Title",system.Name);
    add(chapter,system);
    sect = Section("Title","Diagram Elements");
    elemFinder = DiagramElementFinder("Container", ...
        system.Object, "Types",...
        ["block" "annotation" "line"]);
    elems = find(elemFinder);
    for elem = elems
        add(sect, elem);
    end  
    add(chapter, sect);
    add(rpt, chapter);
end

close(rpt);
close_system(model_name);
rptview(rpt);

Введенный в R2017b