🔶Save File Operators

Function Description

This is a generic 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. Specific input/output depends on the specific save operator under this category.

Usage Scenarios

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

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

  • Data Backup: Create backups for important data.

Input Output

Input

Specific input items depend on the specific "Save File" operator used, for example, the [Save Point Cloud] operator requires point cloud data as input.

Output

Usually no data output to downstream operators, or outputs the path of saved files.

Parameter Description

Includes [Save Point Cloud], [Save Image], [Save Image and Point Cloud], [Save EpicRaw] operators. The following are common file saving related parameter configurations used to control file saving location, naming method, and storage management.

Save Path

Parameter Description

Used to specify the target folder path for file saving.

Parameter Adjustment

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

  • No Path Specified: Leave the path empty, and the operator will default to creating a file_save_dir subfolder in the .transfertech atom folder as the storage path. This is convenient for temporary saving or when you don’t care about the specific storage location.

Path Check: The operator will check whether the specified path is valid. If the path points to an existing file (rather than a folder) or the path is invalid, the operator will report an error. If the specified path doesn’t exist, it will attempt to create it.

Save Name

Parameter Description

Specify the save file name, no need to include file extension.

Parameter Adjustment

It’s recommended to use descriptive names for easy subsequent retrieval and management, avoiding special characters.

Default Name: data

Save Single File Only

Parameter Description

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

Parameter Adjustment

  • Disable (Default): Generate multiple files, automatically add timestamps after the specified filename to avoid duplicate names, suitable for scenarios that need to record historical data or multiple run results.

  • Enable: The operator will attempt to use the specified name as the filename to save data each time it runs. If the file already exists, new data will overwrite the old file. Suitable for scenarios that need fixed filename output, such as overwriting previous results.

Maximum Storage Memory

Parameter Description

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

Parameter Adjustment

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

  • Smaller Value: Will delete old files more frequently, saving disk space, but may cause historical data to be lost more quickly.

  • Larger Value: Allows saving more historical data, but will occupy more disk space.

Parameter Range

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

Binary Storage

Parameter Description

Used to decide whether point clouds are stored in binary format. (This parameter mainly applies to [Save Point Cloud] operator)

Parameter Adjustment

  • Enable (Default): Point cloud data is stored in binary format. Binary files are usually smaller than ASCII files and have faster read/write speeds. Recommended when file size and processing efficiency are important.

  • Disable: Point cloud data will be stored in ASCII text format. ASCII files have strong readability and can be viewed directly with text editors, but have larger file sizes and slower read/write speeds.