match-standards-serum-mix18.Rmd

---
title: "Identifying mix18 standards in serum"
author: "Marilyn De Graeve, Andrea Vicini, Vinicius Verri Hernandes, Johannes Rainer"
output:
  rmarkdown::html_document:
    highlight: pygments
    toc: true
    toc_float: true
    toc_depth: 3
    fig_width: 5
---

```{r, include = FALSE, cached = FALSE}
knitr::read_chunk("R/match-standards-chunks.R")
MIX <- 18
MATRIX <- "Serum"
POLARITY <- "POS"
## settings to find MS2 spectra for features. Be rather inclusive here.
FEATURE_MS2_PPM <- 20
FEATURE_MS2_TOLERANCE <- 0.05
```

```{r, libraries, echo = FALSE, message = FALSE}
```
```{r, general-settings, echo = FALSE, message = FALSE}
```

**Current version: 0.10.1, 2024-10-29.**

# Introduction

Mixes of standards have been solved in serum or added to human serum sample
pools in two different concentration and these samples were measured with the
LC-MS setup from Eurac (used also to generate the CHRIS untargeted metabolomics
data). Assignment of retention time and observed ion can be performed for each
standard based on MS1 information such as expected m/z but also based on the
expected difference in signal between samples with low and high concentration of
the standards. Finally, experimental fragment spectra provide the third level of
evidence. Thus, the present data set allows to annotate features to standards
based on 3 levels of evidence: expected m/z, difference in measured intensity
and MS2-based annotation.

A detailed description of the approach is given in
[match-standards-introduction.Rmd](match-standards-introduction.Rmd).


The list of standards that constitute the present sample mix are listed below
along with the expected retention time and the most abundant adduct for positive
and negative polarity as defined manually in a previous analysis by Mar
Garcia-Aloy.

```{r, standards-table, echo = FALSE, results = "asis"}
```

# Data import

We next load the data and split it according to matrix and polarity.

```{r, data-import}
```

We next also load the reference databases we will use to compare the
experimental MS2 spectra against. Below we thus load HMDB and MassBank data. We
create in addition *neutral loss* versions of the databases. Since HMDB does not
provide precursor m/z values we assume the fragment spectra to represent `[M+H]+`
ions (respectively `[M-H]-` ions for negative polarity) and add the m/z for
these adducts as *precursor m/z*.

```{r, load-reference-databases, message = FALSE}
```

```{r, setup-ion-db, message = FALSE, echo = FALSE}
```

# Initial evaluation of available MS2 data

Before performing the actual analysis that involves chromatographic peak
detection and evaluation of feature abundances, we compare all experimental MS2
spectra against the reference libraries. This provides already a first hint for
which standards a valid MS2 spectrum was recorded (and hence would allow
annotation based on evidence 3) and what related retention time might be.

We first extract all MS2 spectra from the respective data files and process them
by first removing all peaks with an intensity below 5% of the highest peak
signal, then scaling all intensities to a value range between 0 and 100 and
finally remove all MS2 spectra with less than 2 peaks.

```{r prepare-all-ms2}
fls <- fileNames(data_all)[data_all$polarity == "POS"]
```
```{r, all-ms2}
```

We next match these spectra against all reference spectra from HMDB for the
standards in `r MIX_NAME`. 

The settings for the matching are defined below. These will be used for all MS2
spectra similarity calculations. All matching spectra with a similarity larger
0.7 are identified.

```{r, compare-spectra-param}
```
 
Positive polarity:

Standards for which no MS2 spectrum in HMDB is present are listed in
the table below.

```{r, echo = FALSE, results = "asis"}
tmp <- std_dilution[!(std_dilution$HMDB %in% hmdb_std$compound_id), ]
pandoc.table(tmp[, c("name", "HMDB", "formula")], style = "rmarkdown",
             caption = "Standards for which no reference spectrum is available")
```

The table below lists all standards and the number of matching reference spectra
(along with their retention times).

```{r, table-all-ms2-hmdb, echo = FALSE, results = "asis"}
```

Negative polarity:

We repeat the same analysis for the negative polarity data (code not shown
again).

```{r, echo = FALSE}
fls <- fileNames(data_all)[data_all$polarity == "NEG"]
```
```{r, all-ms2, echo = FALSE}
```

