Introduc)on  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.  ScripOng  (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  InstallaOon  process  

•  InVEST:  The  ApplicaOon  • Get  InVEST  •  Install  the  core  InVEST  applicaOon  – InVEST  staOsOcs  while  that  runs  

• Check  installaOon  •  InVEST  Marine  Extensions  

InVEST:  The  ApplicaOon  

•  InVEST  is  a  framework  for  mapping  Ecosystem  Services  and  evaluaOng  tradeoffs.  

•  InVEST  The  So/ware  consists  of  – A  set  of  Python  scripts  dependent  on  ArcGIS  

• generally  one  per  model  biophysical  and  valuaOon  module  

–  Base  datasets  • Some  required,  some  opOonal  

– DocumentaOon  

Where  to  get  InVEST  

•  InVEST  is  released  as  a  Windows  installer  downloadable  from  our  website  –  h`p://www.naturalcapitalproject.org/  

AlternaOve  Download  OpOons  

• We  offer  alternaOve  downloads  for  InVEST  users  with  slow  Internet  connecOons:  – Full  (296  MB)  – Models  Only  (56.7  MB)  – Individual  datasets  (variable  sizes)  

InVEST  InstallaOon  Procedure  

1.  Copy  InVEST_2.2.2_Full_Setup.exe  to  your  desktop  (or  other  locaOon)  

2.  Double  click  the  icon  to  start  the  installaOon  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  InstallaOon  

•  Open  your  file  explorer  and  check  for  a  directory  in  C:\InVEST_2_2_2

Checking  Your  InstallaOon  

•  In  C:\InVEST_2_2_2 you’ll  find  an  ArcMap  document  and  an  ArcToolbox  

•  Open  the  ArcMap  document  and  add  the  toolbox  if  necessary  

You’ll  End  up  With  this  

Complete  InstallaOon  

•  Enable  SpaOal  Analyst  Extension  •  Install  Marine  Python  Extensions  •  Non-­‐English  Language  in  Windows?  

– We  might  need  to  change  the  decimal  symbol  and  digit  grouping  symbol.  

Enable  SpaOal  Analyst  Extension  

• Most  InVEST  models  require  the  SpaOal  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,  SpaOal  Analyst  2.  ArcGIS  Tools  and  Toolboxes  

Loading  toolbox  (tbx)  

Seing  script  source  

Seing  tool  parameters  

1  

2  

Running  model  

Progress  and  error  reporOng  

Custom  errors  

Windows  Language  Seings  

•  Some  InVEST  models  require  that  floaOng  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,  Ome  or  number  

format“  –  Easiest  thing  to  do:  Set  Format  to  English  (United  States)  –  OR:  To  just  do  commas  and  periods,  click  "AddiOonal  seings..."  then  

change  values  in  "Decimal  symbol"  to  “.”  and  "Digit  grouping  symbol“  to  “,”  

•  Windows  XP  Users:  –  Control  Panel  -­‐>  Regional  and  Language  OpOons  –  Easiest  thing  to  do:  Under  the  Regional  OpOons  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  planorm  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  fixed  and  released  with  no  new  funcOonality  

Release  “Schedule”  

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

2008   2009   2010   2011   2012  

InVEST  1.0  10/13/2008  

InVEST  1.001  12/16/2008   InVEST  1.002  

4/17/2009  InVEST  1.003  8/10/2009  

InVEST  1.004  3/12/2010  

InVEST  1.005  7/13/2010  

InVEST  2.0  2/16/2011  

InVEST  2.1  5/13/2011  

InVEST  2.1.3  10/17/2011  

InVEST  2.2.0  12/22/2012  

InVEST  2.2.1  1/22/2012  

•  InVEST  3.0  will  be  the  big  one  in  late  2012  

Folder/file/column    naming:  

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

ChangeLog  

ProjecOons  

1.  Data  should  be  in  meters  2.  All  data  should  have  same  projecOon  3.  If  possible,  project  the  vector  to  match  

raster  and  not  the  other  way  round.  

Sopware  versions  

1.  ArcGIS  9.3,  10  2.  Python  2.4,  2.5  3.  Extensions  1.  SpaOal  Analyst  2.  Numpy  3.  Scipy  (See  specific  models)  

Data  locking  

1.  ArcGIS  and  Python  are  separate  2.  Close  files  before  running  model.  

ResoluOon  and  file  size  

1.  Set  working  resoluOon  on  tool  interface  2.  High  resoluOon  takes  Ome  to  compute,  

demanding  on  computer  resources  3.  Set  resoluOon  based  on  the  model.  

Results  suffix  

1.  Uniquely  idenOfies  each  run  2.  Restricted  to  1  character  3.  Parameter  log  file  records  input  

User  Support  for  InVEST  

•  Online  user’s  guide,  also  included  with  the  InVEST  install.  

•  Need  addiOonal  support  or  file  a  bug  report?  Email:  – richsharp@stanford.edu

•  InVEST  user  listserv  launched  

EdiOng  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  office.  

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%