DIYABC-RF GUIis under final development stage. You may still encounter a few bugs. Please check ongoing issues or fill a new one here if you encounter any problem.
We provide a graphical user interface (GUI) for the
DIYABC-RF software , called
DIYABC-RF GUIreplaces the old interface
DIYABC V2.1which is not maintained anymore.
Please check the project website for additional information and detailed documentation.
DIYABC-RF GUI is available as a standalone application, or as a
shiny web app implemented in the
diyabcGUI R package .
You can either install and run the standalone app, or install the
diyabcGUI R package and run
DIYABC-RF GUI as a standard
shiny app, c.f. below.
DIYABC-RF GUI provides a set of tools implementing Approximate Bayesian Computation (ABC) combined with supervised machine learning based on Random Forests (RF), for model choice and parameter inference in the context of population genetics analysis.
The DIYABC-RF GUI software is edited by the DIYABC-RF Core team.
DIYABC-RF Core team: François-David Collin, Ghislain Durif, Louis Raynal, Mathieu Gautier, Renaud Vitalis, Eric Lombaert, Jean-Michel Marin, Arnaud Estoup
The Windows DIYABC-RF GUI standalone app is based on DesktopDeployR by Wyming Lee Pang (https://github.com/wleepang/DesktopDeployR).
See the dedicated file for detailed copyright and licensing information.
For Windows users:
Please download the latest release of
DIYABC-RF GUIat https://github.com/diyabc/diyabcGUI/releases/latest and unzip
DIYABC-RF GUI, run
DIYABC-RF_GUI.batin the previously extracted directory (either by double-clicking it or in a terminal, you can also create a shortcut to run it by right-clicking on it).
It will open a new tab in your web browser and you can use
DIYABC-RF GUIas a web app.
Important: you should not forget to quit the app when you are done with the dedicated button (otherwise some background related processes will remains active). Repeat steps 2 and 3 to launch again the application.
A log file for DIYABC-RF GUI is available in your user-specific directory for temporary files, generally
If you want to open multiple DIYABC-RF projects, you need to simultaneously open multiple instances of DIYABC-RF GUI (i.e. step 2 and 3).
At the moment, the standalone app is not available for Linux and MacOS users. Nonetheless, Linux and MacOS users can install the
diyabcGUI package, c.f. below, and
run the DIYABC-RF GUI as a standard
Note: if encountering instability in the standalone app, we recommend to install and use the
shinyapp available in the
diyabcGUIR package, c.f. below.
devtoolspackage (if not installed on your system)
Note: if you encounter any issue when installing
devtools, please check the next section.
devtools::install_github( "diyabc/diyabcGUI", subdir = "R-pkg" )
- The first time after installation, you need to download required binary files (e.g.
abcrangercommand line tools) by running
Note: you can run this command from time to time to update the required binary files in case new versions were released.
- Launch the interface
diyabc() will launch DIYABC-RF GUI as a standard
shiny web app, that you will be able to use either in your web browser or in the Rstudio
shiny app viewer.
To run simultaneously mutliple instances of DIYABC-RF GUI, e.g. to simultaneously manage and run multiple projects, you just need to run several times the function
diyabc() from R (this is not possible from RStudio).
You may encounter some issue when installing devtools, please check the official devtools page.
devtools recommandations, make sure you have a working development environment.
- Windows: Install Rtools.
- Mac: Install Xcode from the Mac App Store.
- Linux: Install a compiler and various development libraries (details vary across different flavors of Linux).
For Ubuntu users here is a guide to install devtools requirement (users of other Linux distributions may still find it useful).
shiny app, DIYABC-RF GUI can be installed and run from a Shiny server. To do so, you just need (on Unix system, please adapt for Windows server) to:
- install the
diyabcGUIpackage on your system, c.f. above
- manage the file access rights so that the Shiny server has access to the R package installation directory
- Create a symbolic link to the directory given by the R command
system.file("application", package = "diyabcGUI")inside the
site_dirfolder configured in
ln -s /path/to/R_LIBS/diyabcGUI/application /srv/shiny-server/diyabc
- DIYABC-RF GUI is now available on your server at
Please see the dedicated directory for instructions about the standalone building.
 Collin F-D, Durif G, Raynal L, Gautier M, Vitalis R, Lombaert E., Marin J-M, Estoup A., 2021, Extending Approximate Bayesian Computation with Supervised Machine Learning to infer demographic history from genetic polymorphisms using DIYABC Random Forest. Molecular Ecology Resources, Wiley/Blackwell, 21(8), pp. 2598–2613. <doi/10.1111/1755-0998.13413> <hal-03229207>