causalexplain.gui package

Subpackages

• causalexplain.gui.tabs package
  • Submodules
    • GenerateTab
      • GenerateTab.__init__()
      • GenerateTab.build()
      • GenerateTab.run_generate()
      • GenerateTab.run_save_generated()
    • LoadTab
      • LoadTab.__init__()
      • LoadTab.build()
      • LoadTab.run_load()
    • TrainTab
      • TrainTab.__init__()
      • TrainTab.build()
      • TrainTab.run_training()
      • TrainTab.start_training_task()
      • TrainTab.cancel_training_task()
      • TrainTab.save_trained_model()
      • TrainTab.save_trained_dag()
  • Module contents
    • TrainTab
      • TrainTab.__init__()
      • TrainTab.build()
      • TrainTab.run_training()
      • TrainTab.start_training_task()
      • TrainTab.cancel_training_task()
      • TrainTab.save_trained_model()
      • TrainTab.save_trained_dag()
    • LoadTab
      • LoadTab.__init__()
      • LoadTab.build()
      • LoadTab.run_load()
    • GenerateTab
      • GenerateTab.__init__()
      • GenerateTab.build()
      • GenerateTab.run_generate()
      • GenerateTab.run_save_generated()

Submodules

NiceGUI app for local causalexplain workflows.

run_gui(host='127.0.0.1', port=8080)

Start the NiceGUI application.

Cytoscape helpers for NiceGUI graph rendering.

ensure_cytoscape_assets()

Expose Cytoscape asset registration for GUI apps.

Graph helper utilities for the GUI.

clean_node_name(name)

Normalize a node name by stripping whitespace and quotes.

normalize_graph(graph)

Return a cleaned directed graph with normalized node names.

dag_is_valid(graph, min_edges, max_edges)

Check that the graph is a DAG within the edge constraints.

graph_from_dot(path)

Load a DOT file into a normalized directed graph.

File and path utilities for the GUI.

ensure_file(path, suffixes)

Ensure the file exists and matches the expected suffixes.

ensure_output_dir(path)

Create the output directory for the given file path when needed.

normalize_output_value(raw_value, required_ext)

Normalize an output path by enforcing the required extension.

sanitize_output_name(name)

Strip extensions and whitespace from a dataset base name.

Rendering helpers for graphs and metrics in the GUI.

update_metrics_log(log_el, metrics)

Render metrics into a NiceGUI log element.

overlay_status_message(classes)

Return the overlay status message based on edge classes.

render_cytoscape_overlay(container, status_label, discoverer, ref_graph, *, persist_positions, height='420px')

Render an interactive overlay chart for predicted vs. reference DAGs.

render_cytoscape_graph(container, graph, *, height='420px')

Render a DAG in a NiceGUI container using Cytoscape.

Default settings and persistence helpers for the GUI.

default_train_settings()

Return default training settings for the GUI.

default_load_settings()

Return default load/evaluation settings for the GUI.

default_generate_settings()

Return default dataset generation settings for the GUI.

merge_settings(stored, defaults)

Merge persisted settings into the provided defaults.

Style helpers for the causalexplain GUI.

app_styles_path()

Return the absolute path to the GUI CSS file.

read_app_styles()

Read the GUI CSS content from disk.

register_app_styles()

Inject the GUI CSS into the NiceGUI head.

UI helper utilities for NiceGUI widgets.

update_settings(storage, settings_key, target, key, value)

Update a settings dict and persist it to NiceGUI storage.

bind_setting(element, storage, settings_key, settings_ref, field)

Bind UI change events to a settings dictionary.

set_input_value(input_el, value)

Update a NiceGUI input value and refresh the widget.

async save_upload(file_upload, upload_dir, suffix=None)

Persist an uploaded file to the GUI upload folder.

make_upload_handler(input_el, storage, settings_key, settings_ref, field, upload_dir, suffix=None, status_label=None)

Create an async upload handler that updates UI state.

normalize_output_path(input_el, storage, settings_key, settings_ref, field, required_ext)

Normalize a UI output path and persist the setting.

Module contents

GUI entry points for causalexplain.

run_gui(*args, **kwargs)

Lazy import to avoid circular dependencies when loading GUI helpers.