Save File Operators

Feature Description

This is a collective term for a class of operators used to save different types of data (such as point clouds, images, EpicRaw format data) to the local file system. The specific inputs and outputs depend on the concrete save operator used within this category.

Usage Scenarios

  • Data Persistence: Saves intermediate processing results or final output data for subsequent analysis, debugging, archiving, or sharing with other systems.

  • Offline Processing: Saves real-time collected data for subsequent offline development and testing.

  • Data Backup: Creates backups for important data.

Inputs and Outputs

Input Items

Specific input items depend on the concrete "Save File" class operator being used. For example, the "Save Point Cloud" operator requires point cloud data as input.

Output Items

Usually, no data is output to downstream operators, or the path of the saved file is output.

Parameter Description

Includes four operators: "Save Point Cloud", "Save Image", "Save Image and Point Cloud", and "Save EpicRaw". The following are general file saving related parameter configurations, used to control the location, naming convention, and storage management of saved files.

Save Path

Parameter Description

Used to specify the target folder path for saving files.

Adjustment Notes

  • Specify Path: Directly enter a valid folder path, or click the icon on the right to select a folder path.

  • Do Not Specify Path: Leave it blank. The operator will, by default, create a subfolder named file_save_dir in the .transfertech atom folder as the storage path. This is convenient for temporary saving or when the specific storage location is not critical.

  • Path Check: The operator will check if the specified path is valid. If the path points to an existing file (not a folder), or if the path is invalid, the operator will report an error. If the specified path does not exist, it will attempt to create it.

Save Name

Parameter Description

Specifies the save file name; no need to include the file extension.

Adjustment Notes

It is recommended to use a descriptive name for easy retrieval and management later. Avoid using special characters. Default name: data

Save Only Single File

Parameter Description

Sets the file saving strategy, either saving as a single file or multiple files.

Adjustment Notes

  • Disabled (default): Generates multiple files, automatically adding a timestamp after the specified file name to avoid duplication. Suitable for scenarios requiring historical data or multiple run results.

  • Enabled: The operator will attempt to use the specified name as the file name to save data each time it runs. If the file already exists, the new data will overwrite the old file. Suitable for scenarios requiring a fixed file name output, e.g., for overwriting the previous result.

Maximum Storable Memory

Parameter Description

Sets the maximum total size of files allowed in the save directory. When the total size of relevant files in the folder exceeds this limit, the software will attempt to delete the oldest files of the same type in that directory to free up space.

Adjustment Notes

Please set this value based on available disk space and data retention needs:

  • Smaller value: Will delete old files more frequently, saving disk space, but may lead to faster loss of historical data.

  • Larger value: Allows more historical data to be saved but will consume more disk space.

Parameter Range

[0.00001, 10], Default: 10, Unit: GB

Binary Storage

Parameter Description

Used to determine whether point clouds are stored in binary format. (This parameter mainly applies to the "Save Point Cloud" operator)

Adjustment Notes

  • Enabled (default): Point cloud data is stored in binary format. Binary files are typically smaller in size and faster to read/write than ASCII files. Recommended when file size and processing efficiency are important.

  • Disabled: Point cloud data will be stored in ASCII text format. ASCII files are human-readable and can be viewed directly with a text editor, but they are larger in size and slower to read/write.