parq_blockmodel.io.ingest_utils.build_world_id_encoding_from_xyz

parq_blockmodel.io.ingest_utils.build_world_id_encoding_from_xyz#

parq_blockmodel.io.ingest_utils.build_world_id_encoding_from_xyz(x, y, z, scale=10.0, bits_per_axis=(24, 24, 16))[source]#

Build default world_id encoding metadata from xyz ranges.

Parameters:

  • x (np.ndarray) – Coordinate arrays (may contain min/max values).

  • y (np.ndarray) – Coordinate arrays (may contain min/max values).

  • z (np.ndarray) – Coordinate arrays (may contain min/max values).

  • scale (float, default 10.0) – Quantization scale factor.

  • bits_per_axis (tuple[int, int, int], default DEFAULT_AXIS_BITS) – Number of bits per axis for Morton encoding.

Returns:

Encoding metadata payload ready for geometry.world_id_encoding.

Return type:

dict[str, object]

Raises:

ValueError – If axis bit counts are invalid or exceed supported limits.