Engee documentation

Data Store Write

Writing to a data warehouse.

data store write

Description

Block Data Store Write copies the value on its input to a named data store. Each write operation performed by the block Data Store Write, overwrites the data store or a selected part of it and replaces the previous contents.

The datastore to which this block writes is determined by the name of the datastore, which is specified by the parameters of the Data store name blocks Data Store Write и Data Store Memory. The size of the data store is specified by the block *Data Store Memory*which defines and initialises the data store.

In the block Data Store Memory you can specify the data storage as a scalar, vector, matrix or multidimensional array. In this case, in Data Store Write it is impossible to write to the data storage a value of a higher dimension than it is specified in the storage (for example, it will not be possible to write a vector to a scalar).

More than one block can be written to one and the same data store Data Store Write. However, if two blocks Data Store Write attempt to write data to the same data store during the same simulation step, the results will be unpredictable.

To obtain correct results from data stores, the expected order of reading and writing to the data store must be ensured.

Ports

Input

# IN — values to be written to the data warehouse
scalar | vector | matrix | N-D array

Details

Values to be written to the specified data store, specified as a real or complex scalar, vector, matrix or - - array.

To assign a subset of bus or matrix elements to the corresponding data store, use the Element Assignment parameters section.

Data types

Float32 | Float64| Int8 | Int16 | Int32 | Int64 | UInt8 | UInt16 | UInt32 | UInt64 | Bool

Complex numbers support

Yes

Parameters

Parameters

# Data store name — name of the data storage to which the block is written
String

Details

The name of the datastore to which this block writes data.

If the programme does not find the block *Data Store Memory*block, it stops compilation and generates an error.

Default value

A

Program usage name

DataStoreName

Tunable

No

Evaluatable

Yes

# Sample time — interval between calculation steps
SampleTime (real number / vector of two real numbers)

Details

Specify the interval between calculation steps as a non-negative number. To inherit a calculation step, set this parameter to -1.

Default value

-1

Program usage name

SampleTime

Tunable

No

Evaluatable

Yes

Parameters

# Specify element(s) to assign — list of selected items
String

Details

Storage elements to which you write data using the block Data Store Write. The block icon displays next to each input port the storage element you specified (if there are 2 or more input ports).

Default value

Program usage name

DataStoreElements

Tunable

No

Evaluatable

Yes