Creative Commons License

1 Install R/Rstudio

You can install R from the CRAN repository. Yo will need R version 4.5 or higher.

You can install from the Posit website.

2 Install the GitHub and Bioconductor installers

Open Rstudio and paste the following command in the console:

install.packages("devtools")
install.packages("BiocManager")
BiocManager::install(version = "devel")

The first command will install a utility package that will enable to install packages from GitHub. The second line will install the Bioconductor package installer. Ensure the installation succeeded by running the following command:

BiocManager::version()
## [1] '3.22'

It should return 3.22 or higher.

3 Install QFeatures

The workshop will require a specific version of QFeatures, you can install it using the following command:

BiocManager::install("cvanderaa/QFeatures", ref = "uniquePrecId")

Test the package has been correctly installed using the following command:

library(QFeatures)
data(feat2)
joinAssays(feat2, 1:3, fcol = "Prot")
## An instance of class QFeatures (type: bulk) with 4 sets:
## 
##  [1] assay1: SummarizedExperiment with 10 rows and 4 columns 
##  [2] assay2: SummarizedExperiment with 4 rows and 4 columns 
##  [3] assay3: SummarizedExperiment with 7 rows and 4 columns 
##  [4] joinedAssay: SummarizedExperiment with 14 rows and 12 columns

4 Install msqrob2

The workshop will also require a specific version of msqrob2, you can install it using the following command:

BiocManager::install("statOmics/msqrob2") ## this installs msqrob2

Test whether the package has been correctly installed using the following command:

library(msqrob2)
data(pe)
pe <- aggregateFeatures(
    pe, i = "peptide", fcol = "Proteins", name = "protein"
)
msqrob(pe,i = "protein", formula = ~ condition)
## An instance of class QFeatures (type: bulk) with 2 sets:
## 
##  [1] peptide: SummarizedExperiment with 631 rows and 20 columns 
##  [2] protein: SummarizedExperiment with 100 rows and 20 columns

5 Install the graphical user interfaces

In this course, we will use 2 graphical user interfaces (GUIs): QFeaturesGUI for the data preprocessing and msqrob2gui for the data modelling. For installing the GUIs, you’ll again need to install specific versions as the software is still in a developmental stage.

Note, that QFeaturesGUI is actively developed and maintained by the Laurent Gatto lab. However, we forked QFeaturesGUI temporarily for this version of the course because we needed some additional functionalities.

BiocManager::install("statOmics/QFeaturesGUI") ## this installs QFeaturesGUI
BiocManager::install("statOmics/msqrob2gui", ref = "gui2modules") ## this installs msqrob2gui

Test whether the QFeaturesGUI package has been correctly installed using the following command:

QFeaturesGUI::importQFeatures()

This should open a new window. You can close it for now.

Test whether the msqrob2gui package has been correctly installed using the following command:

msqrob2gui::launchMsqrob2App()

Again, this should open a new window, but you can close it for now.

