This tutorial explains how to use the Well Plate Maker package.
To generate plate maps, the WPM uses an algorithm inspired from the backtracking algorithm. More precisely, WPM loops on the following actions until all of the samples are given a correct location:
This process allows for an experimental design by block randomization.
There are two ways to use the WPM
:
Important: Even in case of command line use, we strongly recommend to read the section about the shiny app section, as this is where all terms and concepts are detailed.
Input Format | Command line | WPM app |
---|---|---|
CSV | yes | yes |
ExpressionSet | yes | no |
SummarizedExperiment | yes | no |
MSnSet | yes | no |
Make sure you are using a recent version of R (\(\geq 4.0.0\)). For Windows users who do not have the Edge browser, we recommend using the Chrome browser rather than Internet Explorer.
From GitHub (consider it a devel version):
devtools::install_github("HelBor/wpm", build_vignettes=TRUE)
From Bioconductor (release, stable version):
if (!requireNamespace("BiocManager", quietly = TRUE))
install.packages("BiocManager")
BiocManager::install("wpm")
Instructions can also be found on the Bioconductor page
library(wpm)
Whether you use RStudio or simply work in an R console, the procedure remains the same to launch the shiny app:
library(wpm)
wpm()
If everything is in order, a new window will open in your default browser.
If not, find the line written in the R console that looks like
Listening on http://127.0.0.1:8000
, and paste the URL in your web browser.
WPM has 4 main tabs: Home, Parameters, Results and Help.
This tab briefly presents the aim of the app, shows the last package version, explains how to support our work by citing the associated article and gives contact information.