For `r MIX_NAME`, zero matched MS2 spectra were found in the negative ionization 
mode. Therefore, the chunk below was adjusted.

```{r, table-all-ms2-hmdb-MIX18, echo = FALSE, results = "asis"}
all_match <- matchSpectra(
    hmdb_std, all_ms2,
    param = csp)
all_match <- all_match[whichQuery(all_match)]

tab <- matchedData(all_match, c("name", "compound_id", "score", "target_rtime"))
tab
```

We next perform the full analysis of the data set involving MS1 and MS2 data.


# Serum, positive polarity

We first perform the analysis on the samples with the standards solved in pure
serum acquired in positive polarity mode.

```{r}
POLARITY <- "POS"
data <- filterFile(data_all, which(data_all$polarity == POLARITY))
hmdb <- hmdb_pos
hmdb_nl <- hmdb_pos_nl
```

## Data pre-processing

We perform the pre-processing of our data set which consists of the
chromatographic peak detection followed by a peak refinement step to reduce peak
detection artifacts, the correspondence analysis to group peaks across samples
and finally the gap-filling to fill in missing peak data from samples in which
no chromatographic peak was detected. For details on settings please refer to
the analysis of *mix 01* samples.

```{r, preprocessing, eval = !file.exists(paste0(RDATA_PATH, "processed_data_", POLARITY, ".RData")), message = FALSE}
```

```{r, echo = FALSE}
load(paste0(RDATA_PATH, paste0("processed_data_", POLARITY, ".RData")))
data_FS <- filterFile(data, which(data$mode == "FS"),
                      keepFeatures = TRUE)
```

## Signal intensity difference

We compute the difference in (log2) signals between samples with high and low
concentration of the standards and calculate the p-value for this difference
using the Student's t-test.

```{r, abundance-difference}
```

## Identification of features matching standards

We now identify all features matching the any of the pre-defined set of adducts
for the standards of mix `r MIX`. Matching features are further subsetted to
those that show an at least twice as high signal in samples with high
concentration compared to those with low concentrations. Also, features with a
signal in low concentration but no detectable signal in high concentration are
removed. Lastly, from mixture 12 onward the maximum retention time deviation 
from the expected 'Target_RT' is less than 10 seconds.

```{r, define-adducts-pos}
```
```{r, match-features}
```

For most of the standards (`r length(unique(mD$target_name))` out of 
`r nrow(std_dilution)`) in mix `r MIX` at least one feature was found
matching the standards adducts' m/z. 

```{r, table-standard-no-feature, results = "asis", echo = FALSE}
```

In the next sections we investigate for each standard which assignment would be
the correct one or, for those for which no signal was detected, why that was the
case.

## Standards evaluation (all, incl not found/matched)

While for some standards a matching feature was found we still need to evaluate
whether this matching is correct. For each standard we thus first evaluate the
EICs for all matching features, then we match their MS2 spectra (if available)
against reference libraries. To ensure correct assignment of a feature, its
retention time and eventually related MS2 spectra, we consider the following
criteria to determine the annotation confidence:

- feature(s) was/were found with m/z matching those of adduct(s) of the 
  standard.
- signal is higher for samples with higher concentration.
- MS2 spectra matches reference spectra for the standard (if available).
- MS2 spectra don't match MS2 spectra of other compounds.

### Fructose 6-Phosphate

```{r, echo = FALSE}
std <- "Fructose 6-Phosphate"
```

```{r, table-feature-matches, results = "asis", echo = FALSE, message = FALSE}
```

Many features have been assigned to this standard based on m/z matching. Based
on their retention times, these seem however to represent ions from different
compounds.

We next plot the EIC for the assigned feature and visually inspect these.

EICs (check D?):

```{r, echo = FALSE}
plot_eics(data, std, feature_table, "WP", std_ms2)
```

The cleaned MS2 spectra for the features matched to `r std` are shown below
(peaks with an intensity below 5% of the maximum peak and spectra with less
than 2 peaks were removed).

```{r mix18-serum-pos-Fructose 6-Phosphate-ms2, echo = FALSE}
plot_spectra(std_ms2)
```

