保存文件类算子

功能描述

这是一类算子的统称，用于将不同类型的数据（如点云、图像、EpicRaw格式数据）保存到本地文件系统。具体的输入输出取决于该类别下具体的保存算子。

使用场景

  • 数据持久化：保存中间处理结果或最终输出数据，用于后续分析、调试、存档或与其他系统共享。

  • 离线处理：保存实时采集的数据，以便后续进行离线开发和测试。

  • 数据备份：为重要数据创建备份。

输入输出

输入项

具体输入项取决于所使用的具体“保存文件”类算子，例如【保存点云】算子需要点云数据作为输入。

输出项

通常无数据输出到下游算子，或输出保存文件的路径。

参数说明

包含【保存点云】、【保存图片】、【保存图片和点云】、【保存EpicRaw】四个算子，以下为通用文件保存相关参数配置，用于控制文件保存的位置、命名方式和存储管理。

保存路径

参数说明

用于指定文件保存的目标文件夹路径。

调参说明

  • 指定路径：直接输入一个有效文件夹路径，或点击右侧图标点选一个文件夹路径。

  • 不指定路径：即不填任何路径，算子默认会在 .transfertech 的 atom 文件夹里创建一个 file_save_dir 子文件夹作为存储路径。这对于临时保存或不关心具体存储位置时比较方便。

  • 路径检查：算子会检查指定的路径是否有效。如果路径指向一个已存在的文件（而非文件夹），或者路径无效，算子会报错。如果指定路径不存在，则会尝试创建。

保存名字

参数说明

指定保存文件名称，不需要包含文件后缀名。

调参说明

建议使用具有描述性的名称，便于后续检索和管理，避免使用特殊字符。默认名称：data

只保存单一文件

参数说明

设置文件保存策略，保存为单一文件或者多个文件。

调参说明

  • 关闭（默认）：生成多个文件，自动在指定文件名后添加时间戳避免重名，适用于需要记录历史数据或多次运行结果的场景。

  • 开启：算子每次运行都会尝试使用指定名称作为文件名来保存数据，如果文件已存在，新的数据会覆盖旧的文件。适用于需要固定文件名输出，例如用于覆盖上一次结果的场景。

可存储最大内存

参数说明

设置保存目录下允许存储文件的最大总大小，当文件夹内相关文件的总大小超过此限制时，软件会尝试删除该目录下最早创建的同类型文件，以释放空间。

调参说明

请根据可用磁盘空间和数据保留需求设置此值：

  • 较小值： 会更频繁地删除旧文件，节省磁盘空间，但可能导致历史数据丢失较快。

  • 较大值： 允许保存更多历史数据，但会占用更多磁盘空间。

参数范围

[0.00001, 10]，默认值：10，单位：GB

二进制存储

参数说明

用于决定点云是否以二进制格式存储。（此参数主要适用于【保存点云】算子）

调参说明

  • 开启（默认）：点云数据以二进制格式存储。二进制文件通常比 ASCII 文件体积更小，读写速度也更快。推荐在对文件大小和处理效率有要求时使用。

  • 关闭：点云数据将以 ASCII 文本格式存储。ASCII 文件内容可读性强，可直接用文本编辑器查看，但文件体积较大，读写较慢。