How to Launch gmShiny
Run App Locally
Run the below code in an R or RStudio console:
# This first chunk of code is only necessary for first time users or after the most recent update to gmShiny (most recent update: 8/7/24)
install.packages('devtools')
devtools::install_version("ape", version = "5.8")
devtools::install_version("RRPP", version = "2.0.3")
devtools::install_version("geomorph", version = "4.0.5")
devtools::install_version("shiny", version = "1.9.1")
devtools::install_version("shinyjs", version = "2.0.0")
devtools::install_version("shinyalert", version = "2.0.0")
devtools::install_version("shinyWidgets", version = "0.6.0")
devtools::install_version("shinydashboard", version = "0.7.1")
devtools::install_version("shinythemes", version = "1.2.0")
devtools::install_version("shinyMatrix", version = "0.8.0")
devtools::install_version("shinyjqui", version = "0.4.1")
devtools::install_version("shinymeta", version = "0.2.0.1")
devtools::install_version("prettycode", version = "1.1.0")
devtools::install_version("stringr", version = "1.4.0")
devtools::install_version("stringi", version = "1.8.4")
devtools::install_version("RColorBrewer", version = "1.1.3")
devtools::install_version("reactlog", version = "1.1.0")
devtools::install_version("StereoMorph", version = "1.6.4")
devtools::install_version("shinybusy",version = "0.3.3")
# Returning users can run this line alone
shiny::runUrl("https://github.com/geomorphR/gmShiny/archive/master.tar.gz")
Advantages: Running gmShiny on your local computer can allow greater computational speed, a large number of concurrent users, and the use of larger datasets (depending on your local computer's specifications). Internet is only required upon installation.
Disadvantages: Recent updates to the required packages may produce errors not yet addressed by the gmShiny developers. If this occurs, please report it as an issue on the GitHub repository. Not available using Internet Explorer 8 or 9.
Note for first time users: This app depends on several packages, so first time users will need to run the first several lines of code to install all the requried packages in their appropriate versions. We recommend using R v4.4.1 or higher. Returning users can launch the app with just the final line of code.
Run App on Server
Visit the following URL in any web browser: gmshiny.chatham.edu
Advantages: Running gmShiny on the hosted server has the benefit of not requiring R, RStudio, or any lines of code. This also avoids errors caused by the dependent packages releasing updates that have not yet been observed by the developers.
Disadvantages: Based on the number of active users and available server space, the computational speed and/or capacity might be constrained. This also requires internet access for the entire session (i.e., internet disruptions may end your session and reset the app).
Server specifications:
Limit of 50 concurrent users
Session will automatically terminate after 60 idle minutes
App does not accept files greater than 10 MB
2D TPS data on 2,000+ specimens, 3D TPS data on 500+ specimens, and Stereomorph files of 300+ specimens will cause substantial slow-downs in processsing. Use of geomorph directly in R or RStudio is recommended in these cases.
News: This server option will be retired soon due to computational limitations.