Workflow

Startup

magboltz_gui.main is the application entry point. It prepares platform theme hints on Linux, creates the QApplication, sets the desktop identity and icon, and finally instantiates the main window.

Editing inputs

The main window works around an InputCards object that mirrors the subset of Magboltz cards exposed by the GUI. The gas table combines:

  • a numeric gas identifier

  • a user-facing gas name from the bundled CSV catalogue

  • a fraction that is normalised on save

Running Magboltz

ProcessManager is responsible for starting magboltz, feeding the input file to stdin, and streaming stdout/stderr back into the console pane. When the process finishes, the buffered stdout is handed to parse_magboltz_output.

Parsing and export

The parser builds a RunResult object containing:

  • run metadata and original input

  • conditions and control flags

  • mixture composition

  • drift, diffusion, and collision-frequency summaries

  • tabular sections such as convergence rows and energy distributions

  • raw stdout plus parser warnings

The export dialog then selects one view of that structure and dispatches to the CSV, JSON, or XML export functions.

Plotting

The plot window uses the parsed RunResult rather than reparsing text or calling Magboltz again. This keeps plotting and export consistent with the same parsed representation of the run.