get

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

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

Синтаксис

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

Описание

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

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

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

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

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

расширить все

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

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

Имя элемента набора данных, заданное как:

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

  • Массив ячеек, содержащий один вектор символов. Возврат 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