EDAmame Installation Guide
EDAmame (Exploratory Data Analysis ML-Aided Multiomics Explorer) is an interactive R Shiny application for data exploration and analysis. Follow these steps to install and run it locally on your machine.
Prerequisites
Installation Steps
1. Download EDAmame
Download and unzip the EDAmame folder from https://doi.org/10.5281/zenodo.15356492 to a folder on your computer.
2. Install Required Packages
EDAmame requires several R packages to run. You can install them automatically using the provided setup script:
Option A: Using RStudio
- Open RStudio
- Open the file
installer.R from the EDAmame distribution folder
- Click the "Source" button in RStudio to run the script or run
source("installer.R") in the console
Option B: Using R from Command Line
- Open a terminal/command prompt
- Navigate to the EDAmame distribution folder
- Run:
Rscript installer.R
The installation may take several minutes to complete as it downloads and installs all required packages.
3. Launch EDAmame
After installing the required packages, you can run EDAmame. The first launch may take several minutes in case some package updates are initiated:
Option A: Using RStudio
- Open RStudio
- Open the file
EDAmame_app.R from the EDAmame distribution folder
- Click the "Run App" button in the top-right corner of the editor
Option B: Using R from Command Line
- Open a terminal/command prompt
- Navigate to the EDAmame distribution folder
- Run:
Rscript -e "shiny::runApp('EDAmame_app.R', launch.browser=TRUE)"
Troubleshooting
- Error installing packages: Try installing packages individually using
install.packages("package_name")
- Port already in use: Change the port by adding a port argument:
Rscript -e "shiny::runApp('EDAmame_app.R', port=10020, launch.browser=TRUE)"
- Memory issues: EDAmame processes data in memory. For large datasets, ensure your computer has sufficient RAM.
Additional Information
- The first time you run EDAmame, it will create a cache folder in the application directory.
- Example datasets are included in the
www/example_data folder.
For more information, visit https://gitlab.com/baaron/EDAmame.
Additional Notes for Windows Users
- When installing R and RStudio on Windows, you can accept the default installation locations.
- If you encounter permission errors when installing packages, try running RStudio as an administrator (right-click the RStudio icon and select "Run as administrator").
- If Windows Defender Firewall displays an alert when running EDAmame, click "Allow access" to permit the app to create a local web server.