Travis Build Status AppVeyor Build Status CRAN Version


RSurvey is a geographic information system (GIS) graphical user interface (GUI) that provides data viewing, management, and analysis tools. The cross-platform application was designed to be simple enough for non-technical users. RSurvey-generated graphics attempt to meet the exact standards for illustrations in reports of the United States Geological Survey (USGS).


If R is not already installed on your computer, download and install the latest binary distribution from the Comprehensive R Archive Network (CRAN). Windows users should set R to operate as a single document interface (SDI) application during installation by choosing to customize the start-up options and specifying the SDI interface (not the default).

If your operating system is OS X, download and install XQuartz, and reboot your computer.

RSurvey uses the Tk toolkit for GUI rendering, access to Tk is provided by the tcltk package. To check if Tk is available, startup an R session and type the following at the command prompt


Support for viewing and editing table data is provided by Tktable, a spreadsheet-like Tk widget (typically included with the binary distribution of R). To check if Tktable is available, use the command

inherits(tcltk::tclRequire("Tktable", FALSE), "tclObj")

To install the stable version of RSurvey from CRAN use the command


Or use devtools to install the development version from GitHub.


In addition to its required packages, RSurvey can make use of the functionality in its suggested packages. If any of the suggested packages are missing, you will be prompted to install them when it first starts up.

If you're running into difficulties with package installation, see the R Commander installation notes for possible solutions. R Commander is another GUI implemented as an R package.


Load RSurvey in the current R session and launch its main GUI using the command



Report bugs, suggest new features on the Issues page, and propose improvements with pull requests. A tentative list of features proposed for future releases is given on the Future Plans page.


This software is in the public domain because it contains materials that originally came from the USGS, an agency of the United States Department of Interior. For more information, see the official USGS copyright policy.

Although this software program has been used by the USGS, no warranty, expressed or implied, is made by the USGS or the U.S. Government as to the accuracy and functioning of the program and related program material nor shall the fact of distribution constitute any such warranty, and no responsibility is assumed by the USGS in connection therewith.

This software is provided "AS IS."