get

Класс: Simulink.SimulationData.Dataset
Пакет: 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