Skip to content

USGS-R/RSurvey

Repository files navigation

RSurvey

Travis Build Status CRAN Version USGS Category

Deprecated

Development of this package has halted. If you are interested in taking over maintainer status for the package, please email the author.

Overview

The R package 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.

Install

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 macOS, 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

capabilities("tcltk")

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

install.packages("RSurvey")

Or use devtools to install the development version from GitHub.

devtools::install_github("USGS-R/RSurvey")

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.

Run

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

library("RSurvey")

Disclaimer

This information is preliminary or provisional and is subject to revision. It is being provided to meet the need for timely best science. The information has not received final approval by the U.S. Geological Survey (USGS) and is provided on the condition that neither the USGS nor the U.S. Government shall be held liable for any damages resulting from the authorized or unauthorized use of the information.

Although this software program has been used by the U.S. Geological Survey (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.