1 pose_generation.utils

pose_generation.utils

Frame-preserving pose and directional statistics for candidate generation.

Helpers operate on EFM PoseTW values or explicitly documented LUF reference-frame vectors. Summary functions detach no state and return plain statistics suitable for diagnostics and persisted reports.

1.1 Functions

Name	Description
ensure_unbatched_pose	Squeeze a singleton batch from :class:PoseTW while preserving unbatched poses.
rejected_pose_tensor	Return rejected candidate poses as a tensor (or None if none rejected).
stats_to_markdown_table	Convert nested stats dict into a GitHub-flavoured Markdown table.
summarise_dirs_ref	Summarize azimuth/elevation of LUF directions Tensor["N 3"].
summarise_offsets_ref	Summarize radii and angles for LUF offsets Tensor["N 3"] in metres.

1.1.1 ensure_unbatched_pose

pose_generation.utils.ensure_unbatched_pose(pose)

Squeeze a singleton batch from :class:PoseTW while preserving unbatched poses.

1.1.2 rejected_pose_tensor

pose_generation.utils.rejected_pose_tensor(candidates)

Return rejected candidate poses as a tensor (or None if none rejected).

1.1.3 stats_to_markdown_table

pose_generation.utils.stats_to_markdown_table(stats, *, header=None)

Convert nested stats dict into a GitHub-flavoured Markdown table.

1.1.3.1 Parameters

Name	Type	Description	Default
stats	dict[str, dict[str, float]]	Mapping like {"radius_m": {"min": .., "max": .., ...}}.	required
header	str | None	Optional table title inserted as a preceding bold line.	None

1.1.3.2 Returns

Name	Type	Description
	str	Markdown string containing a table with columns metric \| min \| max \| mean \| std.

1.1.4 summarise_dirs_ref

pose_generation.utils.summarise_dirs_ref(dirs_ref)

Summarize azimuth/elevation of LUF directions Tensor["N 3"].

1.1.5 summarise_offsets_ref

pose_generation.utils.summarise_offsets_ref(offsets_ref)

Summarize radii and angles for LUF offsets Tensor["N 3"] in metres.