We next match the extracted MS2 spectra against the reference spectra for 
`r std` from HMDB and MassBank.

Heat maps:

```{r mix12-serum-pos-dUTP-ms2-hmdb, echo = FALSE, fig.width = 5, fig.height = 5}
hmdb_id <- std_dilution$HMDB[std_dilution$name == std]
std_hmdb <- Spectra(cdb, filter = ~ compound_id == hmdb_id)
sim_hmdb <- plot_ms2_similarity_heatmap(std_ms2, std_hmdb, csp)
```

```{r mix12-serum-pos-dUTP-ms2-mbank, echo = FALSE, fig.width = 5, fig.height = 5}
std_mbank <- get_mbank(mbank, inchikey = unique(std_hmdb$inchikey))
sim_mbank <- plot_ms2_similarity_heatmap(std_ms2, std_mbank, csp)
```

For spectra from untargeted features that match with good similarity to some of 
the HMDB reference spectra for `r std`, we show the mirror plots of the best 
matches.

Mirror plots (check D -> C or B?):

```{r mix12-serum-pos-dUTP-mirror-hmdb, echo = TRUE, fig.cap = "Mirror plots"}
std_ms2_sel <- plot_select_ms2(std_ms2, std_hmdb, 0.1, ppm = csp@ppm,
                               tolerance = csp@tolerance, sim_hmdb)
```

```{r mix12-serum-pos-dUTP-mirror-mbank, echo = TRUE, fig.cap = "Mirror plots"}
tmp_sel <- plot_select_ms2(std_ms2, std_mbank, 0.1,
                           ppm = csp@ppm, tolerance = csp@tolerance, sim_mbank)
```

In addition we match (**all**) the MS2 spectra for the matched features against
all spectra from HMDB or MassBank identifying reference spectra with a
similarity larger than 0.7. The results (if any spectra matched) are shown in
the two following tables.

Highest confidence matches (check B -> A?):

```{r, echo = FALSE, message = FALSE, results = "asis"}
perform_match(std_ms2, hmdb, sv = c("rtime", "target_name", "score"),
              name = "target_name", param = csp)
```

```{r, echo = FALSE, message = FALSE, results = "asis"}
perform_match(std_ms2, mbank, sv = c("rtime", "target_name", "score"),
              name = "target_name", param = csp)
```

#### Summary

- No good spectral matches.
- D for:

| label |   feature  | mzmed | ppm_error | rtmed | target_RT | feature_group |  adduct   | n_ms2 | mean_high | mean_low |
|:-----:|:----------:|:-----:|:---------:|:-----:|:---------:|:-------------:|:---------:|:-----:|:---------:|:--------:|
| **D** | FT03536    | 283   | 2.383     | 230.3 | 235       | FG.001.001    | [M+Na]+   | 2     | 17.02     | 4.43     |
| **D** | FT03874    | 299   | 7.618     | 230.7 | 235       | FG.002.001    | [M+K]+    | 2     | 15.27     | 5.097    |

- Results previous (wo rt filtering):
  - No MS2 spectra available.
  - maybe D for, high rt dev and/or ppm:
  
  | label |   feature   | mzmed  | ppm_error | rtmed | target_RT | feature_group |  adduct           | n_ms2 | mean_high | mean_low |
  |:-----:|:-----------:|:------:|:---------:|:-----:|:---------:|:-------------:|:-----------------:|:-----:|:---------:|:--------:|
  | **D** | **FT03876** |  299   |   21.26   | 172.5 |    235    |  FG.001.001   |   [M+K]+          |   0   |   11.2    |  8.961   |
  | **D** | **FT03535** |  283   |   22.08   | 176.9 |    235    |  FG.001.001   |  [M+Na]+          |   0   |   11.24   |  10.12   |
  | **D** | **FT00902** |  131   |   1.654   | 197.4 |    235    |  FG.002.001   |  [M+2H]2+         |   0   |   10.13   |  7.578   |
  | **D** | **FT02849** |  243   |   4.096   | 210.8 |    235    |  FG.004.001   | [M+H-H2O]+        |   0   |   12.06   |  7.187   |
  | **D** | **FT00383** | +-98.9 |   -       | +-210 |    235    |  -            | [M+H-Hexose-H2O]+ |   -   |   -       |  -       |

