Added descriptions for WMS layers and EDR assets

docs/source/basic_tasks/adding_assets_from_the_edr.rst

@@ -0,0 +1,29 @@
+Adding assets from the Energy Data Repository
+=============================================
+
+The `Energy Data Repository <https://edr.hesi.energy>`_ is an online database with ESDL data. The Energy Data Repository
+(EDR) contains 3 sections:
+
+* Assets: Asset data with technology and cost parameters
+* Profiles: Standard profiles
+* Key figures: Key figures, like a list of energy carriers, or the sector overview according to the `SBI
+  <https://www.kvk.nl/overzicht-standaard-bedrijfsindeling/>`_
+
+At the moment the MapEditor allows to add assets to the map based on the EDR contents. To add an assets from the EDR,
+click the 'EDR assets' button:
+
+  .. image:: images/menu_bar_edr_assets.png
+    :alt: Menu bar - EDR assets
+
+The following dialog appears:
+
+  .. image:: images/edr_assets_dialog.png
+    :alt: EDR assets dialog
+
+The dialog contains two drop down lists. The first one can be used to filter on a specific type of asset. The second
+drop down list actually determines which asset information is loaded from the EDR. Press the 'Select' button to start
+with the process of adding the asset to a specific location. See the :ref:`Adding assets<Adding assets>` section for more information.
+
+  .. image:: images/edr_assets_select_asset.png
+    :alt: EDR assets select asset
+

docs/source/basic_tasks/index.rst

@@ -7,6 +7,7 @@ Basic tasks in the ESDL MapEditor
 
    creating_an_energy_system_description
    adding_assets
+   adding_assets_from_the_edr
    moving_assets
    removing_assets
    connecting_assets

docs/source/conf.py

@@ -30,6 +30,7 @@
 # ones.
 extensions = [
     "sphinx_rtd_theme",
+    "sphinx.ext.autosectionlabel",
 ]
 
 # Add any paths that contain templates here, relative to this directory.

docs/source/example_workflows/exploring_spatial_possibilities_for_large_scale_wind_and_solar.rst

@@ -41,3 +41,4 @@ This workflow can be divided in the following steps:
     :width: 800
     :alt: Wind potential areas in the province of Drenthe
 
+6.

docs/source/features/configuring_external_services.rst

@@ -1,3 +1,3 @@
-External ESDL services
-======================
+Configuring external ESDL services
+==================================
 

docs/source/features/profile_manager.rst

@@ -1,2 +1,2 @@
-Boundary service
-================
+Profile manager
+===============

docs/source/features/wms_services.rst

@@ -1,3 +1,91 @@
 WMS layer data
 ==============
 
+The ESDL MapEditor provides basic functionality for adding WMS layers. This information will be shown on the map and
+can then be used as input information to design your energy system. WMS layers can be hosted by any external server
+or you can install your own ARCGIS server or use the open source `geoserver <http://geoserver.org/>`_.
+
+WMS layers can be organized per project or for personal use only.
+
+Show WMS layers on the map
+--------------------------
+
+From the 'View' menu, select 'WMS layers'
+
+  .. image:: images/view_menu_wms_layers.png
+    :alt: View menu - WMS layers
+
+The following dialog will open:
+
+  .. image:: images/wms_layer_dialog.png
+    :alt: WMS layer dialog
+
+Click any layer from the list to visualize the information on the map
+
+  .. image:: images/adding_a_wms_layer_to_the_map.png
+    :alt: adding a WMS layer to the map
+
+Adding new layers
+-----------------
+
+To add a new layer, the following information must be filled in:
+
+* Description: Name of the layer that is used in the list with all WMS layers
+* URL: URL of the server where the WMS layer is hosted. See example configurations for the format
+* Layer name: Name of the layer on the server that needs to be visualized
+* Legend URL (optional): URL of the legend image that belongs to the layer
+* Add to group: To determine where this new layer will be added
+
+Click 'Add layer' button to save the layer configuration.
+
+Example configurations are:
+
+* Example layer from the 'Nationaal Georegister':
+
+  * Description: AHN2 5 meter
+
+  * URL: http://geodata.nationaalgeoregister.nl/ahn2/wms?
+
+  * Layer name: ahn2_5m
+
+  * Legend URL: -
+
+* Example layer from the 'Warmte atlas'
+
+  * Description: LT_WarmteBronnen_ECW
+
+  * URL: https://rvo.b3p.nl/geoserver/WarmteAtlas/wms?
+
+  * Layer name: LT_WarmteBronnen_ECW
+
+  * Legend URL: -
+
+* Example layer from Thermogis
+
+  * Description: Thermogis layer 1
+
+  * URL: http://www.thermogis.nl/arcgis/services/thermogis/ThermoGIS_WMS/MapServer/WmsServer?
+
+  * Layer name: 1
+
+  * Legend URL: -
+
+* Example layer from PICO
+
+  * Description: PICO Hoogspanningsnet 2018
+
+  * URL: https://pico.geodan.nl/cgi-bin/qgis_mapserv.fcgi?DPI=120&map=/usr/lib/cgi-bin/projects/Hoogspanningsnet_2018.qgs
+
+  * Layer name: Hoogspanningsnet_2018
+
+  * Legend URL: `https://pico.geodan.nl/cgi-bin/qgis_mapserv.fcgi?DPI=96
+    &map=/usr/lib/cgi-bin/projects/Hoogspanningsnet_2018.qgs&request=GetLegendGraphic&service=WMS
+    &itemFONTSIZE=7&format=png&layertitle=false&layer=Hoogspanningsnet_2018 <https://pico.geodan.nl/cgi-bin/qgis_mapserv.fcgi?DPI=96&map=/usr/lib/cgi-bin/projects/Hoogspanningsnet_2018.qgs&request=GetLegendGraphic&service=WMS&itemFONTSIZE=7&format=png&layertitle=false&layer=Hoogspanningsnet_2018>`_
+
+Deleting layers
+---------------
+
+Right click with the mouse on a layer name and click 'Delete layer'
+
+  .. image:: images/delete_wms_layer.png
+    :alt: Delete a WMS layer from the list