diff --git a/source/e_viewer.rst b/source/e_viewer.rst index 94cfe93..7be0f1e 100644 --- a/source/e_viewer.rst +++ b/source/e_viewer.rst @@ -2,11 +2,11 @@ Viewer ====== -The Lizard Viewer is a graphical user interface (GUI) in which measuring locations, parameters, timeseries, rasters and other layers are visible. +The Lizard Viewer is a graphical user interface (GUI) in which measuring locations, parameters, time series, rasters and other layers are visible. Below you will find an overview of a general Lizard Viewer instance. Every aspect of the viewer will be discussed and in the end we will supply a series of short tutorials designed to kick-start your Lizard experience. These are short and simple explanations of commonly used features that might require a short explanation. -If you are struggling with any of the features, feel free to contact the `servicedesk `_ for guidance. +If you are struggling with any of the features, feel free to contact the `service-desk `_ for guidance. Elements Overview =================== @@ -14,13 +14,15 @@ Elements Overview The Lizard Viewer can be divided into 4 sections, with each their own elements. We will handle items within a section from left to right, top to bottom: -1. The Topbar: +1. The Top-bar: + * 1.1: Lizard Menu - * 1.2: Searchbar + * 1.2: Search Bar * 1.3: Map / Graph * 1.4: Settings and Login 2. The Viewport + * 2.1: Select Menu * 2.1.A: Cursor @@ -33,13 +35,14 @@ We will handle items within a section from left to right, top to bottom: * 2.2: Time Panel * 2.2.A: Datetime - * 2.2.B: Timeframe Selection + * 2.2.B: Time Frame Selection * 2.2.C: Expand / Collapse - * 2.2.D: Timebar + * 2.2.D: Time-bar * 2.2.E: End / Start Date - * 2.2.F: Zoomfunctions + * 2.2.F: Zoom Functions 3. The Left Panel + * 3.1: Minimize * 3.2: Layers button * 3.3: Add new x @@ -51,6 +54,7 @@ We will handle items within a section from left to right, top to bottom: * 3.5: Base layer 4. The Right Panel + * 4.1: Minimize * 4.2: Layer details @@ -69,19 +73,19 @@ We will handle items within a section from left to right, top to bottom: .. image:: /images/e_overview_01.jpg -1. Topbar +1. Top-Bar -------------------- .. image:: /images/e_topbar_01.jpg **1.1 Lizard Menu** -The Lizard gives acts as a shortcut to the homepage. At the homepage you can vind the catalogue, the viewer, the management page and the API. -At the homepage there are also apps available, for example dashboards or floodsmart. +The Lizard gives acts as a shortcut to the homepage. At the homepage you can find the catalogue, the viewer, the management page and the API. +At the homepage there are also apps available, for example dashboards or FloodSmart. At the bottom there are some useful links, like the documentation and support links. -**1.2 Searchbar** -At the searchbar you can lookup items or locations, depending on the setting used. -The right side of the searchbar displays the currently selected option. +**1.2 Search Bar** +At the search bar you can lookup items or locations, depending on the setting used. +The right side of the search-bar displays the currently selected option. Clicking results in a drop-down menu with the available search options; currently assets or addresses. A location search will move the viewport to the desired location. The search of an asset will add the asset to the selection panel (left), select the asset and move the screen accordingly. @@ -96,27 +100,27 @@ It should be noted that it is not possible to display graphs if no assets or sel Offers a drop-down menu in regards to links, support tools, settings and the login. -There is a link to the homepage available under `home`, and a link to the documentation at `help`. +There is a link to the homepage available under ``home``, and a link to the documentation at ``help``. -To get familiar with the entire viewer one can use the `Start a tour` button. +To get familiar with the entire viewer one can use the ``Start a tour`` button. This button will start a 'tour', during which the functionality of the viewer is introduced and explained briefly. The tour has a lot of functionality, allowing you to move forward and backward through the items. Furthermore, once confident you can skip the rest of the tour or if you would close the tour screen it can be resumed by clicking on the pulsing blue dot. -If the tour is skipped at any point it can be restarted by using the `Start a tour` button once more. +If the tour is skipped at any point it can be restarted by using the ``Start a tour`` button once more. -Clicking `Export` will take you to the exports overview. +Clicking ``Export`` will take you to the exports overview. In this overview you can see the status of your exports and download or delete any available exports. -Next up is `favourites`, which will open the favourites overview screen. +Next up is ``favourites``, which will open the favourites overview screen. Similar to a bookmark, favourites allows you to save the current view, in both map and graph mode, to be saved. -This includes the viewbox, the layers and assets and timeframe. +This includes the view-box, the layers and assets and time frame. This 'favourite' can then be loaded from the menu to quickly re-access the saved view. -By using the option `make time relative` the user is able to determine if a favourite should remain static, or adjust based on the time past. +By using the option ``make time relative`` the user is able to determine if a favourite should remain static, or adjust based on the time past. -We then find two language options: `EN` for English and `NL` for Dutch. +We then find two language options: ``EN`` for English and ``NL`` for Dutch. Clicking on between the EN and NL buttons will swap the language settings for the entire Lizard Viewer. -Finally we find the `Reset Application` and `Login` / `Logout` buttons. +Finally we find the ``Reset Application`` and ``Login`` / ``Logout`` buttons. `Reset Application` as the name suggests resets the Lizard Viewer. This can be useful when you want to have a clean slate to work in. @@ -124,122 +128,133 @@ This can be useful when you want to have a clean slate to work in. 2. Viewport -------------------- +The viewport is the section of the screen used to view the map and your results. +There are two ways to interact with the viewport: + +1. With the selection tool +2. With the time-bar + .. image:: /images/e_viewport_01.jpg **2.1 Select Menu** -.. image:: /images/e_selectmenu_01.jpg - The select menu determines the way you interact with the layers with the cursor and is found at the top of the viewport. There is a variety of options to choose from. At all times you are able to move the view through dragging. -If you hold CTRL while dragging you turn the angle of the viewport. -*2.1.A: Cursor* +.. tip:: + If you hold CTRL while dragging you turn the angle of the viewport. + +.. image:: /images/e_selectmenu_01.jpg + +2.1.A: Cursor:: The Cursor when selected allows you to select individual assets by clicking on them. If you want to select multiple assets, CTRL has to be pressed while clicking. -*2.1.B: Points* -Allows you to create one or multiple points that display the value of a raster, or the timeseries for temporal rasters. +2.1.B: Points:: +Allows you to create one or multiple points that display the value of a raster, or the time series for temporal rasters. As a default only one point can be created. This way clutter is avoided. If you are interested in using multiple points you could use CTRL-clicking to add multiple point assets. -*2.1.C: Line* +2.1.C: Line:: Able to create a straight line. If you click once you start the line placement. The second click will complete the line. -If instead of selecting a different point, you reclick the start, the line placement will be cancelled. +If instead of selecting a different point, you re-click the start, the line placement will be cancelled. Could be used to examine the slope of a hill or mountain. With CTRL-clicking one can create multiple lines. -*2.1.D: Polygon* +2.1.D: Polygon:: The polygon method allows the user to create figures with 3 or more corners. -By reclicking on the previously defined corner you cancel it. +By re-clicking on the previously defined corner you cancel it. It allows you to inspect the statistics of a certain area. Like what percentage of the selected area consists of a certain land-use type. -*2.1.E: North-South* +2.1.E: North-South:: If you used CTRL+dragging to move the angle of the screen you can use this button to return the view to top-down North. -*2.1.F: Hotkeys* +2.1.F: Hotkeys:: +There are multiple hotkeys within the drop-down menu. +Every shortcut can be accessed by clicking on it, or using the key that is displayed on the right side. .. image:: /images/e_shortcuts_01.jpg -There are multiple hotkeys within the drop-down menu. -Every shortcut can be accessed by clicking on it, or using the key that is displayed on the rightside. + * Zoom-in [+]: Zooms in for the viewport * Zoom-out [-]: Zooms out for the viewport * Toggle baselayer labels [L]: Toggles the labels within the baselayer, like names of locations. * Full Map [F]: Toggles the right and left panel to provide a full view of the map. -* Show Time Period [T]: Toggles the timebar in the bottom. +* Show Time Period [T]: Toggles the time-bar in the bottom. **2.2 Time Panel** -.. image:: /images/e_timepanel_01.jpg - The time panel is related to all things time. It is located at the bottom of the viewport. + +.. image:: /images/e_timepanel_01.jpg + The time panel has a few mentionable items: -*2.2.A: Datetime Display* -The datetime display shows you the timeframe that is currently viewed on screen. +2.2.A: Datetime Display:: +The datetime display shows you the time frame that is currently viewed on screen. -*2.2.B: Timeperiod Selection* -The timeperiod selection tool in the upper-left corner of the panel allows you to select the timeperiod you would like to view in the timebar. -There are a few standard settings, like one day `1D`, a week `7D`, a month `1M`, a year `1Y` or five years `5Y`. -These will all show you the timeframe between now and the timeperiod. +2.2.B: Time Period Selection:: +The time period selection tool in the upper-left corner of the panel allows you to select the time period you would like to view in the time-bar. +There are a few standard settings, like one day ``1D``, a week ``7D``, a month ``1M``, a year ``1Y`` or five years ``5Y``. +These will all show you the time frame between now and the time period. Thus 1D will for the 27th of September 2023 12:05 will the time from 26/09/2023 12:05 till 27/09/2023 12:05. -The `MAX` and `NOW` button function slightly differently. -When one clicks `NOW` the timebar centres on the present time, with one day in advance and one day prior forming the timebar edges. -The `MAX` button zooms to the timespan of the entire data set available. +The ``MAX`` and ``NOW`` button function slightly differently. +When one clicks ``NOW`` the time-bar centres on the present time, with one day in advance and one day prior forming the time-bar edges. +The ``MAX`` button zooms to the time span of the entire data set available. .. note:: - `MAX` results in a view of the entire timeframe during which data can be found for the **selected** layers. + ``MAX`` results in a view of the entire time frame during which data can be found for the **selected** layers. -*2.2.C: Expand / Collapse* -The `Expand / Collapse` button can be found in the top-right corner. +2.2.C: Expand / Collapse:: +The ``Expand / Collapse`` button can be found in the top-right corner. It allows the user to minimize the time panel in two steps: + 1. The first time you use click the button: - * The zoom functionality will be removed from the bar together with the timeperiod selection - * The timeperiod selection buttons are removed + * The zoom functionality will be removed from the bar together with the time period selection + * The time period selection buttons are removed .. image:: /images/e_minimize_01.jpg 2. The second button fully minimizes the panel: - * The timebar itself is removed + * The time-bar itself is removed * The start and end dates of the interval have been removed - * The datetime date display becomes the current viewdate and remains visible + * The datetime date display becomes the current view date and remains visible .. image:: /images/e_minimize_02.jpg -*2.2.D: Timebar* -The timebar displays the time interval of interest. -If a layer has been selected, the data from this timeperiod will be displayed in the right panel. +2.2.D: Time-bar:: +The time-bar displays the time interval of interest. +If a layer has been selected, the data from this time period will be displayed in the right panel. .. tip:: - Support `SHIFT-click` dragging functionality to zoom into a selection of the timebar. + Support ``SHIFT-click`` dragging functionality to zoom into a selection of the time-bar. .. tip:: - It is also possible to zoom in or out of the temporal timeframe with the `Scroll` button on the mouse. + It is also possible to zoom in or out of the temporal time frame with the ``Scroll`` button on the mouse. -*2.2.E: End / Start Date* -At the edges, just below the timebar, you will find the interval between which the data is displayed in the right panel. +2.2.E: End / Start Date:: +At the edges, just below the time-bar, you will find the interval between which the data is displayed in the right panel. For animations, this will be the start and end date. You are able to adjust these dates in a multitude of ways. -One is to scroll in the timebar itself. +One is to scroll in the time-bar itself. Dependent on the level of initial zoom the addition or removal of the dates can range from single minutes to multiple years, the build up is gradual. Another way to update the dates on one side is clicking on the datetime and using the calendar to select a date (and possibly a time). -*2.2.F: Zoomfunctions* +2.2.F: Zoom Functions:: All the way at the bottom within the middle of the time panel you will find the zoom-buttons. -Logically, the magnifying glass with a `+` icon is the zoom-in, with the `-` representing the zoom-out functionality. +Logically, the magnifying glass with a ``+`` icon is the zoom-in, with the ``-`` representing the zoom-out functionality. 3. Left Panel @@ -248,16 +263,20 @@ Logically, the magnifying glass with a `+` icon is the zoom-in, with the `-` rep .. image:: /images/e_leftpanel_01.jpg **3.1 Minimize** + Allows you to move the side panel of the screen so you have complete better of the map itself. .. image:: /images/e_minimize_03.jpg **3.2 Layers Button** + The layers button displays the number of layers that are currently available within the left panel. By clicking this button all layers are selected, if all layers are selected it functions as a de-select all button. **3.3 Add new x** + Opens a window that allows you to select a new: + - Layer - Asset - Asset set @@ -266,25 +285,31 @@ Opens a window that allows you to select a new: .. image:: /images/e_addmenu_01.jpg + In the menu that opens after clicking the ``+``-icon you are able to select what kind of data category you would like to add to your selection. + + .. image:: /images/e_addraster_01.jpg -*3.3.A: Home* + An example of how your screen could look if you wanted to add a layer of the type 'raster'. + +3.3.A: Home:: If one would like to switch to a different category the home button in the top left corner can be pressed. This will bring you back to the category selection screen. -*3.3.B: Search bar* +3.3.B: Search bar:: You can search within any category with the search bar at the topside of the pop-up window. This can be combined with category selections to create a more selective overview. -*3.3.C: Filters* +3.3.C: Filters:: Within each of the categories there is a variety of filters to apply. Examples are: + * Organisation * Observation type * Layer collection * Asset type -*3.3.D: Results* +3.3.D: Results:: This is the panel where the results of your search query are returned. @@ -292,7 +317,7 @@ This is the panel where the results of your search query are returned. .. image:: /images/e_assetsrasters_01.jpg -*3.4.A: Assets and selections* +3.4.A: Assets and selections:: the top part of the panel is reserved for assets and selections. Often a graph of the data found on a line, point or region can be displayed in a graph. Layers only have legends, separating the two. @@ -302,13 +327,14 @@ Clicking another asset will de-select the previously selected asset. .. tip:: You can select multiple assets with CTRL-clicking. -*3.4.B: Layers* +3.4.B: Layers:: Below the gray line layers can be found. Layers comprise of all categories except individual assets or selections. Selecting a layer without the use of CTRL will not result in de-selection of previously selected layers. Selections will interact with the selected layers, allowing you to view time series of temporal rasters, or values found within a region. **3.5 Baselayer** + The lowest part of the left panel is related to the base map. By clicking on the layer icon, you are able to alter the base layer. The different layers that are available are: @@ -323,35 +349,38 @@ The different layers that are available are: -------------------- **4.1 Minimize** -Just like the left panel, the right panel is equiped with a minimize button to give you more access to the map layer. -By combining the minimize of the timebar and both panels you are left with a full map view. + +Just like the left panel, the right panel is equipped with a minimize button to give you more access to the map layer. +By combining the minimize of the time-bar and both panels you are left with a full map view. .. image:: /images/e_minimize_04.jpg .. note:: - The `Full Map` shortcut only minimizes both panels, not the timebar. + The `Full Map` shortcut only minimizes both panels, not the time-bar. **4.2 Layer details** + Every selected layer is shown in the right panel with additional details visible below. .. image:: /images/e_rightraster_01.jpg -*4.2.A: Legend* +4.2.A: Legend:: Displays the raster values. This might be a value scale for scalar data, but it could also possibly be classes for things like land-use. -*4.2.B: Controls* +4.2.B: Controls:: - Opacity: How translucent is the layer. Can be set anywhere from 0 to 100 percent. - Zoom to extent: Allows the user to zoom to the full extent of the layer. - Rescale color range: Depending on extent of the view the color scale can be adjusted. An example for when this would be very useful would be when zooming in of a height map, adjusting the scale will give you a much better view. - Animate: Animates temporal rasters for you to view the change through time. -*4.2.C: Export raster* +4.2.C: Export raster:: Opens the raster export view pane. There is quite a lot to this view, an overview is available below. .. image:: /images/e_export_01.jpg In the export view you will find information about: + - Layer name - Organisation name - Projection @@ -367,12 +396,13 @@ The cap is at 10.000.000.000 pixels. .. image:: /images/e_exporterror_01.jpg -*4.2.D: Catalog* +4.2.D: Catalog:: The `Open in Lizard Catalog` brings you to the lizard catalog, allowing you to see aspects of the raster layer unavailable in the viewer. It also allows the user to quickly access the API of the respective layer. **4.3 Assets and selection details** + Every asset or selection shows its details in the right panel, they stack on top of the layer details. .. note:: @@ -380,8 +410,9 @@ Every asset or selection shows its details in the right panel, they stack on top .. image:: /images/e_rightasset_01.jpg -*4.3.A: General information* +4.3.A: General information:: Immediately under the asset general information is available, some examples: + - Assets: name, code, type, capacity, station type - Selections: label, coordinates, length or area. @@ -394,23 +425,25 @@ For a raster with categories like soil types a point returns the category found The information depends on the asset or selection type. -*4.3.B: Time series data selection* +4.3.B: Time series data selection:: Right below the time series label a drop-down menu is available. Within the drop-down field you will find all the data available for the asset. -*4.3.C: Time series data display* -A graph displaying the selected data type for the time interval displayed on the timebar. -There are many ways to interact with the timeframe of the graph: +4.3.C: Time series data display:: +A graph displaying the selected data type for the time interval displayed on the time-bar. +There are many ways to interact with the time frame of the graph: + 1. Click-dragging in the graph itself, this will zoom in to the time range selected. -2. Interacting with the timebar through any of the methods discussed in section 2.2 +2. Interacting with the time-bar through any of the methods discussed in section 2.2 -*4.3.D: Time series export function* -The `Export time series` button exports all information in the time series for the selected time period (within the timebar). +4.3.D: Time series export function:: +The `Export time series` button exports all information in the time series for the selected time period (within the time-bar). The export can be found in the user drop-down menu in the top-right corner. The time series is given in an Excel file. -*4.3.E: Controls* +4.3.E: Controls:: In the controls section we have options that have been discussed prior like: + - Opacity: How translucent is the layer. Can be set anywhere from 0 to 100 percent. - Zoom to extent: Allows the user to zoom to the extent of the selection or asset.