```{r, echo = FALSE}
fts <- data.frame(feature_id = c("FT03536", "FT03874"),
                  confidence_level = c("D", 'D'))
```

```{r, add-ions, echo = FALSE, results = "asis"}
```


### 2-Hydroxybutyric acid

```{r, echo = FALSE}
std <- "2-Hydroxybutyric acid"
```

```{r, table-feature-matches-2-Hydroxybutyric acid, results = "asis", echo = FALSE, message = FALSE}
feature_table <- as.data.frame(mD[mD$target_name == std, ])
pandoc.table(feature_table, style = "rmarkdown",
             split.tables = Inf,
             caption = paste0("Feature to standards matches for ", std))
```

#### Summary

- No filtered feature table, no potential peaks found.
- No MS2 spectra available (because no potential peaks for `r std`).
- Results previous (wo rt filtering):
  - 3 feats, very high rt deviation, 2 with spectra but no similarity and 
    matching to other compounds.


### 3-Hydroxy-DL-kynurenine

```{r, echo = FALSE}
std <- "3-Hydroxy-DL-kynurenine"
```

```{r, table-feature-matches, results = "asis", echo = FALSE, message = FALSE}
```

Many features have been assigned to this standard based on m/z matching. Based
on their retention times, these seem however to represent ions from different
compounds.

We next plot the EIC for the assigned feature and visually inspect these.

EICs (check D?):

```{r, echo = FALSE}
plot_eics(data, std, feature_table, "WP", std_ms2)
```

The cleaned MS2 spectra for the features matched to `r std` are shown below
(peaks with an intensity below 5% of the maximum peak and spectra with less
than 2 peaks were removed).

```{r mix18-serum-pos-3-Hydroxy-DL-kynurenine-ms2, echo = FALSE}
plot_spectra(std_ms2)
```

We next match the extracted MS2 spectra against the reference spectra for 
`r std` from HMDB and MassBank.

Heat maps:

```{r mix12-serum-pos-Pantothenic Acid-ms2-hmdb, echo = FALSE, fig.width = 5, fig.height = 5}
hmdb_id <- std_dilution$HMDB[std_dilution$name == std]
std_hmdb <- Spectra(cdb, filter = ~ compound_id == hmdb_id)
sim_hmdb <- plot_ms2_similarity_heatmap(std_ms2, std_hmdb, csp)
```

```{r mix12-serum-pos-Pantothenic Acid-ms2-mbank, echo = FALSE, fig.width = 5, fig.height = 5}
std_mbank <- get_mbank(mbank, inchikey = unique(std_hmdb$inchikey))
sim_mbank <- plot_ms2_similarity_heatmap(std_ms2, std_mbank, csp)
```

For spectra from untargeted features that match with good similarity to some of 
the HMDB reference spectra for `r std`, we show the mirror plots of the best 
matches.

Mirror plots (check D -> C or B?):

```{r mix12-serum-pos-Pantothenic Acid-mirror-hmdb, echo = TRUE, fig.cap = "Mirror plots"}
std_ms2_sel <- plot_select_ms2(std_ms2, std_hmdb, 0.7, ppm = csp@ppm,
                               tolerance = csp@tolerance, sim_hmdb)
```

```{r mix12-serum-pos-Pantothenic Acid-mirror-mbank, echo = TRUE, fig.cap = "Mirror plots"}
tmp_sel <- plot_select_ms2(std_ms2, std_mbank, 0.7,
                           ppm = csp@ppm, tolerance = csp@tolerance, sim_mbank)
```

In addition we match (**all**) the MS2 spectra for the matched features against
all spectra from HMDB or MassBank identifying reference spectra with a
similarity larger than 0.7. The results (if any spectra matched) are shown in
the two following tables.

Highest confidence matches (check B -> A?):

```{r, echo = FALSE, message = FALSE, results = "asis"}
perform_match(std_ms2, hmdb, sv = c("rtime", "target_name", "score"),
              name = "target_name", param = csp)
```

```{r, echo = FALSE, message = FALSE, results = "asis"}
perform_match(std_ms2, mbank, sv = c("rtime", "target_name", "score"),
              name = "target_name", param = csp)
```

#### Summary

