diff --git a/doc/source/_static/custom.css b/doc/source/_static/custom.css
new file mode 100644
index 0000000000000000000000000000000000000000..4469e0907e3704a5e76f872d247dd28c7c020a0d
--- /dev/null
+++ b/doc/source/_static/custom.css
@@ -0,0 +1,29 @@
+.menuselection {
+ border:1px dashed #7fbbe366;
+ background:#f1f9ff;
+ font-size:95%;
+ font-weight:700;
+ border-radius:1px;
+ padding:2.4px 5px;
+ margin:auto 2px
+}
+
+.rst-content .guilabel {
+ border:1px solid #7fbbe366;
+ background:#f1f9ff;
+ font-size:95%;
+ font-weight:700;
+ border-radius:1px;
+ padding:2.4px 5px;
+ margin:auto 2px
+}
+
+.kbd {
+ font-weight: bold;
+ border: 1px solid #ddd;
+ background: #eee;
+ color: #E22;
+ border-radius:3px;
+ padding-left: 3px;
+ padding-right: 3px;
+}
\ No newline at end of file
diff --git a/doc/source/conf.py b/doc/source/conf.py
index 3ad7f914a88f5e4c00f49cda5c41047a81cdb1a9..d177ea1702889fe305cbaa4a4a56d392ad3e0c99 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -167,6 +167,8 @@ html_favicon = 'img/logo.png'
# so a file named "default.css" will overwrite the builtin "default.css".
html_static_path = ['_static']
+html_css_files = ['custom.css']
+
# Custom sidebar templates, must be a dictionary that maps document names
# to template names.
#
diff --git a/doc/source/gallery.rst b/doc/source/gallery.rst
index 4357af1fedb411fae0906ba73414f5759c120eb1..0f32724e66395e15541af0bb69d84058c17cbc4f 100644
--- a/doc/source/gallery.rst
+++ b/doc/source/gallery.rst
@@ -5,12 +5,49 @@ Gallery
This section gives you a visual glimpse at the functionalities of the Time Series Viewer plugin
-Customizable crosshair
-----------------------
-.. figure:: img/gallery_crosshair.PNG
+Multiple Map Views
+------------------
- Detailed and fully customizable crosshair with pixel highlighting and scale bar
+.. figure:: img/gallery_multipleviews.png
+ :width: 100%
+
+ Visualize a time series in several map views, for example to show a different band combination or highlight additional layers
+
+Temporal plots
+--------------
+
+.. figure:: img/example_2dprofile.png
+ :width: 100%
+
+ Visualize temporal profiles at selected (in the map canvas) or imported (from a shapefile) locations and transform
+ the values on-the-fly for plotting
+
+Spectral plots
+--------------
+
+.. figure:: img/gallery_speclib.png
+ :width: 100%
+
+ Visualize and manage spectral profiles in a comprehensive spectral library tool
+
+.. label time series
+
+
+Labeling
+--------
+
+.. figure:: img/gallery_labeling.png
+
+ Label your time series using a vector dataset and interactively zoom/pan to selected features in the map canvas
+
+Image crosshair
+---------------
+
+.. figure:: img/gallery_crosshair.png
+ :height: 500px
+
+ Detailed and fully customizable crosshair with pixel highlighting and scale bar
diff --git a/doc/source/icon_links.rst b/doc/source/icon_links.rst
new file mode 100644
index 0000000000000000000000000000000000000000..944b194eebb1dd0f0483e060bd62ebcdbc29942c
--- /dev/null
+++ b/doc/source/icon_links.rst
@@ -0,0 +1,272 @@
+.. |ActionIdentifyTimeSeries| image:: /../../eotimeseriesviewer/ui/icons/ActionIdentifyTimeSeries.svg
+ :width: 28px
+.. |add_class| image:: /../../eotimeseriesviewer/ui/icons/add_class.svg
+ :width: 28px
+.. |copyright_label| image:: /../../eotimeseriesviewer/ui/icons/copyright_label.svg
+ :width: 28px
+.. |crosshair| image:: /../../eotimeseriesviewer/ui/icons/crosshair.svg
+ :width: 28px
+.. |CRS| image:: /../../eotimeseriesviewer/ui/icons/CRS.svg
+ :width: 28px
+.. |general| image:: /../../eotimeseriesviewer/ui/icons/general.svg
+ :width: 28px
+.. |icon| image:: /../../eotimeseriesviewer/ui/icons/icon.svg
+ :width: 28px
+.. |IconTimeSeries| image:: /../../eotimeseriesviewer/ui/icons/IconTimeSeries.svg
+ :width: 28px
+.. |locked| image:: /../../eotimeseriesviewer/ui/icons/locked.svg
+ :width: 28px
+.. |lockedGray| image:: /../../eotimeseriesviewer/ui/icons/lockedGray.svg
+ :width: 28px
+.. |logo_hub| image:: /../../eotimeseriesviewer/ui/icons/logo_hub.svg
+ :width: 28px
+.. |mActionAdd| image:: /../../eotimeseriesviewer/ui/icons/mActionAdd.svg
+ :width: 28px
+.. |mActionAddMapView| image:: /../../eotimeseriesviewer/ui/icons/mActionAddMapView.svg
+ :width: 28px
+.. |mActionAddOgrLayer| image:: /../../eotimeseriesviewer/ui/icons/mActionAddOgrLayer.svg
+ :width: 28px
+.. |mActionAddRasterLayer| image:: /../../eotimeseriesviewer/ui/icons/mActionAddRasterLayer.svg
+ :width: 28px
+.. |mActionAddTS| image:: /../../eotimeseriesviewer/ui/icons/mActionAddTS.svg
+ :width: 28px
+.. |mActionAddVirtualRaster| image:: /../../eotimeseriesviewer/ui/icons/mActionAddVirtualRaster.svg
+ :width: 28px
+.. |mActionAtlasFirst| image:: /../../eotimeseriesviewer/ui/icons/mActionAtlasFirst.svg
+ :width: 28px
+.. |mActionAtlasLast| image:: /../../eotimeseriesviewer/ui/icons/mActionAtlasLast.svg
+ :width: 28px
+.. |mActionAtlasNext| image:: /../../eotimeseriesviewer/ui/icons/mActionAtlasNext.svg
+ :width: 28px
+.. |mActionAtlasPrev| image:: /../../eotimeseriesviewer/ui/icons/mActionAtlasPrev.svg
+ :width: 28px
+.. |mActionCollapseTree| image:: /../../eotimeseriesviewer/ui/icons/mActionCollapseTree.svg
+ :width: 28px
+.. |mActionCopySelected| image:: /../../eotimeseriesviewer/ui/icons/mActionCopySelected.png
+ :width: 28px
+.. |mActionEditCopy| image:: /../../eotimeseriesviewer/ui/icons/mActionEditCopy.svg
+ :width: 28px
+.. |mActionEditPaste| image:: /../../eotimeseriesviewer/ui/icons/mActionEditPaste.svg
+ :width: 28px
+.. |mActionExpandTree| image:: /../../eotimeseriesviewer/ui/icons/mActionExpandTree.svg
+ :width: 28px
+.. |mActionFileSave| image:: /../../eotimeseriesviewer/ui/icons/mActionFileSave.svg
+ :width: 28px
+.. |mActionFileSaveAs| image:: /../../eotimeseriesviewer/ui/icons/mActionFileSaveAs.svg
+ :width: 28px
+.. |mActionIdentify| image:: /../../eotimeseriesviewer/ui/icons/mActionIdentify.svg
+ :width: 28px
+.. |mActionOpenTable| image:: /../../eotimeseriesviewer/ui/icons/mActionOpenTable.svg
+ :width: 28px
+.. |mActionPan| image:: /../../eotimeseriesviewer/ui/icons/mActionPan.svg
+ :width: 28px
+.. |mActionRefresh| image:: /../../eotimeseriesviewer/ui/icons/mActionRefresh.svg
+ :width: 28px
+.. |mActionRemove| image:: /../../eotimeseriesviewer/ui/icons/mActionRemove.svg
+ :width: 28px
+.. |mActionRemoveMapView| image:: /../../eotimeseriesviewer/ui/icons/mActionRemoveMapView.svg
+ :width: 28px
+.. |mActionRemoveTS| image:: /../../eotimeseriesviewer/ui/icons/mActionRemoveTS.svg
+ :width: 28px
+.. |mActionRemoveTSD| image:: /../../eotimeseriesviewer/ui/icons/mActionRemoveTSD.svg
+ :width: 28px
+.. |mActionRemoveVirtualRaster| image:: /../../eotimeseriesviewer/ui/icons/mActionRemoveVirtualRaster.svg
+ :width: 28px
+.. |mActionSaveTS| image:: /../../eotimeseriesviewer/ui/icons/mActionSaveTS.svg
+ :width: 28px
+.. |mActionShowAllLayers| image:: /../../eotimeseriesviewer/ui/icons/mActionShowAllLayers.svg
+ :width: 28px
+.. |mActionZoomActual| image:: /../../eotimeseriesviewer/ui/icons/mActionZoomActual.svg
+ :width: 28px
+.. |mActionZoomFullExtent| image:: /../../eotimeseriesviewer/ui/icons/mActionZoomFullExtent.svg
+ :width: 28px
+.. |mActionZoomIn| image:: /../../eotimeseriesviewer/ui/icons/mActionZoomIn.svg
+ :width: 28px
+.. |mActionZoomOut| image:: /../../eotimeseriesviewer/ui/icons/mActionZoomOut.svg
+ :width: 28px
+.. |mActionZoomPoint| image:: /../../eotimeseriesviewer/ui/icons/mActionZoomPoint.svg
+ :width: 28px
+.. |mActionZoomToArea| image:: /../../eotimeseriesviewer/ui/icons/mActionZoomToArea.svg
+ :width: 28px
+.. |mActionZoomToLayer| image:: /../../eotimeseriesviewer/ui/icons/mActionZoomToLayer.svg
+ :width: 28px
+.. |mActionZoomToSelected| image:: /../../eotimeseriesviewer/ui/icons/mActionZoomToSelected.svg
+ :width: 28px
+.. |map| image:: /../../eotimeseriesviewer/ui/icons/map.svg
+ :width: 28px
+.. |mapCenterExport| image:: /../../eotimeseriesviewer/ui/icons/mapCenterExport.svg
+ :width: 28px
+.. |mapCenterImport| image:: /../../eotimeseriesviewer/ui/icons/mapCenterImport.svg
+ :width: 28px
+.. |mapExtentExport| image:: /../../eotimeseriesviewer/ui/icons/mapExtentExport.svg
+ :width: 28px
+.. |mapExtentImport| image:: /../../eotimeseriesviewer/ui/icons/mapExtentImport.svg
+ :width: 28px
+.. |mapview| image:: /../../eotimeseriesviewer/ui/icons/mapview.svg
+ :width: 28px
+.. |mapview2| image:: /../../eotimeseriesviewer/ui/icons/mapview2.svg
+ :width: 28px
+.. |mapviewHidden| image:: /../../eotimeseriesviewer/ui/icons/mapviewHidden.svg
+ :width: 28px
+.. |metadata| image:: /../../eotimeseriesviewer/ui/icons/metadata.svg
+ :width: 28px
+.. |mIconClear| image:: /../../eotimeseriesviewer/ui/icons/mIconClear.svg
+ :width: 28px
+.. |mIconClearText| image:: /../../eotimeseriesviewer/ui/icons/mIconClearText.svg
+ :width: 28px
+.. |mIconClose| image:: /../../eotimeseriesviewer/ui/icons/mIconClose.svg
+ :width: 28px
+.. |mIconCollapse| image:: /../../eotimeseriesviewer/ui/icons/mIconCollapse.svg
+ :width: 28px
+.. |mIconExpand| image:: /../../eotimeseriesviewer/ui/icons/mIconExpand.svg
+ :width: 28px
+.. |mIconFieldTime| image:: /../../eotimeseriesviewer/ui/icons/mIconFieldTime.svg
+ :width: 28px
+.. |mIconPolygonLayer| image:: /../../eotimeseriesviewer/ui/icons/mIconPolygonLayer.svg
+ :width: 28px
+.. |mIconRaster| image:: /../../eotimeseriesviewer/ui/icons/mIconRaster.svg
+ :width: 28px
+.. |mIconRasterClassification| image:: /../../eotimeseriesviewer/ui/icons/mIconRasterClassification.svg
+ :width: 28px
+.. |mIconRasterImage| image:: /../../eotimeseriesviewer/ui/icons/mIconRasterImage.svg
+ :width: 28px
+.. |mIconRasterMask| image:: /../../eotimeseriesviewer/ui/icons/mIconRasterMask.svg
+ :width: 28px
+.. |mIconRasterRegression| image:: /../../eotimeseriesviewer/ui/icons/mIconRasterRegression.svg
+ :width: 28px
+.. |mIconSelectTemporalProfile| image:: /../../eotimeseriesviewer/ui/icons/mIconSelectTemporalProfile.svg
+ :width: 28px
+.. |mIconTemporalProfile| image:: /../../eotimeseriesviewer/ui/icons/mIconTemporalProfile.svg
+ :width: 28px
+.. |mIconTemporalProfile2D| image:: /../../eotimeseriesviewer/ui/icons/mIconTemporalProfile2D.svg
+ :width: 28px
+.. |mIconTemporalProfile3D| image:: /../../eotimeseriesviewer/ui/icons/mIconTemporalProfile3D.svg
+ :width: 28px
+.. |mIconTemporalProfileRefresh| image:: /../../eotimeseriesviewer/ui/icons/mIconTemporalProfileRefresh.svg
+ :width: 28px
+.. |mIconVirtualRaster| image:: /../../eotimeseriesviewer/ui/icons/mIconVirtualRaster.svg
+ :width: 28px
+.. |mIconVirtualRaster2| image:: /../../eotimeseriesviewer/ui/icons/mIconVirtualRaster2.svg
+ :width: 28px
+.. |pickrasterspectrum| image:: /../../eotimeseriesviewer/ui/icons/pickrasterspectrum.svg
+ :width: 28px
+.. |profile2speclib| image:: /../../eotimeseriesviewer/ui/icons/profile2speclib.svg
+ :width: 28px
+.. |profile2speclib_auto| image:: /../../eotimeseriesviewer/ui/icons/profile2speclib_auto.svg
+ :width: 28px
+.. |qgis_icon| image:: /../../eotimeseriesviewer/ui/icons/qgis_icon.svg
+ :width: 28px
+.. |qgsMapCenter| image:: /../../eotimeseriesviewer/ui/icons/qgsMapCenter.svg
+ :width: 28px
+.. |remove_class| image:: /../../eotimeseriesviewer/ui/icons/remove_class.svg
+ :width: 28px
+.. |render| image:: /../../eotimeseriesviewer/ui/icons/render.svg
+ :width: 28px
+.. |settings| image:: /../../eotimeseriesviewer/ui/icons/settings.svg
+ :width: 28px
+.. |speclib| image:: /../../eotimeseriesviewer/ui/icons/speclib.svg
+ :width: 28px
+.. |speclib_add| image:: /../../eotimeseriesviewer/ui/icons/speclib_add.svg
+ :width: 28px
+.. |speclib_save| image:: /../../eotimeseriesviewer/ui/icons/speclib_save.svg
+ :width: 28px
+.. |spectralprofile| image:: /../../eotimeseriesviewer/ui/icons/spectralprofile.svg
+ :width: 28px
+.. |stylepreset| image:: /../../eotimeseriesviewer/ui/icons/stylepreset.svg
+ :width: 28px
+.. |symbology| image:: /../../eotimeseriesviewer/ui/icons/symbology.svg
+ :width: 28px
+.. |system| image:: /../../eotimeseriesviewer/ui/icons/system.svg
+ :width: 28px
+.. |center_map| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/center_map.svg
+ :width: 28px
+.. |classinfo| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/classinfo.svg
+ :width: 28px
+.. |classinfo_add| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/classinfo_add.svg
+ :width: 28px
+.. |classinfo_remove| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/classinfo_remove.svg
+ :width: 28px
+.. |crosshair| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/crosshair.svg
+ :width: 28px
+.. |cross_red| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/cross_red.svg
+ :width: 28px
+.. |cursorlocationinfo| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/cursorlocationinfo.svg
+ :width: 28px
+.. |cursor_zoom_fullextent| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/cursor_zoom_fullextent.svg
+ :width: 28px
+.. |cursor_zoom_pixelscale| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/cursor_zoom_pixelscale.svg
+ :width: 28px
+.. |pan_center| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/pan_center.svg
+ :width: 28px
+.. |plus_green| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/plus_green.svg
+ :width: 28px
+.. |plus_green_icon| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/plus_green_icon.svg
+ :width: 28px
+.. |poly2speclib| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/poly2speclib.svg
+ :width: 28px
+.. |profile| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/profile.svg
+ :width: 28px
+.. |profile_add_auto| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/profile_add_auto.svg
+ :width: 28px
+.. |profile_dontreceive| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/profile_dontreceive.svg
+ :width: 28px
+.. |profile_identify| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/profile_identify.svg
+ :width: 28px
+.. |profile_reload| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/profile_reload.svg
+ :width: 28px
+.. |profile_save| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/profile_save.svg
+ :width: 28px
+.. |raster| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/raster.svg
+ :width: 28px
+.. |raster_classification| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/raster_classification.svg
+ :width: 28px
+.. |raster_mask| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/raster_mask.svg
+ :width: 28px
+.. |raster_multispectral| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/raster_multispectral.svg
+ :width: 28px
+.. |raster_timeseries| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/raster_timeseries.svg
+ :width: 28px
+.. |refresh_green| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/refresh_green.svg
+ :width: 28px
+.. |refresh_orange| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/refresh_orange.svg
+ :width: 28px
+.. |selectcursor| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/selectcursor.svg
+ :width: 28px
+.. |select_location| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/select_location.svg
+ :width: 28px
+.. |speclib| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/speclib.svg
+ :width: 28px
+.. |speclib_add| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/speclib_add.svg
+ :width: 28px
+.. |speclib_clear| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/speclib_clear.svg
+ :width: 28px
+.. |speclib_reload| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/speclib_reload.svg
+ :width: 28px
+.. |speclib_save| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/speclib_save.svg
+ :width: 28px
+.. |temporalProfile| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/temporalProfile.svg
+ :width: 28px
+.. |undo_green| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/undo_green.svg
+ :width: 28px
+.. |undo_orange| image:: /../../eotimeseriesviewer/externals/qps/ui/icons/undo_orange.svg
+ :width: 28px
+.. |action| image:: /img/qgis_icons/action.svg
+ :width: 28px
+.. |mActionCapturePolygon| image:: /img/qgis_icons/mActionCapturePolygon.svg
+ :width: 28px
+.. |mActionDeleteAttribute| image:: /img/qgis_icons/mActionDeleteAttribute.svg
+ :width: 28px
+.. |mActionDeleteSelected| image:: /img/qgis_icons/mActionDeleteSelected.svg
+ :width: 28px
+.. |mActionNewAttribute| image:: /img/qgis_icons/mActionNewAttribute.svg
+ :width: 28px
+.. |mActionPropertiesWidget| image:: /img/qgis_icons/mActionPropertiesWidget.svg
+ :width: 28px
+.. |mActionSaveEdits| image:: /img/qgis_icons/mActionSaveEdits.svg
+ :width: 28px
+.. |mActionSelectRectangle| image:: /img/qgis_icons/mActionSelectRectangle.svg
+ :width: 28px
+.. |mActionSetProjection| image:: /img/qgis_icons/mActionSetProjection.svg
+ :width: 28px
+.. |mActionToggleEditing| image:: /img/qgis_icons/mActionToggleEditing.svg
+ :width: 28px
diff --git a/doc/source/img/cursorlocationvalues.png b/doc/source/img/cursorlocationvalues.png
new file mode 100644
index 0000000000000000000000000000000000000000..a0e710e5c1b33a5a9ad90ba3bcd2d2ceed7726a5
Binary files /dev/null and b/doc/source/img/cursorlocationvalues.png differ
diff --git a/doc/source/img/gallery_crosshair.PNG b/doc/source/img/gallery_crosshair.PNG
index c4799df0b57fd7400b47d16f3cb6f4ec561dbc5a..b368187b82d21c8fbeb8b5b198cce3600ae53622 100644
Binary files a/doc/source/img/gallery_crosshair.PNG and b/doc/source/img/gallery_crosshair.PNG differ
diff --git a/doc/source/img/gallery_labeling.png b/doc/source/img/gallery_labeling.png
new file mode 100644
index 0000000000000000000000000000000000000000..29d5bed9176f6419ee3e8bc167508b218ae91fd4
Binary files /dev/null and b/doc/source/img/gallery_labeling.png differ
diff --git a/doc/source/img/gallery_multipleviews.png b/doc/source/img/gallery_multipleviews.png
new file mode 100644
index 0000000000000000000000000000000000000000..9724440ff23367b3a0ead9eaa40e055b940ac191
Binary files /dev/null and b/doc/source/img/gallery_multipleviews.png differ
diff --git a/doc/source/img/gallery_speclib.png b/doc/source/img/gallery_speclib.png
new file mode 100644
index 0000000000000000000000000000000000000000..d72b1ee5b8abec16234ffd1b334a3e944449a3f3
Binary files /dev/null and b/doc/source/img/gallery_speclib.png differ
diff --git a/doc/source/img/install_plugin.png b/doc/source/img/install_plugin.png
new file mode 100644
index 0000000000000000000000000000000000000000..c3bd60cc3b729504e435f63951dc1aa60d0bab13
Binary files /dev/null and b/doc/source/img/install_plugin.png differ
diff --git a/doc/source/img/interface.png b/doc/source/img/interface.png
index 9c66b07d7c2bae40533723771a7d01827b8142a5..0f4128cfe0fc223099d6d84a50a5049a59df385b 100644
Binary files a/doc/source/img/interface.png and b/doc/source/img/interface.png differ
diff --git a/doc/source/img/layerproperties.png b/doc/source/img/layerproperties.png
new file mode 100644
index 0000000000000000000000000000000000000000..7832c4500d48316fa5657f103497ae0fc8cde61a
Binary files /dev/null and b/doc/source/img/layerproperties.png differ
diff --git a/doc/source/img/mapproperties.png b/doc/source/img/mapproperties.png
new file mode 100644
index 0000000000000000000000000000000000000000..f7c405691400571f872ed3b54b1595cd7c8c59e4
Binary files /dev/null and b/doc/source/img/mapproperties.png differ
diff --git a/doc/source/img/mapviewbutton.png b/doc/source/img/mapviewbutton.png
new file mode 100644
index 0000000000000000000000000000000000000000..8d3b9d779bb445913fd67c8b2d9ae934e106afca
Binary files /dev/null and b/doc/source/img/mapviewbutton.png differ
diff --git a/doc/source/img/qgis_icons/action.svg b/doc/source/img/qgis_icons/action.svg
new file mode 100644
index 0000000000000000000000000000000000000000..aec920db42448d370c2994ae564ffd19aa1c6362
--- /dev/null
+++ b/doc/source/img/qgis_icons/action.svg
@@ -0,0 +1,51 @@
+<svg height="48" width="48" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+<linearGradient id="a" gradientUnits="userSpaceOnUse" x1="64" x2="64" y1="21.941" y2="104.06">
+<stop offset="0" stop-color="#dadada"/>
+<stop offset="1" stop-color="#ccc"/>
+</linearGradient>
+<linearGradient id="b" gradientUnits="userSpaceOnUse" x1="64" x2="64" xlink:href="#a" y1="21.523" y2="103.07">
+<stop offset="0" stop-color="#d9d9d9"/>
+<stop offset="1" stop-color="#ccc"/>
+</linearGradient>
+<linearGradient id="c" gradientTransform="scale(.375)" gradientUnits="userSpaceOnUse" x1="64" x2="64" y1="6.8743" y2="117.23">
+<stop offset="0" stop-color="#f2f2f2"/>
+<stop offset="1" stop-color="#d8d8d8"/>
+</linearGradient>
+<linearGradient id="d" gradientTransform="matrix(.28343236 -.12030991 .12010907 .2829592 2.4859227 9.1250937)" gradientUnits="userSpaceOnUse" x1="64" x2="64" xlink:href="#b" y1="21.523" y2="103.07"/>
+<linearGradient id="e" gradientTransform="matrix(.28343236 -.12030991 .12010907 .2829592 2.4859227 9.1250937)" gradientUnits="userSpaceOnUse" x1="49.273" x2="49.374" xlink:href="#b" y1="22.275" y2="102.05"/>
+<linearGradient id="f" gradientTransform="matrix(.24558489 -.10424462 .10406965 .2451728 6.0097698 10.691978)" gradientUnits="userSpaceOnUse" x1="64" x2="64" xlink:href="#a" y1="21.941" y2="104.06"/>
+<linearGradient id="g">
+<stop offset="0" stop-color="#fff"/>
+<stop offset="1" stop-color="#959595"/>
+</linearGradient>
+<linearGradient id="h" gradientTransform="matrix(.24558489 -.10424462 .10406965 .2451728 6.0097698 10.691978)" gradientUnits="userSpaceOnUse" x1="86.133" x2="84.639" xlink:href="#g" y1="105.1" y2="20.895"/>
+<linearGradient id="i" gradientTransform="matrix(.2862028 -.1214859 .1214859 .2862028 2.4198026 9.4751138)" gradientUnits="userSpaceOnUse" x1="64" x2="64" xlink:href="#c" y1="6.8743" y2="117.23"/>
+<linearGradient id="j">
+<stop offset="0"/>
+<stop offset="1" stop-opacity="0"/>
+</linearGradient>
+<radialGradient id="k" cx="6.7027" cy="73.616" gradientTransform="matrix(2.5234219 0 0 .80403758 11.273995 -25.022728)" gradientUnits="userSpaceOnUse" r="7.2284" xlink:href="#j"/>
+<linearGradient id="l" gradientTransform="matrix(.1403734 0 0 .14013905 .49993623 29.332891)" gradientUnits="userSpaceOnUse" x1="64" x2="64" xlink:href="#m" y1="21.523001" y2="103.07"/>
+<linearGradient id="m" gradientUnits="userSpaceOnUse" x1="64" x2="64" xlink:href="#a" y1="21.523001" y2="103.07">
+<stop offset="0" stop-color="#d9d9d9"/>
+<stop offset="1" stop-color="#ccc"/>
+</linearGradient>
+<linearGradient id="n" gradientTransform="matrix(.1403734 0 0 .14013905 .49993623 29.332891)" gradientUnits="userSpaceOnUse" x1="49.272999" x2="49.374001" xlink:href="#m" y1="22.275" y2="102.05"/>
+<linearGradient id="o" gradientTransform="matrix(.12162898 0 0 .12142486 1.6996094 30.618141)" gradientUnits="userSpaceOnUse" x1="64" x2="64" xlink:href="#a" y1="21.941" y2="104.06"/>
+<linearGradient id="p" gradientTransform="matrix(.12162898 0 0 .12142486 1.6996094 30.618141)" gradientUnits="userSpaceOnUse" x1="86.133003" x2="84.639" xlink:href="#g" y1="105.1" y2="20.895"/>
+<linearGradient id="q" gradientTransform="matrix(.1417455 0 0 .1417455 .40983923 29.467999)" gradientUnits="userSpaceOnUse" x1="64" x2="64" xlink:href="#c" y1="6.8743" y2="117.23"/>
+<radialGradient id="r" cx="6.7027001" cy="73.615997" gradientTransform="matrix(1.1504064 0 0 .36655385 1.770596 17.977542)" gradientUnits="userSpaceOnUse" r="7.2284002" xlink:href="#j"/>
+<path d="m46.428617 34.167207c0 3.210347-8.166817 5.812121-18.240606 5.812121-10.073788 0-18.2406052-2.601774-18.2406052-5.812121 0-3.209849 8.1665682-5.811955 18.2406052-5.811955 10.074038 0 18.240606 2.602106 18.240606 5.811955z" fill="url(#k)" opacity=".4"/>
+<path d="m41.930076 9.0998299l-1.294709.5495634c-.349438.1483327-.876722.0295191-1.128124-.2539308-.013608-.0145156-1.628733-1.6030502-1.628733-1.6030502-.30397-.2598665-.432455-.7831781-.290228-1.1347506l.52752-1.3025285c.121098-.2995787.118298-.6292893-.008567-.9281609-.126879-.29891-.362098-.5299628-.661614-.6506862l-5.131854-2.0678384c-.29977-.1205441-.629773-.1171055-.929082.00959-.299406.1270894-.531116.3620501-.652211.6616272l-.527139 1.3023676c-.142739.351251-.599757.6390089-.978029.6157386-.02093-.0005249-2.2889.022942-2.2889.022942-.398581.030746-.860608-.2492604-1.008692-.5981218l-.548796-1.292872c-.262134-.6154331-.976178-.9034826-1.59285-.641721l-5.097159 2.1636151c-.616838.2618332-.905948.975669-.644564 1.5914477l.548796 1.2928716c.148091.3488601.02853.8756757-.255542 1.1271876-.01446.013782-1.606806 1.6287966-1.606806 1.6287966-.260537.3039304-.784961.4327171-1.136583.2910127l-1.302942-.5252789c-.299896-.1208503-.629902-.1174112-.929079.00959-.299409.1270899-.531006.3623176-.652213.6616273l-2.077466 5.128913c-.251274.620441.04933 1.328613.670186 1.578847l1.303415.525345c.351333.14183.638891.597887.61521.975912-.000602.0209.01995 2.286299.01995 2.286299.03019.397957-.250482.8594-.599887 1.007713l-.959272.407191c-.616598.261734-1.241221 1.118641-.979784 1.734549l2.159922 5.088458c.261392.615811.975692.90369 1.592545.641849l1.295015-.549693c.349441-.148332.876609-.02978 1.127895.254028.01387.0144 1.629038 1.60292 1.629038 1.60292.303971.259868.432182.783296.29023 1.134754l-.527522 1.302533c-.251274.62044.04934 1.328612.670187 1.578846l5.132154 2.068339c.299511.120727.629604.117537.929005-.0095.299674-.127199.531271-.362438.652513-.661765l.527525-1.302533c.142414-.351096.599342-.638869.977781-.615678.02093.0006 2.288924-.02268 2.288924-.02268.398185-.03051.860093.249168 1.00819.598062l.54866 1.292566c.26139.615813.975693.903691 1.592548.64185l5.096928-2.163516c.61656-.261723.905648-.975533.644262-1.591321l-.548661-1.292569c-.148079-.348863-.02851-.875683.25582-1.127303.01456-.01361 1.606808-1.628801 1.606808-1.628801.260533-.303928.785076-.433074 1.136468-.291273l1.303414.525347c.299511.120725.629603.11754.929001-.0095.299408-.127089.531007-.362324.652211-.661636l2.077015-5.128451c.121225-.299317.118418-.629016-.0085-.927935-.126876-.298912-.3621-.529963-.661616-.650685l-1.303393-.525408c-.351599-.141711-.638889-.597884-.615207-.975909.0006-.0209-.01995-2.2863-.01995-2.2863-.03007-.397685.250481-.859398.599962-1.007743l1.294698-.549569c.616838-.261842.905951-.975674.644571-1.591452l-2.160139-5.0890481c-.260553-.6161652-.974882-.9040326-1.591709-.6422066zm-11.720153 14.9026601c-2.62421 1.113913-5.663978-.111135-6.776014-2.730924-1.112037-2.619784.11829-5.65774 2.742425-6.771621 2.62444-1.114013 5.663852.111462 6.775918 2.731324 1.112163 2.620094-.117884 5.657209-2.742329 6.771221z" fill="#030303" opacity=".1" stroke-width="2.66669989"/>
+<path d="m41.922905 9.0956669l-1.294705.5495756c-.349443.1483204-.87695.0289881-1.128578-.2550071-.013609-.0145141-1.630001-1.6060265-1.630001-1.6060265-.304202-.2604097-.433003-.7844771-.2909-1.1363583l.526835-1.3041337c.120981-.2998503.117954-.6300942-.009155-.9295384-.126992-.2991778-.362451-.5307609-.662204-.6520587l-5.134379-2.0737927c-.299734-.12126-.629824-.1180634-.929222.00902-.299407.1270903-.531009.3623182-.651988.6621618l-.526587 1.3036695c-.142513.3517858-.59953.6395437-.977901.6160449-.02096-.0006161-2.289487.021568-2.289487.021568-.398707.030441-.860931-.2500194-1.009241-.599416l-.5497-1.2950076c-.262619-.6165771-.976989-.9053901-1.593659-.6436287l-5.097159 2.1636153c-.616839.2618328-.905608.9764707-.643757 1.5933562l.549692 1.2950128c.148317.3493945.02907.877021-.254992 1.1284854-.01447.013786-1.606257 1.6300952-1.606257 1.6300952-.26042.3041968-.784846.4329791-1.136582.2910112l-1.303575-.5268102c-.300002-.1211464-.630095-.11795-.929534.00915-.299407.1270915-.530887.3625917-.651986.6621621l-2.074933 5.134866c-.250935.621242.05023 1.330748.671343 1.581593l1.30409.526954c.351448.142097.639349.598963.61602.977819-.0006.0209.02132 2.289505.02132 2.289505.03042.398494-.250024.860475-.599427 1.00879l-.959275.407189c-.61668.261447-1.241155 1.118585-.979287 1.735509l2.163552 5.097005c.26174.616617.976404.905368 1.593259.643529l1.295013-.549692c.349442-.148334.876839-.02926 1.128351.255104.01385.0144 1.630305 1.605897 1.630305 1.605897.304199.260411.43286.784897.291042 1.13666l-.52684 1.304136c-.251047.620971.05023 1.330748.671342 1.581597l5.134684 2.074293c.299738.121258.629826.118064.929228-.009.299673-.1272.531271-.362432.652291-.662292l.526973-1.303833c.142187-.351632.598999-.639677.977666-.615944.02081.000288 2.28941-.02154 2.28941-.02154.398289-.03032.860434.249968 1.008869.599664l.549565 1.294706c.261854.616885.976501.9056 1.593356.643759l5.096929-2.163518c.616566-.261722.905302-.976351.643453-1.593227l-.54957-1.294718c-.148426-.349671-.02909-.877021.255133-1.128906.01455-.01361 1.606253-1.630094 1.606253-1.630094.260418-.304204.78519-.432812 1.136584-.291017l1.303962.526645c.299739.121263.629827.118063.929226-.009.299408-.127081.531006-.362316.651987-.662161l2.0745-5.134404c.121108-.29958.118074-.629823-.009-.929305-.127104-.299447-.362553-.531033-.662204-.65206l-1.304091-.526945c-.351705-.14198-.639457-.599226-.615887-.977509.000481-.02117-.02132-2.289508-.02132-2.289508-.03054-.398761.249913-.860742.599392-1.009087l1.294704-.549573c.61683-.261839.905608-.97647.643853-1.593127l-2.163589-5.0970493c-.261007-.6172434-.975692-.9059399-1.592518-.6441141zm-11.557844 15.2850291c-2.846916 1.208444-6.144207-.120584-7.350512-2.962464-1.206435-2.842186.12803-6.137278 2.974944-7.345723 2.846612-1.208315 6.143976.120684 7.350412 2.962868 1.20634 2.841957-.128157 6.136972-2.974844 7.345319z" fill="url(#i)" stroke="#262626" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.14286005"/>
+<path d="m23.953709 9.265886c-5.633921 2.391459-8.275443 8.913173-5.888065 14.537478 2.387505 5.62461 8.913351 8.254646 14.54758 5.863059 5.633919-2.391456 8.275441-8.913169 5.888064-14.537478-2.387505-5.6246091-8.913353-8.2546458-14.547579-5.863059zm7.514307 17.702601c-4.150629 1.761838-8.940412-.168555-10.699429-4.312542-1.759018-4.143992.179713-8.930467 4.330263-10.692271 4.150629-1.761839 8.940509.168784 10.699431 4.312544 1.75892 4.143758-.179713 8.930462-4.330265 10.692269z" fill="url(#f)" stroke="url(#h)" stroke-width=".82876194"/>
+<path d="m24.4692 10.480302c-4.852629 2.059817-7.119036 7.656693-5.062748 12.501 2.056415 4.844613 7.657023 7.101778 12.509344 5.04209 4.852627-2.059816 7.119034-7.656691 5.062747-12.500997-2.056417-4.844615-7.657025-7.1017814-12.509343-5.042093zm6.185735 14.572685c-3.209286 1.362262-6.912755-.130685-8.272619-3.334325-1.359993-3.203944.138846-6.904777 3.348133-8.267038 3.20898-1.362133 6.912624.130378 8.272616 3.334323 1.3599 3.203716-.13907 6.904875-3.34813 8.26704z" fill="url(#d)" stroke="url(#e)" stroke-width=".82876194"/>
+<path d="m54.915255 10.220339a15.355932 12.864407 0 1 1 -30.711865 0 15.355932 12.864407 0 1 1 30.711865 0z" fill="#6d97c4" stroke="#000" stroke-linecap="round" stroke-linejoin="round" transform="matrix(.62412553 -.26492557 .32396238 .76320751 .36330993 22.072689)"/>
+<path d="m-14.745763 38.135592l-5.773012 3.739829-.352281-6.869489z" fill="#fff" stroke="#fff" stroke-linejoin="round" stroke-width="1.52425003" transform="matrix(1.2190336 .06120627 -.06388686 1.1678851 53.258503 -24.148376)"/>
+<path d="m17.797287 44.961727c0 1.46357-3.723182 2.649696-8.3157362 2.649696-4.5925538 0-8.3157357-1.186126-8.3157357-2.649696 0-1.463343 3.7230685-2.64962 8.3157357-2.64962 4.5926682 0 8.3157362 1.186277 8.3157362 2.64962z" fill="url(#r)" opacity=".4"/>
+<path d="m17.057187 36.348515h-.641219c-.173066 0-.373176-.143783-.428185-.307516-.0031-.0085-.397946-.962849-.397946-.962849-.08127-.1632-.04197-.405695.08034-.527898l.453397-.45264c.104185-.104147.161741-.243009.161741-.391029 0-.148039-.05755-.2869-.161741-.390915l-1.785237-1.781911c-.104325-.103985-.243424-.161325-.391596-.161476-.148284 0-.287376.05732-.391557.161472l-.453208.452641c-.122468.121976-.365514.161325-.520111.08418-.0087-.004-.964626-.398097-.964626-.398097-.17274-.0581-.316753-.257904-.316753-.430682v-.640311c-.000379-.304961-.248717-.553035-.554131-.553035h-2.524434c-.305497 0-.5539788.248062-.5539788.553035v.640311c0 .172778-.1440216.372557-.3080264.427505-.00853.0032-.9644361.397302-.9644361.397302-.1634724.08114-.4064886.04176-.5288057-.08034l-.4532074-.452524c-.1043246-.104136-.2434241-.161477-.3915954-.161477-.1482848 0-.2873766.05746-.3915578.161473l-1.7854265 1.782289c-.2159672.215608-.2159672.56634 0 .781944l.4533971.452641c.1221728.122101.1616087.364709.084333.519128-.00401.0086-.3988909.963-.3988909.963-.058222.172378-.2582.316028-.4312467.316028h-.4750929c-.3053764 0-.7201428.248338-.7201428.553374v2.520122c0 .304987.2484741.553034.5539793.553034h.6413699c.173066 0 .3731761.143651.4280714.307516.00323.0085.3980969.962849.3980969.962849.081271.1632.041835.405695-.080337.527898l-.4533966.452641c-.2159673.215608-.2159673.566339 0 .781943l1.7852749 1.782176c.1041851.104015.2432773.161476.3915583.161476.1484165 0 .2875088-.05746.3917088-.161476l.4533967-.45264c.1223055-.121969.3653173-.161341.5199978-.0842.00866.004.9645873.39821.9645873.39821.1725331.05812.3165537.257773.3165537.430566v.64016c0 .304988.2484745.553035.5539793.553035h2.5243176c.305361 0 .553828-.248058.553828-.553035v-.64016c0-.172778.144021-.37256.308162-.427504.0085-.0031.964437-.397303.964437-.397303.163472-.08114.406601-.04189.528804.0802l.453397.45264c.104185.104015.243277.161477.391558.161477.148285 0 .287377-.05746.391558-.161477l1.785162-1.782175c.104188-.104015.161741-.242873.161741-.390916 0-.148038-.05755-.2869-.161741-.390915l-.453398-.452632c-.122305-.122102-.161608-.36471-.08433-.519129.004-.0086.398891-.963.398891-.963.05822-.172245.258199-.316028.431284-.316028h.641219c.305497 0 .553979-.248063.553979-.553034v-2.520387c.000416-.304986-.248073-.553034-.553563-.553034zm-7.5729902 4.166183c-1.2996737 0-2.3570953-1.055569-2.3570953-2.353051 0-1.297481 1.0574592-2.353202 2.3570953-2.353202 1.2997872 0 2.3569822 1.055683 2.3569822 2.353202 0 1.297634-1.057195 2.353051-2.3569822 2.353051z" fill="#030303" opacity=".1" stroke-width="2.66669989"/>
+<path d="m17.054919 36.345491h-.641219c-.173066 0-.373176-.144047-.428185-.308049-.0031-.0085-.397946-.964323-.397946-.964323-.08127-.163469-.04197-.406337.08034-.528691l.453396-.453435c.104185-.104279.161742-.243405.161742-.391709 0-.148171-.05756-.287297-.161742-.391595l-1.785236-1.78486c-.104185-.104279-.243277-.161737-.391558-.161737-.148285 0-.287377.05746-.391558.161737l-.453208.453284c-.122468.122241-.365514.161589-.520111.08433-.0087-.004-.964626-.398778-.964626-.398778-.17274-.05825-.316754-.258279-.316754-.431322v-.64137c-.000378-.305527-.248716-.553979-.55413-.553979h-2.524433c-.3054976 0-.5539793.248459-.5539793.553979v.64137c0 .173043-.1440207.373222-.308026.428147-.00853.0032-.9644361.397946-.9644361.397946-.1634724.08127-.4064886.04189-.5288056-.08034l-.4532075-.453284c-.1043168-.104279-.2434091-.161737-.3917088-.161737-.1482848 0-.2873766.05759-.3915583.161737l-1.7854255 1.785238c-.2159673.216005-.2159673.567397 0 .783304l.4533961.453435c.1221733.122233.1616087.365241.084333.520073-.00401.0086-.3988904.964587-.3988904.964587-.058222.172646-.2582.316562-.4312467.316562h-.4750929c-.3053615-.000133-.7201051.248326-.7201051.553865v2.524355c0 .305388.2484745.553866.5539793.553866h.6413703c.173065 0 .3731761.143915.428071.308049.00323.0085.3980973.964323.3980973.964323.081271.163469.041835.406488-.080338.528843l-.4533967.453435c-.2159667.215872-.2159667.567397 0 .783304l1.785275 1.785124c.104185.104279.2432768.161737.3915582.161737.1484166 0 .2875089-.05746.3917089-.161737l.4533961-.453283c.122306-.122234.3653183-.161741.5199984-.08433.00866.0039.9645877.398777.9645877.398777.1725326.05826.3165537.258169.3165537.431359v.64122c0 .30552.2484741.553979.5539789.553979h2.524317c.305362 0 .553829-.248464.553829-.553979v-.64122c0-.173178.14402-.373221.308158-.428297.0085-.0031.964436-.397946.964436-.397946.163473-.08127.406602-.04176.528806.08034l.453396.453283c.104185.10428.243277.161737.391558.161737.148284 0 .287376-.05746.391558-.161737l1.785161-1.785124c.104189-.104146.161742-.243273.161742-.391595 0-.148304-.05755-.28743-.161742-.391596l-.453396-.453434c-.122302-.122234-.161609-.365374-.08433-.519922.004-.0088.39889-.964588.39889-.964588.05822-.172778.2582-.316693.431285-.316693h.641219c.305493 0 .553979-.24846.553979-.553867v-2.524354c.000416-.30552-.248074-.55398-.553564-.55398zm-7.5729902 4.355555c-1.4099704 0-2.5569373-1.145076-2.5569373-2.552552 0-1.407628 1.1469669-2.552705 2.5569373-2.552705 1.4098202 0 2.5568242 1.145077 2.5568242 2.552705 0 1.407513-1.146967 2.552552-2.5568242 2.552552z" fill="url(#q)" stroke="#262626" stroke-linecap="round" stroke-linejoin="round"/>
+<path d="m9.4838188 33.216053c-2.7902693 0-5.0605026 2.266303-5.0605026 5.051809 0 2.785658 2.2700822 5.051809 5.0605026 5.051809 2.7902702 0 5.0605032-2.266302 5.0605032-5.051809 0-2.785658-2.270082-5.051809-5.0605032-5.051809zm0 8.767431c-2.0556495 0-3.7218207-1.663298-3.7218207-3.71566 0-2.052361 1.6662088-3.715659 3.7218207-3.715659 2.0556502 0 3.7218212 1.663411 3.7218212 3.715659 0 2.052248-1.666209 3.71566-3.7218212 3.71566z" fill="url(#o)" stroke="url(#p)" stroke-width=".37782547"/>
+<path d="m9.4838188 33.817507c-2.4033228 0-4.3513978 1.945013-4.3513978 4.344217 0 2.399354 1.9482261 4.344215 4.3513978 4.344215 2.4033242 0 4.3513982-1.945013 4.3513982-4.344215 0-2.399355-1.948225-4.344217-4.3513982-4.344217zm0 7.217303c-1.5894392 0-2.8776599-1.286218-2.8776599-2.87286 0-1.586794 1.2882207-2.87286 2.8776599-2.87286 1.5892882 0 2.8776612 1.286066 2.8776612 2.87286 0 1.58668-1.288334 2.87286-2.8776612 2.87286z" fill="url(#l)" stroke="url(#n)" stroke-width=".37782547"/>
+<path d="m54.915255 10.220339a15.355932 12.864407 0 1 1 -30.711865 0 15.355932 12.864407 0 1 1 30.711865 0z" fill="#6d97c4" stroke="#000" stroke-linecap="round" stroke-linejoin="round" transform="matrix(.30910592 0 0 .37798799 -2.6971869 34.38825)"/>
+</svg>
diff --git a/doc/source/img/qgis_icons/mActionCapturePolygon.svg b/doc/source/img/qgis_icons/mActionCapturePolygon.svg
new file mode 100644
index 0000000000000000000000000000000000000000..948cfe942d9368626f676b3f22c1c07f641c29f0
--- /dev/null
+++ b/doc/source/img/qgis_icons/mActionCapturePolygon.svg
@@ -0,0 +1,14 @@
+<svg height="24" viewBox="0 0 24 24" width="24" xmlns="http://www.w3.org/2000/svg">
+<linearGradient gradientUnits="userSpaceOnUse" x1="-10" x2="-10" y1="15" y2="21">
+<stop offset="0" stop-color="#555753"/>
+<stop offset="1" stop-color="#555753" stop-opacity="0"/>
+</linearGradient>
+<g transform="translate(0 -8)">
+<g transform="translate(33 8)">
+<rect fill="#c4a000" height="11" rx="2.0114901" width="11" x="-20" y="13"/>
+<path d="m-15 14v2.0625c-.537663.111041-1.024662.383291-1.375.78125l-1.78125-1.03125-.5.875 1.78125 1.03125c-.082063.247432-.125.506395-.125.78125 0 .274855.04294.533818.125.78125l-1.78125 1.03125.5.875 1.78125-1.03125c.352503.40042.832682.670182 1.375.78125v2.0625h1v-2.0625c.537663-.111041 1.024662-.383291 1.375-.78125l1.78125 1.03125.5-.875-1.78125-1.03125c.082063-.247432.125-.506395.125-.78125 0-.274855-.04294-.533818-.125-.78125l1.78125-1.03125-.5-.875-1.78125 1.03125c-.352503-.40042-.832682-.670182-1.375-.78125v-2.0625zm.5 3.5c.552 0 1 .448 1 1 0 .552-.448 1-1 1-.552 0-1-.448-1-1 0-.552.448-1 1-1z" fill="#fcffff"/>
+<path d="m-19 19l9-.0096c0 0 0 0 0-2 0-2.9904-1-2.9904-4.5-2.9904-3.5 0-4.5 0-4.5 3 0 2 0 2 0 2z" fill="#fcffff" fill-rule="evenodd" opacity=".3"/>
+</g>
+<path d="m8.0275933 9.5013891c-2.8183472.0466368-5.2878242 1.2552559-6.2839838 4.1947259-.98846785 2.916771 1.1714865 8.182008 5.9325763 5.840503 7.9077412-3.889027 7.9038032.963382 9.8807382.963382 2.438571 0 4.94037-1.699566 4.94037-3.873599 0-1.944514.09638-3.806388-.992208-4.87712-1.976935-1.944514-2.973677.987396-8.289071-1.184158-1.694017-.6920746-3.4974127-1.0917169-5.1884217-1.0637339z" style="fill:#8cbe8c;fill-rule:evenodd;stroke:#555753;stroke-width:.99999994;stroke-linecap:round;stroke-linejoin:round"/>
+</g>
+</svg>
diff --git a/doc/source/img/qgis_icons/mActionPropertiesWidget.svg b/doc/source/img/qgis_icons/mActionPropertiesWidget.svg
new file mode 100644
index 0000000000000000000000000000000000000000..b94cdfc960b720a99d53bc2f0aab794ddb65a866
--- /dev/null
+++ b/doc/source/img/qgis_icons/mActionPropertiesWidget.svg
@@ -0,0 +1,6 @@
+<svg height="24" width="24" xmlns="http://www.w3.org/2000/svg">
+<circle cx="12" cy="12" fill="#6d97c4" r="9.5" stroke="#445e75" stroke-miterlimit="10"/>
+<path d="m4.3057227 13.721911c.2424856-2.788914.7870842-4.46213 2.5189339-6.1939793 1.8703187-1.87032 3.6025004-2.7382322 6.8753914-3.4829155 1.607958-.365715-1.177314-1.5781419-5.0315735-.1361492-2.070403.7744965-4.1719438 2.7958718-4.9093385 5.741475-.8934195 3.566391.4356126 5.348593.5465867 4.071569z" fill="#fff" opacity=".3" stroke-width=".65832847"/>
+<path d="m14.277442 15.998692l-.235198-.234536c-.214326-.213996-.624764-.171594-.794371.08216-.106336.159338-.597933.668161-.907665.907334.03843-.158677.111968-.401161.250436-.794703l1.242242-3.526642c.291842-.835117.468076-1.339301.468076-1.769282 0-.680417-.501534-1.120336-1.277024-1.120336-1.958766 0-3.4918577 1.768951-4.0593134 2.528871-.00728.0096-.013913.01889-.019877.02716-.097722.110973-.1364805.259048-.1060038.410768.02352.117267.087785.230891.186171.329277l.1762324.175901c.1053415.105342.2421536.163313.3855913.163313.1069983 0 .2673302-.03346.4250115-.192796l.02916-.03411c.20439-.272299.586338-.684062.865593-.937478-.04804.162982-.115942.363065-.195778.593295l-.8636069 2.517278c-.6151585 1.778558-.8453869 2.444069-.8453869 2.814754 0 .484639.3097321 1.002074 1.1789698 1.002074 2.70146 0 4.033142-2.006798 4.17923-2.240341.148739-.249111.120249-.497891-.08249-.701949z" fill="#fff" stroke="#34497d" stroke-miterlimit="10" stroke-width=".5"/>
+<path d="m13.180294 5.5009239c-.868575 0-1.630152.7523016-1.630152 1.6102767 0 .9782234.655241 1.6102749 1.669242 1.6102749.99545 0 1.767295-.918264 1.767295-1.7083301.000331-.6973112-.472715-1.5122215-1.806385-1.5122215z" fill="#fff" stroke="#34497d" stroke-miterlimit="10" stroke-width=".5"/>
+</svg>
diff --git a/doc/source/img/qgis_icons/mActionSaveEdits.svg b/doc/source/img/qgis_icons/mActionSaveEdits.svg
new file mode 100644
index 0000000000000000000000000000000000000000..84f24c19b5aa1f914e35f5fae0cabf8f5faba600
--- /dev/null
+++ b/doc/source/img/qgis_icons/mActionSaveEdits.svg
@@ -0,0 +1,25 @@
+<svg height="24" width="24" xmlns="http://www.w3.org/2000/svg">
+<g transform="translate(0 -8)">
+<rect fill="#f7f93d" height="21.286964" ry="2.3321381" width="21.381363" x="1.091639" y="9.0755777"/>
+<g transform="matrix(.94107443 0 0 .93686547 -3.5866537 2.6048543)">
+<rect height="20" rx="1.4775906" style="fill:#82a0b4;fill-rule:evenodd;stroke:#3c5a6e;stroke-linecap:round;stroke-linejoin:round;overflow:visible" width="20" x="5.5" y="7.5"/>
+<path d="m8.5 8.5h14v8h-14z" style="fill:#e6e6e6;fill-rule:evenodd;stroke:#969696;stroke-linecap:round;stroke-linejoin:round;overflow:visible"/>
+<path d="m10.5 10.5h10" fill="none" stroke="#969696"/>
+<path d="m10.5 12.5h10" fill="none" stroke="#969696"/>
+<path d="m10.5 14.5h10" fill="none" stroke="#969696"/>
+<path d="m9.5 20.5h12v7h-12z" style="fill:#e6e6e6;fill-rule:evenodd;stroke:#969696;stroke-linecap:round;stroke-linejoin:round;overflow:visible"/>
+<path d="m10.5 21.5h4v5h-4z" style="fill:#82a0b4;fill-rule:evenodd;stroke:#e6e6e6;stroke-linecap:round;stroke-linejoin:round;overflow:visible"/>
+</g>
+<g enable-background="new" stroke-dashoffset=".5" stroke-linejoin="round" transform="matrix(.56625909 .32692978 -.32692978 .56625909 15.571125 13.856155)">
+<path d="m8.0961023 18.028419l5.9999997 0-3.12491 6.990956-2.8750897-6.990956z" fill="#505050" overflow="visible" stroke="#505050" stroke-linecap="round" stroke-width=".75"/>
+<path d="m8.0961004 1.0284199l6.0000006-.000001.000001 17.0000001-5.9999997 0-.0000019-16.9999991" fill="#de6b37" overflow="visible" stroke="#c04317" stroke-linecap="round" stroke-width=".74999994"/>
+<path d="m10.576704 2.1008083l.000001 15.7948847" fill="none" opacity=".5" overflow="visible" stroke="#f8b008" stroke-width="2.10598469"/>
+<path d="m12.686221 2.0551469l-.080979 16.1486211" fill-opacity=".58823529" opacity=".25" overflow="visible" stroke="#632923" stroke-width="2.15934753"/>
+<path d="m12.096101 2.0284193l.000001 15.9999997" style="opacity:.5;fill:#fc894f;stroke:#a7481e;stroke-width:.75000006;stroke-linecap:round;overflow:visible"/>
+<path d="m11.463292 23.228968l1.996957-4.943779-1.996957-.000001 0 4.94378z" fill="#969696" overflow="visible" stroke="#969696" stroke-linecap="square" stroke-width=".49999997"/>
+<path d="m9.5961007 2.0284198l.0000015 15.9999982" style="opacity:.5;fill:#db562d;stroke:#9b3819;stroke-width:.74999994;stroke-linecap:round;overflow:visible"/>
+<path d="m7.8653316-.08727704h6.4615374v2.1791313h-6.4615374z" fill="#e6e6e6" overflow="visible" stroke="#969696" stroke-linecap="round" stroke-width=".5"/>
+<path d="m10.728912 23.38728l-1.9969556-5.102091 1.9969556 0 0 5.102091z" fill="#e6e6e6" overflow="visible" stroke="#e6e6e6" stroke-linecap="square" stroke-width=".49999997"/>
+</g>
+</g>
+</svg>
diff --git a/doc/source/img/qgis_icons/mActionSelectRectangle.svg b/doc/source/img/qgis_icons/mActionSelectRectangle.svg
new file mode 100644
index 0000000000000000000000000000000000000000..433f7657ce9c07ba9380f404db9aef9bf76dce70
--- /dev/null
+++ b/doc/source/img/qgis_icons/mActionSelectRectangle.svg
@@ -0,0 +1,7 @@
+<svg height="24" width="24" xmlns="http://www.w3.org/2000/svg">
+<g transform="translate(0 -1028.3622)">
+<path d="m1.4798758 1029.842h21.040247v19.040249h-21.040247z" fill="#e5e5e5" stroke="#424242" stroke-dasharray="1.91950336 .95975168" stroke-width=".95975173"/>
+<path d="m2.5384617 1030.9006h12.923078v12.923077h-12.923078z" fill="#fce94f" overflow="visible" stroke="#c4a000" stroke-linecap="round" stroke-width="1.07692313"/>
+<path d="m22.652743 1044.0577l-12.756464-6.9791 5.477553 13.6014 2.180887-3.5312 4.312159 4.7134 1.633122-1.5913-4.408599-4.6683 3.561343-1.5449z" style="fill:#fff;fill-rule:evenodd;stroke:#000;stroke-width:.7;stroke-linecap:round;stroke-linejoin:round"/>
+</g>
+</svg>
diff --git a/doc/source/img/qgis_icons/mActionSetProjection.svg b/doc/source/img/qgis_icons/mActionSetProjection.svg
new file mode 100644
index 0000000000000000000000000000000000000000..ed9f271111efa2bd695345c082dc69ec3f8aff83
--- /dev/null
+++ b/doc/source/img/qgis_icons/mActionSetProjection.svg
@@ -0,0 +1,30 @@
+<svg enable-background="new 0 0 24 24" height="24" viewBox="0 0 24 24" width="24" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+<linearGradient id="a" gradientUnits="userSpaceOnUse" x1="3.0864" x2="20.9115" y1="14.0254" y2="10.8823">
+<stop offset="0" stop-color="#c8e6fa"/>
+<stop offset=".2857" stop-color="#b7ddf6"/>
+<stop offset=".8515" stop-color="#8ac7eb"/>
+<stop offset="1" stop-color="#7dc1e8"/>
+</linearGradient>
+<linearGradient id="b" gradientUnits="userSpaceOnUse" x1=".9834" x2="23.6108" y1="6.6646" y2="8.6442">
+<stop offset="0" stop-color="#f5f5f5"/>
+<stop offset=".2503" stop-color="#e4e4e4"/>
+<stop offset=".7217" stop-color="#c9c9c9"/>
+<stop offset="1" stop-color="#bfbfbf"/>
+</linearGradient>
+<path d="m21.049 12.457c0 4.987-4.054 9.039-9.049 9.039-4.998 0-9.049-4.052-9.049-9.039 0-4.995 4.052-9.046 9.049-9.046 4.995 0 9.049 4.051 9.049 9.046z" fill="url(#a)" stroke="#4774b4" stroke-linecap="round" stroke-linejoin="round" stroke-width=".75"/>
+<path d="m12 3.887c4.762 4.763 4.762 12.37 0 17.135" fill="none" stroke="#4774b4" stroke-linecap="round" stroke-linejoin="round" stroke-width=".75"/>
+<path d="m12 3.887c-4.763 4.763-4.763 12.37 0 17.135" fill="none" stroke="#4774b4" stroke-linecap="round" stroke-linejoin="round" stroke-width=".75"/>
+<path d="m3.427 12.457c1.905 0 15.24 0 17.146 0" fill="none" stroke="#4774b4" stroke-linecap="round" stroke-linejoin="round" stroke-width=".75"/>
+<path d="m18.667 6.745c-2.675 1.918-10.309 2.067-13.335 0" fill="none" stroke="#4774b4" stroke-linecap="round" stroke-linejoin="round" stroke-width=".75"/>
+<path d="m18.667 18.163c-3.447-1.867-9.708-1.995-13.335 0" fill="none" stroke="#4774b4" stroke-linecap="round" stroke-linejoin="round" stroke-width=".75"/>
+<path d="m23.4 11.046c0 0-4.453 2.013-11.4 2.013-6.948 0-11.4-2.013-11.4-2.013l8.479-8.729c0 0 1.75.425 2.921.425s2.922-.425 2.922-.425z" fill="url(#b)" fill-opacity=".8" stroke="#404040" stroke-linecap="round" stroke-width=".5"/>
+<path d="m12 13.059v-5.747-4.571" fill="none" stroke="#404040" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+<path d="m20.41 8.064c0 0-3.283 1.375-8.41 1.375-5.126 0-8.41-1.375-8.41-1.375" fill="none" stroke="#404040" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+<path d="m17.561 4.997c0 0-2.17.802-5.561.802-3.39 0-5.562-.802-5.562-.802" fill="none" stroke="#404040" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+<path d="m13.266 2.632l4.81 9.903" fill="none" stroke="#404040" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+<path d="m10.736 2.632l-4.813 9.903" fill="none" stroke="#404040" stroke-linecap="round" stroke-linejoin="round" stroke-width=".5"/>
+<path d="m15.012 13h6.977c1.111 0 2.011.9 2.011 2.012v6.977c0 1.111-.9 2.011-2.012 2.011h-6.977c-1.111 0-2.011-.9-2.011-2.012v-6.977c0-1.111.9-2.011 2.012-2.011z" fill="#c4a000"/>
+<path d="m14 19l9-.01c0 0 0 0 0-2 0-2.99-1-2.99-4.5-2.99s-4.5 0-4.5 3c0 2 0 2 0 2z" fill="#fcffff" opacity=".3"/>
+<path d="m16.572 18.586l4.938-4.148 1.016 1.059-3.961 4.874z" fill="#fcffff" stroke="#fcffff" stroke-linejoin="round" stroke-width=".25"/>
+<path d="m15.701 19.146l2.137 2.178-3.401 1.224z" fill="#fcffff" stroke="#fcffff" stroke-linejoin="round" stroke-width=".25"/>
+</svg>
diff --git a/doc/source/img/timeseriespanel.png b/doc/source/img/timeseriespanel.png
new file mode 100644
index 0000000000000000000000000000000000000000..6ad336f91a8a94af228a9295c9e42fd3e7072cda
Binary files /dev/null and b/doc/source/img/timeseriespanel.png differ
diff --git a/doc/source/installation.rst b/doc/source/installation.rst
index 3a013ee47a451f121f6e6c52a548435daefeed1c..ad55873be53373f74a3d4d40c5ab3a5640d8136b 100644
--- a/doc/source/installation.rst
+++ b/doc/source/installation.rst
@@ -1,31 +1,27 @@
-
-.. |icon| image:: img/logo.png
- :width: 30px
- :height: 30px
-
+.. include:: icon_links.rst
============
Installation
============
-.. note:: * The EO TSV plugin requires QGIS Version 3.4 or higher
- * You can get QGIS `here <https://www.qgis.org/en/site/forusers/download.html>`_
+.. important:: The EO TSV plugin requires `QGIS Version 3.4 or higher <https://www.qgis.org/en/site/forusers/download.html>`_
+
-.. important:: :ref:`Additional python packages <Additional python dependencies>` are needed and some of them are not delivered with the
- standard QGIS python environment, hence they have to be installed. Follow platform-specific advices below.
+QGIS 3 Plugin Installation
+--------------------------
-Standard QGIS 3 Plugin Installation
------------------------------------
+#. Open QGIS
+#. In the menu bar go to :menuselection:`Plugins --> Manage and Install Plugins...`
+#. Switch to the **All** tab and search for ``EO Time Series Viewer``
-1. Download the most recent zip archive of the EO Time Series Viewer QGIS Plugin from https://bitbucket.org/jakimowb/eo-time-series-viewer/downloads
+ .. figure:: img/install_plugin.png
-2. Start QGIS 3 and open *Plugins* > *Manage and Install Plugins* > *Install from ZIP*.
-3. Select the downloaded *timeseriesviewerplugin.0.5.YYYYMMDDTHHMM.QGIS3.zip* and start *Install plugin*.
-4. Start the EO Time Series Viewer via the |icon| icon. In case of missing requirements you should see an error message. Please :ref:`install <Additional python dependencies>` the requested packages.
+#. Click on :guilabel:`Install Plugin` to start the installation
+#. Start the EO Time Series Viewer via the |icon| icon or from the menu bar :menuselection:`Raster --> EO Time Series Viewer`
Developers
----------
@@ -51,47 +47,3 @@ Developers
.. todo:: add detailed description how to setup an IDE to run the EO Time Series Viewer without QGIS
-Additional python dependencies
-------------------------------
-
-The EO Time Series Viewer requires the following packages:
-
- * pyqtgraph
- * pyopengl (optional)
-
-
-
-On **Windows**, open the *OSGeo4W Shell* and install the packages via pip:
-
-.. code-block:: shell
-
- call py3_env.bat
- python3 -m pip install pyqtgraph
- python3 -m pip install pyopengl
-
-On **Linux** or **Mac** you should be able to use the same commands in the terminal, as long as `pip <https://pip.pypa.io/en/stable/installing/>`_
-is available, i.e.
-
-.. code-block:: shell
-
- python3 -m pip install pyqtgraph
- python3 -m pip install pyopengl
-
-....
-
-In case pip is not available in the OSGeo4W Shell, enter
-
- .. code-block:: batch
-
- setup
-
- in the shell, which will start the OSGeo4W installer. Then navigate through
-
- :menuselection:`Advanced Installation --> Installation from Internet --> default OSGeo4W root directory --> local temp directory --> direct connection --> Select downloadsite --> http://download.osgeo.ogr`
-
-
- Now use the textbox to filter, select and finally install the following package:
-
- .. code-block:: batch
-
- python-pip
\ No newline at end of file
diff --git a/doc/source/user_guide.rst b/doc/source/user_guide.rst
index b637f6ebed179c3b63855e72dea1cd605db5d7ab..3f375e213d82915b6fc6cbe5064289688dcaa631 100644
--- a/doc/source/user_guide.rst
+++ b/doc/source/user_guide.rst
@@ -1,97 +1,28 @@
-
.. DEFINE ICONS AND IMAGE HERE
+.. include:: /icon_links.rst
+
.. |cbc| image:: img/checkbox_checked.PNG
.. |cbu| image:: img/checkbox_unchecked.PNG
-.. |ad_ra| image:: ../../eotimeseriesviewer/ui/icons/mActionAddRasterLayer.svg
- :width: 27px
-.. |re_ra| image:: ../../eotimeseriesviewer/ui/icons/mActionRemoveTSD.svg
- :width: 27px
-.. |timeseriesdock| image:: img/timeseriesdock.png
-.. |icon_eotsv| image:: ../../eotimeseriesviewer/ui/icons/icon.svg
- :width: 27px
-.. |icon_zoom_in| image:: ../../eotimeseriesviewer/ui/icons/mActionZoomIn.svg
- :width: 27px
-.. |icon_zoom_out| image:: ../../eotimeseriesviewer/ui/icons/mActionZoomOut.svg
- :width: 27px
-.. |icon_zoom_pan| image:: ../../eotimeseriesviewer/ui/icons/mActionPan.svg
- :width: 27px
-.. |icon_zoom_full| image:: ../../eotimeseriesviewer/ui/icons/mActionZoomFullExtent.svg
- :width: 27px
-.. |icon_zoom_11| image:: ../../eotimeseriesviewer/ui/icons/mActionZoomActual.svg
- :width: 27px
-.. |icon_add_map_view| image:: ../../eotimeseriesviewer/ui/icons/mActionAddMapView.svg
- :width: 27px
-.. |icon_select_ts_profile| image:: ../../eotimeseriesviewer/ui/icons/mIconTemporalProfile.svg
- :width: 27px
-.. |spectral_profile| image:: ../../eotimeseriesviewer/ui/icons/pickrasterspectrum.svg
- :width: 27px
-.. |addTS| image:: ../../eotimeseriesviewer/ui/icons/mActionAddTS.svg
- :width: 27px
-.. |remTS| image:: ../../eotimeseriesviewer/ui/icons/mActionRemoveTS.svg
- :width: 27px
-.. |saveTS| image:: ../../eotimeseriesviewer/ui/icons/mActionSaveTS.svg
- :width: 27px
-.. |refresh| image:: ../../eotimeseriesviewer/ui/icons/mActionRefresh.svg
- :width: 27px
-.. |zoompoint| image:: ../../eotimeseriesviewer/ui/icons/mActionZoomPoint.svg
- :width: 27px
-.. |extentimport| image:: ../../eotimeseriesviewer/ui/icons/mapExtentImport.svg
- :width: 27px
-.. |centerimport| image:: ../../eotimeseriesviewer/ui/icons/mapCenterImport.svg
- :width: 27px
-.. |extentexport| image:: ../../eotimeseriesviewer/ui/icons/mapExtentExport.svg
- :width: 27px
-.. |centerexport| image:: ../../eotimeseriesviewer/ui/icons/mapCenterExport.svg
- :width: 27px
-.. |identify| image:: ../../eotimeseriesviewer/ui/icons/mActionIdentify.svg
- :width: 27px
-
-.. |removemapview| image:: ../../eotimeseriesviewer/ui/icons/mActionRemoveMapView.svg
-.. |mapviewdropdown| image:: img/mapviewdropdown.png
+.. |timeseriesdock| image:: img/timeseriesdock.png
+.. |mapviewbutton| image:: img/mapviewbutton.png
.. |questionmark| image:: img/questionmark.png
-.. |hidemapview| image:: ../../eotimeseriesviewer/ui/icons/mapviewHidden.svg
- :height: 27px
- :width: 27px
-.. |crosshair| image:: ../../eotimeseriesviewer/ui/icons/crosshair.svg
- :height: 27px
- :width: 27px
-.. |symbology| image:: ../../eotimeseriesviewer/ui/icons/symbology.svg
- :height: 27px
- :width: 27px
-.. |copy| image:: ../../eotimeseriesviewer/ui/icons/mActionEditCopy.svg
-.. |paste| image:: ../../eotimeseriesviewer/ui/icons/mActionEditPaste.svg
-
-.. |addspectrum| image:: ../../eotimeseriesviewer/ui/icons/profile2speclib.svg
- :width: 27px
-.. |addattribute| image:: img/qgis_icons/mActionNewAttribute.svg
- :width: 27px
-.. |removeattribute| image:: img/qgis_icons/mActionDeleteAttribute.svg
- :width: 27px
-.. |importspeclib| image:: ../../eotimeseriesviewer/ui/icons/speclib_add.svg
- :width: 27px
-.. |exportspeclib| image:: ../../eotimeseriesviewer/ui/icons/speclib_save.svg
- :width: 27px
-.. |info| image:: ../../eotimeseriesviewer/ui/icons/metadata.svg
- :width: 27px
-.. |loadmissingvalues| image:: ../../eotimeseriesviewer/ui/icons/mIconTemporalProfileRefresh.svg
- :width: 27px
==========
User Guide
==========
-.. note:: This documentation reflects the previous EO Time Series Viewer version, where some parts of the GUI looked
+.. todo:: This documentation reflects the previous EO Time Series Viewer version, where some parts of the GUI looked
different. We are working hard on updating the figures and descriptions.
Quick Start
-----------
-1. Click |icon_eotsv| in the QGIS Tool Bar or via :menuselection:`Raster --> EO Time Series Viewer` to start the EO Time Series Viewer
+1. Click |icon| in the QGIS Tool Bar or via :menuselection:`Raster --> EO Time Series Viewer` to start the EO Time Series Viewer
-2. Click :menuselection:`Files --> Add example` to load an examplary time series of Landsat and RapidEye observations.
+2. Click :menuselection:`Files --> Add example` to load an exemplary time series of Landsat and RapidEye observations.
3. Open the sensor panel :menuselection:`View --> Panels... --> Sensors / Products` and change the sensor names
@@ -102,24 +33,25 @@ Quick Start
6bands@30.0m Landsat
============ =========
-4. Use the scroll band and the map tools |icon_zoom_in| |icon_zoom_out| |icon_zoom_pan| to change the temporal and spatial subset shown from the time series.
+4. Use the scroll band and the map tools |mActionZoomIn| |mActionZoomOut| |mActionPan| to change the temporal and spatial subset shown from the time series.
-5. Open the Map View panel, change the map view name from `Map View 1` to `True Color` and set the multiband color render band selection to `RGB = 3-2-1` for both, Landsat and RapidEye images.
+5. Open the Mapping panel, change the map view name from `Map View 1` to `True Color` and set the multiband color render
+ band selection to `RGB = 3-2-1` for both, Landsat and RapidEye images (right-click on layer, :menuselection:`Set Properties --> Style`).
-.. note:: Use |refresh| to refresh or redraw related maps, spectral profile plots etc.
+.. note:: Use |mActionRefresh| to refresh or redraw related maps, spectral profile plots etc.
-6. Now we like to Optimize the color stretch. Choose a none-clouded Landsat observation like 2014-06-24 and use the map context menu (right-mouse-click)
+6. Now we like to optimize the color stretch. Choose a none-clouded Landsat observation like 2014-06-24 and use the map context menu (right-mouse-click)
to click on :menuselection:`Stretch to current extent ... --> Linear 5%`. Repeat with `Linear` and `Gaussian` stretch as well as for RapidEye images to
see how this changes the band-specific min/max values in the Map View settings.
-7. Click |icon_add_map_view| to create a second map view, respectively row of map images. Call it `Short-Wave IR` and the the multiband color render bands to
- ``Landsat RGB = 4-5-3`` and ``RapidEye RGB = 5-4-3``
+7. Click |mActionAddMapView| to create a second map view, respectively row of map images. Call it ``Short-Wave IR`` and the the multiband color render bands to
+ *Landsat RGB = 4-5-3* and *RapidEye RGB = 5-4-3*
-8. Expand the `Map Properties` combobox (the first in the Map Views panel), increase the map size to 300x300 pixel and press `Apply`.
+8. Expand the :guilabel:`Map Properties` combobox (in the Mapping panel), increase the map size to 300x300 pixel and press :guilabel:`Apply`.
9. Bring the Temporal Profile panel :menuselection:`View --> Panels... --> Sensors / Products` and the `2D` page to the front.
- Click |icon_select_ts_profile| and select a map location to visualize the temporal profile for.
- Each selected map location will be listed in the panels' `Coordinate` page.
+ Click |mIconTemporalProfile| and select a map location to visualize the temporal profile for.
+ Each selected map location will be listed in the panels |mActionOpenTable| :guilabel:`Coordinate` page.
Go back to the `2D` plot page and add a second profile with RapidEye data as Sensor source.
Change the expression field to show the Normalized Difference Vegetation Index (NDVI) for both sensors:
@@ -143,8 +75,9 @@ The Graphical User Interface
----------------------------
.. figure:: img/interface.png
+ :width: 100%
- This is what the EO Time Series Viewer's interface looks like when opening it.
+ This is what the EO Time Series Viewer's interface looks like when opening it.
.. note:: Just like in QGIS, many parts of the GUI are adjustable panels. You can arrange them as tabbed, stacked or separate windows.
Activate/Deactivate panels under :menuselection:`View --> Panels`
@@ -155,20 +88,24 @@ The Graphical User Interface
Time Series
^^^^^^^^^^^
-.. figure:: img/autogenerated/timeseriesPanel.png
+This window lists the individual input raster files of the time series.
+.. figure:: img/timeseriespanel.png
-This window lists the individual input raster files of the time series.
+* **Date** corresponds to the image acquisition date as automatically derived by the EO TSV from the file name. Checking |cbc| or unchecking |cbu| the box in the date field will include or exclude the respective image from the display
+* **Sensor** shows the name of the sensor as defined in the :ref:`Sensors / Products` tab
+* **ns**: number of samples (pixels in x direction)
+* **nl**: number of lines (pixels in y direction)
+* **nb**: number of bands
+* **image**: path to the raster file
-* ``date`` corresponds to the image acquisition date as automatically derived by the EO TSV from the file name. Checking |cbc| or unchecking |cbu| the box in the date field will include or exclude the respective image from the display
-* ``sensor`` shows the name of the sensor as defined in the :ref:`Sensors / Products` tab
-* ``ns``: number of samples (pixels in x direction)
-* ``nl``: number of lines (pixels in y direction)
-* ``nb``: number of bands
-* ``image``: path to the raster file
+You can add new rasters to the time series by clicking |mActionAddRasterLayer| :superscript:`Add image to time series`.
+Remove them by selecting the desired rows in the table (click on the row number) and pressing the |mActionRemoveTSD| :superscript:`Remove image from time series` button.
+
+.. tip::
+
+ If you have your time series available as one large raster stack, you can import this file via :menuselection:`Files --> Add images from time stack`
-You can *add new rasters* to the time series by clicking |ad_ra| :superscript:`Add image to time series`.
-Remove them by selecting the desired rows in the table (click on the row number) and pressing the |re_ra| :superscript:`Remove image from time series` button.
.. tip:: Click :menuselection:`Files --> Add example` to load a small example time series.
@@ -183,7 +120,7 @@ The EO Time Series Viewer automatically assesses different characteristics of th
and combines identical ones into sensor groups (or products). Those are listed as follows in the Sensor / Products window:
* ``name`` is automatically generated from the resolution and number of bands (e.g. *6bands@30.m*). This field is adjustable,
- i.e. you can change the name by double clicking into the field. The here defined name will be also displayed in the Map View and the Time Series table.
+ i.e. you can change the name by double-clicking into the field. The here defined name will be also displayed in the Map View and the Time Series table.
* ``nb``: number of bands
* ``n images``: number of images within the time series attributed to the according sensor
* ``wl``: comma separated string of the (center) wavelength of every band and [unit]
@@ -194,31 +131,39 @@ and combines identical ones into sensor groups (or products). Those are listed a
The Toolbar
^^^^^^^^^^^
+.. csv-table::
+ :header: "Button", "Function"
+
+ |mActionAddRasterLayer|, Add images to the time series
+ |mActionAddTS|, Add Time Series from CSV
+ |mActionRemoveTS|, Remove all images from Time Series
+ |mActionSaveTS|, Save Time Series as CSV file
+ |mActionAddOgrLayer|, Add vector data file
+ |qgsMapCenter|, Synchronize with QGIS map canvas
+ |mActionAddMapView|, Add maps that show a specified band selection
+ |mActionRefresh|, Refresh maps
+ |mActionPan|, Pan map
+ |mActionZoomIn|, Zoom into map
+ |mActionZoomOut|, Zoom out
+ |mActionZoomActual|, Zoom to pixel scale
+ |mActionZoomFullExtent|, Zoom to maximum extent of time series
+ |pan_center|, Center map on clicked locations
+ |select_location|, Identify Pixels and Features
+ |mActionPropertiesWidget|, Identify cursor location values
+ |profile|, Identify raster profiles to be shown in a Spectral Library
+ |mIconTemporalProfile|, Identify pixel time series for specific coordinate
+ |mActionSelectRectangle|, Select Features
+ |mActionToggleEditing|, Start Editing Mode
+ |mActionSaveEdits|, Save Edits
+ |mActionCapturePolygon|, Draw a new Feature
+
+
+.. note::
+
+ Only after |select_location| :sup:`Identify Pixels and Features` is activated you can select the other identify tools
+ (|mActionPropertiesWidget|, |profile|, |mIconTemporalProfile|). You can activate them all at once as well as none of them,
+ in case of the latter variant clicking in the map has no direct effect (other than moving the crosshair, when activated)
-============================================ ===========================================================================
-Button Function
-============================================ ===========================================================================
-|ad_ra| Add Raster Layer
-|addTS| Add Time Series from CSV
-|remTS| Remove all images from Time Series
-|saveTS| Save Time Series as CSV file
-|icon_add_map_view| Add maps that show a specified band selection
-|refresh| Refresh maps
-|zoompoint| Select center coordinate
-|icon_zoom_in| Zoom into map
-|icon_zoom_out| Zoom out
-|icon_zoom_full| Zoom to maximum extent of time series
-|icon_zoom_11| Zoom to pixel scale
-|icon_zoom_pan| Pan map
-|extentimport| Set spatial map extent from QGIS map canvas
-|centerimport| Set spatial map center from QGIS map canvas
-|extentexport| Set map extent to QGIS map canvas
-|centerexport| Set map center to QGIS map canvas
-|identify| Identify map layers (cursor location info)
-|icon_select_ts_profile| Identify pixel time series for specific coordinate
-|spectral_profile| Select pixel profiles from map
-|info| About the plugin
-============================================ ===========================================================================
@@ -230,18 +175,17 @@ Button Function
Map Visualization
^^^^^^^^^^^^^^^^^
-.. figure:: img/mapviewdock.png
Map Properties
..............
-In the map properties box you can specify **Width** and **Height**, as well as background **Color** and the **CRS** of the single map canvases.
-Click :guilabel:`Apply` to apply changes. By default the **keep ratio** option is |cbc| checked, i.e. height will be the same as width. In case
+In the map properties box you can specify :guilabel:`Width` and :guilabel:`Height`, as well as background :guilabel:`Color` and the :guilabel:`CRS` of the single map canvases.
+Click :guilabel:`Apply` to apply changes. By default the :guilabel:`keep ratio` option is |cbc| checked, i.e. height will be the same as width. In case
you want to have unequally sized views, deactivate this option.
-.. .. image:: img/maprendering.png
+.. image:: img/mapproperties.png
.. * :guilabel:`Set Center` center the QGIS Map View to the same coordinate as the EO TSV Map View
.. * :guilabel:`Get Center` center the EO TSV Map View to the same coordinate as the QGIS Map View
@@ -257,42 +201,33 @@ A map view is a row of map canvases that show the time series images of differen
The map view panel allows to add or remove map views and to specifiy how the images of each sensor are to be rendered.
-* You can *add new Map Views* using the |icon_add_map_view| button. This will create a now row of map canvases. Remove a map view via |removemapview|.
-* In case the Map View does not refresh correctly, you can 'force' the refresh using the |refresh| button (which will also apply all the render settings).
-* Access the settings for individual Map Views via the dropdown menu |mapviewdropdown|
-* You can use the |questionmark| button to *highlight the current Map View* selected in the dropdown menu (respective image chips will show red margin for a few seconds).
+* You can *add new Map Views* using the |mActionAddMapView| button. This will create a new row of map canvases. Remove a map view with the |mActionRemoveMapView| button.
+* In case the Map View does not refresh correctly, you can 'force' the refresh using the |mActionRefresh| button (which will also apply all the render settings).
+* Access the settings for individual Map Views by clicking in the mapview |mapviewbutton|
+* You can use the |questionmark| button to highlight the current Map View selected in the dropdown menu (respective image chips will show red margin for a few seconds).
-Now, for every Map View you can alter the following settings:
+For every Map View you can alter the following settings:
-* *Hide/Unhide* the Map View via the |hidemapview| :superscript:`Toggle visibility of this map view` button.
+* *Hide/Unhide* the Map View via the |mapviewHidden| :superscript:`Toggle visibility of this map view` button.
* *Activate/Deactivate Crosshair* via the |crosshair| :superscript:`Show/hide a crosshair` button. Press the arrow button next to it to enter
the *Crosshair specifications* |symbology| , where you can customize e.g. color, opacity, thickness, size and further options.
-* You may rename the Map View by altering the text in the ``Name`` field.
+* You may rename the Map View by altering the text in the :guilabel:`Name` field.
-* **Vector Rendering** allows you to visualize vector data (e.g. a shapefile). In order to do so, open the file in QGIS. Once loaded in the QGIS Layers Panel, it will become selectable
- in the dropdown menu. Vector styling will be same as in QGIS (i.e. if you want to adjust it, do it in QGIS). Check |cbc| or uncheck |cbu| in order to activate/deactivate Vector Rendering.
+.. * **Vector Rendering** allows you to visualize vector data (e.g. a shapefile). In order to do so, open the file in QGIS. Once loaded in the QGIS Layers Panel, it will become selectable
+.. in the dropdown menu. Vector styling will be same as in QGIS (i.e. if you want to adjust it, do it in QGIS). Check |cbc| or uncheck |cbu| in order to activate/deactivate Vector Rendering.
Furthermore, you can visualize the locations of :ref:`Temporal Profiles` or :ref:`Spectral Profiles <Spectral Library>` as points. Select the desired option
from the dropdown list.
-
-* Under **Raster Rendering** you can adjust the visualisation of the raster layers. Every sensor, as specified in the :ref:`Sensors / Products` tab, has its separate
- rendering option section (since band specifications differ among sensors). The handling is very similar to the QGIS style options.
-
- * Multiband (RGB) as well as singleband rendering is supported. Select the desired mode in the dropdown menu.
-
- * Select the desired band(s) for display using the slider or dropdown list. In the dropdown menu at the bottom you can specify the contrast enhancement to be used for the value stretch.
- In case EO TSV has sufficient wavelength information for the bands, you can choose several presets: *True* (True Color; red-green-blue),
- *CIR1* (colored infrared; swir-red-green) and *CIR2* (colored infrared; swIR-mwIR-red)
-
- * You can copy and paste styles using the |copy| :superscript:`Copy style to clipboard` and |paste| :superscript:`Paste style from clipboard` buttons (also between QGIS and EO TSV)
-
- * Once you specified your rendering settings, press |refresh| to apply them.
+**Layer representation:**
+* Similar to QGIS you can change the visual representation of raster or vector layers in the layer properties. To open them,
+ right-click on the layer you want to alter and select :menuselection:`Set Properties --> Style`
+ .. image:: img/layerproperties.png
@@ -301,17 +236,20 @@ Now, for every Map View you can alter the following settings:
Cursor Location Values
^^^^^^^^^^^^^^^^^^^^^^
-Similar to the Identify tool in QGIS, you can retrieve the pixel information for the images in your time series. First click on the
-|identify| :superscript:`Select cursor location` button and then on a desired pixel in the Map Views.
-In case the Map View contains (additional) vector data, location information will also be retrieved for those features.
-
-.. image:: img/autogenerated/cursorLocationInfoPanel.png
+This tools lets you inspect the values of a layer or multiple layers at the location where you click in the map view. To select a location (e.g. pixel or feature)
+use the |select_location| :superscript:`Select Cursor Location` button and click somewhere in the map view.
-* Coordinates of the selected pixel are shown in the ``x`` and ``y`` fields. You may change the coordinate system of the
- displayed coordinates via the |crs| :superscript:`Select CRS` button.
+* The Cursor Location Value panel should open automatically and list the information for a selected location. The layers will be listed in the order they appear in the Map View.
+ In case you do not see the panel, you can open it via :menuselection:`View --> Panels --> Cursor Location Values`.
-.. |crs| image:: ../../eotimeseriesviewer/ui/icons/CRS.svg
+ .. figure:: img/cursorlocationvalues.png
+* By default, raster layer information will only be shown for the bands which are mapped to RGB. If you want to view all bands, change the :guilabel:`Visible` setting
+ to :guilabel:`All` (right dropdown menu). Also, the first information is always the pixel coordinate (column, row).
+* You can select whether location information should be gathered for :guilabel:`All layers` or only the :guilabel:`Top layer`. You can further
+ define whether you want to consider :guilabel:`Raster and Vector` layers, or :guilabel:`Vector only` and :guilabel:`Raster only`, respectively.
+* Coordinates of the selected location are shown in the :guilabel:`x` and :guilabel:`y` fields. You may change the coordinate system of the displayed
+ coordinates via the |mActionSetProjection| :superscript:`Select CRS` button (e.g. for switching to lat/long coordinates).
@@ -330,69 +268,44 @@ Profile Visualization
Temporal Profiles
.................
-The Temporal Profiles panel lets you visualize temporal profiles (2D) as well as temporal-spectral profiles (3D; experimental!).
-On the left side you can switch between the different modes, i.e. |temporal2d| :superscript:`2D` and |temporal3d|
-:superscript:`3D`. The coordinates |temporal_coords| page lists the coordinates of the temporal profiles.
-
-**Adding and managing a temporal profile:**
+The Temporal Profiles panel lets you visualize temporal profiles.
+On the left side you can switch between the |mIconTemporalProfile2D| profile and the coordinates |mActionOpenTable| page. The latter
+lists all coordinates of selected or imported profile locations.
-* You can use the |icon_select_ts_profile| button to click on a location on the map an retrieve the temporal profile.
-* Mind how the selected pixel now also appears on the coordinates |temporal_coords| page!
-* If you select further pixels ( |icon_select_ts_profile| ), they will be listed in the coordinates page,
- but not automatically visualized in the plot.
-* Use |add| to create an additional plot layer, and double click in the ``Coordinate`` field in order to select the
- desired location (so e.g. the newly chosen pixel) or just change the location in the current plot layer.
-* Similarly, you can change the sensor to be visualized by double clicking inside the ``Sensor`` field and choosing from
- the dropdown.
-* Click inside the ``Style`` field to change the visual representation of your time series in the plot.
-* Remove a time series profile by selecting the desired row(s) and click |remove|.
-* The ``DN or Index`` field depicts which values will be plotted.
+Adding and managing a temporal profile:
+ * You can use the |mIconTemporalProfile| button to click on a location on the map an retrieve the temporal profile, or
+ in the toolbar select |select_location| + |mIconTemporalProfile|.
+ * Mind how the selected pixel now also appears on the coordinates |mActionOpenTable| page!
+ * If you select further pixels ( |mIconTemporalProfile| ), they will be listed in the coordinates page,
+ but not automatically visualized in the plot.
+ * Use |mActionAdd| to create an additional plot layer, and double-click in the :guilabel:`Coordinate` field in order to select the
+ desired location (so e.g. the newly chosen pixel) or just change the location in the current plot layer.
+ * Similarly, you can change the sensor to be visualized by double-clicking inside the :guilabel:`Sensor` field and choosing from
+ the dropdown.
+ * Click inside the :guilabel:`Style` field to change the visual representation of your time series in the plot.
+ * Remove a time series profile by selecting the desired row(s) and click |mActionRemove|.
+ * The :guilabel:`DN or Index` field depicts which values will be plotted.
- * Here you may select single bands (e.g. b1 for the first band)
- * or you can calculate indices on-the-fly: e.g. for the Landsat images in the example dataset the expression (b4-b3)/(b4+b3)
- would return the NDVI.
+ * Here you may select single bands (e.g. ``b1`` for the first band)
+ * or you can calculate indices on-the-fly: e.g. for the Landsat images in the example dataset the expression ``(b4-b3)/(b4+b3)``
+ would return the NDVI.
- .. figure:: img/example_temppindex.png
+ .. figure:: img/example_temppindex.png
- Example of visualizing the NDVI for the same location for different sensors (example dataset).
-* You can also move the map views to a desired date from the plot directly by :menuselection:`Right-click into plot --> Move maps to ...`
+ Example of visualizing the NDVI for the same location for different sensors (example dataset).
-.. note:: The EO TSV won't extract and load all pixel values into memory by default in order to reduce processing time (only the ones required).
- You can manually load all the values by selecting the rows on the coordinates |temporal_coords| page :menuselection:`--> Right-click --> Load missing/reload`,
- or click the |loadmissingvalues| button.
- See information in the ``loaded`` and ``percent`` column.
+ * You can also move the map views to a desired date from the plot directly by right-click into plot :menuselection:`--> Move maps to ...`
+ .. note:: The EO TSV won't extract and load all pixel values into memory by default in order to reduce processing time (only the ones required).
+ You can manually load all the values by clicking the |mIconTemporalProfileRefresh| :sup:`Load missing band values` button
+ on the coordinates |mActionOpenTable| page.
Importing or exporting locations:
- * You can also import locations from a vector file instead of collecting them from the map: Go to the coordinates |temporal_coords| page
- and add locations via the |addvector| button. The naming of the locations will be based on respective fields in the vector dataset.
- * If you want to save your locations, e.g. as shapefile or CSV, click on |save|.
-
-Visualizing the temporal profile locations as points in the Map View:
- * Under :ref:`Map Properties` --> Vector Rendering select *Temporal profile*
- * Furthermore, you can focus the Map View center on the profile location, by clicking the :guilabel:`Move to` button
- in the table on the coordinates |temporal_coords| page
-
-**Spectral-temporal plots (3D):**
+ * You can also import locations from a vector file instead of collecting them from the map: Go to the coordinates |mActionOpenTable| page
+ and add locations via the |mActionAddOgrLayer| button.
+ * If you want to save your locations, e.g. as shapefile or CSV, click on |mActionFileSave|.
-.. todo:: This feature is still experimental and under development. Documentation will follow!
-
-
-.. |temporal2d| image:: ../../eotimeseriesviewer/ui/icons/mIconTemporalProfile2D.svg
- :width: 27px
-.. |temporal3d| image:: ../../eotimeseriesviewer/ui/icons/mIconTemporalProfile3D.svg
- :width: 27px
-.. |temporal_coords| image:: ../../eotimeseriesviewer/ui/icons/mActionOpenTable.svg
- :width: 27px
-.. |add| image:: ../../eotimeseriesviewer/ui/icons/mActionAdd.svg
- :width: 27px
-.. |remove| image:: ../../eotimeseriesviewer/ui/icons/mActionRemove.svg
- :width: 27px
-.. |addvector| image:: ../../eotimeseriesviewer/ui/icons/mActionAddOgrLayer.svg
- :width: 27px
-.. |save| image:: ../../eotimeseriesviewer/ui/icons/mActionFileSave.svg
- :width: 27px
|
@@ -405,45 +318,22 @@ The spectral library view allows you to visualize, label and export spectral pro
.. image:: img/autogenerated/spectralLibraryPanel.png
-* Use the |spectral_profile| :superscript:`Select a spectrum from a map` button to extract and visualize a pixels profile
- (by clicking on a pixel on the map)
-* You can add a selected spectrum to your spectral library by clicking on |addspectrum|.
+* Use the |pickrasterspectrum| :superscript:`Select a spectrum from a map` button to extract and visualize a pixels profile
+ (by clicking on a pixel on the map).
+* You can add a selected spectrum to your spectral library by clicking on |profile2speclib|.
* The gathered spectra are listed in the table on the right. For every spectrum additional metadata will be stored, e.g.
- the columns and rows (``px_x``, ``px_y``), the ``sensorname`` or the path of the respective file (``source``).
-* When the |autoadd_profile| button is activated, the profile will be directly added to the library after clicking on a pixel.
-* In the table, you can choose whether to display a spectral profile in the plot, by checking |cbc| or unchecking |cbu| it.
-* Change the display style (color, shape, linetype) via :menuselection:`Right-click into respective row(s) --> Set Style`
+ the date, day of year and sensor.
+* When the |profile2speclib_auto| button is activated, the profile will be directly added to the library after clicking on a pixel.
+* Change the display style (color, shape, linetype) in the Spectral Library Properties, which can be accessed via the |action| button in the lower right.
.. note::
The spectral library table behaves quite similar to the attribute table you know from QGIS:
- * You can edit the content by entering the editing mode (|startediting|)
- * You can add further information by adding fields via the |addattribute| button (e.g. different class labels).
- Remove them with |removeattribute|, accordingly.
- * Double click into a desired field to change its content
- * Remove spectra by selecting the desired row(s) in the table and click |deleteselected|
-
-
-
-* Export or import a spectral library via the |importspeclib| |exportspeclib| buttons.
-
-
-You can visualize the locations of your extracted spectra as points in the Map View:
- * Under :ref:`Map Properties` --> Vector Rendering select *Spectral Library*
- * Furthermore, you can focus the Map View center on a specific spectrum, by clicking the :guilabel:`Move to` button
- in the spectral library table
-
-.. add further information on spectral library format or import/export. maybe link to enmap box documentation once its there
-
-.. |startediting| image:: img/qgis_icons/mActionToggleEditing.svg
- :width: 27px
-.. |autoadd_profile| image:: ../../eotimeseriesviewer/ui/icons/profile2speclib_auto.svg
- :width: 27px
-.. |deleteselected| image:: img/qgis_icons/mActionDeleteSelected.svg
- :width: 27px
-
-|
-|
+ * You can edit the content by entering the editing mode (|mActionToggleEditing|)
+ * You can add further information by adding fields via the |mActionNewAttribute| button (e.g. different class labels).
+ Remove them with |mActionDeleteAttribute|, accordingly.
+ * Double-click into a desired field to change its content
+ * Remove spectra by selecting the desired row(s) in the table and click |mActionDeleteSelected|