Installing and running GAT

The Geographic Aggregation Tool (GAT) is available from New York State (NYS) Environmental Public Health Tracking (EPHT) GitHub.

Until GAT is posted to CRAN, the easiest way to install is from GitHub. You will need to install devtools first. Some users have also reported that they needed to install RTools first.

install.packages("devtools")
devtools::install_github("ajstamm/gatpkg", dependencies = TRUE,
                         build_vignettes = TRUE)

To load GAT, run library(gatpkg).

To run GAT with default settings, run runGATprogram(). For most users, this function alone is probably sufficient. If you would like more detail on what GAT does, check out the GAT tutorial or the GAT technical notes.

The full default program to run GAT looks like this:

# from GitHub
install.packages("devtools")
devtools::install_github("ajstamm/gatpkg", dependencies = TRUE,
                         build_vignettes = TRUE)
# from CRAN (not yet available)
# install.packages("gatpkg") 
library(gatpkg)
runGATprogram()

The package contains over 30 additional functions, most of which are used in the function runGATprogram(). Feel free to use these to customize GAT to meet your needs.

Disclaimer

This version of GAT is provided as is.

GAT was written in R-2.9.2 in Windows XP. It was revised and converted to a package in R-3.4.3 in Windows 10 using RStudio-1.2.5019. It has been tested on R versions 3.4 through 4.2. The current version runs on R versions 4.0 through 4.2.

The user needs minimal R programming experience to run GAT and basic experience in manipulating R functions for some advanced features.