- Synonyms with 3-Hydroxykynurenine and Hydroxykynurenine
- Unique spectral matches for FT02568 (>0.7)
- labels:

| label |   feature  | mzmed | ppm_error | rtmed | target_RT | feature_group |  adduct    | n_ms2 | mean_high | mean_low |
|:-----:|:----------:|:-----:|:---------:|:-----:|:---------:|:-------------:|:----------:|:-----:|:---------:|:--------:|
| **A** | FT02568    | 225.1 | 1.155     | 165.1 | 163       | FG.002.001    | [M+H]+     | 2     | 19.8      | 15.53    |
| **C** | FT02312    | 208.1 | 0.3687    | 164.8 | 163       | FG.002.001    | [M+H-NH3]+ | 3     | 17.8      | 13.31    |
| **D** | FT02918    | 247.1 | 0.1955    | 164.3 | 163       | FG.001.001    | [M+Na]+    | 0     | 19.43     | 15.24    |
| **D** | FT03254    | 269.1 | 0.2754    | 164.6 | 163       | FG.001.001    | [M+2Na-H]+ | 1     | 19.11     | 14.99    |
| **D** | FT02288    | 207.1 | 22.61     | 165.1 | 163       | FG.002.001    | [M+H-H2O]+ | 0     | 11.75     | 10.9     |

- Reference MS2: FT02568: F07.S0510, F08.S0555

```{r, echo = FALSE}
fts <- data.frame(feature_id = c("FT02568", "FT02312", 'FT02918', 'FT03254', 'FT02288'),
                  confidence_level = c("A", "C", 'D', 'D', 'D'))
## Get MS2 spectra:
ms2 <- std_ms2[match(c("FT02568_F07.S0510", "FT02568_F08.S0555",
                       'FT02312_F08.S0554', 'FT02312_F08.S0627'),
                     spectraNames(std_ms2))]
ms2$confidence <- c('high', 'high',
                    'high', 'high')
```

```{r, add-ions, echo = FALSE, results = "asis"}
```

```{r, add-ms2-spectra, echo = FALSE, results = "asis"}
```


### Succinyl-CoA

```{r, echo = FALSE}
std <- "Succinyl-CoA"
```

```{r, table-feature-matches-Succinyl-CoA, results = "asis", echo = FALSE, message = FALSE}
feature_table <- as.data.frame(mD[mD$target_name == std, ])
pandoc.table(feature_table, style = "rmarkdown",
             split.tables = Inf,
             caption = paste0("Feature to standards matches for ", std))
```

#### Summary

- No filtered feature table, no potential peaks found.
- No MS2 spectra available (because no potential peaks for `r std`).


# Serum, negative polarity

We now perform the analysis on the samples with the standards still solved in
pure serum but acquired in negative polarity mode.

```{r}
POLARITY <- "NEG"
data <- filterFile(data_all, which(data_all$polarity == POLARITY))
hmdb <- hmdb_neg
hmdb_nl <- hmdb_neg_nl
```

```{r, preprocessing, eval = !file.exists(paste0(RDATA_PATH, "processed_data_", POLARITY, ".RData")), message = FALSE}
```

```{r, echo = FALSE}
load(paste0(RDATA_PATH, paste0("processed_data_", POLARITY, ".RData")))
data_FS <- filterFile(data, which(data$mode == "FS"),
                      keepFeatures = TRUE)
```


## Signal intensity difference

We compute the difference in (log2) signals between samples with high and low
concentration of the standards and calculate the p-value for this difference
using the Student's t-test.

```{r, abundance-difference}
```

## Identification of features matching standards

We now identify all features matching the any of the pre-defined set of adducts
for the standards of mix `r MIX`. Matching features are further subsetted to
those that show an at least twice as high signal in samples with high
concentration compared to those with low concentrations. Also, features with a
signal in low concentration but no detectable signal in high concentration are
removed.

```{r, define-adducts-neg}
```
```{r, match-features}
```

For most of the standards (`r length(unique(mD$target_name))` out of 
`r nrow(std_dilution)`) in mix `r MIX` at least one feature was found
matching the standards adducts' m/z. 

```{r, table-standard-no-feature, results = "asis", echo = FALSE}
```

