pyvale.render.verifyinput module

Cheap, non rendering validation helpers.

mesh_convention_issues(coords, connectivity, path)[source]

Return shared convention issues for a render surface mesh.

Two dimensional coordinates are padded onto the XY plane before invoking the common DataIO checker. This keeps planar renderers aligned with the same counter clockwise, right handed convention as 3D renderers.

Parameters:

  • coords (np.ndarray) – Nodal coordinates array with shape (num_nodes, 2) or (num_nodes, 3) and dtype float64.

  • connectivity (np.ndarray) – Element connectivity table with shape (num_elements, nodes_per_element) and integer dtype.

  • path (str) – Dotted path identifier for error reporting.

Returns:

tuple[ValidationIssue, ] – Tuple of validation issues detected, or an empty tuple if valid.

raise_if_issues(issues)[source]

Raise an aggregated error when validation detected issues.

Parameters:

issues (tuple[ValidationIssue, ]) – Issues returned by a verification routine.

Raises:

RenderInputError – If issues is not empty.

verify_scene_3d(meshes, cameras, lights)[source]

Check common three dimensional scene constraints cheaply.

Parameters:

  • meshes (Sequence[Mesh3D]) – Surface meshes in the requested scene.

  • cameras (Sequence[Camera]) – Cameras in the requested scene.

  • lights (Sequence[Light] or None) – Explicit scene lights, if any.

Returns:

tuple[ValidationIssue, ] – Every detected issue. An empty tuple denotes a valid common scene.

Notes

This routine performs no scene construction, image allocation, or backend calculation. Backends must add their own capability checks.