R-ArcGIS / r-bridge-install

Install the R ArcGIS Tools

Install the R-ArcGIS Bridge

Install and update the R-ArcGIS bridge with this Python toolbox.

NOTE: If you encounter problems, please create an issue so that we can take a look.

Prerequisites

• ArcGIS 10.3.1 or later or ArcGIS Pro 1.1 or later (don't have it? try a 60 day trial)
• R Statistical Computing Software, 3.5 or later (What is R?)

• 32-bit version required for ArcMap, 64-bit version required for ArcGIS Pro (Note: the installer installs both by default).
• 64-bit version can be used with ArcGIS Pro, or with ArcMap by installing Background Geoprocessing and configuring scripts to run in the background. NOTE: Background Geoprocessing only allows using the bridge from ArcGIS, not from within R itself.

Installation

First, make sure you've installed an appropriate version of R, 3.5 or later.

If you need to install offline, follow the offline installation instructions.

The clip below shows how to download, install and verify proper installation of the bridge:

ArcGIS 10.3.1+

• In the Catalog window, navigate to the folder containing the Python Toolbox, R Integration.pyt. Note: You may have to first add a folder connection to the location that you extracted the files or downloaded via GitHub.
• Open the toolbox, which should look like this:

• Run the Install R bindings script. You can then test that the bridge is able to see your R installation by running the Print R Version and R Installation Details tools, and running the included sample tools.

ArcGIS Pro 1.1+

• In the Project pane, either navigate to a folder connection containing the Python toolbox, or right click on Toolboxes > Add Toolbox and navigate to the location of the Python toolbox.
• Open the toolbox, which should look like this:

• Run the Install R bindings script. You can then test that the bridge is able to see your R installation by running the Print R Version and R Installation Details tools, and running the included sample tools.

If everything worked, you should be ready to start! See Next Steps for where to go from here. Remember, you can update the package at any time by running the 'Update R bindings' script.

Offline Installation

• From a machine that does have internet access:
  • download this repository.
  • download the latest version of the arcgisbinding package. As of writing, this is arcgisbinding_1.0.0.122.zip.
• Copy both zip files onto the machine that you're targeting offline installation. Extract the r-bridge-install zip. Place the arcgisbinding_1.0.0.122.zip into the same directory as the "R Integration" Python toolbox.
• Run the installation procedure as listed above.

Problems Installing?

• A few things to check :
  • All prerequisites have been met, such as the right version of R for your platform, and a current release of ArcGIS.
  • Make sure that your user has administrator access, and try running ArcGIS as an Administrator:
  • Start ArcGIS as an administrator, by right clicking the icon, selecting 'Run as Administrator', then trying the script
  • If that doesn't work, the package directory, "arcgisbinding", that gets installed into the R folder (usually, C:\Users<username>\Documents\R\win-library) into the requested place, C:\Program Files (x86)\ArcGIS\Desktop\Rintegration
  • On Windows 7, KB2533623 must be installed. Without this hotfix, the library will generate the error "The procedure entry point AddDllDirectory could be located".
• The release can be manually installed into R, as shown in this screencast. Use this if you're planning on mostly working from R.
• Still stuck? Add an issue and we'll take a look. (More about GitHub Issues)

Next Steps

Additional resources and discussion at the R-ArcGIS project on GeoNet

Want to use tools others have developed?

• See how complex problems can be solved with R and ArcGIS in the Sample Tools, such as model-based clustering and combining parametric and non-parametric models with semiparametric regression.
• Check out the community page for more tools Coming Soon

Want to develop new tools using R?

• Develop new R-based tools using the R package arcgisbinding, which is described in the package vignette. There are additional resources within the bridge repository and the package documentation.

Credits

This toolbox depends on the R Statistical Computing Software:

Copyright (C) 2015 The R Foundation for Statistical Computing R is free software and comes with ABSOLUTELY NO WARRANTY. See the COPYRIGHTS file for details.

This toolbox depends on ntfsutils:

(c) 2012 the Mozilla Foundation and others, licensed under the Simplified BSD License. See the LICENSE file for details.

License

Apache 2.0