Scenario page displays the scenarios under the current Solution. There are two tabs in this page – Scenarios and Files. Files tab allows the user to download files created as a result of running Scenarios on the cloud. All other functionalities such as creation of a scenario, running a scenario, comparing selected scenarios etc. are offered under the Scenarios tab. We shall also refer to this tab as Scenario List.
Users are directed to Scenarios page when they click on a Solution from the Recent Solution dashboard or from the Active Solution list.
The users see a blank Scenarios page when a Solution has just been created but no scenario has been added.
For existing Solutions which already have one or more Scenarios added, the dashboard shows the list of Scenarios with checkbox for selection. By clicking on any of them, user can view the detail Result page for that Scenario.
Scenario tab functionalities:
Following functionalities are offered in Scenarios tab. These functionalities are described in details in subsequent sections as noted.
Pin Solution : The current Solution can be pinned from this page by clicking on the Click to Pin icon. Note that this icon is not used to pin a Scenario and hence there is no effect of pinning on Scenario list.
Create New Scenario: Allows user to create new Scenario(s).
View Summary Result: Displays selected single –value Performance Indicators for all scenarios that have been completed in this solution.
Compare scenarios: Compare relative performances of two or more scenarios using Performance Indicators selected while creating this Solution.
Run: Execute (or run) selected Scenarios.
Stop execution: Stop execution of a running scenario.
Delete Scenario: Delete a scenario.
Search: Search scenarios by entering partial Scenario names
Using Column headers: Sort, filter and show/hide columns of the Scenario List.
The Scenario List:
Scenario List shows scenarios in the current Solution along with some basic information and the status of each Scenario. Status is refreshed every few seconds and a counter shows the seconds remaining for the next refresh. The Status message can be one of the following:
Pending – Scenario was not executed
Queued – Scenario execution was requested but it has not been taken up. Typically a Scenario will be stuck in this stage if a new cluster is being provisioned or the current cluster is overloaded.
Processing – Scenario is currently running
Successful – Scenario has been successfully executed
Failed – Scenario run has failed.
Cancelled – Scenario has been cancelled at user’s request
Cancelling – A Stop scenario request has been sent but the scenario has not been cancelled yet.
User can select to Run or Execute Scenarios by clicking on the “Run” scenario icon. If no Scenario is selected, or the Scenario is Queued or Processing, error messages are displayed.
User needs to select a Cluster to run the Scenario. The choices are the same as explained under Create New Scenarios section.
Users can stop a running or queued Scenario by clicking on the Stop icon . If any other type of scenario is selected and Stop icon is pressed, an error message will appear: Can not stop a scenario which is not in progress.
Existing Scenarios can be permanently deleted by selecting the Scenarios and clicking on the Delete icon . Only one Scenario may be deleted at a time. If more than one Scenario is selected for deletion, the following error is shown: Please select only one Scenario
If not Scenario is selected, an error message is displayed as well.
User must confirm that this Scenario needs to be deleted, as there is no way to retrieve the Scenario after it is deleted. A Warning message is shown.
The user may Cancel the deletion at this point or click Continue to delete the selected Scenario.
Scenarios may be searched by partial name (Contains) as shown:
Use Column headers to Sort, Filter and Hide/Unhide:
In any data table in Scenario Services Web UI, context menu in the column headers may be used to sort, filter, or show/hide columns. While Sort Ascending, Sort Descending and Filter options work on the specific column. Columns menu can be used to show or hide columns in the current table.
User can click on the button to create a new scenario under the selected Solution.
User must specify a Scenario Name that is unique for this Solution. For each Scenario, user must upload necessary files to cloud storage and provide other (textual) inputs. The Solution Template determines which type of files or inputs are needed to run this specific type of problem. Note that files can also be selected from existing storage on the cloud.
If the user enters a Scenario name that already exists for this Solution, an error is generated.
Error messages are also generated if the user enters a value more than the allowable limit of Scenario Name or Scenario Description.
The Upload section is used for uploading files from user’s local machine to cloud storage or for selecting files already existing on cloud storage. Note that in either case, a separate copy of the file is created for this specific scenario.
While uploading files from the local machine, a progress bar is displayed until the file uploading is complete. After successful upload, the file name shows up in the Browse for files area.
User must specify or upload the mandatory files needed to run a Scenario. Otherwise, an error appears showing that the Scenario cannot be created.
Before creating the scenario, the user can choose to delete the uploaded file by clicking on the delete icon on the right side of the uploaded file name. The icon shows up when the user hovers over the file name edit box. After confirming for file deletion, user should select another file to be used for this Scenario.
User may run the scenario immediately on submission by clicking on Run Scenario on Submission check box.
User must select the type of cluster to run this Scenario. Default Clusters are readily available, small sized clusters but these are shared by every user of Scenario Services. Small, Medium and Large clusters are dedicated for this specific job – but these take time to be provisioned. If the user does not select a cluster to run the Scenario immediately, it will show up with a Pending status in the Scenario List.
After successful creation of a new Scenario, it will show up on the Scenario List.
Users may edit Scenario name or file(s). In the Scenario List page, select the Scenario to be edited and click on Edit Scenario icon from top.
Editing a Scenario causes all the files produced by the previous scenario to be deleted. Effectively, the old scenario gets deleted and new one is created. No result from the precious scenario is retained.
User may decide to run the edited Scenario as soon as it is created, or run it later from the Scenario list page.
View Summary Result:
Summary Result page display the overall performance of the Scenarios in a Solution using a set of “single-value” Performance Indicators. Single-value Performance Indicators are those, which have only one value per Scenario, and can be treated as representative of overall performance of the Scenario. For example, the Overall Utilization Index, the Maximum Deflection, or Total Member Weight, Max Deflection, Max Base Reaction force and Moment - are all single-value Indicators for a Structural Scenario. Indicators shown in the Summary result page are dependent on the Solution Template.
Users can view the summary result page by clicking on the View summary result button .
Note that selection of specific Scenarios in the Scenario List has no bearing on the Summary Result output. Also, only the Completed Scenarios are included in the Summary Result. If some Scenarios are in in Pending or Queued or Processing states, these will not be included in the Summary Result.
User may click on legends to turn on/off specific charts.
Users may click on the context menu icon on the graph to download the graph as an image. Clicking on Export to Excel allows users to download the tabular data in Excel. These are explained in details in View Detail Scenario Data section.
Compare Scenarios :
Performance of Scenarios can be compared using Performance Indicators. Users may select multiple Scenarios and click on Compare Scenarios icon . Note that at least two Scenarios must be selected for comparison, otherwise an error message appears as shown below:
Comparison page shows single-value indicators by default.
User may change the selected Scenarios or the Indicators being displayed by clicking on the
Note that different Performance Indicators are displayed in different ways as shown below. The style and type of outputs for displaying the Performance Indicators are determined by the Subject Matter Experts.
Clicking on Detail Data link for a Scenario for an Indicator shows Indicator data for this specific Scenario in a pop-up window. Clicking on the Detail Data – All Scenarios link for an Indicator shows comparison data for all Scenarios for that indicator both in graphical and tabular format. These are explained in details in the next sub-section.
Some charts have an option of selecting chart types. Once the chart type is set, both individual Scenarios and All Scenario views show the selected type of chart,
View Detail Scenario Comparison Data:
Clicking on Detail Data for a specific Scenario and a specific indicator shows the chart and tabular data for that Scenario and indicator. An example is shown below:
Clicking on Legends (DispZ, DispZ etc) will hide/show the specific indicators. The display will auto-scale.
Clicking on Zoom-in and Zoom-out icons enlarge or contract the Detail windows. This is because these windows cannot be stretched using conventional window handles. The maximum zoom level will be 90% of the current browser window size.
The context menu on the top right can be used to print the graph or to download the graphs as different image formats, or as pdf.
Clicking on Export to Excel button on the tabular data allows the user to download the data as Excel file.
Note that all detail result screens have the same functionalities. Only the data and type of graph/chart will vary.
Clicking on the Detail Data – All Scenarios link from the Indicator column displays similar graph but with all selected Scenarios.
Files tab shows all files uploaded by the users for various scenarios as well as the output files created by the application. Note that only the output files selected by the user while creating the Solution will be available. File sizes are shown in Bytes / KB / MB / GB depending on how large the file is.
Users can select and download different files uploaded for any scenario of a solution from “Files” tab and clicking on the Download files icon. Files are always downloaded as Zip (even if only one file is selected).
Files can be sorted / filtered using the context menu located on the column header. Click on down arrow key to access the context menu.
Multiple Files can be selected for download from this tab. Returns error message if no Files are checked.
The downloaded files are arranged in folders and files inside the zip archive. Each Scenario constitutes a folder and the files belonging to a scenario appears under that folder.
Individual Scenario Details:
Users may click on a Scenario in the Scenario List page to view all indicators produced for that scenario in one page.
Clicking on Detail Data link shows the same chart(s) with tables as described under Detailed Scenario Comparison Data.