2. User Interface

The HydroUQ app is a scientific workflow application that creates workflows and runs them in the background. These workflows can integrate multiple applications, detailed further in the backend and workflows section (Software Architecture). Upon launching HydroUQ app, the user is presented with the user interface (UI) shown in Fig. 2.6, which facilitates the selection of workflow applications, configuration of application parameters, initiation of workflows either locally or remotely, and visualization of simulation outcomes.

../../../../_images/HydroUQ_MPM_3DViewPort_OSULWF_2024.04.253.gif

Fig. 2.5 The HydroUQ app new graphical user interface.

../../../../_images/HydroPanel.png

Fig. 2.6 The HydroUQ app basic user interface.

The main window of the UI comprises the following key components:

  1. Login Button

    The Login button, at the top right of the user interface, is used to log in to DesignSafe. You can launch jobs on DesignSafe after logging in. You don’t need to log in to DesignSafe to run the analyses on your local computer. You can register for an account on the DesignSafe-CI website 1.
  2. Message Area

    The message area is located at the bottom of the UI and displays the status and error messages for a running background application. The message area is a dockable dialog that can be resized, moved, and closed as needed. The dialog visibility can be toggled by clicking on the menu item View -> Program Output. If moved from its default location, the status dialog can be restored to the bottom of the UI by dragging the dialog back to the bottom of the UI and hovering over the area.
  3. Input Panel

    The input panel is the large central area of the user interface where the user provides input for the workflow applications. You can select a workflow application using the drop-down menu at the top of each input panel. Each panel collects input parameters and paths to files with input data for the selected workflow application. The RES (results) panel is different; it shows the results after a simulation is completed.
  4. Input Panel Selection Ribbon

    The ribbon on the left side provides buttons that represent each step of the simulation workflow (e.g., EVT: Event Description, SIM: Structural Model, RES: Results). Clicking on one of these buttons shows the corresponding workflow applications in the central input panel.

    The following sections of the user guide describe in detail each of the steps presented in the input panel selection ribbon and the corresponding workflow applications available in the tool:

  5. Push Buttons

    This is the area near the bottom of the UI with the following four buttons:
    • RUN: Run the simulation locally on your computer.

    • RUN at DesignSafe: Process the input information and send the data to DesignSafe. The simulation will be run there on a supercomputer and the results will be stored in your DesignSafe jobs folder.

    • GET from DesignSafe: Obtain the list of jobs you ran on DesignSafe. You can select a job to download its results to your computer.

    • Exit: Close the application.

    Running Jobs Remotely

    Clicking on the RUN at DesignSafe button will show the remote job submission dialog shown below (Fig. 2.8)

    ../../../../_images/RemoteJobPanel_sWHALE.png

    Fig. 2.8 Remote job submission dialog.

1

For more help on external services provided by DesignSafe-CI, such as creating an account, we encourage users to explore their documentation or consider submitting a ticket.