GME is a stand-alone program that can be started from the Windows Start button -- Programs -- SpatialEcology.
GME has dependencies on three other software packages that you must install: R, StatConn, and ArcGIS. Use the table below to identify compatible versions of the software. If you are upgrading any of the dependencies, it is recommended that you use Control Panel to uninstall the old version first. See below for further details.
I recommend you subscribe to the newsletter to receive notification of updates, new functionality, bug fixes, and other related news.
Download GME here:
| ArcGIS | Download GME | R | StatConn DCOM |
| ArcGIS 10 SP2/SP3 | GME 0.5.5 Beta | R 2.12.2+ | 3.1-2B7 |
| Pre-ArcGIS 10 | Not supported | NA | NA |
(SP = Service Pack)
ArcGIS 10: it is very important to ensure you have the Microsoft .NET Framework 3.5 installed BEFORE you install ArcGIS 10, otherwise the ESRI .NET libraries will not be installed!
GME 0.4.0 for ArcGIS 9.3.1: This version has been removed as it is no longer possible to access the required version of Statconn.
Instructions:
1. Uninstall any prior versions of GME using Control Panel -- Add/Remove Programs (which is called 'Programs and Features' in Vista/Win7). If prior to GME 0.3.3, use the C:\Program Files\SpatialEcology\GME\gme_setup.exe program.
2. Identify which configuration applies to your system using the above table. Install or update ArcGIS, R, and StatConn as required.
3. Download the zip file using the 'Download GME' link, unzip it, run setup.exe. (The .exe and .msi files must remain together, but you should install using the setup.exe program, not the gme.msi file). You must have administrator rights to run the setup.exe program (e.g. in Vista, right-click the setup program and select 'Run as Administrator').
ArcInfo and ArcEditor users: GME is compiled against an ArcView license, but also works fine with these other (higher) licenses.
**Installing GME with other versions of ArcGIS: GME is compiled against a particular version of ArcGIS, and it is recommended you use GME with only that version. However, although it is not recommended, you could try using GME with other versions of ArcGIS. If it is a version that is close to the supported version, it would probably run fine. But if you try to use it with more distant versions of ArcGIS there is a chance that some commands will generate errors, or, worse, will run but produce incorrect output. I strongly recommend you use caution when running any third party extension (including GME) with a version of ArcGIS other than the version it was compiled against.
Detailed Instructions
GME has two dependencies: the open source, statistical software R, and a program called StatConn, written by Thomas Baier and Dr Erich Neuwirth, that allows other software (such as GME) to communicate with R. It is recommended that you install this software yourself before running the GME installation program.
Step 1: To install the required version of R and StatConn DCOM, go to the StatConn website, click the 'Download' link near the top, and download and run the 'RAndFriends' setup program. This installs everything that is required.
If you already have R installed you can just download the StatConnDCOM software from that page, but make sure that you then install the rscproxy package in R using: install.packages("rscproxy")
Step 2: Download and run the GME setup program from this website (see table above).
Step 3: Install required R libraries. It is recommended that you install the required R libraries as an Administrator. In Windws XP, log in with an administrative account and start R. In Vista or higher, log in with an administrative account and then right-click on the R icon and select Run As Administrator. Then copy and paste this text into R and press Enter:
install.packages(pkgs=c("deldir", "CircStats", "gplots","ks"))
If these libraries are not installed, GME will attempt to automatically install them as it needs them. However, to avoid possible problems (especially if you are using a proxy server to access the internet) it is still recommended that you install them yourself when you first install R.
Troubleshooting Installation
The installation program does not run
You must use the setup.exe program, not the gme.msi program, to install GME. The former performs a variety of checks on your system and helps you install missing components. Also, run it with Administrator privileges (an admin account in WinXP, or right-click and 'Run as Administrator' in Vista/Win7).
Problems with R
It is recommended that you uninstall any previous versions of R before installing a new version. You can uninstall any version of R using the Control Panel, Add/Remove Programs interface (in Vista/Win7 it is Control Panel, Programs and Features).
Please note that the most recent version of R may not be compatible with StatConn. Occasionally, particularly when there have been major structural changes to R as in the switch from version 2.7 to 2.8, there is a slight delay in the availability of an updated version of StatConn. So please check the StatConn website to ensure you are installing a version of R that is compatible with StatConnDCOM. If you follow Step 1 above it ensures compatibility.
To get the most recent version of R, go to the R website and click the 'CRAN' link on the left hand side (see picture below). Select a mirror site near you from the list, click the 'Windows' link on the next page, then the 'base' link on that page after that, and download the R installer called 'R-2.11.1-win32.exe' (note that the version number you see may be different than this example). When you run the R installation program keep an eye out for an option that says 'Save version number in registry'. By default this is checked. Please keep this option checked (in fact, if you install R to a location other than the default installation folder, then you MUST have this option checked or GME will not work).
Finally, install the required packages. (If you access the internet via a proxy server then see the help section below that describes how to configure R for use with a proxy server before proceeding). Open R, from the Packages menu select 'Install Packages', select a mirror near you, and from the long list of packages select the following: CircStats, ks, rscproxy, deldir, gplots. Press OK and R will install these packages for you.
Acquiring the R installer from the R website
Problems with StatConn
The authors of StatConn, Thomas Baier and Dr Erich Neuwirth, generously make this software available to us all for free. It is a very useful contribution to the statistical community. If you have problems installing their software then you should first review the extensive material in their Wiki. If you fail to resolve your problem there, you could send an email their mailing list. It is not appropriate to email the authors of StatConnDCOM with installation questions if you have not first made a reasonable effort to discover the solution to your problem using these two sources of information. Also, please do not email them with GME questions as they are not responsible for GME.
It is highly recommended that you uninstall previous versions of StatConn (or the older 'R/Scilab (D)COM Server') using the Control Panel, Add/Remove Programs interface before installing a new version.
Other issues
Supported Operating Systems
This software should run on any Windows XP, Vista or Windows 7 system (32 or 64 bit). I do not know how well it runs on terminal servers.
Registry problems
GME no longer enters any data into the registry, so the registry issues with previous versions are now resolved.
Uninstall GME.
From 0.3.3 onwards: you can uninstall using Control Panel where it is listed as "GME".
Older verions: To perform a manual uninstall, close down all ArcGIS programs, use Windows Explorer to browse to the folder containing the SEGME.dll, and double-click the file called uninstall.reg (you will be prompted about a registry change). Once that is done you can delete the 'GME' folder that contains the SEGME.dll and associated files. Note that it is very important that you remove the registry values using the uninstall.reg file before you delete the files.