knitr::opts_chunk$set( collapse = TRUE, comment = "#>" )
pmd
package use Paired Mass Distance (PMD) relationship to analysis the GC/LC-MS based non-targeted data. PMD means the distance between two masses or mass to charge ratios. In mass spectrometry, PMD would keep the same value between two masses and two mass to charge ratios(m/z). There are two kinds of PMD involved in this package: PMD from the same compound and PMD from different compounds. In GC/LC-MS or XCMS based non-targeted data analysis, peaks could be separated by chronograph and same compound means ions from similar retention times or ions co-eluted by certain column.
For MS1 full scan data, we could build retention time(RT) bins to assign peaks into different RT groups by retention time hierarchical clustering analysis. For each RT group, the peaks should come from same compounds or co-elutes. If certain PMD appeared in multiple RT groups, it would be related to the relationship about adducts, neutral loss, isotopologues or common fragments ions.
The peaks from different retention time groups would like to be different compounds separated by chronograph. The PMD would reflect the relationship about homologous series or chemical reactions.
GlobalStd algorithm use the PMD within same RT group to find independent peaks among certain data set. Then, structure/reaction directed analysis use PMD from different RT groups to screen important compounds or reactions.
The input data should be a list
object with at least two elements from a peaks list:
mz
, high resolution mass spectrometry is requiredrt
However, I suggested to add intensity and group information to the list for validation of PMD analysis.
In this package, a data set from in vivo solid phase micro-extraction(SPME) was attached. This data set contain 9 samples from 3 fish with triplicates samples for each fish. Here is the data structure:
library(pmd) data("spmeinvivo") str(spmeinvivo)
You could build this list
or mzrt
object from the xcms
objects via enviGCMS
package. When you have a xcmsSet
object or XCMSnExp
object named xset
, you could use enviGCMS::getmzrt(xset)
to get such list. Of course you could build such list by yourself.
GlobalStd algorithm try to find independent peaks among certain peaks list. The first step is retention time hierarchical clustering analysis. The second step is to find the relationship among adducts, neutral loss, isotopologues and common fragments ions. The third step is to screen the independent peaks.
Here is a workflow for this algorithm:
knitr::include_graphics('https://yufree.github.io/presentation/figure/GlobalStd.png')
pmd <- getpaired(spmeinvivo) plotrtg(pmd)
This plot would show the distribution of RT groups. The rtcutoff
in function getpaired
could be used to set the cutoff of the distances in retention time hierarchical clustering analysis. Retention time cluster cutoff should fit the peak picking algorithm. For HPLC, 10 is suggested and 5 could be used for UPLC.
Global PMD's retention time group numbers should be around 20 percent of the retention time cluster numbers. For example, if you find 100 retention time clusters, I suggested you use 20 as the cutoff of empirical global PMD's retention time group numbers. If you don't specificlly assign a value to ng
, the algorithm will select such recommendation by default setting.
Take care of the retention time cluster with lots of peaks. In this case, such cluster could be co-eluted compounds on certain column. It would be wise to trim the retention time window for high quality peaks. Another important hint is that pre-filter your peak list by black samples or other quality control samples. Otherwise the running time would be long and lots of pmd relationship would be just from noise.
The ng
in function getpaired
could be used to set cutoff of global PMD's retention time group numbers. If ng
is 10, at least 10 of the retention time groups should contain the shown PMD relationship. You could use plotpaired
to show the distribution.
plotpaired(pmd)
You could also show the distribution of PMD relationship by index:
# show the unique PMD found by getpaired function for(i in 1:length(unique(pmd$paired$diff2))){ diff <- unique(pmd$paired$diff2)[i] index <- pmd$paired$diff2 == diff plotpaired(pmd,index) }
This is an easy way to find potential adducts of the data by high frequency PMD from the same compound. For example, 21.98 Da could be the mass distances between $[M+H]^+$ and $[M+Na]^+$. In this case, user could find the potential adducts or neutral loss even when they have no preferred adducts list. If one adduct exist in certain analytical system, the high frequency PMD will reveal such relationship. The high frequency PMD list could also be used to check the fragmental pattern of in-source reactions as long as such patterns are popular among all collected ions.
You could use getstd
function to get the independent peaks. Independent peaks mean the peaks list removing the redundant peaks such as adducts, neutral loss, isotopologues and comment fragments ions found by PMD analysis in STEP2. Ideally, those peaks could be molecular ions while they might still contain redundant peaks.
std <- getstd(pmd)
Here you could plot the peaks by plotstd
function to show the distribution of independent peaks:
plotstd(std)
You could also plot the peaks distribution by assign a retention time group via plotstdrt
:
par(mfrow = c(2,3)) plotstdrt(std,rtcluster = 23,main = 'Retention time group 23') plotstdrt(std,rtcluster = 9,main = 'Retention time group 9') plotstdrt(std,rtcluster = 18,main = 'Retention time group 18') plotstdrt(std,rtcluster = 67,main = 'Retention time group 67') plotstdrt(std,rtcluster = 49,main = 'Retention time group 49') plotstdrt(std,rtcluster = 6,main = 'Retention time group 6')
Original GlobalStd algorithm only use mass to charge ratio and retention time of peaks to select independent peaks. However, if intensity data across samples are available, correlation coefficient of paired ions could be used to further filter the random noise in high frequency PMDs. You could set up cutoff of Pearson Correlation Coefficient between peaks to refine the peaks selected by GlobalStd within same retention time groups. In this case, the numbers of selected independent peaks will be further reduced. When you use this parameter, make sure the intensity data are from real samples instead of blank samples, which will affect the calculation of correlation coefficient.
std2 <- getstd(pmd,corcutoff = 0.9)
You need to check the GlobalStd algorithm's results by principal components analysis(PCA). If we removed too much peaks containing information, the score plot of reduced data set would show great changes.
library(enviGCMS) par(mfrow = c(2,2),mar = c(4,4,2,1)+0.1) plotpca(std$data,lv = as.numeric(as.factor(std$group$sample_group)),main = "all peaks") plotpca(std$data[std$stdmassindex,],lv = as.numeric(as.factor(std$group$sample_group)),main = paste(sum(std$stdmassindex),"independent peaks")) plotpca(std2$data[std2$stdmassindex,],lv = as.numeric(as.factor(std$group$sample_group)),main = paste(sum(std2$stdmassindex),"reduced independent peaks"))
You might find original GlobalStd algorithm show a similar PCA score plot with original data while GlobalStd algorithm considering intensity data seems change the profile. The major reason is that correlation coefficient option in the algorithm will remove the paired ions without strong correlation. It will be aggressive to remove low intensity peaks, which are vulnerable by baseline noise. However, such options would be helpful if you only concern high quanlity peaks for following analysis. Otherwise, original GlobalStd will keep the most information for explorer purpose.
GlobalStd algorithm in pmd
package could be treated as a method to extract pseudo spectra. You could use getcluster
to get peaks groups information for all GlobalStd peaks. This function would consider the merge of GlobalStd peaks when certain peak is involved in multiple clusters. Then you could choose export peaks with the highest intensities or base peaks in each GlobalStd merged peaks groups. Meanwhile, you could also include the correlation coefficient cutoff to further improve the data quality.
stdcluster <- getcluster(std) # extract pseudospectra for std peak 71 idx <- unique(stdcluster$cluster$largei[stdcluster$cluster$i==71]) plot(stdcluster$cluster$mz[stdcluster$cluster$largei==idx],stdcluster$cluster$ins[stdcluster$cluster$largei==idx],type = 'h',xlab = 'm/z',ylab = 'intensity',main = 'pseudo spectra for GlobalStd peak 71') # export peaks with the highest intensities in each GlobalStd peaks groups. data <- stdcluster$data[stdcluster$stdmassindex2,] # considering the correlation coefficient cutoff stdcluster2 <- getcluster(std, corcutoff = 0.9) # considering the correlation coefficient cutoff for both psedospectra extraction and GlobalStd algorithm stdcluster3 <- getcluster(std2, corcutoff = 0.9)
We supplied getcorcluster
to find peaks groups by correlation analysis only. The base peaks of correlation cluster were selected to stand for the compounds.
corcluster <- getcorcluster(spmeinvivo) # extract pseudospectra 1@46 peak <- corcluster$cluster[corcluster$cluster$largei == '1@46',] plot(peak$ins~peak$mz,type = 'h',xlab = 'm/z',ylab = 'intensity',main = 'pseudo spectra for correlation cluster')
Then we could compare the compare reduced result using PCA similarity factor. A good peak selection algorithm could show a high PCA similarity factor compared with original data set while retain the minimized number of peaks.
par(mfrow = c(3,3),mar = c(4,4,2,1)+0.1) plotpca(std$data[std$stdmassindex,],lv = as.numeric(as.factor(std$group$sample_group)),main = paste(sum(std$stdmassindex),"independent peaks")) plotpca(std$data[stdcluster$stdmassindex2,],lv = as.numeric(as.factor(std$group$sample_group)),main = paste(sum(stdcluster$stdmassindex2),"independent base peaks")) plotpca(std$data[stdcluster2$stdmassindex2,],lv = as.numeric(as.factor(std$group$sample_group)),main = paste(sum(stdcluster2$stdmassindex2),"independent reduced base peaks")) plotpca(std$data[corcluster$stdmassindex,],lv = as.numeric(as.factor(std$group$sample_group)),main = paste(sum(corcluster$stdmassindex),"peaks without correlationship")) plotpca(std$data[corcluster$stdmassindex2,],lv = as.numeric(as.factor(std$group$sample_group)),main = paste(sum(corcluster$stdmassindex2),"base peaks without correlationship")) plotpca(std$data,lv = as.numeric(as.factor(std$group$sample_group)),main = paste(nrow(std$data),"all peaks")) plotpca(std$data[stdcluster3$stdmassindex2,],lv = as.numeric(as.factor(std$group$sample_group)),main = paste(sum(stdcluster3$stdmassindex2),"reduced independent base peaks")) pcasf(std$data, std$data[std$stdmassindex,]) pcasf(std$data, std$data[stdcluster$stdmassindex2,]) pcasf(std$data, std$data[stdcluster2$stdmassindex2,]) pcasf(std$data, std$data[corcluster$stdmassindex,]) pcasf(std$data, std$data[corcluster$stdmassindex2,]) pcasf(std$data, std$data[stdcluster3$stdmassindex2,])
In this case, five peaks selection algorithms are fine to stand for the original peaks with PCA similarity score larger than 0.9. However, the independent base peaks retain the most information with relative low numbers of peaks.
getsda
function could be used to perform Structure/reaction directed analysis. The cutoff of frequency is automate found by PMD network analysis with the largest mean distance of all nodes.
sda <- getsda(std)
Such largest mean distance of all nodes is calculated for top 1 to 100 (if possible) high frequency PMDs. Here is a demo for the network generation process.
library(igraph) cdf <- sda$sda # get the PMDs and frequency pmds <- as.numeric(names(sort(table(cdf$diff2),decreasing = T))) freq <- sort(table(cdf$diff2),decreasing = T) # filter the frequency larger than 10 for demo pmds <- pmds[freq>10] cdf <- sda$sda[sda$sda$diff2 %in% pmds,] g <- igraph::graph_from_data_frame(cdf,directed = F) l <- igraph::layout_with_fr(g) for(i in 1:length(pmds)){ g2 <- igraph::delete_edges(g,which(E(g)$diff2%in%pmds[1:i])) plot(g2,edge.width=1,vertex.label="",vertex.size=1,layout=l,main=paste('Top',length(pmds)-i,'high frequency PMDs')) }
Here we could find more and more compounds will be connected with more high frequency PMDs. Meanwhile, the mean distance of all network nodes will increase. However, some PMDs are generated by random combination of ions. In this case, if we included those PMDs for the network, the mean distance of all network nodes will decrease. Here, the largest mean distance means no more information will be found for certain data set and such value is used as the cutoff for high frequency PMDs selection.
You could use plotstdsda
to show the distribution of the selected paired peaks.
plotstdsda(sda)
You could also use index to show the distribution of certain PMDs.
par(mfrow = c(1,3),mar = c(4,4,2,1)+0.1) plotstdsda(sda,sda$sda$diff2 == 2.02) plotstdsda(sda,sda$sda$diff2 == 28.03) plotstdsda(sda,sda$sda$diff2 == 58.04)
Structure/reaction directed analysis could be directly performed on all the peaks, which is slow to process:
sdaall <- getsda(spmeinvivo) par(mfrow = c(1,3),mar = c(4,4,2,1)+0.1) plotstdsda(sdaall,sdaall$sda$diff2 == 2.02) plotstdsda(sdaall,sdaall$sda$diff2 == 28.03) plotstdsda(sdaall,sdaall$sda$diff2 == 58.04)
Structure/Reaction directed analysis could also use correlation to restrict the paired ions. However, similar to GlobalStd algorithm, such cutoff will remove low intensity data. Researcher should have a clear idea to use this cutoff.
sda2 <- getsda(std, corcutoff = 0.9) plotstdsda(sda2)
When you only have data of peaks without retention time or compounds list, structure/reaction directed analysis could also be done by getrda
function.
sda <- getrda(spmeinvivo$mz[std$stdmassindex])
globalstd
function is a wrap function to process GlobalStd algorithm and structure/reaction directed analysis in one line. All the plot function could be directly used on the list
objects from globalstd
function. If you want to perform structure/reaction directed analysis, set the sda=T
in the globalstd
function.
result <- globalstd(spmeinvivo, sda=FALSE)
Independent peaks are supposing generated from different compounds. We could use those peaks for MS/MS analysis instead of DIA or DDA. Here we need multiple injections for one sample since it might be impossible to get all ions' fragmental ions in one injection with good sensitivity. You could use gettarget
to generate the index for the injections and output the peaks for each run.
# you need retention time for independent peaks index <- gettarget(std$rt[std$stdmassindex]) # output the ions for each injection table(index) # show the ions for the first injection std$mz[index==1] std$rt[index==1]
An interactive document has been included in this package to perform PMD analysis. You need to prepare a csv file with m/z and retention time of peaks. Such csv file could be generated by run enviGCMS::getcsv()
on the list
object from enviGCMS::getmzrt(xset)
function. The xset
should be XCMSnExp
object or xcmsSet
object. You could also generate the csv file by enviGCMS::getmzrt(xset,name = 'test')
. You will find the csv file in the working dictionary named test.csv
.
Then you could run runPMD()
to start the Graphical user interface(GUI) for GlobalStd algorithm and structure/reaction directed analysis.
pmd
package could be used to reduce the redundancy peaks for GC/LC-MS based research and perform structure/reaction directed analysis to screen known and unknown important compounds or reactions.
Any scripts or data that you put into this service are public.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.