LS0tCnRpdGxlOiBTb2Z0d2FyZSBmb3IgUHJvdGVvbWljcyBEYXRhIEFuYWx5c2lzIChQREEpIAphdXRob3I6ICJMaWV2ZW4gQ2xlbWVudCIKZGF0ZTogIltzdGF0T21pY3NdKGh0dHBzOi8vc3RhdG9taWNzLmdpdGh1Yi5pbyksIEdoZW50IFVuaXZlcnNpdHkiCm91dHB1dDoKICAgIGh0bWxfZG9jdW1lbnQ6CiAgICAgIHRoZW1lOiBmbGF0bHkgICAgICAKICAgICAgY29kZV9kb3dubG9hZDogZmFsc2UKICAgICAgdG9jOiBmYWxzZQogICAgICB0b2NfZmxvYXQ6IGZhbHNlCiAgICAgIG51bWJlcl9zZWN0aW9uczogZmFsc2UKCi0tLQoKPGEgcmVsPSJsaWNlbnNlIiBocmVmPSJodHRwczovL2NyZWF0aXZlY29tbW9ucy5vcmcvbGljZW5zZXMvYnktbmMtc2EvNC4wIj48aW1nIGFsdD0iQ3JlYXRpdmUgQ29tbW9ucyBMaWNlbnNlIiBzdHlsZT0iYm9yZGVyLXdpZHRoOjAiIHNyYz0iaHR0cHM6Ly9pLmNyZWF0aXZlY29tbW9ucy5vcmcvbC9ieS1uYy1zYS80LjAvODh4MzEucG5nIiAvPjwvYT4KCiMjIEluc3RhbGwgUi9Sc3R1ZGlvCgpZb3UgY2FuIGluc3RhbGwgUiBmcm9tIHRoZSBbQ1JBTiByZXBvc2l0b3J5XShodHRwczovL2NyYW4uci1wcm9qZWN0Lm9yZy8pLgpZbyB3aWxsIG5lZWQgUiB2ZXJzaW9uIDQuNSBvciBoaWdoZXIuCgpZb3UgY2FuIGluc3RhbGwgZnJvbSB0aGUgW1Bvc2l0IHdlYnNpdGVdKGh0dHBzOi8vcG9zaXQuY28vZG93bmxvYWQvcnN0dWRpby1kZXNrdG9wLykuCgojIyBJbnN0YWxsIHRoZSBHaXRIdWIgYW5kIEJpb2NvbmR1Y3RvciBpbnN0YWxsZXJzCgpPcGVuIFJzdHVkaW8gYW5kIHBhc3RlIHRoZSBmb2xsb3dpbmcgY29tbWFuZCBpbiB0aGUgY29uc29sZToKCmBgYHtyLCBldmFsPUZBTFNFfQppbnN0YWxsLnBhY2thZ2VzKCJkZXZ0b29scyIpCmluc3RhbGwucGFja2FnZXMoIkJpb2NNYW5hZ2VyIikKQmlvY01hbmFnZXI6Omluc3RhbGwodmVyc2lvbiA9ICJkZXZlbCIpCmBgYAoKVGhlIGZpcnN0IGNvbW1hbmQgd2lsbCBpbnN0YWxsIGEgdXRpbGl0eSBwYWNrYWdlIHRoYXQgd2lsbCBlbmFibGUgdG8KaW5zdGFsbCBwYWNrYWdlcyBmcm9tIEdpdEh1Yi4gVGhlIHNlY29uZCBsaW5lIHdpbGwgaW5zdGFsbCB0aGUKQmlvY29uZHVjdG9yIHBhY2thZ2UgaW5zdGFsbGVyLiBFbnN1cmUgdGhlIGluc3RhbGxhdGlvbiBzdWNjZWVkZWQgYnkKcnVubmluZyB0aGUgZm9sbG93aW5nIGNvbW1hbmQ6CgpgYGB7ciwgd2FybmluZz1GQUxTRSwgbWVzc2FnZT1GQUxTRX0KQmlvY01hbmFnZXI6OnZlcnNpb24oKQpgYGAKCkl0IHNob3VsZCByZXR1cm4gMy4yMiBvciBoaWdoZXIuCgojIyBJbnN0YWxsIFFGZWF0dXJlcwoKVGhlIHdvcmtzaG9wIHdpbGwgcmVxdWlyZSBhIHNwZWNpZmljIHZlcnNpb24gb2YgYFFGZWF0dXJlc2AsIHlvdSBjYW4KaW5zdGFsbCBpdCB1c2luZyB0aGUgZm9sbG93aW5nIGNvbW1hbmQ6CgpgYGB7ciwgZXZhbD1GQUxTRX0KQmlvY01hbmFnZXI6Omluc3RhbGwoImN2YW5kZXJhYS9RRmVhdHVyZXMiLCByZWYgPSAidW5pcXVlUHJlY0lkIikKYGBgCgpUZXN0IHRoZSBwYWNrYWdlIGhhcyBiZWVuIGNvcnJlY3RseSBpbnN0YWxsZWQgdXNpbmcgdGhlIGZvbGxvd2luZwpjb21tYW5kOgoKYGBge3IsIHdhcm5pbmc9RkFMU0UsIG1lc3NhZ2U9RkFMU0V9CmxpYnJhcnkoUUZlYXR1cmVzKQpkYXRhKGZlYXQyKQpqb2luQXNzYXlzKGZlYXQyLCAxOjMsIGZjb2wgPSAiUHJvdCIpCmBgYAoKIyMgSW5zdGFsbCBtc3Fyb2IyCgpUaGUgd29ya3Nob3Agd2lsbCBhbHNvIHJlcXVpcmUgYSBzcGVjaWZpYyB2ZXJzaW9uIG9mIGBtc3Fyb2IyYCwgeW91CmNhbiBpbnN0YWxsIGl0IHVzaW5nIHRoZSBmb2xsb3dpbmcgY29tbWFuZDoKCmBgYHtyLCBldmFsPUZBTFNFfQpCaW9jTWFuYWdlcjo6aW5zdGFsbCgic3RhdE9taWNzL21zcXJvYjIiKSAjIyB0aGlzIGluc3RhbGxzIG1zcXJvYjIKYGBgCgpUZXN0IHdoZXRoZXIgdGhlIHBhY2thZ2UgaGFzIGJlZW4gY29ycmVjdGx5IGluc3RhbGxlZCB1c2luZyB0aGUKZm9sbG93aW5nIGNvbW1hbmQ6CgpgYGB7ciwgd2FybmluZz1GQUxTRSwgbWVzc2FnZT1GQUxTRX0KbGlicmFyeShtc3Fyb2IyKQpkYXRhKHBlKQpwZSA8LSBhZ2dyZWdhdGVGZWF0dXJlcygKICAgIHBlLCBpID0gInBlcHRpZGUiLCBmY29sID0gIlByb3RlaW5zIiwgbmFtZSA9ICJwcm90ZWluIgopCm1zcXJvYihwZSxpID0gInByb3RlaW4iLCBmb3JtdWxhID0gfiBjb25kaXRpb24pCmBgYAojIyBJbnN0YWxsIHRoZSBncmFwaGljYWwgdXNlciBpbnRlcmZhY2VzCgpJbiB0aGlzIGNvdXJzZSwgd2Ugd2lsbCB1c2UgMiBncmFwaGljYWwgdXNlciBpbnRlcmZhY2VzIChHVUlzKToKYFFGZWF0dXJlc0dVSWAgZm9yIHRoZSBkYXRhIHByZXByb2Nlc3NpbmcgYW5kIGBtc3Fyb2IyZ3VpYCBmb3IgdGhlCmRhdGEgbW9kZWxsaW5nLiBGb3IgaW5zdGFsbGluZyB0aGUgR1VJcywgeW91J2xsIGFnYWluIG5lZWQgdG8gaW5zdGFsbApzcGVjaWZpYyB2ZXJzaW9ucyBhcyB0aGUgc29mdHdhcmUgaXMgc3RpbGwgaW4gYSBkZXZlbG9wbWVudGFsIHN0YWdlLgoKTm90ZSwgdGhhdCBbUUZlYXR1cmVzR1VJXShodHRwczovL2dpdGh1Yi5jb20vVUNMb3V2YWluLUNCSU8vUUZlYXR1cmVzR1VJKSBpcyBhY3RpdmVseSBkZXZlbG9wZWQgYW5kIG1haW50YWluZWQgYnkgdGhlIExhdXJlbnQgR2F0dG8gbGFiLiAKSG93ZXZlciwgd2UgZm9ya2VkIFFGZWF0dXJlc0dVSSB0ZW1wb3JhcmlseSBmb3IgdGhpcyB2ZXJzaW9uIG9mIHRoZSBjb3Vyc2UgYmVjYXVzZSB3ZSBuZWVkZWQgc29tZSBhZGRpdGlvbmFsIGZ1bmN0aW9uYWxpdGllcy4gCgpgYGB7ciwgZXZhbD1GQUxTRX0KQmlvY01hbmFnZXI6Omluc3RhbGwoInN0YXRPbWljcy9RRmVhdHVyZXNHVUkiKSAjIyB0aGlzIGluc3RhbGxzIFFGZWF0dXJlc0dVSQpCaW9jTWFuYWdlcjo6aW5zdGFsbCgic3RhdE9taWNzL21zcXJvYjJndWkiLCByZWYgPSAiZ3VpMm1vZHVsZXMiKSAjIyB0aGlzIGluc3RhbGxzIG1zcXJvYjJndWkKYGBgCgpUZXN0IHdoZXRoZXIgdGhlIGBRRmVhdHVyZXNHVUlgIHBhY2thZ2UgaGFzIGJlZW4gY29ycmVjdGx5IGluc3RhbGxlZAp1c2luZyB0aGUgZm9sbG93aW5nIGNvbW1hbmQ6CgpgYGB7ciwgZXZhbD1GQUxTRX0KUUZlYXR1cmVzR1VJOjppbXBvcnRRRmVhdHVyZXMoKQpgYGAKClRoaXMgc2hvdWxkIG9wZW4gYSBuZXcgd2luZG93LiBZb3UgY2FuIGNsb3NlIGl0IGZvciBub3cuCgpUZXN0IHdoZXRoZXIgdGhlIGBtc3Fyb2IyZ3VpYCBwYWNrYWdlIGhhcyBiZWVuIGNvcnJlY3RseSBpbnN0YWxsZWQKdXNpbmcgdGhlIGZvbGxvd2luZyBjb21tYW5kOgoKYGBge3IsIGV2YWw9RkFMU0V9Cm1zcXJvYjJndWk6OmxhdW5jaE1zcXJvYjJBcHAoKQpgYGAKCkFnYWluLCB0aGlzIHNob3VsZCBvcGVuIGEgbmV3IHdpbmRvdywgYnV0IHlvdSBjYW4gY2xvc2UgaXQgZm9yIG5vdy4K