In the next sections we investigate for each standard which assignment would be
the correct one or, for those for which no signal was detected, why that was the
case.

## Standards evaluation (all, incl not found/matched)

While for some standards a matching feature was found we still need to evaluate
whether this matching is correct. For each standard we thus first evaluate the
EICs for all matching features, then we match their MS2 spectra (if available)
against reference libraries. To ensure correct assignment of a feature, its
retention time and eventually related MS2 spectra, we consider the following
criteria to determine the annotation confidence:

- feature(s) was/were found with m/z matching those of adduct(s) of the 
  standard.
- signal is higher for samples with higher concentration.
- MS2 spectra matches reference spectra for the standard (if available).
- MS2 spectra don't match MS2 spectra of other compounds.

### Fructose 6-Phosphate

```{r, echo = FALSE}
std <- "Fructose 6-Phosphate"
```

```{r, table-feature-matches, results = "asis", echo = FALSE, message = FALSE}
```

Many features have been assigned to this standard based on m/z matching. Based
on their retention times, these seem however to represent ions from different
compounds.

We next plot the EIC for the assigned feature and visually inspect these.

EICs (check D?):

```{r, echo = FALSE}
plot_eics(data, std, feature_table, "WP", std_ms2)
```

The cleaned MS2 spectra for the features matched to `r std` are shown below
(peaks with an intensity below 5% of the maximum peak and spectra with less
than 2 peaks were removed).

```{r mix18-serum-neg-Fructose 6-Phosphate-ms2, echo = FALSE}
plot_spectra(std_ms2)
```

We next match the extracted MS2 spectra against the reference spectra for 
`r std` from HMDB and MassBank.

Heat maps:

```{r mix18-serum-neg-Fructose 6-Phosphate-ms2-hmdb, echo = FALSE, fig.width = 5, fig.height = 5}
hmdb_id <- std_dilution$HMDB[std_dilution$name == std]
std_hmdb <- Spectra(cdb, filter = ~ compound_id == hmdb_id)
sim_hmdb <- plot_ms2_similarity_heatmap(std_ms2, std_hmdb, csp)
```

```{r mix18-serum-neg-Fructose 6-Phosphate-ms2-mbank, echo = FALSE, fig.width = 5, fig.height = 5}
std_mbank <- get_mbank(mbank, inchikey = unique(std_hmdb$inchikey))
sim_mbank <- plot_ms2_similarity_heatmap(std_ms2, std_mbank, csp)
```

For spectra from untargeted features that match with good similarity to some of 
the HMDB reference spectra for `r std`, we show the mirror plots of the best 
matches.

Mirror plots (check D -> C or B?):

```{r mix18-serum-neg-Fructose 6-Phosphate-mirror-hmdb, echo = TRUE, fig.cap = "Mirror plots"}
std_ms2_sel <- plot_select_ms2(std_ms2, std_hmdb, 0.1, ppm = csp@ppm,
                               tolerance = csp@tolerance, sim_hmdb)
```

```{r mix18-serum-neg-Fructose 6-Phosphate-mirror-mbank, echo = TRUE, fig.cap = "Mirror plots"}
tmp_sel <- plot_select_ms2(std_ms2, std_mbank, 0.1,
                           ppm = csp@ppm, tolerance = csp@tolerance, sim_mbank)
```

In addition we match (**all**) the MS2 spectra for the matched features against
all spectra from HMDB or MassBank identifying reference spectra with a
similarity larger than 0.7. The results (if any spectra matched) are shown in
the two following tables.

Highest confidence matches (check B -> A?):

```{r, echo = FALSE, message = FALSE, results = "asis"}
perform_match(std_ms2, hmdb, sv = c("rtime", "target_name", "score"),
              name = "target_name", param = csp)
```

```{r, echo = FALSE, message = FALSE, results = "asis"}
perform_match(std_ms2, mbank, sv = c("rtime", "target_name", "score"),
              name = "target_name", param = csp)
```

#### Summary

- MS spectra contain "phosphate" and "hexose" fragments for FT1560 in HMDB,
  but doesn't match to `r std` >0.7, so C.

