Introduc on to Invest Arcgis Tool

Introducon to InVEST ArcGIS Tool

Nasser Olwero

GMP, Bangkok April 2-6 2012 Background of tool design

Why a tool/ArcGIS Tool? ArcGIS Geoprocessing Framework

1. Tool dialog 2. Command line 3. Model builder 4. Scripng (ArcObjects, Python, VB…) a) The python geoprocessing object Why Python?

1. Supported by ESRI 2. Simple, easy to learn and use 3. Robust 4. Extensible 5. Flexible InVEST Installaon process

• InVEST: The Applicaon • Get InVEST • Install the core InVEST applicaon – InVEST stascs while that runs • Check installaon • InVEST Marine Extensions InVEST: The Applicaon

• InVEST is a framework for mapping Ecosystem Services and evaluang tradeoﬀs. • InVEST The Soware consists of – A set of Python scripts dependent on ArcGIS • generally one per model biophysical and valuaon module – Base datasets • Some required, some oponal – Documentaon Where to get InVEST

• InVEST is released as a Windows installer downloadable from our website – hp://www.naturalcapitalproject.org/ Alternave Download Opons

• We oﬀer alternave downloads for InVEST users with slow Internet connecons: – Full (296 MB) – Models Only (56.7 MB) – Individual datasets (variable sizes) InVEST Installaon Procedure

1. Copy InVEST_2.2.2_Full_Setup.exe to your desktop (or other locaon) 2. Double click the icon to start the installaon process 3. By default the InVEST toolset will copy itself to C:\InVEST_2_2_2 and take 1.9 GB of disk space. 4. This is will take a few minutes. Checking Your Installaon

• Open your ﬁle explorer and check for a directory in C:\InVEST_2_2_2 Checking Your Installaon

• In C: \InVEST_2_2_2 you’ll ﬁnd an ArcMap document and an ArcToolbox • Open the ArcMap document and add the toolbox if necessary You’ll End up With this Complete Installaon

• Enable Spaal Analyst Extension • Install Marine Python Extensions • Non-English Language in Windows? – We might need to change the decimal symbol and digit grouping symbol. Enable Spaal Analyst Extension

• Most InVEST models require the Spaal Analyst Extension • Customize -> Extensions -> Spatial Analyst InVEST Marine Extensions

• Visit www.naturalcapitalproject.org • Navigate to the download page • Download the “Marine Python Extensions” for your version of Arc (9.3 or 10). – Install each of the installers: • matplotlib • numpy • pywin32 • Scipy Check Marine Extensions

• Run the “Marine Python Extension Check” ArcGIS Licensing and ArcToolbox

1. Licensing – ArcView, ArcEditor, Arcmap, Spaal Analyst 2. ArcGIS Tools and Toolboxes Loading toolbox (tbx) Seng script source Seng tool parameters

2 Running model Progress and error reporng

Custom errors Windows Language Sengs

• Some InVEST models require that ﬂoang point values are separated by decimals. – A problem in some non-English languages • Windows 7 Users: – Go to Control Panel -> Clock, Language and Region – Under Region and Language choose "Change the date, me or number format“ – Easiest thing to do: Set Format to English (United States) – OR: To just do commas and periods, click "Addional sengs..." then change values in "Decimal symbol" to “.” and "Digit grouping symbol“ to “,” • Windows XP Users: – Control Panel -> Regional and Language Opons – Easiest thing to do: Under the Regional Opons tab, pick English (United States) from the drop-down – OR: To just do commas and periods, click "Customize..." then change values in "Decimal symbol" to “.” and "Digit grouping symbol“ to “,” InVEST Versioning Scheme

• 2.2.2 is the major version number – An increment means change of plaorm or architecture • 2.2.2 is the minor version number – This increments as new models are added to the suite • 2.2.2 is the release number – This increments when bugs are ﬁxed and released with no new funconality Release “Schedule”

• Generally we release a new InVEST version every 3-5 months:

InVEST 1.005 InVEST 2.1 InVEST 2.2.0 7/13/2010 5/13/2011 12/22/2012 InVEST 1.001 12/16/2008 InVEST 1.002 InVEST 1.003 InVEST 1.004 InVEST 2.0 InVEST 2.1.3 InVEST 2.2.1 4/17/2009 8/10/2009 2/16/2011 InVEST 1.0 3/12/2010 10/17/2011 1/22/2012 10/13/2008

2008 2009 2010 2011 2012

• InVEST 3.0 will be the big one in late 2012 Folder/ﬁle/column naming:

1. No spaces 2. Use shorter names 3. Avoid special characters(eg hyphen) 4. Naming consistency. ChangeLog Projecons

1. Data should be in meters 2. All data should have same projecon 3. If possible, project the vector to match raster and not the other way round. Soware versions

1. ArcGIS 9.3, 10 2. Python 2.4, 2.5 3. Extensions 1. Spaal Analyst 2. Numpy 3. Scipy (See speciﬁc models) Data locking

1. ArcGIS and Python are separate 2. Close ﬁles before running model. Resoluon and ﬁle size

1. Set working resoluon on tool interface 2. High resoluon takes me to compute, demanding on computer resources 3. Set resoluon based on the model. Results suﬃx

1. Uniquely idenﬁes each run 2. Restricted to 1 character 3. Parameter log ﬁle records input User Support for InVEST

• Online user’s guide, also included with the InVEST install. • Need addional support or ﬁle a bug report? Email: – [email protected] • InVEST user listserv launched Eding tables

1. Edit in ArcMap OR Excel* 2. Excel 2007 does not save dbf 3. ArcGIS 9.2 does not read xlsx 4. Use Open oﬃce. Under the hood (advanced) InVEST 3.0 Preview Who Downloads InVEST?

• We started tracking user analytics on October 23, 2011. Prior to that we had “about 2000” downloads. • InVEST 2.1.3 (released 10/17/2011) – 164 downloads • InVEST 2.2.0 (released 12/22/2011) – 889 downloads • InVEST 2.2.1 (released 1/22/2012) – 55 downloads Who Downloads InVEST?

• Breaking down InVEST 2.2.0 downloads per country for those > 3% Country Percent of InVEST 2.2.0 Downloads United States 23.99%

China 22.61%

Brazil 4.27%

South Korea 4.04%

Mexico 3.69%

South Africa 3.34%