tud_lbm.io.plotting.run_comparison

Cross-run comparison plots and batch CSV-export CLI entry point.

Functions

compare_runs(→ None)

Generate comparison scatter plots across all processed runs.

process_parent_dir(→ tuple[int, int])

Discover runs, export per-run CSVs, and generate comparison plots.

main(→ None)

Script entry point for batch CSV export and run comparison plots.

Module Contents

tud_lbm.io.plotting.run_comparison.compare_runs(parent_dir: str | pathlib.Path) None[source]

Generate comparison scatter plots across all processed runs.

Reads simulation_data.csv files produced by build_simulation_csv() from every run directory under parent_dir and writes plots to <parent_dir>/comparison_analysis/.

Parameters:

parent_dir – Parent directory that contains the individual run directories.

tud_lbm.io.plotting.run_comparison.process_parent_dir(parent_dir: str | pathlib.Path, fields: list[str] | None = None) tuple[int, int][source]

Discover runs, export per-run CSVs, and generate comparison plots.

Discovers runs by searching for config.toml files recursively. Skips directories whose path contains "init" or "comparison_analysis". Writes simulation_data.csv per run, then generates 8 comparison plots when at least one run produced CSV data.

Parameters:
  • parent_dir – Absolute or relative path to the parent directory.

  • fields – Comparison operator names to run as per-run analysis plots. When None, no per-run analysis plots are generated beyond the CSV.

Returns:

A tuple (n_runs_found, n_runs_with_csv).

tud_lbm.io.plotting.run_comparison.main(parent_dir: str | None = None) None[source]

Script entry point for batch CSV export and run comparison plots.