From ea1c0e9373b48900627fe8f1941e8f3da8b8aabe Mon Sep 17 00:00:00 2001 From: thomas-enzlein Date: Tue, 13 Aug 2024 10:03:59 +0200 Subject: [PATCH] - update manual --- README.md | 2 +- manual.Rmd | 25 +++++++++++++++++++++---- manual.md | 24 ++++++++++++++++++++---- 3 files changed, 42 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 99d56a6..280da67 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ # M²ara - MALDI MS Bioassays Evaluation and Classification App -M²ara is a software tool to facilitate the exploration of metabolomic responses in complex matrix-assisted laser desorption/ionization mass spectrometry (MALDI MS) bioassays. The app is intented for the evaluation of metabolomic drug actions by using the mass-to-charge ratios of hundreds of metabolites and it is particularly useful in defining novel pharmacodynamic biomarkers for high-throughput applications. +M²ara is a software tool to facilitate the exploration of metabolomic responses in complex matrix-assisted laser desorption/ionization mass spectrometry (MALDI MS) bioassays. The app is intended for the evaluation of metabolomic drug actions by using the mass-to-charge ratios of hundreds of metabolites and it is particularly useful in defining novel pharmacodynamic biomarkers for high-throughput applications. M²ara is based on the R package [MALDIcellassay](https://github.com/CeMOS-Mannheim/MALDIcellassay) (published in [Unger et. al. 2021](https://www.nature.com/articles/s41596-021-00624-z), Nature Protocols) and extends its capabilities with a GUI and adds helpful features like clustering of curves, PCA analysis as well as the Curve Response Score (CRS) which enables fast screening for molecules regulated by drug treatment. diff --git a/manual.Rmd b/manual.Rmd index c6f6226..8b716dd 100644 --- a/manual.Rmd +++ b/manual.Rmd @@ -15,6 +15,26 @@ This is **M2ara**, a shiny application based on the R-package `MALDIcellassay` w This manual describes some of the details of the inner-workings of the `MALDIcellassay`-package and how this shiny application (**M2ara**) is supposed to be used. +The following features were already part of `MALDIcellassay`: + +- pre-processing though the `MALDIquant`-package +- re-calibration to a single *m/z* (single point-re-calibration) +- normalization to a single *m/z* +- fitting curves to the data using the `nplr`-package + +**M2ara** adds the following features: + +- graphical user interface +- interactive data exploration +- support for [mzML](#mzml) data \* +- calculation of quality metrics (Z', V', log2FC, CRS) \* +- feature ranking by metric \* +- principle component analysis (PCA) +- curve clustering +- outlier detection \* + +\* The features marked with a asterisks were re-implemented to `MALDIcellassay`. + ## General information The blue question mark icons (`r icon("question-circle")`) throughout the application can be clicked and provide further information on the specific settings. @@ -165,16 +185,13 @@ knitr::include_graphics("figures/clustering_metrics.png") ### Settings tab - ```{r, echo=FALSE, out.width="33%", fig.cap="Settings tab"} knitr::include_graphics("figures/settings.png") ``` The `File format`-menu can be used to select between Bruker raw data of mzML format (see [Requirements to the raw data](#requirements-to-the-raw-data)). -The `Conc. mapping` upload button enables the upload of a mapping file containing one concentration for each spectrum. -It needs to be in the *.txt-format and needs to contain one concentration (dont include units!) per line, one for each spectrum. -The file needs to be uploaded before the spectra are loaded using the button on the sidebar if the mapping should be used. +The `Conc. mapping` upload button enables the upload of a mapping file containing one concentration for each spectrum. It needs to be in the \*.txt-format and needs to contain one concentration (dont include units!) per line, one for each spectrum. The file needs to be uploaded before the spectra are loaded using the button on the sidebar if the mapping should be used. The `Peak window size` and `Peak method` setting enables to change the peak detection. Usually a `Peak window size` of 20 and the *SuperSmoother* method should lead to good results. Sometimes, especially if a small peak is close to a large one, this small peak might not be detected. In this cases the `Peak window size` can be decreased or if this is still not enough the *MAD* peak detection method can be chosen. Please note that both will lead to much more signals being considered as valid peaks, so it makes sense to increase SNR at the same time. diff --git a/manual.md b/manual.md index ce328f4..df46fa4 100644 --- a/manual.md +++ b/manual.md @@ -13,6 +13,25 @@ This is **M2ara**, a shiny application based on the R-package `MALDIcellassay` w This manual describes some of the details of the inner-workings of the `MALDIcellassay`-package and how this shiny application (**M2ara**) is supposed to be used. +The following features were already part of `MALDIcellassay`: + +- pre-processing though the `MALDIquant`-package +- re-calibration to a single **m/z** (single point-re-calibration) +- normalization to a single **m/z** +- fitting curves to the data using the `nplr`-package + +**M2ara** adds the following features: + +- graphical user interface +- interactive data exploration +- support for [mzML](#mzml) data \* +- calculation of quality metrics (Z', V', log2FC, CRS) \* +- principle component analysis (PCA) +- curve clustering +- outlier detection \* + +\* The features marked with a asterisks were re-implemented to `MALDIcellassay`. + ## General information The blue question mark icons () throughout the application can be clicked and provide further information on the specific settings. @@ -170,7 +189,6 @@ Using the slider the user needs to adjust the number of clusters to a reasonable ### Settings tab -
Settings tab

Settings tab

@@ -178,9 +196,7 @@ Using the slider the user needs to adjust the number of clusters to a reasonable The `File format`-menu can be used to select between Bruker raw data of mzML format (see [Requirements to the raw data](#requirements-to-the-raw-data)). -The `Conc. mapping` upload button enables the upload of a mapping file containing one concentration for each spectrum. -It needs to be in the *.txt-format and needs to contain one concentration (dont include units!) per line, one for each spectrum. -The file needs to be uploaded before the spectra are loaded using the button on the sidebar if the mapping should be used. +The `Conc. mapping` upload button enables the upload of a mapping file containing one concentration for each spectrum. It needs to be in the \*.txt-format and needs to contain one concentration (dont include units!) per line, one for each spectrum. The file needs to be uploaded before the spectra are loaded using the button on the sidebar if the mapping should be used. The `Peak window size` and `Peak method` setting enables to change the peak detection. Usually a `Peak window size` of 20 and the *SuperSmoother* method should lead to good results. Sometimes, especially if a small peak is close to a large one, this small peak might not be detected. In this cases the `Peak window size` can be decreased or if this is still not enough the *MAD* peak detection method can be chosen. Please note that both will lead to much more signals being considered as valid peaks, so it makes sense to increase SNR at the same time.