tud_lbm.io.plotting.simulation_csv

Per-timestep droplet-metric CSV export.

Classes

RZero	Resolved R₀ plus whether the nominal-radius fallback was used.
SimulationCsvExport	Export per-timestep droplet metrics to simulation_data.csv.

Functions

build_simulation_csv(→ pathlib.Path | None)

Compute per-timestep metrics and write simulation_data.csv.

Module Contents

class tud_lbm.io.plotting.simulation_csv.RZero

Bases: NamedTuple

Resolved R₀ plus whether the nominal-radius fallback was used.

value: float

used_fallback: bool

tud_lbm.io.plotting.simulation_csv.build_simulation_csv(run_dir: str | pathlib.Path, config: tud_lbm.config.SimulationConfig) → pathlib.Path | None

Compute per-timestep metrics and write simulation_data.csv.

Skips silently (returns None) when config.sim_type is not a supported wetting variant. Saves the CSV directly to run_dir.

Parameters:

• run_dir – Run directory (contains data/timestep_*.npz).

• config – SimulationConfig.

Returns:

Path to the written CSV, or None when skipped.

class tud_lbm.io.plotting.simulation_csv.SimulationCsvExport(config: tud_lbm.config.SimulationConfig | None = None)

Bases: tud_lbm.io.plotting.base.AnalysisPlot

Export per-timestep droplet metrics to simulation_data.csv.

name = 'simulation_csv'

required_keys = ('rho', 'u')

export_only = True

compute(files: list[pathlib.Path]) → dict[str, numpy.ndarray]

Return an empty payload because this operator is export-only.

render(ax: matplotlib.axes.Axes, precomputed: dict[str, numpy.ndarray]) → None

Render a placeholder panel when this operator is selected for plotting.

export(run_dir: pathlib.Path) → pathlib.Path | None

Write simulation_data.csv for the configured run directory.