/MSBuffer

Multi-scale spatial analyses for the delimitation and management of protected area buffer zones

Primary LanguagePythonGNU General Public License v2.0GPL-2.0

MSBuffer

This is a repository for sharing the code of the Multi-Scale Buffer (MSBuffer) ArcGIS toolbox. It is a free and open source package built as an ArcToolbox in Python 2.7 to perform multi-scale spatial analyses for Conservation Unit buffer zones delimitation and management. MSBuffer tool performs area and length calculation and feature counting in buffers of multiples buffer sizes around of an area of interest.

MSBuffer was developed and is maintained by the Spatial Ecology and Conservation Lab (LEEC), at Universidade Estadual Paulista, Rio Claro, SP, Brazil.

The repository has 3 folders:

  • MSBuffer_v1_0_0: here you can find the main MSBuffer stable script, as well as the ArcGIS toolbox itself.
  • old_versions: old versions of the code (before package release).
  • Maps_tutorial: maps and data for testing and tutorials.

For more information on how to use and how it works, take a look at the pdf tutorial or at our wiki.

How to use

MSBuffer runs as a ArcToolbox, therefore you should first install ArcGIS in your computer. You can download and find installation procedures for ArcGIS here and here.

Adding MSBuffer as an ArcToolbox inside ArcMap.

  • Open ArcMap with an empty map document file and open the ArcToolbox window.
  • Right-click on ArcToolbox > Add toolbox and navigate to the folder where you have saved to MSBuffer.
  • Open the toolbox by selecting MSBuffer.tbx and clicking on the Open button. The MSBuffer should now be displayed in ArcToolbox.

Three basic steps to run MSbuffer:

1. What do you need to use this tool?

  • ArcMap installed and MSBuffer added as toolbox
  • A map (a Conservation Unit, forest fragment, a city map, an area of interest, etc.).
  • A variable of interest (point, line or polygon shapefile maps with information about, for example, species occurrence, caves occurrence, forest cover, land use type and roads).

2. Running MSBuffer

  1. Input the map of the area of interest in the "Input Map" and select the identification column (eg. name of the area) in the attribute table of the map. In the case of the input map contains more than one polygon (eg. multiple conservation units or areas of interest) the program will run a similar buffer analysis for each area and the identification column and print the requested metrics according to the identification column specified.
  2. Input the variable of interest (the response variable of the buffer analysis, eg. forest cover area).
  3. Set the size of the buffer steps (the unit here is the same of your projection units, therefore, we strongly recommend that projections should be set to meters).
  4. Set how many buffer you want to run.
  5. Choose the metrics you want to calculate (area, count, functional area).
  6. Set the path for the output folder.
  7. Name your output .txt file.
  8. Click "OK" to run.

Authors

Bruno P. Leles <brunopleles@gmail.com>
Bernardo B. S. Niebuhr <bernardo_brandaum@yahoo.com.br>
John W. Ribeiro <jw.ribeiro.rc@gmail.com>
Milton C. Ribeiro <mcr@rc.unesp.br>

Citation

If you are going to use and cite MSBuffer in your study or report, please refer to:

Leles, BP; Niebuhr, BBS; Ribeiro, JW; dos Santos, JS; Eboli, C; Hughes, AC; Ribeiro, MC. The importance of multi-scale spatial analyses for the delimitation and management of Conservation Unit buffer zones. Under review.