Update how to setup authored by Jakob Grahn's avatar Jakob Grahn
...@@ -2,13 +2,14 @@ Below are step-by-step instructions for setting up the 2D-InSAR VPI ArcGIS toolb ...@@ -2,13 +2,14 @@ Below are step-by-step instructions for setting up the 2D-InSAR VPI ArcGIS toolb
## 1. Remove old installation: ## 1. Remove old installation:
If you have an older version of the vpi-toolbox installed already, remove the toolbox from ArcGIS: If you have an older version of the vpi-toolbox installed already, remove the toolbox from ArcGIS:
><details><summary>Show screen shot</summary>[[https://gitlab.itek.norut.no/jakob/vpi-toolbox/uploads/07bfcbde9012f449d0a1102fe1b51125/image.png]]</details>
Also, remove the old vpi conda environment, by first open `Start` > `ArcGIS` > `Python Command Prompt`: Also, remove the old vpi conda environment, by first opening `Start` > `ArcGIS` > `Python Command Prompt`:
<details><summary>Show screen shot</summary>[[resources/how-to-setup_python-command-prompt.png]]</details> ><details><summary>Show screen shot</summary>[[resources/how-to-setup_python-command-prompt.png]]</details>
In the command prompt, type: In the command prompt, type:
```bash ```bash
conda deactivate deactivate
conda remove --name vpi --all conda remove --name vpi --all
``` ```
...@@ -19,7 +20,8 @@ Make sure you have updated ArcGIS to 2.5 or higher. ...@@ -19,7 +20,8 @@ Make sure you have updated ArcGIS to 2.5 or higher.
[Download](https://gitlab.itek.norut.no/jakob/vpi-toolbox#releases) the VPI toolbox and unzip it to a path of your choice, from now on referenced to as `C:\path-to-vpi-codes\`. [Download](https://gitlab.itek.norut.no/jakob/vpi-toolbox#releases) the VPI toolbox and unzip it to a path of your choice, from now on referenced to as `C:\path-to-vpi-codes\`.
## 4. Create ArcGIS Conda environment: ## 4. Create ArcGIS Conda environment:
Open `Start` > `ArcGIS` > `Python Command Prompt`: <details><summary>Show screen shot</summary>[[resources/how-to-setup_python-command-prompt.png]]</details> Open `Start` > `ArcGIS` > `Python Command Prompt`:
><details><summary>Show screen shot</summary>[[resources/how-to-setup_python-command-prompt.png]]</details>
In the command prompt, type (where `C:\path-to-vpi-codes\` must be changed to the path to the vpi source code as of step 1): In the command prompt, type (where `C:\path-to-vpi-codes\` must be changed to the path to the vpi source code as of step 1):
```bash ```bash
...@@ -28,18 +30,22 @@ conda create --clone arcgispro-py3 --name vpi ...@@ -28,18 +30,22 @@ conda create --clone arcgispro-py3 --name vpi
conda env update --name vpi --file conda\environment_arcgis.yml conda env update --name vpi --file conda\environment_arcgis.yml
``` ```
Open ArcGIS Pro, go to `Project` > `Python` > `Manage Environments`: <details><summary>Show screen shot</summary>[[resources/how-to-setup_python-package-manager.png]]</details> Open ArcGIS Pro, go to `Project` > `Python` > `Manage Environments`:
><details><summary>Show screen shot</summary>[[resources/how-to-setup_python-package-manager.png]]</details>
Activate the environment called "vpi": <details><summary>Show screen shot</summary>[[resources/how-to-setup_manage_environments.png]]</details> Activate the environment called "vpi":
><details><summary>Show screen shot</summary>[[resources/how-to-setup_manage_environments.png]]</details>
Restart ArcGIS Pro. Restart ArcGIS Pro.
## 5. Add the toolbox to your project ## 5. Add the toolbox to your project
After restarting ArcGIS Pro, go to the catalog pane: <details><summary>Show screen shot</summary>[[resources/how-to-setup_add-toolbox.png]]</details> After restarting ArcGIS Pro, go to the catalog pane:
><details><summary>Show screen shot</summary>[[resources/how-to-setup_add-toolbox.png]]</details>
Left-click `Toolboxes`, click `Add Toolbox` and select the file: Left-click `Toolboxes`, click `Add Toolbox` and select the file:
``` ```
C:\path-to-vpi-codes\vpi.pyt C:\path-to-vpi-codes\vpi.pyt
``` ```
The 2D-InSAR VPI toolbox should appear and be ready for use: <details><summary>Show screen shot</summary>[[resources/how-to-setup_added-toolbox.png]]</details> The 2D-InSAR VPI toolbox should appear and be ready for use:
><details><summary>Show screen shot</summary>[[resources/how-to-setup_added-toolbox.png]]</details>