MHCXGraph.app.run_screening_mode

MHCXGraph.app.run_screening_mode(ref_graph, target_graphs, base_output, run_name, config, log)[source]

Execute the association workflow in screening mode (1-vs-All).

This mode compares a single reference graph against a collection of target graphs. Each target is processed individually against the reference, and the results are aggregated into a single interactive dashboard. To leverage existing frontend logic, the dashboard payload mimics the “pairwise” mode structure but includes an actual_mode flag to trigger specific UI text replacements during HTML generation.

Parameters:

  • ref_graph (tuple) – A tuple containing the reference graph data produced by the preprocessing stage. Typically structured as (networkx.Graph, file_path, base_name).

  • target_graphs (list of tuple) – A list of graph tuples to be compared against the reference graph.

  • base_output (pathlib.Path) – The root directory where the screening results and the final HTML dashboard will be saved.

  • run_name (str) – A unique base identifier for the current execution run.

  • config (dict[str, Any]) – The association configuration dictionary controlling the graph association algorithm’s parameters and thresholds.

  • log (logging.Logger) – Logger instance used to record runtime progress, warnings, and errors.

Return type:

None