Dashboard: restructure/refactor toolbar code (BLAST-ImpactX#981)

* add: functionality to parse variables from input file

Only allowing int,float values at the moment. So no lists, or math expressions

* update: update delete available after loading variables

otherwise the delete button stays disabled to the user

* add: variable to reset button

Not implemented in a very robust way right now

* fix: prevent crash

For example, say lattice element #1 references a variable called 'ns'. If the lattice list is reset or elements are deleted, the variable update handler would still try to access index 1, causing an IndexError. This patch adds a guard to skip updates if the referenced lattice element index is no longer valid.

* update: parser to only load in variables which are used in the lattice configuration

* empty the variables list before loading in variables

* update: allow negative inputs with variables

* add float wrapper

* update: on_variable_change

modify docstring and set variable value to None if empty

* simplify 'process_if_variable'

* variable renames and move code block

* shorted helper function name

* add docstring to state.change('variables')

* correctly update lattice elements on variable change after element deletion

Prevents cases similar to the following: Say you add three lattice elements, the first two reference a variable named ns, the third one references a variable named ns2 in the same parameter name. If we end up deleting the second lattice element, and update the value of the ns variable, the ns2 originally from index 2 becomes ns

* add parse_variables docstring

and update var name

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* fix docstring

* move input toolbar to separate file

also need to move toolbarimport class to remove circular dependency

* move parser to separate folder

new folder name is 'dashboard_parser'

importParser renamed to parser.py
importParserHelper renamed to parser_helper.py

* move logic to ui_populator.py

* rename

* move RunToolbar to separate file

* move AnalyzeToolbar to separate file

* introduce general_toolbar.py

contain toolbar components utilized in all the routes

* strip '_toolbar' from file name

fix resulting circular import

* simplify ui_populator

break into sub functions

* update class docstring

* update docstrings

* break out populate_variables logic

* add inline comments

* relocate some code

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: proy30

src/python/impactx/dashboard/Input/distribution/ui.py

@@ -80,9 +80,6 @@ def populate_distribution_parameters():
 
 @state.change("distribution")
 def on_distribution_name_change(distribution, **kwargs):
-    if state.importing_file:
-        return
-
     if distribution == "Thermal" or distribution == "Empty":
         state.distribution_type = ""
         state.distribution_type_disable = True
@@ -99,8 +96,6 @@ def on_distribution_name_change(distribution, **kwargs):
 
 @state.change("distribution_type")
 def on_distribution_type_change(**kwargs):
-    if state.importing_file:
-        return
     populate_distribution_parameters()
 
 

src/python/impactx/dashboard/Input/generalFunctions.py

@@ -9,6 +9,7 @@
 from typing import Union
 
 from .. import setup_server
+from ..Toolbar.file_imports.python.parser import DashboardParser
 from .defaults import DashboardDefaults
 
 server, state, ctrl = setup_server()
@@ -101,6 +102,7 @@ def reset_inputs(input_section):
                 state.dirty("max_level")
 
         elif input_section == "all":
+            DashboardParser.reset_importing_states()
             state.update(DashboardDefaults.DEFAULT_VALUES)
             state.dirty("distribution_type")
             state.selected_lattice_list = []

src/python/impactx/dashboard/Run/utils.py

@@ -6,7 +6,7 @@
 import time
 
 from .. import setup_server
-from ..Toolbar.sim_history.ui import SimulationHistory
+from ..Toolbar.sim_history import save_view_details_log
 
 server, state, ctrl = setup_server()
 
@@ -50,7 +50,7 @@ def complete_simulation():
         state.sim_is_generating_plots = False
         state.dirty("filtered_sims")
         state.flush()
-        SimulationHistory.save_view_details_log()
+        save_view_details_log()
 
     @staticmethod
     def cancel_simulation(proc: asyncio.subprocess.Process):
@@ -68,7 +68,7 @@ def cancel_simulation(proc: asyncio.subprocess.Process):
         state.dirty("filtered_sims")
         ctrl.terminal_print("Simulation cancelled.")
         state.flush()
-        SimulationHistory.save_view_details_log()
+        save_view_details_log()
 
     @staticmethod
     def fail_simulation() -> None:
@@ -82,7 +82,7 @@ def fail_simulation() -> None:
         state.dirty("filtered_sims")
         state.flush()
         ctrl.terminal_print("Simulation failed due to the above error.")
-        SimulationHistory.save_view_details_log()
+        save_view_details_log()
 
     @staticmethod
     def reset():

src/python/impactx/dashboard/Toolbar/__init__.py

@@ -0,0 +1,4 @@
+from ..Input.components.card import CardComponents
+from ..Input.generalFunctions import generalFunctions
+
+__all__ = ["CardComponents", "generalFunctions"]

src/python/impactx/dashboard/Toolbar/analyze.py

@@ -0,0 +1,35 @@
+"""
+This file is part of ImpactX
+
+Copyright 2025 ImpactX contributors
+Authors: Parthib Roy, Axel Huebl
+License: BSD-3-Clause-LBNL
+"""
+
+from .. import setup_server, vuetify
+
+server, state, ctrl = setup_server()
+
+
+class AnalyzeToolbar:
+    """
+    Contains toolbar components for the 'Analyze' page.
+    """
+
+    @staticmethod
+    def plot_options() -> vuetify.VSelect:
+        """
+        Displays a dropdown menu to select the available plots
+        generated from the simulation data.
+        """
+
+        return vuetify.VSelect(
+            v_model=("active_plot", "1D plots over s"),
+            items=("plot_options",),
+            label="Select plot to view",
+            hide_details=True,
+            density="compact",
+            variant="underlined",
+            style="max-width: 250px",
+            disabled=("disableRunSimulationButton", True),
+        )