| label |   feature  | mzmed | ppm_error | rtmed | target_RT | feature_group |  adduct   | n_ms2 | mean_high | mean_low |
|:-----:|:----------:|:-----:|:---------:|:-----:|:---------:|:-------------:|:---------:|:-----:|:---------:|:--------:|
| **C** | FT4653     | 519   | 9.382     | 233.8 | 235       | FG.001.001    | [2M-H]-   | 2     | 17.42     | 0.2109   |
| **C** | FT1560     | 259   | 16.87     | 234.5 | 235       | FG.001.001    | [M-H]-    | 4     | 19.12     | 11.64    |

```{r, echo = FALSE}
fts <- data.frame(feature_id = c("FT4653", "FT1560"),
                  confidence_level = c("C", "C"))
## Get MS2 spectra:
ms2 <- std_ms2[match(c("FT4653_F16.S0694",
                       'FT1560_F15.S0568', 'FT1560_F15.S0598'),
                     spectraNames(std_ms2))]
ms2$confidence <- c('high', 
                    'high', 'high')
```

```{r, add-ions, echo = FALSE, results = "asis"}
```

```{r, add-ms2-spectra, echo = FALSE, results = "asis"}
```


### 2-Hydroxybutyric acid

```{r, echo = FALSE}
std <- "2-Hydroxybutyric acid"
```

```{r, table-feature-matches, results = "asis", echo = FALSE, message = FALSE}
```

Many features have been assigned to this standard based on m/z matching. Based
on their retention times, these seem however to represent ions from different
compounds.

We next plot the EIC for the assigned feature and visually inspect these.

EICs (check D?):

```{r, echo = FALSE}
plot_eics(data, std, feature_table, "WP", std_ms2)
```

The cleaned MS2 spectra for the features matched to `r std` are shown below
(peaks with an intensity below 5% of the maximum peak and spectra with less
than 2 peaks were removed).

```{r mix18-serum-neg-2-Hydroxybutyric acid-ms2, echo = FALSE}
plot_spectra(std_ms2)
```

We next match the extracted MS2 spectra against the reference spectra for 
`r std` from HMDB and MassBank.

Heat maps:

```{r mix18-serum-neg-2-Hydroxybutyric acid-ms2-hmdb, echo = FALSE, fig.width = 5, fig.height = 5}
hmdb_id <- std_dilution$HMDB[std_dilution$name == std]
std_hmdb <- Spectra(cdb, filter = ~ compound_id == hmdb_id)
sim_hmdb <- plot_ms2_similarity_heatmap(std_ms2, std_hmdb, csp)
```

```{r mix18-serum-neg-2-Hydroxybutyric acid-ms2-mbank, echo = FALSE, fig.width = 5, fig.height = 5}
std_mbank <- get_mbank(mbank, inchikey = unique(std_hmdb$inchikey))
sim_mbank <- plot_ms2_similarity_heatmap(std_ms2, std_mbank, csp)
```

For spectra from untargeted features that match with good similarity to some of 
the HMDB reference spectra for `r std`, we show the mirror plots of the best 
matches.

Mirror plots (check D -> C or B?):

```{r mix18-serum-neg-2-Hydroxybutyric acid-mirror-hmdb, echo = TRUE, fig.cap = "Mirror plots"}
std_ms2_sel <- plot_select_ms2(std_ms2, std_hmdb, 0.1, ppm = csp@ppm,
                               tolerance = csp@tolerance, sim_hmdb)
```

```{r mix18-serum-neg-2-Hydroxybutyric acid-mirror-mbank, echo = TRUE, fig.cap = "Mirror plots"}
tmp_sel <- plot_select_ms2(std_ms2, std_mbank, 0.1,
                           ppm = csp@ppm, tolerance = csp@tolerance, sim_mbank)
```

In addition we match (**all**) the MS2 spectra for the matched features against
all spectra from HMDB or MassBank identifying reference spectra with a
similarity larger than 0.7. The results (if any spectra matched) are shown in
the two following tables.

Highest confidence matches (check B -> A?):

```{r, echo = FALSE, message = FALSE, results = "asis"}
perform_match(std_ms2, hmdb, sv = c("rtime", "target_name", "score"),
              name = "target_name", param = csp)
```

```{r, echo = FALSE, message = FALSE, results = "asis"}
perform_match(std_ms2, mbank, sv = c("rtime", "target_name", "score"),
              name = "target_name", param = csp)
```

