nvidia.dali.fn.io.file.read#

nvidia.dali.fn.io.file.read(__filepaths, /, *, bytes_per_sample_hint=[0], dont_use_mmap=False, preserve=False, use_o_direct=False, device=None, name=None)#

从由 1D 字节数组表示的编码文件名中读取原始文件内容。

注意

要从 Python 生成兼容的编码文件路径（例如，在 external_source 节点生成器中），请使用 np.frombuffer(filepath_str.encode(“utf-8”), dtype=types.UINT8)。

支持的后端

  • ‘cpu’

参数:

__filepaths (TensorList) – 要读取的文件路径。

关键字参数:

  • bytes_per_sample_hint (int 或 int 列表, 可选, 默认 = [0]) –

    输出大小提示，以每样本字节数为单位。

    如果指定，则运算符位于 GPU 或页锁定主机内存中的输出将被预先分配，以容纳此大小的样本批次。

  • dont_use_mmap (bool, 可选, 默认 = False) –

    如果设置为 True，它将使用普通文件 I/O，而不是尝试将文件映射到内存中。

    当访问本地文件系统时，映射提供少量性能优势，但对于大多数网络文件系统，它不提供优势

  • preserve (bool, 可选, 默认 = False) – 阻止运算符从图中删除，即使其输出未使用。

  • use_o_direct (bool, 可选, 默认 = False) –

    如果设置为 True，数据将直接从存储读取，绕过系统缓存。

    与 dont_use_mmap=False 互斥。

本页目录