Embedded IDE Link™ CC

readnumeric

Read object in memory and convert to numeric equivalent in MATLAB^® environment

Syntax

data = readnumeric(objname) data = readnumeric(objname,index) data = readnumeric(...,timeout)

Description

data = readnumeric(objname) returns all data from the memory area specified by objname and converts it into a numeric representation. The properties of objname control the numeric conversion process. Output data is a numeric array that has dimensions defined by objname.size, which is the dimensions array. Each element in the dimensions array specifies the size of the objname array in that dimension. When size is a scalar, data is a column vector of the specified length.

data = readnumeric(objname,index) returns a subset of the numeric values from the numeric array specified by objname. Each row of index is applied as a subscript into the full objname array. Output data composes a column vector with one value per entry in the data. Array indices start at one and range up to the maximum value defined by the value of the property size for objname.

When index is a vector, each row is a single index that defines one entry from the defined numeric array. data is a column vector of values corresponding to the specified indices. You can pass a new timeout value to modify temporarily the default timeout property of objname.

data = readnumeric(...,timeout) adds the optional input argument timeout that lets you specify how long MATLAB software waits for the readnumeric operation to return a completion message. When MATLAB software does not receive notification that the operation finished within the allotted time, you get a time-out error. You may find that the operation did complete successfully in spite of the error message.

objname Array Properties

Property Name	Description
`objname.size`	Dimensions of output numeric array. This defines the size of the output.
`objname.arrayorder`	Defines how sequential memory locations are mapped into matrices in MATLAB software. The default is column major ordering, which is the default arrangement in MATLAB software. Alternatively, you can use row major ordering, which is the memory organization used in C numeric representations.
`objname.represent`	Defines the numeric representation in `objname`. Valid data types for `represent` are: `float` — IEEE^® floating point representation (32 or 64 bits) `signed` — Two's complement signed integers `unsigned` — Unsigned binary integers `fract` — Fractional fixed-point representation. For more information, refer to `objname.p`
`objname.wordsize`	Number of valid bits in the numeric representation. `wordsize` is computed from other properties such as `storageunitspervalue` and therefore this property is read-only.
`objname.binarypt`	Other properties of `objname` control the placement and arrangement of the numeric values in memory.

Changes to the numeric representation are possible by modifying the class properties. However, the convert method enables you to adjust the property values to implement some common data types.

readnumeric

Syntax

Description

objname Array Properties

See Also