exponenta event banner

добраться

Класс: 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 если существует несколько элементов с таким именем.

При использовании данных набора данных журнала для создания 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