INTERFACE USER GUIDE
1. Introduction
This section describes the file system and the main interfaces and capabilities of ONA Toolbox.
2. File system
On installing ONA Toolbox on your computer a working folder is created in C:/Users/UserName/.ona_toolbox. This folder contains the main working subfolders and files of the toolbox.
Special interest folders are:
'work' folder, which contains the modelling files of simulations. Each simulation subfolder will contain the inputs and raw results of the models.
'fixfiles' folder, containing the templates of the parameter input files of the models, the database of wave storms, storm surges, their position, and the sea levels corresponding to the RCP projections and time horizons.
'results' folder, which contains all the graphical results.
'input' folder, with the corresponding Topobathymetry DEMs used.
ONA Toolbox file system
3. User Interfaces
3.1 Main Interface
The main interface allows users to access to the two main sections of the toolbox: the DEM/Topobathymetries Manager and the Projects Manager sections. The user can also access to this sections as well to other sections at the expandible menu located at the upper left corner of the window.
3.2 Digital Elevation Models (DEM)/Topobathymetries Interface
The section Digital Elevation Models / Topobathymetries allows users to upload, visualize, and manage the topobathymetry of the study area. Topobathymetries are saved in the computer and can be accessed, modified, and/or deleted through this section. The figure on the left shows the interface to insert a new Topobathymetry DEM, where the user can search the file from their computer, write a Name, and select the UTM zone from the drop-down list. The figure on the right shows two topobathymetries already uploaded and used in the simulations described below each one.
The input format for the topobathymetries and how to build them is detailed in this manual's section 'How to build a topobathymetric DEM'.
The interface accounts for a search bar to find uploaded DEMs by name or description.
3.3 Projects Interface
At the Project Manager section, user can create, access and modify working projects. The 'CREATE NEW PROJECT' button allows users to add working projects. The saved project will appear listed in the Projects Manager interface, from which they can be accessed, modified, and deleted.
The interface accounts for a search bar to find projects by name or description.
3.4 Simulations Interface
By clicking on an existing project, the Simulations interface will appear. In this interface, the user can create, modify, and delete simulations that will be listed on the main screen. Each project can include as many simulations as needed, considering different RCP scenarios, time horizons, and study areas, whether within the same topobathymetry or across others. The interface accounts for a search bar to find saved simulations by name or description.
This interface also controls simulations. For a simulation within the list, the user can leave the slider option to the left (Full Run), and by clicking the 'Run Models' button, a full simulation starts:
However, by keeping the slider option to the right (Test), the user can control the simulation steps and execute them progressively, one at a time. The execution process of each step is displayed in the debugging window that appears at the lower half of the screen. There will be a Debug window for each Simulation performed:
3.5 Results Interface
The Results interface contains all the information of the project, the computational area, boundary conditions, as well as the results of each model: wave propagation, coastal flooding, and beach erosion. The upper banner accounts for different buttons that guide a user through the different sections of the Results interface: Scenario, Storm, Flood, Beach Erosion, Downloads, and All Images.
From this interface (Downloads window), the user can also retrieve an automatic report summarizing the main results, the model results in ASCII format (to be used with GIS platforms), and the raw model results for further analysis.
