create_point_cloud_spatial#

nominal.experimental.spatial.create_point_cloud_spatial(client, name, *, metadata, description=None, labels=(), properties=None, markings=None)#

Create an empty spatial, ready to have a point cloud added to it.

The spatial reserves the model that will hold its data; add the data with Spatial.add_point_cloud_csv. The time range it covers is not set here: add_point_cloud_csv measures it from the point cloud’s own time column.

Parameters:
  • client (NominalClient)

    Client to create the spatial with.

  • name (str)

    Human-readable name for the spatial.

  • metadata (PointCloudMetadata)

    Point-cloud metadata, e.g. PointCloudMetadata(sensor_model=...).

  • description (str | None)

    Optional description.

  • labels (Sequence[str])

    Labels to apply.

  • properties (Mapping[str, str] | None)

    Key-value properties to apply.

  • markings (Sequence[Marking | str] | None)

    If present, markings (or marking RIDs) applied to the spatial. Sent as part of the creation request rather than applied in a follow-up call. Without any, the spatial is visible to everyone in the workspace.

Returns:

The created spatial.

Raises:

NominalError – Error resolving the workspace or creating the spatial via gRPC.

Return type:

Spatial