# clusters

Python API: `depthai_nodes.message.creators.clusters`

## Functions

### create_cluster_message

```python
def create_cluster_message(clusters: list[list[list[float | int]]]) -> dai.beta.Clusters:
```

Create a native cluster message from grouped 2D points.

Parameters

 * `clusters` (`list[list[list[float | int]]]`): List of clusters, each a list of XY points. Points may be lists or tuples
   containing two numeric coordinates. Coordinates are copied without scaling; empty clusters are retained.

Returns

 * `dai.beta.Clusters`: A message with one cluster per input list, labeled by its zero-based list index.

Raises

 * `TypeError`: If clusters or their point containers have unsupported types, or a coordinate is not an int or float.
 * `ValueError`: If a point does not contain exactly two coordinates.