navigate.model.features.autofocus.autofocus_bounds_error

navigate.model.features.autofocus.autofocus_bounds_error(scan_name, positions, minimum, maximum, device_ref)

Describe an autofocus trajectory that exceeds enabled stage limits.

Parameters:

• scan_name (str) – User-facing scan name, such as "coarse" or "fine".

• positions (Sequence[float]) – Exact ordered stage targets.

• minimum (float) – Configured lower stage limit.

• maximum (float) – Configured upper stage limit.

• device_ref (str) – Selected stage-axis reference.

Returns:

An actionable diagnostic, or None when every position is allowed.

Return type:

str or None