получение

Класс: Simulink. SimulationData. Набор данных
Пакет: Simulink. SimulationData

Получите элемент или набор элементов от набора данных

Синтаксис

element = get(dataset,index)
element = get(dataset,name)
element = get(dataset,{name})

Описание

element = get(dataset,index) возвращает элемент, соответствующий index. Метод getElement использует тот же синтаксис и поведение как метод get.

element = get(dataset,name) возвращает элемент, имя которого совпадает с name. Когда name находится в массиве ячеек, возвратите индекс элемента, имя которого совпадает с name.

element = get(dataset,{name}) возвращает один элемент, если только одно имя элемента соответствует, SimulationData.Dataset, если несколько элементов с этим именем существуют.

Если вы используете Log Dataset data to file, чтобы создать MAT-файл, используйте getAsDatastore для быстрого доступа к данным.

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

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

Набор данных, от которого можно получить элемент.

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

Назовите для элемента набора данных, указанного как:

  • Символьный массив, отражающий имя элемента набора данных

  • Массив ячеек, содержащий один вектор символов. Чтобы возвратить SimulationData.Dataset object, который может содержать один элемент, используйте этот формат. Рассмотрите эту форму при записи скриптов.

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

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

Элемент, который находит метод get.

  • Если index является первым аргументом после того, как набор данных, метод возвратит элемент в index.

  • Если name является первым аргументом после набора данных:

    • Если метод находит один элемент, он возвращает элемент.

    • Если метод находит больше чем один элемент, возвратите Набор данных, который содержит элементы.

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

Примеры

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

Доступ к элементам Simulink.SimulationData.Dataset в топ-модели модели ex_bus_logging. Сигналом, регистрирующим набор данных, является topOut.

open_system(docpath(fullfile(docroot,'toolbox','simulink',...
'examples','ex_bus_logging')));
open_system(docpath(fullfile(docroot,'toolbox','simulink',...
'examples','ex_mdlref_counter_bus')));
sim('ex_bus_logging')
topOut
topOut = 

  Simulink.SimulationData.Dataset
  Package: Simulink.SimulationData

  Characteristics:
              Name: 'topOut'
    Total Elements: 4

  Elements:
    1: 'COUNTERBUS'
    2: 'OUTPUTBUS'
    3: 'INCREMENTBUS'
    4: 'inner_bus'

  -Use get or getElement to access elements by index, name or 
   block path.
  -Use addElement or setElement to add or modify elements.

  Methods, Superclasses

Доступ к элементу в индексе, если первый аргумент является числовым значением.

el = logsout.get(1);

Доступ к элементу, имя которого совпадает с name.

el = logsout.get('name');

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

ds = logsout.get({'my_name'}); 

Альтернативы

Можно использовать фигурные скобки, чтобы оптимизировать синтаксис индексации, чтобы получить элемент в наборе данных, вместо того, чтобы использовать get или getElement. Индекс должен быть скаляром, который не больше, чем число элементов в переменной. Например, получите второй элемент набора данных logsout.

logsout{2}

Кроме того, можно использовать метод find, чтобы получить элемент или набор элементов от набора данных.

Введенный в R2011a