2. User Guide

The PBE app, as will be discussed in Software Architecture, is a scientific workflow application that creates workflows and runs them in the background. These workflows can involve multiple different backend applications. Once the PBE app is started, the user is presented with the user interface shown in Fig. 2.2. It is in this UI where the user selects the applications to run in a workflow, inputs the necessary parameters for each of these applications, starts the workflow either locally or remotely, and finally views the simulation results. The main window of the UI is divided into several separate areas:


Fig. 2.2 The PBE app user interface.

  1. Login Button:

The Login button is at the top right of the user interface. Before the user can launch any jobs on DesignSafe, they must first login to DesignSafe using their DesignSafe login and password. Pressing the login button will open up the login window for users to enter this information. Users can register for an account on the DesignSafe-CI website 1.

  1. Message Area:

The message area is located in the top center of the UI and displays status and error messages for a running background application.

  1. Input Panel:

The input panel is the large central area of the user-interface where the user provides input for the various applications, and also where they can view the results.

  1. Input Panel Selection Ribbon:

The ribbon on the left side provides the user with a selection of buttons to choose from (e.g. RV: Random Variables, RES: Results). Selecting any of these buttons will change what is displayed in the central input panel. Each panel will present the user with an option for which application to choose for that part of the workflow, and will then allow a user to provide inputs for that application. In the following sections, each of the panels in the input panel selection ribbon are reviewed:

  1. Push Buttons:

This is the area near the bottom of the UI in which 4 buttons are contained:

  • RUN: Run the simulation locally on the user’s desktop machine.

  • RUN at DesignSafe: Process the information, and send to DesignSafe. The simulation will be run there on a supercomputer, and results will be stored in the user’s DesignSafe jobs folder.

  • GET from DesignSafe: Obtain the list of jobs for the user from DesignSafe and select a job to download from that list.

  • Exit: Exit the application.


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.