Finished review of web client.

a6b0e9fe · Stephan · 586d9650 · a6b0e9fe · 586d9650 · a6b0e9fe
Commit a6b0e9fe authored 5 years ago by Stephan
--- a/documentation/usage-guide/conf.py
+++ b/documentation/usage-guide/conf.py
@@ -63,7 +63,7 @@ numfig_secnum_depth = 2

 latex_documents = [(
    'index',
-    'View-Server.tex',
+    'View-Server_-_Usage-Guide.tex',
    u'View Server - Usage Guide',
    u'EOX IT Services GmbH',
    'manual',

--- a/documentation/usage-guide/downloading.md
+++ b/documentation/usage-guide/downloading.md
-# Downloading
-
--- a/documentation/usage-guide/downloading.rst
+++ b/documentation/usage-guide/downloading.rst
+.. _downloading:
+
+Downloading
+===========
+
+WCS
+
+DSEO
--- a/documentation/usage-guide/index.rst
+++ b/documentation/usage-guide/index.rst
@@ -4,7 +4,7 @@ View Server - Usage Guide
 =========================

 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 3

   intro


--- a/documentation/usage-guide/intro.rst
+++ b/documentation/usage-guide/intro.rst
@@ -12,3 +12,5 @@ performance as well as for flexibility are provided alongside each other.
   :alt: Web Client

   *Web Client*
+
+Continue reading to understand the details of the provided :ref:`web_client`.
--- a/documentation/usage-guide/sample-requests.md
+++ b/documentation/usage-guide/sample-requests.md
-# Sample Service Requests
-
-some live samples.
-login needed
-
-## Client
-
-TODO entry page listing collections at
-    * https://pdas.prism.eox.at
-    * https://pass.copernicus.eu
-
-
-* https://vhr18.pdas.prism.eox.at
-* https://emg.pdas.prism.eox.at
-
-* https://vhr18.pass.copernicus.eu
-* https://emg.pass.copernicus.eu
-
-## Cache
-
-### WMTS
-
-* https://vhr18.pdas.prism.eox.at/cache/ows/wmts/1.0.0/WMTSCapabilities.xml
-* https://vhr18.pdas.prism.eox.at/cache/ows/wmts/1.0.0/VHR_IMAGE_2018__TRUE_COLOR/default/2018-06-01T00%3A00%3A00Z--2018-07-01T00%3A00%3A00Z/WGS84/11/524/2224.xxx
-* https://vhr18.pdas.prism.eox.at/cache/ows/wmts/1.0.0/VHR_IMAGE_2018__FALSE_COLOR/default/2018-06-01T00%3A00%3A00Z--2018-07-01T00%3A00%3A00Z/WGS84/11/524/2224.xxx
-* https://vhr18.pdas.prism.eox.at/cache/ows/wmts/1.0.0/VHR_IMAGE_2018__NDVI/default/2018-06-01T00%3A00%3A00Z--2018-07-01T00%3A00%3A00Z/WGS84/11/524/2224.xxx
-
-### WMS
-
-* https://vhr18.pdas.prism.eox.at/cache/ows?service=wms&request=getcapabilities
-* https://vhr18.pdas.prism.eox.at/cache/ows?SERVICE=WMS&VERSION=1.1.0&REQUEST=GetMap&FORMAT=image%2Fpng&TRANSPARENT=true&LAYERS=VHR_IMAGE_2018__TRUE_COLOR&STYLES=&time=2018-06-01T00%3A00%3A00Z%2F2018-07-01T00%3A00%3A00Z&WIDTH=256&HEIGHT=256&SRS=EPSG%3A4326&BBOX=15.46875%2C43.857421875%2C15.556640625%2C43.9453125
-
-## Renderer
-
-### OpenSearch
-
-* 1st step OSDD https://vhr18.pdas.prism.eox.at/opensearch
-* 1st step search for collections https://vhr18.pdas.prism.eox.at/opensearch/atom/
-* 2nd step OSDD https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018/
-* 2nd step search https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018/atom/
-* For one product https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018/atom/?uid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7
-
-### WMS
-
-#### Capabilities
-
-* https://vhr18.pdas.prism.eox.at/ows?service=wms&request=getcapabilities
-* Limited to one product https://vhr18.pdas.prism.eox.at/ows?service=wms&request=GetCapabilities&cql=identifier='urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7'
-
-#### GetMap
-
-* Quicklook https://vhr18.pdas.prism.eox.at/ows?service=WMS&version=1.3.0&request=GetMap&layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&format=image/png&TRANSPARENT=true&width=463&height=500&CRS=EPSG:4326&STYLES=&BBOX=47.297788,25.978201,47.372606,26.047511
-* False color https://vhr18.pdas.prism.eox.at/ows?service=WMS&version=1.3.0&request=GetMap&layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__FALSE_COLOR&format=image/png&TRANSPARENT=true&width=463&height=500&CRS=EPSG:4326&STYLES=&BBOX=47.297788,25.978201,47.372606,26.047511
-* NDVI including style https://vhr18.pdas.prism.eox.at/ows?service=WMS&version=1.3.0&request=GetMap&layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__NDVI&format=image/png&TRANSPARENT=true&width=463&height=500&CRS=EPSG:4326&STYLES=coolwarm&BBOX=47.297788,25.978201,47.372606,26.047511
-* Custom color stretch https://vhr18.pdas.prism.eox.at/ows?service=WMS&version=1.3.0&request=GetMap&layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&format=image/png&TRANSPARENT=true&width=463&height=500&CRS=EPSG:4326&STYLES=&BBOX=47.297788,25.978201,47.372606,26.047511&dim_range=1000%205000
-* CQL filtering on Cloud Coverage https://vhr18.pdas.prism.eox.at/ows?service=WMS&version=1.3.0&request=GetMap&layers=VHR_IMAGE_2018&format=image/png&TRANSPARENT=true&width=392&height=500&CRS=EPSG:4326&STYLES=&BBOX=44.196369,14.849791,44.554918,15.131223&cql=cloudCover%3C1
-* Clouds mask validity https://vhr18.pdas.prism.eox.at/ows?SERVICE=WMS&VERSION=1.1.0&REQUEST=GetMap&FORMAT=image%2Fpng&TRANSPARENT=true&LAYERS=VHR_IMAGE_2018__validity&STYLES=&time=2017-04-14T13%3A49%3A45Z%2F2018-09-05T00%3A00%3A00Z&WIDTH=256&HEIGHT=256&SRS=EPSG%3A4326&BBOX=15.78727912902832,43.005756378173835,16.976377487182617,44.05855560302735
-* Clouds masked https://vhr18.pdas.prism.eox.at/ows?SERVICE=WMS&VERSION=1.1.0&REQUEST=GetMap&FORMAT=image%2Fpng&TRANSPARENT=true&LAYERS=VHR_IMAGE_2018__masked_validity&STYLES=&time=2017-04-14T13%3A49%3A45Z%2F2018-09-05T00%3A00%3A00Z&WIDTH=256&HEIGHT=256&SRS=EPSG%3A4326&BBOX=15.78727912902832,43.005756378173835,16.976377487182617,44.05855560302735
-
-### WCS
-
-#### Capabilities
-
-* https://vhr18.pdas.prism.eox.at/ows?service=wcs&request=getcapabilities
-
-#### Coverage Description
-
-* https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=DescribeEOCoverageSet&eoId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7
-* https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=DescribeCoverage&coverageId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage
-
-#### Coverage
-
-* Full in default format, projection, etc. https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=GetCoverage&coverageId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage
-* Spatial subset https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=GetCoverage&coverageid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage&subset=long(26.004538536944892,26.016211510577705)&subset=lat(47.326254844665534,47.33495235268493)&subsettingCRS=http://www.opengis.net/def/crs/EPSG/0/4326
-* Range subset https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=GetCoverage&coverageid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage&rangesubset=nir
-* Scale down https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=GetCoverage&coverageid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage&scaleFactor=0.1
-* Format, interpolation https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=GetCoverage&coverageid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage&format=image/jp2&interpolation=http://www.opengis.net/def/interpolation/OGC/1/nearest-neighbour
-* Projection https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=GetCoverage&coverageid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage&outputCRS=http://www.opengis.net/def/crs/EPSG/0/4326
-
-## DSEO
-
-* https://vhr18.pdas.prism.eox.at/ows?service=DSEO&version=1.0.0&request=GetProduct&ProductURI=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7
--- a/documentation/usage-guide/sample-requests.rst
+++ b/documentation/usage-guide/sample-requests.rst
+.. _sample_requests:
+
+Sample Service Requests
+=======================
+
+some live samples.
+login needed
+
+Client
+------
+
+TODO entry page listing collections at
+    * https://pdas.prism.eox.at
+    * https://pass.copernicus.eu
+
+
+* https://vhr18.pdas.prism.eox.at
+* https://emg.pdas.prism.eox.at
+
+* https://vhr18.pass.copernicus.eu
+* https://emg.pass.copernicus.eu
+
+Cache
+-----
+
+WMTS
+^^^^
+
+* `Capabilities <https://vhr18.pdas.prism.eox.at/cache/ows/wmts/1.0.0/WMTSCapabilities.xml>`_
+* `True color tile <https://vhr18.pdas.prism.eox.at/cache/ows/wmts/1.0.0/VHR_IMAGE_2018_Level_3__TRUE_COLOR/default/2018-06-01T00%3A00%3A00Z--2018-07-01T00%3A00%3A00Z/WGS84/11/524/2224.xxx>`_
+* `False color tile <https://vhr18.pdas.prism.eox.at/cache/ows/wmts/1.0.0/VHR_IMAGE_2018_Level_3__FALSE_COLOR/default/2018-06-01T00%3A00%3A00Z--2018-07-01T00%3A00%3A00Z/WGS84/11/524/2224.xxx>`_
+* `NDVI tile <https://vhr18.pdas.prism.eox.at/cache/ows/wmts/1.0.0/VHR_IMAGE_2018_Level_3__NDVI/default/2018-06-01T00%3A00%3A00Z--2018-07-01T00%3A00%3A00Z/WGS84/11/524/2224.xxx>`_
+
+WMS
+^^^
+
+* `Capabilities <https://vhr18.pdas.prism.eox.at/cache/ows?service=wms&request=getcapabilities>`_
+* `True color image <https://vhr18.pdas.prism.eox.at/cache/ows?SERVICE=WMS&VERSION=1.1.0&REQUEST=GetMap&FORMAT=image%2Fpng&TRANSPARENT=true&LAYERS=VHR_IMAGE_2018_Level_3__TRUE_COLOR&STYLES=&time=2018-06-01T00%3A00%3A00Z%2F2018-07-01T00%3A00%3A00Z&WIDTH=256&HEIGHT=256&SRS=EPSG%3A4326&BBOX=15.46875%2C43.857421875%2C15.556640625%2C43.9453125>`_
+
+Renderer
+--------
+
+OpenSearch
+^^^^^^^^^^
+
+* `1st step OSDD <https://vhr18.pdas.prism.eox.at/opensearch>`_
+* `1st step search for collections <https://vhr18.pdas.prism.eox.at/opensearch/atom/>`_
+* `2nd step OSDD <https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018_Level_3/>`_
+* `2nd step search <https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018_Level_3/atom/>`_
+* `For one product <https://vhr18.pdas.prism.eox.at/opensearch/collections/VHR_IMAGE_2018_Level_3/atom/?uid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7>`_
+
+WMS
+^^^
+
+* `Collection layers capabilities <https://vhr18.pdas.prism.eox.at/ows?service=wms&request=getcapabilities>`_
+* `Layer capabilities for one product <https://vhr18.pdas.prism.eox.at/ows?service=wms&request=GetCapabilities&cql=identifier='urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7'>`_
+* `Quicklook <https://vhr18.pdas.prism.eox.at/ows?service=WMS&version=1.3.0&request=GetMap&layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&format=image/png&TRANSPARENT=true&width=463&height=500&CRS=EPSG:4326&STYLES=&BBOX=47.297788,25.978201,47.372606,26.047511>`_
+* `False color <https://vhr18.pdas.prism.eox.at/ows?service=WMS&version=1.3.0&request=GetMap&layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__FALSE_COLOR&format=image/png&TRANSPARENT=true&width=463&height=500&CRS=EPSG:4326&STYLES=&BBOX=47.297788,25.978201,47.372606,26.047511>`_
+* `NDVI including style <https://vhr18.pdas.prism.eox.at/ows?service=WMS&version=1.3.0&request=GetMap&layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__NDVI&format=image/png&TRANSPARENT=true&width=463&height=500&CRS=EPSG:4326&STYLES=coolwarm&BBOX=47.297788,25.978201,47.372606,26.047511>`_
+* `Custom color stretch <https://vhr18.pdas.prism.eox.at/ows?service=WMS&version=1.3.0&request=GetMap&layers=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7&format=image/png&TRANSPARENT=true&width=463&height=500&CRS=EPSG:4326&STYLES=&BBOX=47.297788,25.978201,47.372606,26.047511&dim_range=1000%205000>`_
+* `CQL filtering on Cloud Coverage <https://vhr18.pdas.prism.eox.at/ows?service=WMS&version=1.3.0&request=GetMap&layers=VHR_IMAGE_2018_Level_3&format=image/png&TRANSPARENT=true&width=392&height=500&CRS=EPSG:4326&STYLES=&BBOX=44.196369,14.849791,44.554918,15.131223&cql=cloudCover%3C1>`_
+* `Clouds mask validity <https://vhr18.pdas.prism.eox.at/ows?SERVICE=WMS&VERSION=1.1.0&REQUEST=GetMap&FORMAT=image%2Fpng&TRANSPARENT=true&LAYERS=VHR_IMAGE_2018_Level_3__validity&STYLES=&time=2017-04-14T13%3A49%3A45Z%2F2018-09-05T00%3A00%3A00Z&WIDTH=256&HEIGHT=256&SRS=EPSG%3A4326&BBOX=15.78727912902832,43.005756378173835,16.976377487182617,44.05855560302735>`_
+* `Clouds masked <https://vhr18.pdas.prism.eox.at/ows?SERVICE=WMS&VERSION=1.1.0&REQUEST=GetMap&FORMAT=image%2Fpng&TRANSPARENT=true&LAYERS=VHR_IMAGE_2018_Level_3__masked_validity&STYLES=&time=2017-04-14T13%3A49%3A45Z%2F2018-09-05T00%3A00%3A00Z&WIDTH=256&HEIGHT=256&SRS=EPSG%3A4326&BBOX=15.78727912902832,43.005756378173835,16.976377487182617,44.05855560302735>`_
+
+WCS
+^^^
+
+* `Capabilities <https://vhr18.pdas.prism.eox.at/ows?service=wcs&request=getcapabilities>`_
+* `Coverage set description <https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=DescribeEOCoverageSet&eoId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7>`_
+* `Coverage description <https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=DescribeCoverage&coverageId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage>`_
+* `Full in default configuration <https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=GetCoverage&coverageId=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage>`_
+* `Spatial subset <https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=GetCoverage&coverageid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage&subset=long(26.004538536944892,26.016211510577705)&subset=lat(47.326254844665534,47.33495235268493)&subsettingCRS=http://www.opengis.net/def/crs/EPSG/0/4326>`_
+* `Range subset <https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=GetCoverage&coverageid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage&rangesubset=nir>`_
+* `Scale down <https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=GetCoverage&coverageid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage&scaleFactor=0.1>`_
+* `Format and interpolation <https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=GetCoverage&coverageid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage&format=image/jp2&interpolation=http://www.opengis.net/def/interpolation/OGC/1/nearest-neighbour>`_
+* `Projection <https://vhr18.pdas.prism.eox.at/ows?service=WCS&version=2.0.1&request=GetCoverage&coverageid=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7__coverage&outputCRS=http://www.opengis.net/def/crs/EPSG/0/4326>`_
+
+DSEO
+^^^^
+
+* `One product <https://vhr18.pdas.prism.eox.at/ows?service=DSEO&version=1.0.0&request=GetProduct&ProductURI=urn:eop:DOVE:MULTISPECTRAL_4m:20180811_081455_1054_3be7>`_
--- a/documentation/usage-guide/searching.rst
+++ b/documentation/usage-guide/searching.rst
+.. _searching:
+
 Searching
 =========

@@ -8,11 +10,11 @@ TODO add links to spec

 The OpenSearch URL endpoints are:

- * `/opensearch`: Main service description
- * `/opensearch/<format>`: Search for collections in a specific format
- * `/opensearch/collections/<collection-id>`: Collection specific description
- * `/opensearch/collections/<collection-id>/<format>`: Search for products in
-   a collection in that format
+* `/opensearch`: Main service description
+* `/opensearch/<format>`: Search for collections in a specific format
+* `/opensearch/collections/<collection-id>`: Collection specific description
+* `/opensearch/collections/<collection-id>/<format>`: Search for products in
+  a collection in that format

 The description related entrypoints provide an OpenSearch Description Document
 (OSDD). This XML based file format describes general service metadata and
@@ -22,10 +24,10 @@ These URL objects provide templates that can be filled with
 parameters to submit actual metadata queries. Depending on the used
 URL, the search result is returned in one of the following formats:

- * `atom`: Atom syndication format
- * `rss`: RSS
- * `kml`: Keyhole Markup Language
- * `json`: GeoJSON
+* `atom`: Atom syndication format
+* `rss`: RSS
+* `kml`: Keyhole Markup Language
+* `json`: GeoJSON

 The resulting items in that result document can be paged. Specific
 pages can be retrieved using the `offset` and `count` parameters.
@@ -42,7 +44,8 @@ products, containing links to thumbnails, browses and product specific
 services such as WMS or WCS. Additionally it contains the products
 acquisition footprint and timestamp.

-## Filters
+Filters
+-------

 The URL templates for both the collection and the record search allow
 to pass parameters that control the query and shape of the search.

--- a/documentation/usage-guide/viewing.rst
+++ b/documentation/usage-guide/viewing.rst
+.. _viewing:
+
 Viewing
 =======

+/cache endpoint for most performing requests fixed to predefined layers

+/ows endpoint for flexible requests e.g. customize stretch
--- a/documentation/usage-guide/web-client.rst
+++ b/documentation/usage-guide/web-client.rst
+.. _web_client:
+
 Web Client
 ==========

@@ -91,6 +93,8 @@ styling, etc.).

   *Web Client - Current view*

+.. _timeslider:
+
 Timeslider
 ----------

@@ -98,7 +102,7 @@ The *timeslider* presents the distribution of products in time via a *bar* (see
 :numref:`fig_webclient_timeslider`) or an *aggregated dots* (see
 :numref:`fig_webclient_timeslider_dots`) graph. The visualization mode used
 (*bars* or *dots*) is based on the total number of products available for the
-shown time duration.
+shown time interval.

 .. _fig_webclient_timeslider:
 .. figure:: images/webclient_tutorial_03_timeslider.*
@@ -130,38 +134,115 @@ The interactive *timeslider* can be used in the following ways:
 * *zooming the map to a combined minimum bounding box of all products in a dot
  group*: click on the dot group

+.. _search_results:
+
 Search Results
 --------------

-Right part of the map window contains a panel with *Search Results* for each enabled layer based on current area, time and additional filters. Items in the panel are sorted based on order in which the catalog returns them (by default from the oldest to the newest).
+The panel in the right part of the map window has a tab showing the *Search
+Results* grouped by enabled layer(s). The search is defined by the currently
+visible geographic area or spatial filter, selected time interval, and
+additional filters if set. Items in the list are sorted as the catalog returns
+them which typically is from the oldest to the newest.
+
+.. figure:: images/webclient_tutorial_04_search-results.*
+   :alt: Web Client Tutorial - Search Results

-Search can be enabled and disabled for each displayed layer individually by clicking on the large button *X layers selected to show n/n* and clicking on corresponding layer entry or by clicking on the *Search* toggle if only Single Layer is configured.
+   *Web Client Tutorial - Search Results*

-You can inspect metadata and alternative visualization of individual images by hovering over an item and hitting *info* icon. That opens a new overlay panel with *details display*. (see Details Display below)
+Searching can be disabled and enabled again for each displayed layer
+individually by clicking on the large button labeled *N layer(s) selected to
+show n/n* and clicking on the corresponding layer entry (see
+:numref:`fig_webclient_toggle_search`) or by clicking on the *Search* toggle
+(see :numref:`fig_webclient_toggle_search_single`) if only a single layer is
+configured.

-By clicking on individual images, you can insert or remove them from selection for download.
+.. _fig_webclient_toggle_search:
+.. figure:: images/webclient_toggle-search.*
+   :alt: Web Client - Toggle search

-Catalog search from the web client is scaled for performance and only a limited number of items is returned from the first search. In order to query for more items if available, click on *Load n more* button. *Select all* button adds all currently listed items to the collection of selected for download.
+   *Web Client - Toggle search*

-Clicking on the *link* button next to the layer name, it is possible to save the search query results. To download the respective XML file click with the right mouse button on the link and then *Save Link As...*.
+.. _fig_webclient_toggle_search_single:
+.. figure:: images/webclient_toggle-search-single.*
+   :alt: Web Client - Toggle search single layer

-Items selected for download can be viewed in the *Basket* tab or *Selected* button (Single Layer mode) on the right panel. In order to remove them from the selection, you can hover on them and click on the *minus* icon.
+   *Web Client - Toggle search single layer*

-.. figure:: images/webclient_tutorial_04_search-results.*
-   :alt: Web Client Tutorial - Search Results
+Metadata and alternative visualizations of individual products can be inspected
+by hovering over an item and hitting the *info* icon either in the search
+results (see :numref:`fig_webclient_info1`) or on the map (see
+:numref:`fig_webclient_info2`). That opens a new overlay panel showing *details
+display* (see :ref:`details_display` below).

-   *Web Client Tutorial - Search Results*
+.. _fig_webclient_info1:
+.. figure:: images/webclient_info1.*
+   :alt: Web Client - Details button 1

-Filters
-------
+   *Web Client - Details button 1*

-There are several possibilities to filter queried satellite data in the *Filters* panel on left side of the window:
+.. _fig_webclient_info2:
+.. figure:: images/webclient_info2.*
+   :alt: Web Client - Details button 2

-1. Spatial query: with Spatial Filter using the Point, Rectangle or Polygon drawing options under *Draw*. By default when no spatial filter is set, current map window extent is used as a spatial filter.
+   *Web Client - Details button 2*

-2. Temporal query with Timeslider tool: Enter Start and End date of your search interval. More information provided in Timeslider section of documentation.
+By clicking on individual items, they can be inserted to or removed from the
+*basket* holding the list of items selected for download.

-3. You can apply additional filters for each layer based on available metadata under "Additional filters" as configured by the operator. Currently "Cloud Coverage" filter is set up.
+.. figure:: images/webclient_add-to-basket.*
+   :alt: Web Client - Add item to basket
+
+   *Web Client - Add item to basket*
+
+Searching from the web client is throttled for performance and only a limited
+number of items is shown from the first search. Additional items, if available,
+are shown by clicking the button labeled *Load n more*.
+
+The *Select all* button adds all currently listed items to the *basket*.
+
+The *link* button next to the layer name shows the current search query. To
+download the results XML file click with the right mouse button on the link and
+use the *Save Link As...* menu entry.
+
+.. figure:: images/webclient_search-buttons.*
+   :alt: Web Client - Buttons in search panel
+
+   *Web Client - Buttons in search panel*
+
+Items selected for download can be viewed in the *Basket* tab (see
+:numref:`fig_webclient_basket1`) or *Selected* button (see
+:numref:`fig_webclient_basket2`, single layer mode) on the right panel. To
+remove an item from the selection use the *minus* icon visible while hovering
+over it.
+
+.. _fig_webclient_basket1:
+.. figure:: images/webclient_basket1.*
+   :alt: Web Client - Basket
+
+   *Web Client - Basket*
+
+.. _fig_webclient_basket2:
+.. figure:: images/webclient_basket2.*
+   :alt: Web Client - Selected
+
+   *Web Client - Selected*
+
+Filters
+-------
+
+There are several options to add explicit filters to product queries in the
+*Filters* tab in the left panel:
+
+* *Spatial filter*: allows drawing a Point, Rectangle, or Polygon directly on
+  the map. By default when no explicit spatial filter is set, the current map
+  window extent is used as a spatial filter.
+* *Time filter*: by default the time filter, a simple time interval, is
+  configured via the :ref:`timeslider`. If enabled, the time filter tool allows
+  a fine grained configuration of the time interval to use for searching.
+* *Additional filters*: based on the configuration provided by the operator
+  additional filters for each layer based on available metadata like "Cloud
+  Coverage" might be available.

 .. figure:: images/webclient_tutorial_05_filters.*
   :alt: Web Client Tutorial - Filters
@@ -171,58 +252,119 @@ There are several possibilities to filter queried satellite data in the *Filters
 Map Layers
 ----------

-*Layers* panel on left side enables setting the *Overlay*, *Layer* and *Base Layer* groups currently visualized.
+The *Layers* tab in the left panel enables configuring *Overlays*, *Layers*,
+and *Base Layers* to be shown.

-*Base Layer* and *Overlay* groups enable choosing the background, text labels and other footprints to be viewed on the map window for easier orientation.
+.. figure:: images/webclient_tutorial_06_map-layers.*
+   :alt: Web Client Tutorial - Map Layers

-*Layer* group presents selected data sets and its products or products levels (e.g. VHR Image 2018 Level 1).
+   *Web Client Tutorial - Map Layers*

-You can change the order of the layers by dragging the arrows corresponding to each layer up and down. This influences the order of rendering on the map and order of representation of layers in Timeslider.
+*Base Layers* provide various backgrounds whereas *Overlays* are text labels or
+other information like footprints to view on top of products for easier
+orientation on the *map*. They can be enabled and disabled individually as
+needed via the *eye* icon next to their name.

-Individual layers can be fully disabled and enabled by the *eye* icon next to its name.
+*Layers* correspond to product collections or datasets. Searching is performed
+on enabled layers.

-Changing the visualization (styling) of layers can be done by clicking on the *paint brush* icon next to the layer name. An afterwards displayed popup window enables setting the opacity and one of pre-configured styles for the layer.
+The order of *layers* can be changed by dragging the arrows next to each layer
+up and down. This influences the order of the rendering on the *map* as well as
+in the *timeslider*.

-.. figure:: images/webclient_tutorial_06_map-layers.*
-   :alt: Web Client Tutorial - Map Layers
+The visualization (styling) of *layers* can be changed by clicking on the *paint
+brush* icon next to the layer name. The displayed overlay enables setting the
+layer's opacity and selecting one of the predefined styles for the layer.

-   *Web Client Tutorial - Map Layers*
+.. figure:: images/webclient_layer-configuration.*
+   :alt: Web Client - Layer configuration

-Details Display
---------------
+   *Web Client - Layer configuration*

-In order to view details display panel for a single selected product, either click on the *info* (i) icon after clicking on the product footprint on the map or product entry in Search Results panel.
+.. _details_display:

-Newly opened overlay displays a map window with a set visualization and linked metadata. It also contains links to several product related OGC compliant services requests (WMS, WCS etc). More information can be found in *sample-requests* usage-guide chapter.
-
-Visualization (opacity and style) for this map window can be changed after clicking on the *Visualization* button in top left corner.
+Details Display
+---------------

-Product can be added to selection for download by enabling the respective checkbox in the bottom right of the panel.
+In order to view details of individual products, either click on the *info* (i)
+icon after clicking on the product footprint on the map or the product entry in
+the *Search Results* panel.

 .. figure:: images/webclient_details_display.*
   :alt: Web Client Details Display panel

   *Web Client Details Display*

-.. _weblient_download:
+An overlay display will open showing the product metadata as well as the product
+itself on a map. The product metadata contains links to visualize and download
+the metadata and product. Those links are OGC standards compliant service
+requests for OpenSearch (see chapter :ref:`searching`), WMS (see chapter
+:ref:`viewing`), WCS, and DSEO (both see chapter :ref:`downloading`). The
+chapter :ref:`sample_requests` provides sample requests for all those services.

-Download
--------
+The following links are provided:

-Several methods of downloading products or only parts of them are made possible by the web client.
+* *Metadata ATOM*: download the product's metadata in ATOM format
+* *Download Package*: download the entire product as stored on object storage
+* *WMS: GetCapabilities*: get the description of the WMS for the individual
+  product for example for inclusion in QGIS
+* *WMS: GetMap*: visualize the individual product using WMS
+* *WCS: DescribeEOCoverageSet* or *WCS: DescribeCoverage*: get the description
+  of the product's coverage in WCS
+* *WCS: GetCoverage*: download the product as coverage potentially after
+  adjusting the URL parameters

-After selecting one or more products for download, you can view a full list of them on the right panel, either on *Search Results* tab via *Selected* button if only one layer is pre-configured or on *Basket* tab if more layers were configured for display.
+The visualization (opacity and style) of the product layer for this map window
+can be changed via the *Visualization* button in the top left corner.

-In order to download a full product (image and linked metadata file) or a full coverage (just the image), view Details Display of that product using the *info* icon and click on a respective *Download Package* or *WCS: GetCoverage* links on the left side of newly shown overlay. These lead to default *Get Product* or *Get Coverage* WCS requests for that specific product and shall start respective downloads.
+The product itself can be added to the *basket* by ticking the check box in the
+bottom right of the panel.

-In order to download more than one product in parallel, after selecting several products for download, you can click on *Download* or *Download as* buttons on the right panel of the web client.
-
- *Download as* currently offers a *Download as URL-List* option which downloads a *.txt* file with a list of download links (*Get Coverage* requests) and *Download as Metalink* allowing for possibly increased speed via segment downloading by metalink-aware software.
+.. _weblient_download:

- *Download* option opens a new popup panel allowing to select additional parameters (resolution, format, scaling or subsetting) of resulting images. If multiple products are to be downloaded, selected options are applied for all of them. In order to confirm selected options and attempt to start download, click on *Download* button. Note, the browser might open multiple confirmation dialogs or issue a warning. Besides, modern browsers have a limit of 6 concurrent connections. If popups are blocked by your browser, please enable them for this site.
+Download
+--------

+Several methods for downloading products or only parts of them are exploited by
+the web client.
+
+After putting one or more products in the *basket* or selecting them for
+download, they are listed in the right panel, either on the *Search Results* tab
+via the *Selected* button or on the *Basket* tab (see section
+:ref:`search_results` particularly :numref:`fig_webclient_basket1` and
+:numref:`fig_webclient_basket2` above).
+
+To download a full product (image and linked metadata) or a full coverage (just
+the image), the *Details Display* of the respective product can be used (see
+chapter :ref:`details_display` above).
+
+To download all selected products in parallel the *Download* or *Download as*
+buttons on the right panel of the web client can be used.
+
+.. figure:: images/webclient_download-buttons.*
+   :alt: Web Client - Download multiple products
+
+   *Web Client - Download multiple products*
+
+* *Download as*: offers a *Download as URL-List* option which downloads a *.txt*
+  file with a list of download links (*Get Coverage* requests) and a *Download
+  as Metalink* option allowing for possibly increased speed via segment
+  downloading by metalink-aware software.
+* *Download*: opens an overlay panel allowing to specify download parameters
+  for subsetting, projection, format, interpolation, and resolution or scaling
+  as shown in :numref:`webclient_download_multiple` below. When multiple
+  products are to be downloaded, the configured options are applied to all of
+  them. Clicking the *Download* button confirms the selected options and
+  initiates the downloads. Note, the browser might open multiple confirmation
+  dialogs or issue a warning. Besides, modern browsers have a limit of 6
+  concurrent connections. Popups might need to be explicitly allowed for this
+  site.
+
+.. _webclient_download_multiple:
 .. figure:: images/webclient_download_multiple.*
-   :alt: Web Client Download multiple files popup
-   :height: 450px
+   :alt: Web Client - Download multiple products via WCS
+
+   *Web Client - Download multiple products via WCS*

-   *Web Client Download multiple files*
+The following chapters describe the services offered for :ref:`searching`,
+:ref:`viewing`, as well as :ref:`downloading`.