suboptimumg.log_analysis.yaw_segmentation_models

class suboptimumg.log_analysis.yaw_segmentation_models.MaskReport

Bases: BaseModel

Summary of how auto_segment reduced one manual window.

Fields

Field	Type	Required	Default
manual_window	tuple[float, float]	Yes
n_high_slip_pts	int	Yes
n_input_pts	int	Yes
n_kept_pts	int	Yes
n_low_speed_pts	int	Yes
rejected_short	list[tuple[float, float]]	Yes
sub_windows	list[tuple[float, float]]	Yes

Parameters:

• manual_window (tuple[float, float])

• n_input_pts (int)

• n_kept_pts (int)

• n_low_speed_pts (int)

• n_high_slip_pts (int)

• sub_windows (list[tuple[float, float]])

• rejected_short (list[tuple[float, float]])

manual_window: tuple[float, float]

n_high_slip_pts: int

n_input_pts: int

n_kept_pts: int

n_low_speed_pts: int

rejected_short: list[tuple[float, float]]

sub_windows: list[tuple[float, float]]

class suboptimumg.log_analysis.yaw_segmentation_models.StationarityCell

Bases: BaseModel

One (window length, tolerance) cell of the stationarity scan.

Fields

Field	Type	Required	Default
fraction_passing	float	Yes
n_passing	int	Yes
n_windows	int	Yes
tol_pct	float	Yes
window_s	float	Yes

Parameters:

• window_s (float)

• tol_pct (float)

• n_windows (int)

• n_passing (int)

• fraction_passing (float)

fraction_passing: float

n_passing: int

n_windows: int

tol_pct: float

window_s: float

class suboptimumg.log_analysis.yaw_segmentation_models.StationarityReport

Bases: BaseModel

Grid of StationarityCell from scan_speed_stationarity.

fraction_passing near zero at every long window means the car never holds a steady speed, so a nonparametric Welch FRF is not viable and the parametric LPV output-error fit is the right path.

Fields

Field	Type	Required	Default
cells	list[StationarityCell]	Yes
overlap	float	Yes
speed_col	str	Yes

Parameters:

• speed_col (str)

• overlap (float)

• cells (list[StationarityCell])

cells: list[StationarityCell]

fraction_grid(win_lengths_s, tol_pcts)

(len(win_lengths_s), len(tol_pcts)) array of fraction_passing.

Parameters:

• win_lengths_s (tuple[float, ...])

• tol_pcts (tuple[float, ...])

Return type:

NDArray[float64]

overlap: float

speed_col: str

class suboptimumg.log_analysis.yaw_segmentation_models.SubwindowSummary

Bases: BaseModel

Per-sub-window quality metrics, used to triage windows before fitting.

Fields

Field	Type	Required	Default
ax_rms	float	No	nan
duration_s	float	Yes
fs_hz	float	Yes
input_pp	float	No	nan
n_pts	int	Yes
slip_rms	float	No	nan
speed_mean	float	No	nan
speed_pp_pct	float	No	nan
sub_index	int	Yes

Parameters:

• sub_index (int)

• n_pts (int)

• duration_s (float)

• fs_hz (float)

• speed_mean (float)

• speed_pp_pct (float)

• ax_rms (float)

• input_pp (float)

• slip_rms (float)

ax_rms: float

duration_s: float

fs_hz: float

input_pp: float

n_pts: int

slip_rms: float

speed_mean: float

speed_pp_pct: float

sub_index: int