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

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

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

Тип: FromWorkspace

Путь в библиотеке:

/Basic/Sources/From Workspace

Описание

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

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

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

Имя считываемой переменной задается в параметре Данные.

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

Значение параметра Данные

Значение параметра Временные значения

вектор

матрица

матрица N на 1

WorkspaceArray тип :pair

WorkspaceArray тип :time

WorkspaceArray тип :value

включено

ошибка

вектор

ошибка

тип значения WorkspaceArray

ошибка

ошибка

выключено

скаляр

вектор

вектор

тип значения WorkspaceArray

ошибка

тип значения WorkspaceArray

Порты

Выход

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

Details

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

Типы данных

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool

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

Нет

Параметры

Основные

# Данные — данные для загрузки из объекта рабочей области

Details

Переменная в рабочей области в виде вектора, матрицы или типа WorkspaceArray (подробнее см. Работа с WorkspaceArray в Engee).

Если переменная задана в виде вектора, то это всегда один столбец данных (флажок Временные значения не может быть установлен).

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

Подробнее см. в таблице.

Значение по умолчанию

workspace_in

Имя для программного использования

VariableName

Настраиваемый

Нет

Вычисляемый

Нет

# Период дискретизации — интервал между шагами расчета
SampleTime (вещественное число / вектор из двух вещественных чисел)

Details

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

Значение по умолчанию

0

Имя для программного использования

SampleTime

Настраиваемый

Нет

Вычисляемый

Да

# Временные значения — интерпретация данных о времени
Логический тип

Details

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

Значение по умолчанию

true (включено)

Имя для программного использования

TimeValues

Настраиваемый

Нет

Вычисляемый

Нет

# Интерполировать — интерполировать данные
Логический тип

Details

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

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

Значение по умолчанию

true (включено)

Имя для программного использования

Interpolate

Настраиваемый

Нет

Вычисляемый

Нет

# Выход после конечного значения — метод определения вывода блока после конечной точки данных
Экстраполяция | Приравнять к нулю | Удерживать конечное значение | Циклическое повторение

Details

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

Значение параметра Выход после конечного значения Значение параметра Интерполировать Значение выхода блока после последнего значения данных

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

включено

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

выключено

Ошибка

Приравнять к нулю

включено

Ноль

выключено

Удерживать конечное значение

включено

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

выключено

Циклическое повторение

включено

Ошибка

выключено

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

Значения

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

Значение по умолчанию

Extrapolation

Имя для программного использования

OutputAfterFinalValue

Настраиваемый

Нет

Вычисляемый

Нет