#### Summary

- No reliable MS2 spectra matches.
- labels:

| label |   feature  | mzmed | ppm_error | rtmed | target_RT | feature_group |  adduct       | n_ms2 | mean_high | mean_low |
|:-----:|:----------:|:-----:|:---------:|:-----:|:---------:|:-------------:|:-------------:|:-----:|:---------:|:--------:|
| **C** | FT0078     | 103   | 24.29     | 37.85 | 37        | FG.001.001    | [M-H]-        | 3     | 19.27     | 17.05    |
| **D** | FT0569     | 171   | 12.14     | 35.59 | 37        | FG.001.001    | [M-H+HCOONa]- | 0     | 13.63     | 11.6     |
| **D** | FT0398     | 149   | 27.11     | 36.92 | 37        | FG.001.001    | [M+CHO2]-     | 0     | 11.63     | 9.444    |

```{r, echo = FALSE}
fts <- data.frame(feature_id = c("FT0078", "FT0569", 'FT0398'),
                  confidence_level = c("C", "D", 'D'))
## Get MS2 spectra:
ms2 <- std_ms2[match(c("FT0078_F15.S0112"),
                     spectraNames(std_ms2))]
ms2$confidence <- c("low")
```

```{r, add-ions, echo = FALSE, results = "asis"}
```

```{r, add-ms2-spectra, echo = FALSE, results = "asis"}
```


### 3-Hydroxy-DL-kynurenine

```{r, echo = FALSE}
std <- "3-Hydroxy-DL-kynurenine"
```

```{r, table-feature-matches, results = "asis", echo = FALSE, message = FALSE}
```

Many features have been assigned to this standard based on m/z matching. Based
on their retention times, these seem however to represent ions from different
compounds.

We next plot the EIC for the assigned feature and visually inspect these.

EICs (check D?):

```{r, echo = FALSE}
plot_eics(data, std, feature_table, "WP", std_ms2)
```

The cleaned MS2 spectra for the features matched to `r std` are shown below
(peaks with an intensity below 5% of the maximum peak and spectra with less
than 2 peaks were removed).

```{r mix18-serum-neg-3-Hydroxy-DL-kynurenine-ms2, echo = FALSE}
plot_spectra(std_ms2)
```

#### Summary

- No MS2 spectra available.

| label |   feature  | mzmed | ppm_error | rtmed | target_RT | feature_group |    adduct     | n_ms2 | mean_high | mean_low |
|:-----:|:----------:|:-----:|:---------:|:-----:|:---------:|:-------------:|:-------------:|:-----:|:---------:|:--------:|
| **D** | **FT1564** |  259  |   11.89   | 164.3 |    163    |  FG.001.001   |    [M+Cl]-    |   0   |   12.98   |  10.12   |
| **D** | **FT1195** | 223.1 |   16.97   | 164.4 |    163    |  FG.001.001   |    [M-H]-     |   0   |   15.31   |  10.39   |
| **D** | **FT1959** | 291.1 |   16.08   | 164.6 |    163    |  FG.001.001   | [M-H+HCOONa]- |   0   |   12.33   |  10.44   |

```{r, echo = FALSE}
fts <- data.frame(feature_id = c("FT1564", "FT1195", "FT1959"),
                  confidence_level = c("D", 'D', 'D'))
```

```{r, add-ions, echo = FALSE, results = "asis"}
```


### Succinyl-CoA

```{r, echo = FALSE}
std <- "Succinyl-CoA"
```

```{r, table-feature-matches-Succinyl-CoA2, results = "asis", echo = FALSE, message = FALSE}
feature_table <- as.data.frame(mD[mD$target_name == std, ])
pandoc.table(feature_table, style = "rmarkdown",
             split.tables = Inf,
             caption = paste0("Feature to standards matches for ", std))
```

#### Summary

- No filtered feature table, no potential peaks found.
- No MS2 spectra available (because no potential peaks for `r std`).


# Summary on the ion database

Summarizing the content that was added to the `IonDb`.

```{r, iondb-summary, echo = FALSE, results = "asis"}
```

# Session information

The R version and packages used in this analysis are listed below.

```{r sessioninfo}
sessionInfo()
```