Skip to content

StuartRP/tenement-tools

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tenement Tools

The Tenement Tools ArcGIS Pro plug-in is currently under active development and bugs should be expected. If you would like to test the pre-release alpha version, please follow the below instructions.

Requirements

Setup

The Tenement Tools setup process can take up to 30 minutes. Please follow the below steps to install.

1. Download Tenement Tools plug-in and tutorial material

Download the tenement-tools.zip, tutorial.zip and tutorial.pdf files here:

2. Extract tenement-tools folder

Extract the tenement-tools folder from the tenement-tools.zip and store it somewhere permanent.

  • Recommended location: C:/Users/%USERNAME%/Documents/ArcGIS/tenement-tools

3. Clone default ArcGIS Pro python environment

Tenement Tools requires a custom Python virtual environment. Luckily, ArcGIS Pro makes this easy:

  1. Open Windows Start Menu > ArcGIS folder > Python Command Prompt
  2. Enter and run conda create --clone arcgispro-py3 --name arcgispro-py3-dev-tool
  3. When finished, enter and run: activate arcgispro-py3-dev-tool

4. Install addtional Python libraries

Now, enter and run each of the below in order (enter 'y' if asked at end of each):

  • conda install dask=2.30.0
  • conda install -c conda-forge rasterio=1.1.5
  • pip install pyproj==3.2.1
  • conda install -c conda-forge scikit-learn=1.0

Close the Python Command Prompt when finished.

5. Add the Tenement Tools plug-in to ArcGIS Pro

Now, add the actual plug-in to ArcGIS Pro:

  • Run ArcGIS Pro > Add-In Manager > Options tab > Add Folder > Select extracted tenement-tools folder (from step 2)

6. Initialise the new python environment in ArcGIS Pro

Change ArcGIS Pro software to use the custom Python environment (from step 4):

  • Run ArcGIS Pro > Settings > Python > Manage Environments > Select arcgispro-py3-dev-tool > OK

Restart ArcGIS Pro.

7. Create new ArcGIS Pro project and add Tenement Tools Toolbox

Create a new ArcGIS Pro project for the tutorial:

  • New > Map

Finally, add the Tenement Tools toolbox to the project:

  • In Catalog Pane > right-click Toolboxes icon > Add Toolbox > go to extracted folder (step 2) > toolbox folder > add tenement-tools-toolbox.pyt

8. Walkthrough the tutorial pdf

A good place to start is with the Tutorial.pdf document downloaded in step 1.

Install Issues

There are a known issues when cloning the arcgispro-py3 environment in step 3. You maye see the following when activating:

  • The system cannot find the path specified
  • set "GDAL_DRIVER_PATH='
  • rem proj-data is installed because its license was copied over.

The plug-in should still work, regardless. We are currently investigating this issue.

Bug report

If you encounter a bug please email: [email protected] and please provide some context regarding the bug/error:

  • Which tool were you using when the error occurred
  • Describe the data you were using as inputs into the tool
  • What version of ArcGIS Pro are you using (e.g., 2.8, 2.9)
  • If possible, provide a screenshot of the error message
  • Any other useful information

Known bugs

Map outputs from tools do not look correct/match tutorial

A bug has been found where the output from a tool (e.g., metric layers from Phenolopy) do not visualise properly (even though the model was successful). These layers can look all red or blue, have very subdued colours, not match tutorial data. As we explore this issue, you can get around it by going to Add Data > Add Multimdemnsional Data > select the raw output NetCDF (.nc) from the tool you just ran.

COG Fetcher Sentinel band selector is broken

When selecting the Sentinel satellite platform the band selector checkboxes will result in errors. We will correct this in the next release.

Phenolopy LIOS and SIOS output layers look 'noisey' when using Landsat

Currently investigating.

About

Python tools to map and monitor groundwater-dependent vegetation at a tenement scale.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Jupyter Notebook 83.2%
  • Python 16.0%
  • C# 0.8%