Cross-sectional Workflow

High-level workflow orchestration for cross-sectional diagnostic runs.

fuzzy_find_batch_column(headers)

Return the zero-based index of a batch-like header, or None.

validate_subject_ids(data_df, cov_df, data_id_col, cov_id_col)

Ensure subject IDs overlap and return aligned tables plus warnings.

Typical usage

Invoke from the CLI or call programmatically to run the standard diagnostic sequence producing plots and a report.

Input handling

• Subject ID alignment is enforced before diagnostics.
• Batch can be auto-detected, explicitly selected, or intentionally omitted.
• Covariate selection may be empty. In that case the workflow continues and passes covariates=None to the report layer.
• When covariates are empty, the report warns that LMM diagnostics are skipped while all non-LMM diagnostics still run.