Engee documentation

Signal From Workspace

Loading data from the workspace as a signal.

blockType: SubSystem

Path in the library:

/Signal Operations/Sources/Signal From Workspace

Description

Block Signal From Workspace reads the data into the model from the workspace and presents it as a signal. In the parameter Signal the name of the workspace variable containing the imported signal is specified, or any expression defining a matrix or a three-dimensional array.

Ports

Output

# OUT_1 — data from the workspace
scalar | vector | the matrix | array

Details

Data loaded from the workspace as a signal. Depending on the loaded data, the output signal can be a scalar, a vector, a matrix, or a three-dimensional array.

If the parameter Signal sets the matrix on ( ), each of columns are treated as a separate channel. The frame size is set by the Samples per frame parameter., . The output is a matrix on , containing consecutive samples from each signal channel. The sampling period at the output is set by the parameter Sample time, , and the frame period at the output – . For convenience, the imported string vector it is considered as a single channel, therefore the dimension of the output frame is equal to on .

Data types

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

Complex numbers support

Yes

Parameters

Main group

# Signal — the imported signal

Details

The imported signal from the variable workspace, or a valid expression defining the signal.

Default value

collect(1:10)

Program usage name

Signal

Tunable

No

Evaluatable

Yes

# Sample time — sampling period

Details

Sampling period of the output frame , set as a positive number. The sampling period of the output frame is .

Default value

1

Program usage name

SampleTime

Tunable

No

Evaluatable

Yes

# Samples per frame — samples per output frame

Details

Number of samples per frame in one output data channel, set as a positive integer.

Default value

1

Program usage name

SamplesPerFrame

Tunable

No

Evaluatable

Yes

# Form output after final data value by — output values
Setting to zero | Holding final value | Cyclic repetition

Details

Determines the output signal after generating all specified signal samples.

  • If a value is specified for this parameter Setting to zero, the block generates zero-value output signals for the entire simulation time after generating the last signal frame.

  • If a value is specified for this parameter Holding final value, the block repeats the last frame during the entire simulation time after generating the last frame of the signal.

  • If a value is specified for this parameter Cyclic repetition, the block repeats the signal from the beginning after reaching the last frame of the signal. If the frame size is specified in the parameter Samples per frame, does not evenly divide the length of the input signal into a block Signal From Workspace, then an error will appear.

The block does not extrapolate the imported signal beyond the last sample.

Values

Setting to zero | Holding final value | Cyclic repetition

Default value

Setting to zero

Program usage name

FormOutput

Tunable

No

Evaluatable

Yes