Документация Engee

Из рабочей области

Загрузка данных из рабочей области в виде сигнала.

from workspace

Описание

Блок Из рабочей области считывает данные в модель из рабочей области и представляет их в виде сигнала. Блок Из рабочей области может находиться на любом уровне вложенности модели и может быть использован для передачи данных в любую модель или подсистему из рабочей области.

Особенности загрузки данных

Блок Из рабочей области предназначен для считывания данных из переменных типа WorkspaceArray (специальный тип, который получается либо в результате выгрузки данных при помощи блока В рабочую область, либо может быть создан вручную). Имя считываемой переменной задается в поле Data блока.

Порты

Выход

Port_1 — данные из рабочей области
скаляр | вектор | матрица

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

Типы данных: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool

Поддержка комплексных чисел: Да

Параметры

Main

Data — данные для загрузки из объекта рабочей области
workspace_in (по умолчанию) | строка

Имя переменной в рабочей области типа Работа с большими данными через WorkspaceArray.

Программное использование

Параметр блока

VariableName

Значение

WorkspaceArray

По умолчанию

workspace_in

Sample time — интервал между шагами расчета
−1 (по умолчанию) | скаляр

Укажите параметр Sample time как неотрицательное число. Чтобы наследовать дискретный шаг системы, установите значение этого параметра равным −1.

Программное использование

Параметр блока:

SampleTime

Значение:

скаляр

По умолчанию:

0

Time Values — интерпретация данных о времени
включено (по умолчанию) | выключено

Установите флажок, чтобы включить интерпретацию данных о времени.

Interpolate — интерполировать данные
включено (по умолчанию) | выключено

Метод интерполяции, используемой для вычисления промежуточных значений сигнала (отсутствующих в исходных данных). Если флажок установлен, блок Из рабочей области использует линейную интерполяцию промежуточных значений, если снят — константную.

Значение параметра Interpolate также влияет на то, как блок Из рабочей области экстраполирует выходные значения для времени симуляции до первой точки данных. Когда параметр включен, блок использует первые две точки, чтобы линейно экстраполировать выходные значения. Когда параметр выключен, выходной сигнал равен 0. Включение интерполяции позволяет использовать метод экстраполяции Extrapolate.

Программное использование

Параметр блока

Interpolate

Значение

включено | выключено

По умолчанию

включено

Output after final value — метод определения вывода блока после конечной точки данных
Extrapolation | Setting to zero | Holding final value | Cyclic repetition

Блок Из рабочей области использует параметры Interpolate и Output after final value, чтобы вычислить выход блока для времени симуляции после последней точки, доступной в загруженных данных.

Значение параметра Output after final value Значение параметра Interpolate Значение выхода блока после последнего значения данных

Extrapolation

включено

Экстраполировано на основе последних двух точек данных

выключено

Ошибка

Setting to zero

включено

Ноль

выключено

Holding final value

включено

Последнее значение

выключено

Cyclic repetition

включено

Ошибка

выключено

Данный режим можно использовать только при условии, что параметры Interpolate и Time Values выключены, а также задан дискретный Sample Time. В таком случае данные циклично повторяются с первого значения, в ином случае возникает ошибка.

Программное использование

Параметр блока

OutputAfterFinalValue

Значение

Extrapolation | Setting to zero | Holding final value | Cyclic repetition

По умолчанию

Extrapolation

Алгоритмы

Интерполяция

Интерполяция — это процесс, который блок Из рабочей области использует, чтобы предоставить выходные значения, находящиеся между шагами расчета в загруженных данных, для времени симуляции. Если установлен флажок Interpolate, блок Из рабочей области линейно интерполирует выходное значение с помощью двух соседних точек в данных рабочей области.

Когда флажок Interpolate не установлен, блок Из рабочей области использует значение предыдущей точки данных в качестве выходного значения.

Экстраполяция

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

Можно управлять тем, как блок Из рабочей области экстраполирует выходные значения перед первым значением с помощью параметра Interpolate. Используйте Interpolate и Output after final value, чтобы указать, как блок экстраполирует выходные значения после конечной точки данных.

Значение параметра Interpolate Вывод перед первой точкой данных Значение параметра Output after final value Вывод после конечной точки данных

включено

Линейно экстраполировано с использованием первых двух точек данных рабочей области.

Extrapolation

Линейно экстраполировано с использованием последних двух значений данных рабочей области.

Setting to zero

Ноль

Holding final value

Последнее значение данных

Cyclic repetition

Ошибка

выключено

Ноль

Extrapolation

Ошибка

Setting to zero

Ноль

Holding final value

Последнее значение данных

Cyclic repetition

Когда загруженные данные рабочей области используют структуру без формата времени, данные рабочей области повторяются из первого значения.

Ошибки для форматов данных рабочей области, отличных от структуры со временем.