From 4f249b29baf88cf7da9e3fbd7710944c29b2b23a Mon Sep 17 00:00:00 2001 From: lexvand Date: Mon, 11 Dec 2023 12:29:54 +0100 Subject: [PATCH 1/4] Add docs for Lizard QGIS plugin --- source/d_apitutorials.rst | 4 +-- source/d_qgisplugin.rst | 49 +++++++++++++++++++++++++++++++ source/images/d_qgisplugin01.png | Bin 0 -> 12047 bytes source/images/d_qgisplugin02.png | Bin 0 -> 87721 bytes source/index.rst | 1 + 5 files changed, 52 insertions(+), 2 deletions(-) create mode 100644 source/d_qgisplugin.rst create mode 100644 source/images/d_qgisplugin01.png create mode 100644 source/images/d_qgisplugin02.png diff --git a/source/d_apitutorials.rst b/source/d_apitutorials.rst index 4e9b55b..c942f00 100644 --- a/source/d_apitutorials.rst +++ b/source/d_apitutorials.rst @@ -8,7 +8,7 @@ At the moment we have the following: 0. Virtual Environment ---------------------- -`Virtual Environment Requirements ` +`Virtual Environment Requirements `_ 1. Interactive Time Series API manual @@ -27,7 +27,7 @@ At the moment we have the following: 3. Learn to retrieve scenarios from the Lizard API -`Notebook for 3Di results / Scenarios in Lizard ` +`Notebook for 3Di results / Scenarios in Lizard `_ .. note:: diff --git a/source/d_qgisplugin.rst b/source/d_qgisplugin.rst new file mode 100644 index 0000000..fd08b32 --- /dev/null +++ b/source/d_qgisplugin.rst @@ -0,0 +1,49 @@ +================== +Lizard QGIS plugin +================== + +The Lizard QGIS plugin enables users to download their scenario results directly from the Lizard API +to their GIS environment and show WMS of raster results. +Here we describe how to install and use the plugin. + + +Installation +============ + +* Add the Lizard plugin repository + * In the main menu click *Plugins* > *Manage and Install plugins* > *Settings* + * In the section *Plugin repositories*, click *Add* + * As details, fill in '3Di' as *Name*, and 'https://plugins.3di.live/plugins.xml' as *URL* + +* Install the Lizard plugin: in the tab *All*, install the Lizard plugin. Restart QGIS when prompted. + +* Enable macros + * Make sure that *Enable macros* is set to *Always* in Settings > Options > General > Project files. + + +Initial setup +============= + +When starting the plugin for the first time you are prompted to provide some settings that are required. +In the following screen you need to provide the base URL of the Lizard portal you want to use. Also, you +need to set or obtain a personal API key, for authentication with the API. + +.. image:: /images/d_qgisplugin01.png + + +Scenario archive browser +======================== + +The Lizard plugin currently contains the Scenario archive browser (to be extended with more functionality). + +* Select a scenario from the list, which can be filtered by scenario name. +* Two options: + * Retrieve downloadable results (raw results and non-temporal rasters) + * Select the results of interest + * [Optional] Set nodata value and projection for raster exports + * Start the download + * Open raster results as WMS layers + * Use the time controls to animate temporal raster results (e.g. water depth) + +.. image:: /images/d_qgisplugin02.png + diff --git a/source/images/d_qgisplugin01.png b/source/images/d_qgisplugin01.png new file mode 100644 index 0000000000000000000000000000000000000000..06dfbf202fc5de7636b23142bceb61bad34352b1 GIT binary patch literal 12047 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 literal 0 HcmV?d00001 diff --git a/source/images/d_qgisplugin02.png b/source/images/d_qgisplugin02.png new file mode 100644 index 0000000000000000000000000000000000000000..bcfeb04592c923a0b2c0d3b1950212d028e56810 GIT binary patch literal 87721 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箠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
Nv=&Frcd}vG4X$@;{)6)lugd7X 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 Q_Jir&Ho8@D!{N!l1AI{DmH+?% literal 0 HcmV?d00001 diff --git a/source/index.rst b/source/index.rst index cbc9db9..00e03a5 100644 --- a/source/index.rst +++ b/source/index.rst @@ -46,6 +46,7 @@ Welcome to the Lizard documentation! c_apifunctional d_apitechnical d_apitutorials + d_qgisplugin .. toctree:: :maxdepth: 2 From 8c5afe4cfe9eac9ebb2886ab378fd907904c0ab0 Mon Sep 17 00:00:00 2001 From: Leendert van Wolfswinkel Date: Fri, 15 Dec 2023 10:00:38 +0100 Subject: [PATCH 2/4] Update d_qgisplugin.rst --- source/d_qgisplugin.rst | 35 ++++++++++++++++++++++++----------- 1 file changed, 24 insertions(+), 11 deletions(-) diff --git a/source/d_qgisplugin.rst b/source/d_qgisplugin.rst index fd08b32..6e21ddf 100644 --- a/source/d_qgisplugin.rst +++ b/source/d_qgisplugin.rst @@ -11,22 +11,30 @@ Installation ============ * Add the Lizard plugin repository + * Note: if you are using the `3Di Modeller Interface `_, you can skip this step. * In the main menu click *Plugins* > *Manage and Install plugins* > *Settings* * In the section *Plugin repositories*, click *Add* - * As details, fill in '3Di' as *Name*, and 'https://plugins.3di.live/plugins.xml' as *URL* - -* Install the Lizard plugin: in the tab *All*, install the Lizard plugin. Restart QGIS when prompted. - -* Enable macros - * Make sure that *Enable macros* is set to *Always* in Settings > Options > General > Project files. + * As details, fill in '3Di' as *Name*, and 'https://plugins.lizard.net/plugins.xml' as *URL* +* Install the Lizard plugin + * Click on the tab *All* + * In the search bar at the top, search for Lizard + * Select Lizard in the panel in the middle + * In the bottom-right of the dialog, click *Install plugin*. Initial setup ============= When starting the plugin for the first time you are prompted to provide some settings that are required. -In the following screen you need to provide the base URL of the Lizard portal you want to use. Also, you -need to set or obtain a personal API key, for authentication with the API. +In the following screen you need to provide: +- The base URL of the Lizard portal you want to use. This will typically be *your_organisation*.lizard.net. +- A Personal API Key. If you already have an API Key, you can fill it in by clicking "Set...". If you do not have a Personal API Key yet, follow these steps: + - Click "Obtain..." You will be redirected to the management page where you can create a new Personal API Key. + - Create a new Personal API Key by pressing the + NEW ITEM button in the upper right corner. + - Fill in a name for the new Personal API Key. Click on ‘Submit’ to the right. + - You now have your own Personal API Key. Copy it. + - Return to QGIS / the 3Di Modeller Interface. + - Click Set… and paste your Personal API Key. Then click Save. .. image:: /images/d_qgisplugin01.png @@ -40,10 +48,15 @@ The Lizard plugin currently contains the Scenario archive browser (to be extende * Two options: * Retrieve downloadable results (raw results and non-temporal rasters) * Select the results of interest - * [Optional] Set nodata value and projection for raster exports + * [Optional] Set nodata value and projection that the downloaded rasters should get. * Start the download - * Open raster results as WMS layers - * Use the time controls to animate temporal raster results (e.g. water depth) + * Follow the progress at the top of the QGIS main window. + * Add raster results to your project as WMS layers + * Use the `Temporal Controller` to animate temporal raster results (e.g. water depth) + +.. note: + Downloading temporal rasters is not supported at the moment. To visualize them in QGIS or the 3Di Modeller Interface, + add them as WMS and use the `Temporal Controller` to navigate through its time steps. .. image:: /images/d_qgisplugin02.png From a66a25db2912c742d665a7627f91facd94d7d041 Mon Sep 17 00:00:00 2001 From: Leendert van Wolfswinkel Date: Fri, 15 Dec 2023 10:06:43 +0100 Subject: [PATCH 3/4] Update d_qgisplugin.rst Attempt to fix build error --- source/d_qgisplugin.rst | 47 ++++++++++++++++++++++------------------- 1 file changed, 25 insertions(+), 22 deletions(-) diff --git a/source/d_qgisplugin.rst b/source/d_qgisplugin.rst index 6e21ddf..d4bdb01 100644 --- a/source/d_qgisplugin.rst +++ b/source/d_qgisplugin.rst @@ -17,24 +17,24 @@ Installation * As details, fill in '3Di' as *Name*, and 'https://plugins.lizard.net/plugins.xml' as *URL* * Install the Lizard plugin - * Click on the tab *All* - * In the search bar at the top, search for Lizard - * Select Lizard in the panel in the middle - * In the bottom-right of the dialog, click *Install plugin*. + * Click on the tab *All* + * In the search bar at the top, search for Lizard + * Select Lizard in the panel in the middle + * In the bottom-right of the dialog, click *Install plugin*. Initial setup ============= When starting the plugin for the first time you are prompted to provide some settings that are required. In the following screen you need to provide: -- The base URL of the Lizard portal you want to use. This will typically be *your_organisation*.lizard.net. -- A Personal API Key. If you already have an API Key, you can fill it in by clicking "Set...". If you do not have a Personal API Key yet, follow these steps: - - Click "Obtain..." You will be redirected to the management page where you can create a new Personal API Key. - - Create a new Personal API Key by pressing the + NEW ITEM button in the upper right corner. - - Fill in a name for the new Personal API Key. Click on ‘Submit’ to the right. - - You now have your own Personal API Key. Copy it. - - Return to QGIS / the 3Di Modeller Interface. - - Click Set… and paste your Personal API Key. Then click Save. +* The base URL of the Lizard portal you want to use. This will typically be *your_organisation*.lizard.net. +* A Personal API Key. If you already have an API Key, you can fill it in by clicking "Set...". If you do not have a Personal API Key yet, follow these steps: + * Click "Obtain..." You will be redirected to the management page where you can create a new Personal API Key. + * Create a new Personal API Key by pressing the + NEW ITEM button in the upper right corner. + * Fill in a name for the new Personal API Key. Click on ‘Submit’ to the right. + * You now have your own Personal API Key. Copy it. + * Return to QGIS / the 3Di Modeller Interface. + * Click Set… and paste your Personal API Key. Then click Save. .. image:: /images/d_qgisplugin01.png @@ -45,18 +45,21 @@ Scenario archive browser The Lizard plugin currently contains the Scenario archive browser (to be extended with more functionality). * Select a scenario from the list, which can be filtered by scenario name. -* Two options: - * Retrieve downloadable results (raw results and non-temporal rasters) - * Select the results of interest - * [Optional] Set nodata value and projection that the downloaded rasters should get. - * Start the download - * Follow the progress at the top of the QGIS main window. - * Add raster results to your project as WMS layers - * Use the `Temporal Controller` to animate temporal raster results (e.g. water depth) + +After selecting a scenario, you have two options: + +* Retrieve downloadable results (raw results and non-temporal rasters) + * Select the results of interest + * [Optional] Set nodata value and projection that the downloaded rasters should get. + * Start the download + * Follow the progress at the top of the QGIS main window. + +* Add raster results to your project as WMS layers + * Use the `Temporal Controller` to animate temporal raster results (e.g. water depth) .. note: - Downloading temporal rasters is not supported at the moment. To visualize them in QGIS or the 3Di Modeller Interface, - add them as WMS and use the `Temporal Controller` to navigate through its time steps. + + Downloading temporal rasters is not supported at the moment. To visualize them in QGIS or the 3Di Modeller Interface, add them as WMS and use the `Temporal Controller` to navigate through its time steps. .. image:: /images/d_qgisplugin02.png From 20b506b28d85f2cdbf5dfacc3b754b714ac0c20a Mon Sep 17 00:00:00 2001 From: Leendert van Wolfswinkel Date: Fri, 15 Dec 2023 10:12:43 +0100 Subject: [PATCH 4/4] Update d_qgisplugin.rst poging 2 om build fail te fixen --- source/d_qgisplugin.rst | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/source/d_qgisplugin.rst b/source/d_qgisplugin.rst index d4bdb01..2244b6d 100644 --- a/source/d_qgisplugin.rst +++ b/source/d_qgisplugin.rst @@ -27,13 +27,21 @@ Initial setup When starting the plugin for the first time you are prompted to provide some settings that are required. In the following screen you need to provide: + * The base URL of the Lizard portal you want to use. This will typically be *your_organisation*.lizard.net. -* A Personal API Key. If you already have an API Key, you can fill it in by clicking "Set...". If you do not have a Personal API Key yet, follow these steps: + +* A Personal API Key. If you already have an API Key, you can fill it in by clicking "Set...". If you do not have a Personal API Key yet, follow these steps. + * Click "Obtain..." You will be redirected to the management page where you can create a new Personal API Key. + * Create a new Personal API Key by pressing the + NEW ITEM button in the upper right corner. + * Fill in a name for the new Personal API Key. Click on ‘Submit’ to the right. + * You now have your own Personal API Key. Copy it. + * Return to QGIS / the 3Di Modeller Interface. + * Click Set… and paste your Personal API Key. Then click Save. .. image:: /images/d_qgisplugin01.png @@ -49,12 +57,17 @@ The Lizard plugin currently contains the Scenario archive browser (to be extende After selecting a scenario, you have two options: * Retrieve downloadable results (raw results and non-temporal rasters) + * Select the results of interest + * [Optional] Set nodata value and projection that the downloaded rasters should get. + * Start the download + * Follow the progress at the top of the QGIS main window. * Add raster results to your project as WMS layers + * Use the `Temporal Controller` to animate temporal raster results (e.g. water depth) .. note: