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 或 list of int, 可选, 默认值 = [0]) –

    输出大小提示，以每样本字节数表示。

    如果指定，则驻留在 GPU 或页面锁定主机内存中的操作符输出将被预先分配，以容纳此大小的样本批次。

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

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

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

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

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

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

    与 dont_use_mmap=False 互斥。

本页内容