Engee 文档

Binary File Reader

从二进制文件中读取数据。

类型: Binary File Reader

图书馆中的路径:

/Signal Operations/Sources/Binary File Reader

资料描述

Binary File Reader 从二进制文件中读取多通道信号数据。 块读取数据前面的标头。 参数 File header 设置标题结构。 您可以使用块参数设置数据的类型、大小和复杂度。

第一次读取文件时,块读取头,然后读取数据。 在随后的调用中,该块读取剩余的数据。 当到达文件末尾时,块返回指定数据类型、大小和复杂度的零。 块可以从块写入的文件中读取数据 Binary File Writer,或从任何其他二进制文件。

港口

输出

# 数据资料 — 来自二进制文件的数据
'标量|/'向量|/`矩阵'

Details

块从参数中指定的二进制文件中读取数据 File name . 输出数据具有以下维度 Samples per frameNumber of channels . 块可以读取浮点和整数数据。 输入数据可以是真实的,也可以是复杂的。 如果数据是复杂的,则块将它们读取为交替的实数和虚数分量。 读取块假定主机上设置的默认字节顺序。

在取消选中复选框之前,此端口没有名称。 Output end-of-file indicator .

数据类型

Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64.

复数支持

是的

# EOF,EOF — 文件结束指示器
0 | 1

Details

当块到达文件末尾时,端口输出'1'。 否则,端口输出'0'。

依赖关系

要使用此端口,请选中此框 Output end-of-file indicator .

数据类型

'Bool`

复数支持

是的

参数

Main

# File name — 档案名称

Details

块从中读取数据的文件的名称。 如果文件不在当前目录中,请指定其完整路径。

默认值

Untitled.bin

程序使用名称

Filename

可调谐

可计算

# File header — 文件头

Details

如果文件不包含标题,则应在字段`()中指定空括号。 如果使用某种头,则必须在字段中输入命名元组’field1=value,。..,fieldN=valueN',取值可以是字符串、数字、数字的一维向量和数字的二维矩阵。

默认值

()

程序使用名称

HeaderStructure

可调谐

可计算

# Storage data type — 文件中的数据类型
Float64 | Float32 | Int8 | Int16 | Int32 | Int64 | UInt8 | UInt16 | UInt32 | UInt64

Details

文件中存储的数据类型。 此参数定义*data*端口上的输出数据类型。

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

默认值

Float64

程序使用名称

DataType

可调谐

可计算

# Samples per frame — 输出信号中的采样数
Integer

Details

定义输出矩阵的行数。 输出矩阵具有以下维度 Samples per frameNumber of channels . 到达文件末尾时,如果输出矩阵未填充,则块将矩阵填充为零,将其转换为全尺寸矩阵。

默认值

1024

程序使用名称

SamplesPerFrame

可调谐

可计算

# Data is complex — 数据复杂性
Logical

Details

如果选择此选项,则读取块将文件中的数据视为复杂数据。 块将数据读取为交替的实部和虚部并输出复数值。

例如,如果块被配置为以`2`乘`2`矩阵的形式读取复杂数据,则数据`[1 5 2 6 3 7 4 8]` 将被读作`[1 2;3 4]+1j*. 如果块被配置为读取真实数据,那么块将它们视为[1 5; 2 6]`.

默认值

false (关掉)

程序使用名称

isDataComplex

可调谐

可计算

# Number of channels — 输出信号中的通道数
Integer

Details

设置输出矩阵的列数。 此参数定义每个时间点在文件中存储的连续交替数据样本的数量。 输出矩阵具有以下维度 Samples per frameNumber of channels . 到达文件末尾时,如果输出矩阵未填充,则块将矩阵填充为零,将其转换为全尺寸矩阵。

默认值

1

程序使用名称

NumChannels

可调谐

可计算

# Output end-of-file indicator — 文件结束指示器
Logical

Details

如果选择此选项,该单元有一个额外的输出端口*EOF*。 当块到达文件末尾时,端口输出'1'。 否则,端口输出'0'。

默认值

false (关掉)

程序使用名称

OutputEOF

可调谐

可计算

# SampleTime (s) — 采样周期
SampleTime (real number / vector of two real numbers)

Details

控制单元输出端口处的采样周期。 此值表示 ,在哪里 -信号数据的采样频率。 输出端口的采样周期等于参数值的乘积 Samples per frameSampleTime (s) .

默认值

1

程序使用名称

SampleTime

可调谐

可计算

# Indexing mode — 读取矩阵的索引顺序
Row-major | Column-major

Details

选择块将如何读取数据。:

  • Row-major -考虑到矩阵是逐行写入的,读取数据;

  • Column-major -考虑到矩阵是按列写入的,读取数据。

Row-major | Column-major

默认值

Row-major

程序使用名称

IndexingMode

可调谐

可计算