pointcloudset.io.pointcloud.xyz module

pointcloudset.io.pointcloud.xyz.read_xyz(file_path: Path | str, **kwargs) → DataFrame

Read an XYZ pointcloud file into a dataframe.

Parameters:

  • file_path – Path to the XYZ file.

  • **kwargs – Additional keyword arguments forwarded to the shared delimited reader. Supports normalize_xyz to opt in to converting X/Y/Z headers to x/y/z.

Returns:

A dataframe containing pointcloud columns.

Raises:

ValueError – If parsing fails or required coordinate columns are missing.

pointcloudset.io.pointcloud.xyz.write_xyz(pointcloud: PointCloud, file_path: Path, header: bool = False, sep: str = ' ') → None

Write a pointcloud to an XYZ file.

Parameters:

  • pointcloud – PointCloud instance to serialize.

  • file_path – Destination file path.

  • header – Whether to write a header row. Default is False for XYZ files.

  • sep – Field delimiter.