graphlow.TensorMesh.scatter_add_to_parent_point_data

TensorMesh.scatter_add_to_parent_point_data(src_point_data: T, dst_point_data: T | None = None) → T

Scatter this mesh’s point data to the parent point space and add to it. This method works only for extracted surface meshes.

Parameters:

src_point_dataT

Backend tensor of shape (n_points_of_this_mesh, ...).

dst_point_dataT | None, optional

Optional destination tensor of shape (n_points_of_parent, ...). If omitted, a zero-initialized tensor is created.

Returns:

T

Backend tensor of shape (n_points_of_parent, ...).

Raises:

ValueError

If src_point_data.shape[0] does not match this mesh’s n_points. If dst_point_data.shape does not match the parent point-space shape.