.. _mi_overview: User interface overview ======================= The Rana Desktop Client consists of five components: 1. **Main menu** 2. **Toolbar**: the :ref:`schematisation_editor_toolbar`, a button to open the :ref:`models_simulation_panel`, and the :ref:`results_analysis_toolbar` are already added to the toolbar. 3. **Panels**: the :ref:`3di_processing_toolbox` QGIS Processing Toolbox. 4. **Map canvas** 5. **Status bar** .. todo: This image needs to be updated once the modeller interface is updated with the new results analysis tool! .. figure:: image/i_overview_modeller_interface.png :alt: Rana Desktop Client Overview of the Rana Desktop Client. .. _schematisation_editor_toolbar: Rana Schematisation Editor toolbar --------------------------------- .. figure:: image/d_schematisation_editor_options.png :alt: Menu of the schematisation editor Rana Schematisation Editor toolbar * **Open geopackage**: Loads your schematisation in the Modeller Interface, directly from the geopackage. * **Load from Spatialite**: Load your schematisation in the Modeller Interface, by loading the data from the spatialite into a geopackage. The Schematisation Editor automatically performs the transformation and saves the *.gpkg*-file in the same folder and with the same name as the spatialite. * **Save to Spatialite**: Saves the data back to the spatialite from which you loaded it. Do not forget to save your changes to the spatialite *before* uploading the spatialite to a new revision! * **Save As**: Gives you the option to select another spatialite to save your data to. * **Remove Rana Model**: Removes the schematisation layers from your project. To start working with the Schematisation Editor, the data from the spatialite has to be loaded into a geopackage. This is easily done by using the **Load from Spatialite** button. The Schematisation Editor automatically performs the transformation and saves the *.gpkg*-file in the same folder and with the same name as the spatialite. Once you are finished with editing the schematisation, the changes have to be saved back to the spatialite. **Save to Spatialite** will save the data back to the spatialite from which you loaded it. **Save As** gives you the option to select another spatialite to save your data to. Do not forget to save your changes to the spatialite *before* uploading the spatialite to a new revision! Schematisations can also be opened directly from the geopackage, using the **Open Rana Geopackage** option. The **Remove Rana Model** button removes the schematisation layers from your project. .. _results_analysis_toolbar: Rana Results Analysis toolbar ---------------------------- .. figure:: image/i_3di_results_analysis_toolbar.png :alt: Rana Results Analysis toolbar The Rana Results Analysis toolbar gives you access to all the :ref:`toctree_analysing_results`. Clicking the |loggingtoolbar| saves the technical logging of the Rana Results Analysis plugin to a file. This can be helpful for the our :ref:`servicedesk` when you run into any technical issues with the Rana Results Analysis plugin. .. |loggingtoolbar| image:: /image/i_3di_results_analysis_toolbar_logging.png :scale: 25% .. _temporal_controller: Temporal controller ------------------- When you load your results the Temporal Controller will automatically appear at the top of your screen (if it was not already visible). With the Temporal Controller you can see and analyse the results through time. The Temporal Controller is a native feature of QGIS and can also be utilised in combination with other results tools. To use this tool, you first need to click the |closed_eye| in front of the desired results in the *Results Manager*. If you have loaded more than one set of results, the |opened_eye| shows the set that is used in the visualisation. Click the |opened_eye| again to stop visualisation of the results. The results are visualised on the flowlines, 1D nodes and 2D computational cells (see :ref:`3dinetcdf` for more information on the possible flow-variables). 1) Pause or play the animation of the results through time. 2) Skip to next frame. 3) Skip to last frame. 4) Move the slider to visualise the results at different timesteps. 5) Check to automatically reset and repeat the animation endlessly when running the animation. 6) The temporal range that is used for the visualisation. Note that the default range that is shown is the range used in the simulation. 7) The steps per frame. Here the steps frame are shown every 300 seconds. Note that this shouldn't be smaller than the used output timestep in the simulation. 8) The units that correspond to the number of steps [6]. 9) Export the results as png's for every or any timestep. .. image:: /image/i_temporal_controller.png :alt: Temporal Controller panel .. |temporalcontroller| image:: /image/i_temporal_controller.png :scale: 90% .. _3di_processing_toolbox: Rana Processing Algorithms ------------------------- Many Rana related actions can be performed by running a Processing Algorithm. These can be found in the (QGIS native) Processing Toolbox. To open the processing toolbox from the main menu, click *Processing* > *Toolbox*. Alteratively, you can click |processing_toolbox_icon| in the attributes toolbar or use the keyboard shortcut CTRL + ALT + T. Scroll down to the sections *Rana Results Analysis* and *Rana Schematisation Editor* to find the Rana-specific processing algorithms. .. |processing_toolbox_icon| image:: /image/pictogram_processing_toolbox.png .. figure:: image/i_3di_processing_toolbox.png :alt: Processing Toolbox dock panel :align: right :scale: 30% .. |modelsSimulations| image:: /image/pictogram_modelsandsimulations.png :scale: 90% .. |closed_eye| image:: /image/pictogram_temporal_controller_load_results_closed_eye.png :scale: 100% .. |opened_eye| image:: /image/pictogram_temporal_controller_load_results_opened_eye.png :scale: 100%