diff --git a/404.html b/404.html index cd6c0f53..bafb6682 100644 --- a/404.html +++ b/404.html @@ -18,6 +18,8 @@ + +
+ Content not found. Please use links in the navbar. +
+ +
+ + +
+ + + + + + diff --git a/CONDUCT.html b/CONDUCT.html index 98148e7f..8f0ef0d5 100644 --- a/CONDUCT.html +++ b/CONDUCT.html @@ -3,6 +3,8 @@ + +
+ + +
+
+

As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.

We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.

Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.

@@ -67,17 +77,31 @@

Contributor Code of Conduct

Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.

This Code of Conduct is adapted from the Contributor Covenant, version 1.0.0, available from http://contributor-covenant.org/version/1/0/0/

+
+ +
+ + + + + + + + + diff --git a/articles/index.html b/articles/index.html index ae691734..a8a2ef4e 100644 --- a/articles/index.html +++ b/articles/index.html @@ -3,6 +3,8 @@ + +
+ + +
+
+ + + + + + + + diff --git a/articles/v01-MSnbase-demo.html b/articles/v01-MSnbase-demo.html index a1420077..008fef05 100644 --- a/articles/v01-MSnbase-demo.html +++ b/articles/v01-MSnbase-demo.html @@ -12,13 +12,14 @@ - + +
-
+ + +

Abstract

This vignette describes the functionality implemented in the MSnbase package. MSnbase aims at (1) @@ -105,7 +117,8 @@

Sebastian the Bioconductor (Gentleman et al. 2004) project.

- - + +
-
+ + +

Abstract

This vignette describes MSnbase’s input and output capabilities.

-
+ +

Foreword

This software is free and open-source software. If you use it, please @@ -179,7 +189,7 @@

Quantitation datareadMzTabData to create and MSnSet instance.

-MSnbase input capabilities. The white and red boxes represent R functions/methods and objects respectively. The blue boxes represent different disk storage formats.
+MSnbase input capabilities. The white and red boxes represent R functions/methods and objects respectively. The blue boxes represent different disk storage formats.
MSnbase input capabilities. The white and red boxes represent R functions/methods and objects respectively. The blue boxes represent different disk storage formats.
@@ -224,7 +234,7 @@
Quantitation data -MSnbase output capabilities. The white and red boxes represent R functions/methods and objects respectively. The blue boxes represent different disk storage formats.
+MSnbase output capabilities. The white and red boxes represent R functions/methods and objects respectively. The blue boxes represent different disk storage formats.
MSnbase output capabilities. The white and red boxes represent R functions/methods and objects respectively. The blue boxes represent different disk storage formats.
@@ -356,7 +366,7 @@

A complete work flow## experimentData: use 'experimentData(object)' ## Annotation: ## - - - Processing information - - - -## Quantitation data loaded: Wed May 15 16:32:01 2024 using readMSnSet. +## Quantitation data loaded: Wed Sep 11 07:32:01 2024 using readMSnSet. ## MSnbase version: 2.31.1

The MSnSet class @@ -376,7 +386,7 @@

The MSnSet classA detailed description of the MSnSet class is available by typing ?MSnSet in the R console.

-Dimension requirements for the respective expression, feature and sample meta-data slots.
Dimension requirements for the respective +Dimension requirements for the respective expression, feature and sample meta-data slots.
Dimension requirements for the respective expression, feature and sample meta-data slots.

The individual parts of this data object can be accessed with their @@ -468,7 +478,7 @@

Session information
 sessionInfo()

-
## R version 4.4.0 (2024-04-24)
+
## R version 4.4.1 (2024-06-14)
 ## Platform: x86_64-pc-linux-gnu
 ## Running under: Ubuntu 22.04.4 LTS
 ## 
@@ -493,59 +503,59 @@ 

Session information## ## other attached packages: ## [1] pRolocdata_1.42.0 MSnbase_2.31.1 ProtGenerics_1.36.0 -## [4] S4Vectors_0.42.0 mzR_2.38.0 Rcpp_1.0.12 -## [7] Biobase_2.64.0 BiocGenerics_0.50.0 BiocStyle_2.32.0 +## [4] S4Vectors_0.42.1 mzR_2.38.0 Rcpp_1.0.13 +## [7] Biobase_2.64.0 BiocGenerics_0.50.0 BiocStyle_2.32.1 ## ## loaded via a namespace (and not attached): -## [1] rlang_1.1.3 magrittr_2.0.3 -## [3] clue_0.3-65 matrixStats_1.3.0 -## [5] compiler_4.4.0 systemfonts_1.0.6 +## [1] rlang_1.1.4 magrittr_2.0.3 +## [3] clue_0.3-65 matrixStats_1.4.1 +## [5] compiler_4.4.1 systemfonts_1.1.0 ## [7] vctrs_0.6.5 reshape2_1.4.4 ## [9] stringr_1.5.1 pkgconfig_2.0.3 -## [11] crayon_1.5.2 fastmap_1.1.1 +## [11] crayon_1.5.3 fastmap_1.2.0 ## [13] XVector_0.44.0 utf8_1.2.4 -## [15] rmarkdown_2.26.2 UCSC.utils_1.0.0 -## [17] preprocessCore_1.67.0 ragg_1.3.1 -## [19] purrr_1.0.2 xfun_0.43 -## [21] MultiAssayExperiment_1.30.1 zlibbioc_1.50.0 -## [23] cachem_1.0.8 GenomeInfoDb_1.40.0 +## [15] rmarkdown_2.28 UCSC.utils_1.0.0 +## [17] preprocessCore_1.67.0 ragg_1.3.2 +## [19] purrr_1.0.2 xfun_0.47 +## [21] MultiAssayExperiment_1.30.3 zlibbioc_1.50.0 +## [23] cachem_1.1.0 GenomeInfoDb_1.40.1 ## [25] jsonlite_1.8.8 DelayedArray_0.30.1 -## [27] BiocParallel_1.38.0 parallel_4.4.0 +## [27] BiocParallel_1.38.0 parallel_4.4.1 ## [29] cluster_2.1.6 R6_2.5.1 -## [31] bslib_0.7.0 stringi_1.8.4 -## [33] limma_3.60.0 GenomicRanges_1.56.0 +## [31] bslib_0.8.0 stringi_1.8.4 +## [33] limma_3.60.4 GenomicRanges_1.56.1 ## [35] jquerylib_0.1.4 iterators_1.0.14 -## [37] bookdown_0.39 SummarizedExperiment_1.34.0 -## [39] knitr_1.46 IRanges_2.38.0 +## [37] bookdown_0.40 SummarizedExperiment_1.34.0 +## [39] knitr_1.48 IRanges_2.38.1 ## [41] Matrix_1.7-0 igraph_2.0.3 ## [43] tidyselect_1.2.1 abind_1.4-5 -## [45] yaml_2.3.8 doParallel_1.0.17 +## [45] yaml_2.3.10 doParallel_1.0.17 ## [47] codetools_0.2-20 affy_1.82.0 ## [49] lattice_0.22-6 tibble_3.2.1 -## [51] plyr_1.8.9 evaluate_0.23 +## [51] plyr_1.8.9 evaluate_0.24.0 ## [53] desc_1.4.3 pillar_1.9.0 -## [55] affyio_1.74.0 BiocManager_1.30.23 +## [55] affyio_1.74.0 BiocManager_1.30.25 ## [57] MatrixGenerics_1.16.0 foreach_1.5.2 -## [59] MALDIquant_1.22.2 ncdf4_1.22 +## [59] MALDIquant_1.22.3 ncdf4_1.23 ## [61] generics_0.1.3 ggplot2_3.5.1 ## [63] munsell_0.5.1 scales_1.3.0 ## [65] glue_1.7.0 lazyeval_0.2.2 -## [67] tools_4.4.0 mzID_1.42.0 -## [69] QFeatures_1.14.1 vsn_3.72.0 -## [71] fs_1.6.4 XML_3.99-0.16.1 -## [73] grid_4.4.0 impute_1.78.0 -## [75] tidyr_1.3.1 MsCoreUtils_1.16.0 -## [77] colorspace_2.1-0 GenomeInfoDbData_1.2.12 -## [79] PSMatch_1.8.0 cli_3.6.2 -## [81] textshaping_0.3.7 fansi_1.0.6 -## [83] S4Arrays_1.4.0 dplyr_1.1.4 +## [67] tools_4.4.1 mzID_1.42.0 +## [69] QFeatures_1.14.2 vsn_3.72.0 +## [71] fs_1.6.4 XML_3.99-0.17 +## [73] grid_4.4.1 impute_1.78.0 +## [75] tidyr_1.3.1 MsCoreUtils_1.16.1 +## [77] colorspace_2.1-1 GenomeInfoDbData_1.2.12 +## [79] PSMatch_1.8.0 cli_3.6.3 +## [81] textshaping_0.4.0 fansi_1.0.6 +## [83] S4Arrays_1.4.1 dplyr_1.1.4 ## [85] AnnotationFilter_1.28.0 pcaMethods_1.96.0 ## [87] gtable_0.3.5 sass_0.4.9 -## [89] digest_0.6.35 SparseArray_1.4.3 -## [91] htmlwidgets_1.6.4 memoise_2.0.1 -## [93] htmltools_0.5.8.1 pkgdown_2.0.9.9000 -## [95] lifecycle_1.0.4 httr_1.4.7 -## [97] statmod_1.5.0 MASS_7.3-60.2

+## [89] digest_0.6.37 SparseArray_1.4.8 +## [91] htmlwidgets_1.6.4 htmltools_0.5.8.1 +## [93] pkgdown_2.1.0.9000 lifecycle_1.0.4 +## [95] httr_1.4.7 statmod_1.5.0 +## [97] MASS_7.3-61

References @@ -589,20 +599,32 @@

References - -

+ +

+
+ + +
+ + + + + + diff --git a/articles/v03-MSnbase-centroiding.html b/articles/v03-MSnbase-centroiding.html index 5ff9d202..cecbee51 100644 --- a/articles/v03-MSnbase-centroiding.html +++ b/articles/v03-MSnbase-centroiding.html @@ -12,13 +12,14 @@ - + +
-
+ + +

Abstract

This vignette describes the use of the MSnbase package for centroiding of profile-mode mass spectrometry data.

- - + +
## Unit: microseconds
 ##             expr        min         lq        mean      median         uq
-##   spectra(inmem)     62.878     73.357    138.5023    163.2640    175.467
-##     inmem[[200]]     16.160     17.703     40.5395     43.7165     58.780
-##  spectra(ondisk) 296985.032 297306.291 299485.2245 298564.6730 300027.645
-##    ondisk[[200]] 163269.509 163924.191 166592.9137 165307.5655 168637.951
+##   spectra(inmem)     59.681     62.917    133.7524    156.9530    173.153
+##     inmem[[200]]     15.940     17.071     41.1546     39.9745     57.828
+##  spectra(ondisk) 293759.433 294276.725 296479.2544 295842.3710 297222.461
+##    ondisk[[200]] 162204.621 162623.944 165152.8880 163413.3365 166092.695
 ##         max neval
-##     179.414    10
-##      69.509    10
-##  309512.585    10
-##  174080.691    10
+## 175.617 10 +## 89.367 10 +## 302354.014 10 +## 172959.151 10

While it takes order or magnitudes more time to access the data on-the-fly rather than a pre-generated spectrum, accessing all spectra is only marginally slower than accessing all spectra, as most of the @@ -236,11 +247,11 @@

Accessing spectrai <- sample(length(inmem), 100) system.time(inmem[i])

##    user  system elapsed 
-##   0.068   0.000   0.069
+## 0.069 0.000 0.069
 system.time(ondisk[i])
##    user  system elapsed 
-##   0.009   0.000   0.010
+## 0.01 0.00 0.01

Operations on the spectra data, such as peak picking, smoothing, cleaning, … are cleverly cached and only applied when the data is accessed, to minimise file access overhead. Finally, specific operations @@ -257,12 +268,12 @@

MS2 quantitationsystem.time(eim <- quantify(inmem[1:100], reporters = TMT6, method = "max"))

##    user  system elapsed 
-##   5.827   1.090   3.679
+## 5.532 1.147 3.518
 system.time(eod <- quantify(ondisk[1:100], reporters = TMT6,
                             method = "max"))
##    user  system elapsed 
-##   0.195   0.091   0.263
+## 0.189 0.095 0.262
 all.equal(eim, eod, check.attributes = FALSE)
## [1] TRUE
@@ -325,20 +336,32 @@

Conclusionsvignette(package = "MSnbase")

+ + +
+
+ + +
+

-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/articles/v05-MSnbase-development.html b/articles/v05-MSnbase-development.html index 25ed78c0..166afcb6 100644 --- a/articles/v05-MSnbase-development.html +++ b/articles/v05-MSnbase-development.html @@ -12,13 +12,14 @@ - + +
-
+ + +

Abstract

This vignette describes the classes implemented in package. It is intended as a starting point for developers or users who would like to learn more or further develop/extend mass spectrometry and proteomics data structures.

-
+ +

Foreword

This software is free and open-source software. If you use it, please @@ -364,8 +374,9 @@

in quantify and p is the number of reporter ions. If read from an external file, n corresponds to the number of features (protein groups, proteins, peptides, spectra) in the file and -\(p\) is the number of columns with -quantitative data (samples) in the file.

+pp +is the number of columns with quantitative data (samples) in the +file.

This prompted to keep a similar implementation as the ExpressionSet class, while adding the proteomics-specific annotation slot introduced in the pSet class, namely @@ -722,7 +733,7 @@

Session information
 sessionInfo()

-
## R version 4.4.0 (2024-04-24)
+
## R version 4.4.1 (2024-06-14)
 ## Platform: x86_64-pc-linux-gnu
 ## Running under: Ubuntu 22.04.4 LTS
 ## 
@@ -746,60 +757,60 @@ 

Session information## [8] base ## ## other attached packages: -## [1] MSnbase_2.31.1 ProtGenerics_1.36.0 S4Vectors_0.42.0 -## [4] mzR_2.38.0 Rcpp_1.0.12 Biobase_2.64.0 -## [7] BiocGenerics_0.50.0 BiocStyle_2.32.0 +## [1] MSnbase_2.31.1 ProtGenerics_1.36.0 S4Vectors_0.42.1 +## [4] mzR_2.38.0 Rcpp_1.0.13 Biobase_2.64.0 +## [7] BiocGenerics_0.50.0 BiocStyle_2.32.1 ## ## loaded via a namespace (and not attached): -## [1] rlang_1.1.3 magrittr_2.0.3 -## [3] clue_0.3-65 matrixStats_1.3.0 -## [5] compiler_4.4.0 systemfonts_1.0.6 +## [1] rlang_1.1.4 magrittr_2.0.3 +## [3] clue_0.3-65 matrixStats_1.4.1 +## [5] compiler_4.4.1 systemfonts_1.1.0 ## [7] vctrs_0.6.5 reshape2_1.4.4 ## [9] stringr_1.5.1 pkgconfig_2.0.3 -## [11] crayon_1.5.2 fastmap_1.1.1 +## [11] crayon_1.5.3 fastmap_1.2.0 ## [13] XVector_0.44.0 utf8_1.2.4 -## [15] rmarkdown_2.26.2 UCSC.utils_1.0.0 -## [17] preprocessCore_1.67.0 ragg_1.3.1 -## [19] purrr_1.0.2 xfun_0.43 -## [21] MultiAssayExperiment_1.30.1 zlibbioc_1.50.0 -## [23] cachem_1.0.8 GenomeInfoDb_1.40.0 +## [15] rmarkdown_2.28 UCSC.utils_1.0.0 +## [17] preprocessCore_1.67.0 ragg_1.3.2 +## [19] purrr_1.0.2 xfun_0.47 +## [21] MultiAssayExperiment_1.30.3 zlibbioc_1.50.0 +## [23] cachem_1.1.0 GenomeInfoDb_1.40.1 ## [25] jsonlite_1.8.8 DelayedArray_0.30.1 -## [27] BiocParallel_1.38.0 parallel_4.4.0 +## [27] BiocParallel_1.38.0 parallel_4.4.1 ## [29] cluster_2.1.6 R6_2.5.1 -## [31] bslib_0.7.0 stringi_1.8.4 -## [33] limma_3.60.0 GenomicRanges_1.56.0 +## [31] bslib_0.8.0 stringi_1.8.4 +## [33] limma_3.60.4 GenomicRanges_1.56.1 ## [35] jquerylib_0.1.4 iterators_1.0.14 -## [37] bookdown_0.39 SummarizedExperiment_1.34.0 -## [39] knitr_1.46 IRanges_2.38.0 +## [37] bookdown_0.40 SummarizedExperiment_1.34.0 +## [39] knitr_1.48 IRanges_2.38.1 ## [41] Matrix_1.7-0 igraph_2.0.3 ## [43] tidyselect_1.2.1 abind_1.4-5 -## [45] yaml_2.3.8 doParallel_1.0.17 +## [45] yaml_2.3.10 doParallel_1.0.17 ## [47] codetools_0.2-20 affy_1.82.0 ## [49] lattice_0.22-6 tibble_3.2.1 -## [51] plyr_1.8.9 evaluate_0.23 +## [51] plyr_1.8.9 evaluate_0.24.0 ## [53] desc_1.4.3 pillar_1.9.0 -## [55] affyio_1.74.0 BiocManager_1.30.23 +## [55] affyio_1.74.0 BiocManager_1.30.25 ## [57] MatrixGenerics_1.16.0 foreach_1.5.2 -## [59] MALDIquant_1.22.2 ncdf4_1.22 +## [59] MALDIquant_1.22.3 ncdf4_1.23 ## [61] generics_0.1.3 ggplot2_3.5.1 ## [63] munsell_0.5.1 scales_1.3.0 ## [65] glue_1.7.0 lazyeval_0.2.2 -## [67] tools_4.4.0 mzID_1.42.0 -## [69] QFeatures_1.14.1 vsn_3.72.0 -## [71] fs_1.6.4 XML_3.99-0.16.1 -## [73] grid_4.4.0 impute_1.78.0 -## [75] tidyr_1.3.1 MsCoreUtils_1.16.0 -## [77] colorspace_2.1-0 GenomeInfoDbData_1.2.12 -## [79] PSMatch_1.8.0 cli_3.6.2 -## [81] textshaping_0.3.7 fansi_1.0.6 -## [83] S4Arrays_1.4.0 dplyr_1.1.4 +## [67] tools_4.4.1 mzID_1.42.0 +## [69] QFeatures_1.14.2 vsn_3.72.0 +## [71] fs_1.6.4 XML_3.99-0.17 +## [73] grid_4.4.1 impute_1.78.0 +## [75] tidyr_1.3.1 MsCoreUtils_1.16.1 +## [77] colorspace_2.1-1 GenomeInfoDbData_1.2.12 +## [79] PSMatch_1.8.0 cli_3.6.3 +## [81] textshaping_0.4.0 fansi_1.0.6 +## [83] S4Arrays_1.4.1 dplyr_1.1.4 ## [85] AnnotationFilter_1.28.0 pcaMethods_1.96.0 ## [87] gtable_0.3.5 sass_0.4.9 -## [89] digest_0.6.35 SparseArray_1.4.3 -## [91] htmlwidgets_1.6.4 memoise_2.0.1 -## [93] htmltools_0.5.8.1 pkgdown_2.0.9.9000 -## [95] lifecycle_1.0.4 httr_1.4.7 -## [97] statmod_1.5.0 MASS_7.3-60.2

+## [89] digest_0.6.37 SparseArray_1.4.8 +## [91] htmlwidgets_1.6.4 htmltools_0.5.8.1 +## [93] pkgdown_2.1.0.9000 lifecycle_1.0.4 +## [95] httr_1.4.7 statmod_1.5.0 +## [97] MASS_7.3-61

References @@ -849,20 +860,32 @@

References - -

+ +
+
+ + +
+ + + + + + diff --git a/authors.html b/authors.html index e800000c..63cdd7d9 100644 --- a/authors.html +++ b/authors.html @@ -3,6 +3,8 @@ + +
+ + +
+ +
  • Laurent Gatto. Author, maintainer.

    @@ -136,9 +146,11 @@

    Authors and Citation

    Citation

    - Source: inst/CITATION + Source: inst/CITATION
    + +

    Laurent Gatto and Kathryn S. Lilley. MSnbase - an R/Bioconductor package for isobaric tagged mass spectrometry data visualization, processing and quantitation. Bioinformatics 28, 288-289 (2012).

    @Article{,
       title = {MSnbase - an R/Bioconductor package for isobaric tagged mass spectrometry data visualization, processing and quantitation},
    @@ -155,14 +167,27 @@ 

    Citation

    journal = {bioRxiv}, year = {2020}, }
    +
+
+ + +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/index.html b/index.html index 7e5a6517..5afcb26a 100644 --- a/index.html +++ b/index.html @@ -19,6 +19,8 @@ + +
+
@@ -129,7 +138,9 @@

ContributingContributor Code of Conduct. By participating in this project you agree to abide by its terms.

+
+
+ +
+

-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/news/index.html b/news/index.html index 1236c08b..c797e4ca 100644 --- a/news/index.html +++ b/news/index.html @@ -3,6 +3,8 @@ + +
+ + +
+
@@ -2249,16 +2258,28 @@

Changes in version 0.1.0

+ +
+ +
+ + + + + + diff --git a/pkgdown.yml b/pkgdown.yml index 8a28b3fb..2569f7b1 100644 --- a/pkgdown.yml +++ b/pkgdown.yml @@ -1,11 +1,10 @@ -pandoc: 3.1.13 -pkgdown: 2.0.9.9000 -pkgdown_sha: cf719ba763fdaaf9b285cb2871dad8c746e9e6b7 +pandoc: '3.3' +pkgdown: 2.1.0.9000 +pkgdown_sha: ee72108bc3a9827dcf313817525652dbd9d4284d articles: v01-MSnbase-demo: v01-MSnbase-demo.html v02-MSnbase-io: v02-MSnbase-io.html v03-MSnbase-centroiding: v03-MSnbase-centroiding.html v04-benchmarking: v04-benchmarking.html v05-MSnbase-development: v05-MSnbase-development.html -last_built: 2024-05-15T16:28Z - +last_built: 2024-09-11T07:29Z diff --git a/reference/Chromatogram-class.html b/reference/Chromatogram-class.html index de19a829..31b4e733 100644 --- a/reference/Chromatogram-class.html +++ b/reference/Chromatogram-class.html @@ -9,6 +9,8 @@ + +
+ + +
+

The Chromatogram class is designed to store chromatographic MS data, i.e. pairs of retention time and intensity @@ -76,6 +85,7 @@

Representation of chromatographic MS data

MSnExp objects extracting chromatograms should be used instead (i.e. the chromatogram() method).

+
Chromatogram(
   rtime = numeric(),
@@ -173,111 +183,175 @@ 

Representation of chromatographic MS data

# S4 method for class 'Chromatogram' transformIntensity(object, FUN = identity)
+

Arguments

-
rtime
+ + +
rtime

for Chromatogram: numeric with the retention times (length has to be equal to the length of intensity).

+ +
intensity

for Chromatogram: numeric with the intensity values (length has to be equal to the length of rtime). For filterIntensity: numeric(1) or function to use to filter intensities. See description for details.

+ +
mz

for Chromatogram: numeric(2) representing the mz value range (min, max) on which the chromatogram was created. This is supposed to contain the real range of mz values in contrast to filterMz. If not applicable use mzrange = c(0, 0).

+ +
filterMz

for Chromatogram: numeric(2) representing the mz value range (min, max) that was used to filter the original object on m/z dimension. If not applicable use filterMz = c(0, 0).

+ +
precursorMz

for Chromatogram: numeric(2) for SRM/MRM transitions. Represents the mz of the precursor ion. See details for more information.

+ +
productMz

for Chromatogram: numeric(2) for SRM/MRM transitions. Represents the mz of the product. See details for more information.

+ +
fromFile

for Chromatogram: integer(1) the index of the file within the OnDiskMSnExp or MSnExp from which the chromatogram was extracted.

+ +
aggregationFun

for Chromatogram: character string specifying the function that was used to aggregate intensity values for the same retention time across the mz range. Supported are "sum" (total ion chromatogram), "max" (base peak chromatogram), "min" and "mean".

+ +
msLevel

for Chromatogram: integer(1) with the MS level from which the chromatogram was extracted.

+ +
object

Chromatogram object.

+ +
filter

for mz: logical(1) defining whether the m/z range to filter the originating object (e.g. MSnExp object) should be returned or the m/z range of the actual data. Defaults to filter = FALSE.

+ +
x

Chromatogram object.

+ +
rt

for filterRt: numeric(2) defining the lower and upper retention time to which the Chromatogram should be subsetted.

+ +
all

for clean: logical(1) whether all 0 intensities should be removed. Defaults to all = FALSE. See clean() for details.

+ +
na.rm

for clean: if all NA intensities should be removed before cleaning the Chromatogram. Defaults to clean = FALSE.

+ +
col

for plot: the color to be used for plotting.

+ +
lty

for plot: the line type. See help page of plot in the graphics package for details.

+ +
type

for plot: the type of plot. See help page of plot in the graphics package for details.

+ +
xlab

for plot: the x-axis label.

+ +
ylab

for plot: the y-axis label.

+ +
main

for plot: the plot title. If not provided the mz range will be used as plot title.

+ +
...

for plot: additional arguments to be passed to the base plot function. For filterIntensity: additional parameters passed along to the function provided with intensity. For compareChromatograms: ignored

+ +
binSize

for bin: numeric(1) with the size of the bins (in seconds). Defaults to binSize = 0.5.

+ +
breaks

for bin: numeric defining the bins. Usually not required as the function calculates the bins automatically based on binSize.

+ +
fun

for bin: function to be used to aggregate the intensity values falling within each bin. Defaults to fun = max.

+ +
method

character(1). For normalise: defining whether each chromatogram should be normalized to its maximum signal (method = "max") or total signal (method = "sum"). For alignRt: aligning approach that should be used (see description). Defaults to method = "closest".

+ +
y

for alignRt: Chromatogram against which x should be aligned against.

+ +
ALIGNFUN

for compareChromatograms: function to align chromatogram x against chromatogram y. Defaults to alignRt.

+ +
ALIGNFUNARGS

list of parameters to be passed to ALIGNFUN.

+ +
FUN

for compareChromatograms: function to calculate a similarity score on the intensity values of the compared and aligned chromatograms. Defaults to FUN = cor. For transformIntensity: function to transform chromatograms' intensity values. Defaults to FUN = identity.

+ +
FUNARGS

for compareChromatograms: list with additional parameters for FUN. Defaults to FUNARGS = list(use = "pairwise.complete.obs").

+

Details

@@ -294,6 +368,9 @@

Details

Object creation

+ + +

Chromatogram objects can be extracted from an MSnExp or OnDiskMSnExp object with the chromatogram() function.

Alternatively, the constructor function Chromatogram can be used, which @@ -302,6 +379,8 @@

Object creation

Data access and coercion

+ +
  • aggregationFun: gets the aggregation function used to create the Chromatogram.

  • as.data.frame: returns a data.frame with columns "rtime" and @@ -325,6 +404,8 @@

    Data access and coercion

Data subsetting and filtering

+ +
  • filterRt: filter/subset the Chromatogram to the specified retention time range (defined with parameter rt).

  • filterIntensity: filter a Chromatogram() object removing data @@ -339,6 +420,8 @@

    Data subsetting and filtering

Data processing and manipulation

+ +
  • alignRt: Aligns chromatogram x against chromatogram y. The resulting chromatogram has the same length (number of data points) than y and the same retention times thus allowing to perform any pair-wise comparisons @@ -387,6 +470,8 @@

    Data processing and manipulation

Data visualization

+ +
  • plot: plots a Chromatogram object.

@@ -399,6 +484,7 @@

See also

Author

Johannes Rainer

+

Examples


@@ -558,12 +644,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/FeatComp-class.html b/reference/FeatComp-class.html index 81e682c9..53042da1 100644 --- a/reference/FeatComp-class.html +++ b/reference/FeatComp-class.html @@ -3,6 +3,8 @@ + +
+ + +
+

Comparing feature names of two comparable MSnSet instances.

+ +

Objects from the Class

+ +

Objects can be created with compfnames. The method compares the feature names of two objects of class "MSnSet". It prints a summary matrix of common and unique feature names and invisibly @@ -81,24 +95,37 @@

Slots

name of the compared features. By convention, "all" is used when all feature names are used; otherwise, the respective levels of the feature variables fcol1 and fcol2.

+ +
common:

Object of class "character" with the common feature names.

+ +
unique1:

Object of class "character" with the features unique to the first MSnSet (x in compfname).

+ +
unique2:

Object of class "character" with the features unique to the seconn MSnSet (y in compfname).

+ +
all:

Object of class "logical" defining if all features of only a subset were compared. One expects that name == "all" when all is TRUE.

+ + +

Methods

+ +

Accessors names, common, unique1 and unique2 can be used to access the respective FeatComp slots.

@@ -115,6 +142,8 @@

Methods

FeatComp object is returned instead of a list of length 1. The verbose logical controls if a summary table needs to be printed (default is TRUE).

+ +
compfnames

signature(x = "list", y = "missing", ...): when x is a list of MSnSet instances, @@ -122,9 +151,14 @@

Methods

x. Additional parameters fcol1, fcol2, simplify and verbose are passed to the pairwise comparison method.

+ +
show

signature(object = "FeatComp"): prints a summary of the object.

+ + +

Author

@@ -134,6 +168,7 @@

Author

See also

averageMSnSet to compuate an average MSnSet.

+

Examples

library("pRolocdata")
@@ -234,12 +269,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/FeaturesOfInterest-class.html b/reference/FeaturesOfInterest-class.html index 3459bd4b..4a83879f 100644 --- a/reference/FeaturesOfInterest-class.html +++ b/reference/FeaturesOfInterest-class.html @@ -1,5 +1,6 @@ Features of Interest — FeaturesOfInterest-class • MSnbase
+
MChromatograms(data, phenoData, featureData, ...)
+
+# S4 method for class 'MChromatograms'
+show(object)
+
+# S4 method for class 'MChromatograms,ANY,ANY,ANY'
+x[i, j, drop = FALSE]
+
+# S4 method for class 'MChromatograms'
+x[i, j] <- value
+
+# S4 method for class 'MChromatograms,ANY'
+plot(
+  x,
+  col = "#00000060",
+  lty = 1,
+  type = "l",
+  xlab = "retention time",
+  ylab = "intensity",
+  main = NULL,
+  ...
+)
+
+# S4 method for class 'MChromatograms'
+phenoData(object)
+
+# S4 method for class 'MChromatograms'
+pData(object)
+
+# S4 method for class 'MChromatograms,data.frame'
+pData(object) <- value
+
+# S4 method for class 'MChromatograms'
+x$name
+
+# S4 method for class 'MChromatograms'
+x$name <- value
+
+# S4 method for class 'MChromatograms'
+colnames(x) <- value
+
+# S4 method for class 'MChromatograms'
+sampleNames(object)
+
+# S4 method for class 'MChromatograms,ANY'
+sampleNames(object) <- value
+
+# S4 method for class 'MChromatograms'
+isEmpty(x)
+
+# S4 method for class 'MChromatograms'
+featureNames(object)
+
+# S4 method for class 'MChromatograms'
+featureNames(object) <- value
+
+# S4 method for class 'MChromatograms'
+featureData(object)
+
+# S4 method for class 'MChromatograms,ANY'
+featureData(object) <- value
+
+# S4 method for class 'MChromatograms'
+fData(object)
+
+# S4 method for class 'MChromatograms,ANY'
+fData(object) <- value
+
+# S4 method for class 'MChromatograms'
+fvarLabels(object)
+
+# S4 method for class 'MChromatograms'
+rownames(x) <- value
+
+# S4 method for class 'MChromatograms'
+precursorMz(object)
+
+# S4 method for class 'MChromatograms'
+productMz(object)
+
+# S4 method for class 'MChromatograms'
+mz(object)
+
+# S4 method for class 'MChromatograms'
+polarity(object)
+
+# S4 method for class 'MChromatograms'
+bin(x, binSize = 0.5, breaks = numeric(), fun = max)
+
+# S4 method for class 'MChromatograms'
+clean(object, all = FALSE, na.rm = FALSE)
+
+# S4 method for class 'MChromatograms'
+normalize(object, method = c("max", "sum"))
+
+# S4 method for class 'MChromatograms'
+filterIntensity(object, intensity = 0, ...)
+
+# S4 method for class 'MChromatograms,Chromatogram'
+alignRt(x, y, method = c("closest", "approx"), ...)
+
+# S4 method for class 'MChromatograms'
+c(x, ...)
+
+# S4 method for class 'MChromatograms,missing'
+compareChromatograms(
+  x,
+  y,
+  ALIGNFUN = alignRt,
+  ALIGNFUNARGS = list(),
+  FUN = cor,
+  FUNARGS = list(use = "pairwise.complete.obs"),
+  ...
+)
+
+# S4 method for class 'MChromatograms,MChromatograms'
+compareChromatograms(
+  x,
+  y,
+  ALIGNFUN = alignRt,
+  ALIGNFUNARGS = list(),
+  FUN = cor,
+  FUNARGS = list(use = "pairwise.complete.obs"),
+  ...
+)
+
+# S4 method for class 'MChromatograms'
+transformIntensity(object, FUN = identity)
+

Arguments

-
data
+ + +
data

for MChromatograms: a list of Chromatogram() objects.

+ +
phenoData

for MChromatograms: either a data.frame, AnnotatedDataFrame describing the phenotypical information of the samples.

+ +
featureData

for MChromatograms: either a data.frame or AnnotatedDataFrame with additional information for each row of chromatograms.

+ +
...

for MChromatograms: additional parameters to be passed to the matrix constructor, such as nrow, ncol and byrow. For compareChromatograms: ignored.

+ +
object

a MChromatograms object.

+ +
x

for all methods: a MChromatograms object.

+ +
i

for [: numeric, logical or character defining which row(s) to extract.

+ +
j

for [: numeric, logical or character defining which columns(s) to extract.

+ +
drop

for [: logical(1) whether to drop the dimensionality of the returned object (if possible). The default is drop = FALSE, i.e. each subsetting returns a MChromatograms object (or a Chromatogram object if a single element is extracted).

+ +
value

for [<-: the replacement object(s). Can be a list of [Chromatogram()objects or, if length ofiandjare 1, a singleChromatogram` object.

For `pData<-`: a `data.frame` with the number of rows matching
 the number of columns of `object`.
-For `colnames`: a `character` with the new column names.

+ +For `colnames`: a `character` with the new column names.

+ +
col

for plot: the color to be used for plotting. Either a vector of length 1 or equal to ncol(x).

+ +
lty

for plot: the line type (see plot in the graphics package for more details). Can be either a vector of length 1 or of length equal to ncol(x).

+ +
type

for plot: the type of plot (see plot from the graphics package for more details). Can be either a vector of length 1 or of length equal to ncol(x).

+ +
xlab

for plot: the x-axis label.

+ +
ylab

for plot: the y-axis label.

+ +
main

for plot: the plot title. If not provided the mz range will be used as plot title.

+ +
name

for $, the name of the pheno data column.

+ +
binSize

for bin: numeric(1) with the size of the bins (in seconds).

+ +
breaks

For bin: numeric defining the bins. Usually not required as the function calculates the bins automatically based on binSize and the retention time range of chromatograms in the same row.

+ +
fun

for bin: function to be used to aggregate the intensity values falling within each bin.

+ +
all

for clean: logical(1) whether all 0-intensities should be removed (all = TRUE), or whether 0-intensities adjacent to peaks should be kept (all = FALSE; default).

+ +
na.rm

for clean: logical(1) whether all NA intensities should be removed prior to clean 0-intensity data points.

+ +
method

character(1). For normalise: defining whether each chromatogram should be normalized to its maximum signal (method = "max") or total signal (method = "sum"). For alignRt: alignment methods (see documentation for alignRt in the Chromatogram() help page. Defaults to method = "closest".

+ +
intensity

for filterIntensity: numeric(1) or function to use to filter intensities. See description for details.

+ +
y

for alignRt: a Chromatogram() object against which x should be aligned against.

+ +
ALIGNFUN

for compareChromatograms: function to align chromatogram x against chromatogram y. Defaults to alignRt.

+ +
ALIGNFUNARGS

list of parameters to be passed to ALIGNFUN.

+ +
FUN

for transformIntensity: function to transform chromatograms' intensity values. Defaults to FUN = identity.

+ +
FUNARGS

for compareChromatograms: list with additional parameters for FUN. Defaults to FUNARGS = list(use = "pairwise.complete.obs").

+

Value

-

For [: the subset of the MChromatograms object. If a +

For [: the subset of the MChromatograms object. If a single element is extracted (e.g. if i and j are of length 1) a Chromatogram() object is returned. Otherwise (if -drop = FALSE, the default, is specified) a MChromatograms

-

object is returned. If drop = TRUE is specified, the method +drop = FALSE, the default, is specified) a MChromatograms +object is returned. If drop = TRUE is specified, the method returns a list of Chromatogram objects.

For `phenoData`: an `AnnotatedDataFrame` representing the
 pheno data of the object.
-For `pData`: a `data.frame` representing the pheno data of
-the object.
-For `$`: the value of the corresponding column in the pheno data
-table of the object.
-For all other methods see function description.

+ +For `pData`: a `data.frame` representing the pheno data of +the object. + +For `$`: the value of the corresponding column in the pheno data +table of the object. + +For all other methods see function description.

Details

@@ -290,12 +398,17 @@

Details

Object creation

+ + +

MChromatograms are returned by a chromatogram() function from an MSnExp or OnDiskMSnExp. Alternatively, the MChromatograms constructor function can be used.

Data access

+ +
  • $ and $<-: get or replace individual columns of the object's phenodata.

  • colnames and colnames<-: replace or set the column names of the MChromatograms object. Does also set the rownames of the phenoData.

  • @@ -332,6 +445,8 @@

    Data access

Data subsetting, combining and filtering

+ +
  • [ subset (similar to a matrix) by row and column (with parameters i and j).

  • [<- replace individual or multiple elements. value has to be either a @@ -351,6 +466,8 @@

    Data subsetting, combining and filtering

Data processing and manipulation

+ +
  • alignRt: align all chromatograms in an MChromatograms object against the chromatogram specified with y. See documentation on alignRt in the Chromatogram() help page.

  • @@ -377,6 +494,8 @@

    Data processing and manipulation

Data visualization

+ +
  • plot: plots a MChromatograms object. For each row in the object one plot is created, i.e. all Chromatogram() objects in the same row are added to the same plot. If nrow(x) > 1 the plot area is split into @@ -392,6 +511,7 @@

    See also

    Author

    Johannes Rainer

+

Examples

## Creating some chromatogram objects to put them into a MChromatograms object
@@ -517,12 +637,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/MIAPE-class.html b/reference/MIAPE-class.html index 9de61ba1..75989b1d 100644 --- a/reference/MIAPE-class.html +++ b/reference/MIAPE-class.html @@ -4,6 +4,8 @@ + +
+ + +
+

The Minimum Information About a Proteomics Experiment. The current implementation is based on the MIAPE-MS 2.4 document.

+ +

Slots

title:

Object of class character containing a single-sentence experiment title.

+
abstract:

Object of class character containing an abstract describing the experiment.

+
url:

Object of class character containing a URL for the experiment.

+
pubMedIds:

Object of class character listing strings of PubMed identifiers of papers relevant to the dataset.

+
samples:

Object of class list containing information about the samples.

+
preprocessing:

Object of class list containing information about the pre-processing steps used on the raw data from this experiment.

+
other:

Object of class list containing other information for which none of the above slots applies.

+
dateStamp:

Object of class character, giving the date on which the work described was initiated; given in the standard 'YYYY-MM-DD' format (with hyphens).

+
name:

Object of class character containing the name of the (stable) primary contact person for this data set; this could be the experimenter, lab head, line manager, ...

+
lab:

Object of class character containing the laboratory where the experiment was conducted.

+
contact:

Object of class character containing contact information for lab and/or experimenter.

+
email:

Object of class character containing tmail contact information for the primary contact person (see name above).

+
instrumentModel:

Object of class character indicating the model of the mass spectrometer used to generate the data.

+
instrumentManufacturer:

Object of class character indicating the manufacturing company of the mass spectrometer.

+
instrumentCustomisations:

Object of class character describing any significant (i.e. affecting behaviour) deviations from the manufacturer's specification for the mass spectrometer.

+
softwareName:

Object of class character with the instrument management and data analysis package(s) name(s).

+
softwareVersion:

Object of class character with the instrument management and data analysis package(s) version(s).

+
switchingCriteria:

Object of class character describing the list of conditions that cause the switch from survey or zoom mode (MS1) to or tandem mode (MSn where n > 1); e.g. 'parent ion” mass lists, neutral loss criteria and so on [applied for tandem MS only].

+
isolationWidth:

Object of class numeric describing, for tandem instruments, the total width (i.e. not half for plus-or-minus) of the gate applied around a selected precursor ion m/z, provided for all levels or by MS level.

+
parameterFile:

Object of class character giving the location and name under which the mass spectrometer's parameter settings file for the run is stored, if available. Ideally this should be a URI+filename, or most preferably an LSID, where feasible.

+
ionSource:

Object of class character describing the ion source (ESI, MALDI, ...).

+
ionSourceDetails:

Object of class character describing the relevant details about the ion source. See MIAPE-MI docuement for more details.

+
analyser:

Object of class character describing the analyzer type (Quadrupole, time-of-flight, ion trap, ...).

+
analyserDetails:

Object of class character describing the relevant details about the analyzer. See MIAPE-MI document for more details.

+
collisionGas:

Object of class character describing the composition of the gas used to fragment ions in the collision cell.

+
collisionPressure:

Object of class numeric providing the pressure (in bars) of the collision gas.

+
collisionEnergy:

Object of class character specifying for the process of imparting a particular impetus to @@ -174,76 +212,101 @@

Slots

collision energies are also provided for individual "Spectrum2" instances, and is the preferred way of accessing this data.

+
detectorType:

Object of class character describing the type of detector used in the machine (microchannel plate, channeltron, ...).

+
detectorSensitivity:

Object of class character giving and appropriate measure of the sensitivity of the described detector (e.g. applied voltage).

+ +

Methods

The following methods as in "MIAME":

abstract(MIAPE):

An accessor function for abstract.

+
expinfo(MIAPE):

An accessor function for name, lab, contact, title, and url.

+
notes(MIAPE), notes(MIAPE) <- value:

Accessor functions for other. notes(MIAME) <- character appends character to notes; use notes(MIAPE) <- list to replace the notes entirely.

+
otherInfo(MIAPE):

An accessor function for other.

+
preproc(MIAPE):

An accessor function for preprocessing.

+
pubMedIds(MIAPE), pubMedIds(MIAME) <- value:

Accessor function for pubMedIds.

+
expemail(MIAPE):

An accessor function for email slot.

+
exptitle(MIAPE):

An accessor function for title slot.

+
analyzer(MIAPE):

An accessor function for analyser slot. analyser(MIAPE) is also available.

+
analyzerDetails(MIAPE):

An accessor function for analyserDetails slot. analyserDetails is also available.

+
detectorType(MIAPE):

An accessor function for detectorType slot.

+
ionSource(MIAPE):

An accessor function for ionSource slot.

+
ionSourceDetails(MIAPE):

An accessor function for ionSourceDetails slot.

+
instrumentModel(MIAPE):

An accessor function for instrumentModel slot.

+
instrumentManufacturer(MIAPE):

An accessor function for instrumentManufacturer slot.

+
instrumentCustomisations(MIAPE):

An accessor function for instrumentCustomisations slot.

+
as(,"MIAME"):

Coerce the object from MIAPE to MIAME class. Used when converting an MSnSet into an ExpressionSet.

+ +

MIAPE-specific methods, including MIAPE-MS meta-data:

show(MIAPE):

Displays the experiment data.

+
msInfo(MIAPE):

Displays 'MIAPE-MS' information.

+ +

Extends

@@ -260,17 +323,28 @@

References

Author

Laurent Gatto <lg390@cam.ac.uk>

+
+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/MSmap-class.html b/reference/MSmap-class.html index 457d4e54..d07dfe4e 100644 --- a/reference/MSmap-class.html +++ b/reference/MSmap-class.html @@ -5,6 +5,8 @@ + +
+ + +
+

A class to store mass spectrometry data maps, i.e intensities collected along the M/Z and retention time space during a mass spectrometry acquisition.

+ +

Objects from the Class

Objects can be created with the MSmap constructor. The @@ -76,49 +88,70 @@

Objects from the Class

instance of class OnDiskMSnExp. If the latter contains data from multiple files, a warning will be issued and the first one will be used.

+ +
lowMz

A numeric of length 1 defining the lower bound of the M/Z range of the MS map.

+ +
highMz

A numeric of length 1 defining the upper bound of the M/Z range of the MS map.

+ +
resMz

The resolution along the M/Z range.

+ +
hd

An optional data.frame as produced by mzR::header(object). If missing, will be computer within the function. Ignored when object is an OnDiskMSnExp.

+ +
zeroIsNA

Set 0 intensities to NA. This can be used to clarify the 3 dimensional plot produce by plot3D.

+ +

Slots

call:

Object of class "call" - the call used to generate the instance.

+
map:

Object of class "matrix" containing the actual MS map.

+
mz:

Object of class "numeric" with the M/Z sampling bins.

+
res:

Object of class "numeric" storing the the M/Z resolution used to create the map.

+
rt:

Object of class "numeric" with the retention times of the map spectra.

+
ms:

Object of class "numeric" with the MS levels of the spectra.

+
t:

Object of class "logical" indicating if the instance has been transposed.

+
filename:

Object of class "character" specifying the filename of the original raw MS data.

+ +

Methods

@@ -126,54 +159,68 @@

Methods

signature(from = "MSmap", to = "data.frame"): convert the MSmap instance in a data.frame. Useful for plotting with lattice or ggplot2.

+
fileName

signature(object = "MSmap"): returns the raw data filename.

+
msLevel

signature(object = "MSmap"): returns the MS level of the map spectra.

+
msMap

signature(object = "MSmap"): returns the actual map matrix.

+
mz

signature(object = "MSmap", ...): returns the M/Z values of the map. Additional arguments are currently ignored.

+
rtime

signature(object = "MSmap", ...): returns retention time values of the map. Additional arguments are currently ignored.

+
mzRes

signature(object = "MSmap"): returns the resolution with which the sample along the M/Z range was done.

+
dim

signature(x = "MSmap"): returns the dimensions of the map. ncol and nrow return the number of columns and rows respectively.

+
t

signature(x = "MSmap"): transposes the map.

+
show

signature(object = "MSmap"): prints a summary of the map.

+
plot

signature(x = "MSmap", allTicks = "logical"): produces an image of the map using lattice::levelplot. By default, allTicks is TRUE and all M/Z and retention times ticks of drawn. If set to FALSE, only 10 ticks in each dimension are plotted.

+
plot3D

signature(object = "MSmap", rgl = "logical"): produces an three dimensional view of the map using lattice::cloude(..., type = "h"). If rgl is TRUE, the map is visualised on a rgl device and can be rotated with the mouse.

+ +

Author

Laurent Gatto <lg390@cam.ac.uk>

+

Examples


-if (FALSE) {
+if (FALSE) { # \dontrun{
     ## downloads the data
     library("rpx")
     px1 <- PXDataset("PXD000001")
@@ -223,7 +270,7 @@ 

Examples

j <- ms1[which(rtsel)][2] M4 <- MSmap(msn, i:j, 100, 1000, 1) plot3D(M4) -} +} # }
@@ -231,12 +278,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/MSnExp-class.html b/reference/MSnExp-class.html index 159d7dfb..4fb942e4 100644 --- a/reference/MSnExp-class.html +++ b/reference/MSnExp-class.html @@ -16,6 +16,8 @@ + +
+ + +
+

The MSnExp class encapsulates data and meta-data for mass spectrometry experiments, as described in the slots @@ -89,6 +99,8 @@

The 'MSnExp' Class for MS Data And Meta-Data

file. See also the documentation in the mzR package that parses the raw data files and produces these data.

+ +

Objects from the Class

Objects can be created by calls of the form @@ -103,6 +115,7 @@

Slots

containing the MS spectra (see "Spectrum1" and "Spectrum2"). Slot is inherited from "pSet".

+
phenoData:

Object of class "AnnotatedDataFrame" containing @@ -110,6 +123,7 @@

Slots

individual tags for an labelled MS experiment) See phenoData for more details. Slot is inherited from "pSet".

+
featureData:

Object of class "AnnotatedDataFrame" containing variables @@ -118,11 +132,13 @@

Slots

"eSet"). See featureData for more details. Slot is inherited from "pSet".

+
experimentData:

Object of class "MIAPE", containing details of experimental methods. See experimentData for more details. Slot is inherited from "pSet".

+
protocolData:

Object of class "AnnotatedDataFrame" containing @@ -130,10 +146,12 @@

Slots

"eSet"). See protocolData for more details. Slot is inherited from "pSet".

+
processingData:

Object of class "MSnProcess" that records all processing. Slot is inherited from "pSet".

+
.__classVersion__:

Object of class "Versions" describing the versions of R, @@ -142,6 +160,8 @@

Slots

Slot is inherited from "pSet". Intended for developer use and debugging (inherited from "eSet").

+ +

Extends

@@ -157,21 +177,25 @@

Methods

bin

signature(object = "MSnExp"): Bins spectra. See bin documentation for more details and examples.

+
clean

signature(object = "MSnExp"): Removes unused 0 intensity data points. See clean documentation for more details and examples.

+
compareSpectra

signature(x = "Spectrum", y = "missing"): Compares spectra. See compareSpectra documentation for more details and examples.

+
extractPrecSpectra

signature(object = "MSnExp", prec = "numeric"): extracts spectra with precursor MZ value equal to prec and returns an object of class 'MSnExp'. See extractPrecSpectra documentation for more details and examples.

+ % \item{extractSpectra}{\code{signature(object = "MSnExp", selected = % "logical")}: extracts spectra corresponding to 'TRUE' in % \code{selected}. @@ -183,80 +207,104 @@

Methods

allows to restrict peak picking to spectra of certain MS level(s). See pickPeaks documentation for more details and examples.

+
estimateNoise

signature(object = "MSnExp"): Estimates the noise in all profile spectra of object. See estimateNoise documentation for more details and examples.

+
plot

signature(x = "MSnExp", y = "missing"): Plots the MSnExp instance. See plot.MSnExp documentation for more details.

+
plot2d

signature(object = "MSnExp", ...): Plots retention time against precursor MZ for MSnExp instances. See plot2d documentation for more details.

+
plotDensity

signature(object = "MSnExp", ...): Plots the density of parameters of interest. instances. See plotDensity documentation for more details.

+
plotMzDelta

signature(object = "MSnExp", ...): Plots a histogram of the m/z difference betwee all of the highest peaks of all MS2 spectra of an experiment. See plotMzDelta documentation for more details.

+
quantify

signature(object = "MSnExp"): Performs quantification for all the MS2 spectra of the MSnExp instance. See quantify documentation for more details. Also for OnDiskMSnExp objects.

+
removePeaks

signature(object = "MSnExp"): Removes peaks lower that a threshold t. See removePeaks documentation for more details and examples.

+
removeReporters

signature(object = "MSnExp", ...): Removes reporter ion peaks from all MS2 spectra of an experiment. See removeReporters documentation for more details and examples.

+
smooth

signature(x = "MSnExp"): Smooths spectra. See smooth documentation for more details and examples.

+
addIdentificationData

signature(object = "MSnExp", ...): Adds identification data to an experiment. See addIdentificationData documentation for more details and examples.

+ +
removeNoId

signature(object = "MSnExp", fcol = "pepseq", keep = NULL): Removes non-identified features. See removeNoId documentation for more details and examples.

+ +
removeMultipleAssignment

signature(object = "MSnExp", fcol = "nprot"): Removes protein groups (or feature belong to protein groups) with more than one member. The latter is defined by extracting a feature variable (default is "nprot"). Also removes non-identified features.

+ +
idSummary

signature(object = "MSnExp", ...): Prints a summary that lists the percentage of identified features per file (called coverage).

+ +
show

signature(object = "MSnExp"): Displays object content as text.

+ +
isolationWindow

signature(object = "MSnExp", ...): Returns the isolation window offsets for the MS2 spectra. See isolationWindow in the mzR package for details.

+ +
trimMz

signature(object = "MSnExp"): Trims the MZ range of all the spectra of the MSnExp instance. See trimMz documentation for more details and examples.

+ +
isCentroided(object, k = 0.025, qtl = 0.9, verbose = TRUE)

A heuristic assessing if the spectra in the @@ -275,74 +323,108 @@

Methods

advised to assign the majority result for MS1 and MS2 spectra, rather than results for individual spectra. See an example below.

+ +
as

signature(object = "MSnExp", "data.frame"): Coerces the MSnExp object to a four-column data.frame with columns "file" (file index in object), "rt" (retention time), "mz" (m/z values) and "i" (intensity values).

+ +
as

signature(object = "MSnExp", "MSpectra"): Coerces the MSnExp object to a MSpectra object with all feature annotations added as metadata columns (mcols).

+ + Clarifications regarding scan/acquisition numbers and indices: + A spectrumId (or spectrumID) is a vendor specific field in the mzML file that contains some information about the run/spectrum, e.g.: controllerType=0 controllerNumber=1 scan=5281 file=2. + acquisitionNum is a more a less sanitize spectrum id generated from the spectrumId field by mzR (see https://github.com/sneumann/mzR/blob/master/src/pwiz/data/msdata/MSData.cpp#L552-L580). + scanIndex is the mzR generated sequence number of the spectrum in the raw file (which doesn't have to be the same as the acquisitionNum). + See also this issue: https://github.com/lgatto/MSnbase/issues/525. + +

Filtering and subsetting functions:

filterRt

signature(object = "MSnExp", rt = "numeric", msLevel. = "numeric"): Retains MS spectra of level msLevel. with a retention times within rt[1] and rt[2].

+ +
filterMsLevel

signature(object = "MSnExp", msLevel. = "numeric"): Retains MS spectra of level msLevel..

+ +
filterPolarity

signature(object = "MSnExp", polarity. = "numeric"): Retains MS spectra of polarity polarity..

+ +
filterMz

signature(object = "MSnExp", mz = "numeric", msLevel. = "numeric"). See filterMz for details.

+ +
filterFile

signature(object = "MSnExp", file): Retains MS data of files matching the file index or file name provided with parameter file.

+ +
filterAcquisitionNum
+ +
filterEmptySpectra

signature(object = "MSnExp"): Remove empty spectra from object (see isEmpty).

+ +
filterPrecursorScan

signature(object = "MSnExp", acquisitionNum = "numeric"): Retain parent (e.g. MS1) and children scans (e.g. MS2) of acquisitionNum. See OnDiskMSnExp for an example.

+ +
splitByFile

signature(object = "MSnExp", f = "factor"): split a MSnExp object by file into a list of MSnExp objects given the grouping in factor f.

+ +
filterPrecursorMz

signature(object = "MSnExp", mz, ppm = 10): retain spectra with a precursor m/z equal or similar to the one defined with parameter mz. Parameter ppm allows to define an accepted difference between the provided m/z and the spectrum's m/z.

+ +
filterIsolationWindow

signature(object = "MSnExp", mz): retain spectra with isolation windows that contain (which m/z range contain) the specified m/z.

+ +

References

@@ -366,6 +448,7 @@

See also

write for the function to write the data to mzML or mzXML file(s).

+

Examples

mzxmlfile <- dir(system.file("extdata",package="MSnbase"),
@@ -379,7 +462,7 @@ 

Examples

#> Number of spectra: 5 #> MSn retention times: 25:01 - 25:02 minutes #> - - - Processing information - - - -#> Data loaded: Wed May 15 16:29:12 2024 +#> Data loaded: Wed Sep 11 07:29:25 2024 #> MSnbase version: 2.31.1 #> - - - Meta data - - - #> phenoData @@ -401,12 +484,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/MSnProcess-class.html b/reference/MSnProcess-class.html index 444e7bd7..7f21744f 100644 --- a/reference/MSnProcess-class.html +++ b/reference/MSnProcess-class.html @@ -6,6 +6,8 @@ + +
+ + +
+

MSnProcess is a container for MSnExp and MSnSet processing information. It records data files, processing steps, thresholds, analysis methods and times that have been applied to MSnExp or MSnSet instances.

+ +

Slots

files:

Object of class "character" storing the raw data files used in experiment described by the "MSnProcess" instance.

+
processing:

Object of class "character" storing all the processing steps and times.

+
merged:

Object of class "logical" indicating whether spectra have been merged.

+
cleaned:

Object of class "logical" indicating whether spectra have been cleaned. See clean for more details and examples.

+
removedPeaks:

Object of class "character" describing whether peaks have been removed and which threshold was used. See removePeaks for more details and examples.

+
smoothed:

Object of class "logical" indicating whether spectra have been smoothed.

+
trimmed:

Object of class "numeric" documenting if/how the data has been trimmed.

+
normalised:

Object of class "logical" describing whether and how data have been normalised.

+
MSnbaseVersion:

Object of class "character" indicating the version of MSnbase.

+
.__classVersion__:

Object of class "Versions" indicating the version of the MSnProcess instance. Intended for developer use and debugging.

+ + +

Extends

@@ -116,12 +140,16 @@

Methods

signature(object = "MSnProcess"): Returns the file names used in experiment described by the "MSnProcess" instance.

+
show

signature(object = "MSnProcess"): Displays object content as text.

+
combine

signature(x = "MSnProcess", y = "MSnProcess"): Combines multiple MSnProcess instances.

+ +

Author

@@ -136,6 +164,7 @@

See also

See the "MSnExp" and "MSnSet" classes that actually use MSnProcess as a slot.

+

Examples

showClass("MSnProcess")
@@ -160,12 +189,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/MSnSet-class.html b/reference/MSnSet-class.html index 129d816d..e7bf0236 100644 --- a/reference/MSnSet-class.html +++ b/reference/MSnSet-class.html @@ -8,6 +8,8 @@ + +
+ + +
+

The MSnSet holds quantified expression data for MS proteomics data and the experimental meta-data. @@ -73,8 +83,12 @@

The "MSnSet" Class for MS Proteomics Expression Data and Meta-Data

"ExpressionSet" class classically used for microarray data.

+ +

Objects from the Class

+ +

The constructor MSnSet(exprs, fData, pData) can be used to create MSnSet instances. Argument exprs is a matrix and fData and pData must be of class @@ -105,13 +119,19 @@

Objects from the Class

Slots

+ +

qual:

Object of class "data.frame" that records peaks data for each of the reporter ions to be used as quality metrics.

+ +
processingData:

Object of class "MSnProcess" that records all processing.

+ +
assayData:

Object of class "assayData" containing a matrix with equal with column number equal to @@ -121,6 +141,8 @@

Slots

class, exprs and assayData accessor for more details. This slot in indirectly inherited from "eSet".

+ +
phenoData:

Object of class "AnnotatedDataFrame" containing experimenter-supplied variables describing sample (i.e @@ -131,6 +153,8 @@

Slots

with pData and be replaced by a new valid (i.e. of compatible dimensions and row names) data.frame with pData()<-.

+ +
featureData:

Object of class "AnnotatedDataFrame" containing variables describing @@ -141,14 +165,20 @@

Slots

can be accessed as a data.frame with fData and be replaced by a new valid (i.e. of compatible dimensions and row names) data.frame with fData()<-.

+ +
experimentData:

Object of class "MIAPE", containing details of experimental methods (inherited from "eSet"). See experimentData and the "eSet" class for more details.

+ +
annotation:

not used here.

+ +
protocolData:

Object of class "AnnotatedDataFrame" containing @@ -156,6 +186,8 @@

Slots

"eSet"). See protocolData and the "eSet" class for more details.

+ +
.__classVersion__:

Object of class "Versions" describing the versions of R, @@ -163,6 +195,8 @@

Slots

"pSet" and MSnSet of the current instance. Intended for developer use and debugging (inherited indirectly from "eSet").

+ +

Extends

@@ -180,6 +214,8 @@

Methods

a numeric vector with acquisition number of each spectrum. The vector names are the corresponding spectrum names. The information is extracted from the object's featureData slot.

+ +
fromFile

fromFile(signature(object = "MSnSet")): get the index of the file (in fileNames(object)) from which the raw @@ -188,39 +224,59 @@

Methods

featureData slot.

Returns a numeric vector with names corresponding to the spectrum names.

+ +
dim

signature(x = "MSnSet"): Returns the dimensions of object's assay data, i.e the number of samples and the number of features.

+ +
fileNames

signature(object = "MSnSet"): Access file names in the processingData slot.

+ +
msInfo

signature(object = "MSnSet"): Prints the MIAPE-MS meta-data stored in the experimentData slot.

+ +
processingData

signature(object = "MSnSet"): Access the processingData slot.

+ +
show

signature(object = "MSnSet"): Displays object content as text.

+ +
qual

signature(object = "MSnSet"): Access the reporter ion peaks description.

+ +
purityCorrect

signature(object = "MSnSet", impurities = "matrix"): performs reporter ions purity correction. See purityCorrect documentation for more details.

+ +
normalise

signature(object = "MSnSet"): Performs MSnSet normalisation. See normalise for more details.

+ +
t

signature(x = "MSnSet"): Returns a transposed MSnSet object where features are now aligned along columns and samples along rows and the phenoData and featureData slots have been swapped. The protocolData slot is always dropped.

+ +
as(,"ExpressionSet")

signature(x = "MSnSet"): Coerce object from MSnSet to @@ -228,20 +284,28 @@

Methods

is converted to a MIAME instance. It is also possible to coerce an ExpressionSet to and MSnSet, in which case the experimentData slot is newly initialised.

+ +
as(,"IBSpectra")

signature(x = "MSnSet"): Coerce object from MSnSet to IBSpectra from the isobar package.

+ +
as(,"data.frame")

signature(x = "MSnSet"): Coerce object from MSnSet to data.frame. The MSnSet is transposed and the PhenoData slot is appended.

+ +
as(,"SummarizedExperiment")

signature(x = "MSnSet"): Coerce object from MSnSet to SummarizedExperiment. Only part of the metadata is retained. See addMSnSetMetadata and the example below for details.

+ +
write.exprs

signature(x = "MSnSet"): Writes expression values to a tab-separated file (default is tmp.txt). The @@ -249,11 +313,15 @@

Methods

featureData columns (as column names, column number or logical) to append on the right of the expression matrix. The following arguments are the same as write.table.

+ +
combine

signature(x = "MSnSet", y = "MSnSet", ...): Combines 2 or more MSnSet instances according to their feature names. Note that the qual slot and the processing information are silently dropped.

+ +
topN

signature(object = "MSnSet", groupBy, n = 3, fun, ..., verbose = isMSnbaseVerbose()): @@ -271,6 +339,8 @@

Methods

actual number of retained peptides out of n.

A complete use case using topN and nQuants is detailed in the synapter package vignette.

+ +
filterNA

signature(object = "MSnSet", pNA = "numeric", pattern = "character", droplevels = "logical"): This method @@ -287,34 +357,49 @@

Methods

See the droplevels method below.

See also the is.na.MSnSet and plotNA methods for missing data exploration.

+ +
filterZero

signature(object = "MSnSet", pNA = "numeric", pattern = "character", droplevels = "logical"): As filterNA, but for zeros.

+ +
filterMsLevel

signature(object = "MSnSet", msLevel. = "numeric", fcol = "character") Keeps only spectra with level msLevel., as defined by the fcol feature variable (default is "msLevel").

+ +
log

signature(object = "MSnSet", base = "numeric") Log transforms exprs(object) using base::log. base (defaults is e='exp(1)') must be a positive or complex number, the base with respect to which logarithms are computed.

+ +
droplevels

signature(x = "MSnSet", ...)Drops the unused factor levels in the featureData slot. See droplevels for details.

+ +
impute

signature(object = "MSnSet", ...) Performs data imputation on the MSnSet object. See impute for more details.

+ +
trimws

signature(object = "MSnSet", ...)Trim leading and/or trailing white spaces in the feature data slot. Also available for data.frame objects. See ?base::trimws for details.

+ + +

Additional accessors for the experimental metadata (experimentData slot) are defined. See "MIAPE" for details.

@@ -325,6 +410,8 @@

Plotting

signature(object = "MSnSet") Plots row standard deviations versus row means. See meanSdPlot (vsn package) for more details.

+ +
image

signature(x = "MSnSet", facetBy = "character", sOrderBy = "character", legend = "character", low = "character", @@ -349,6 +436,8 @@

Plotting

The code is based on Vlad Petyuk's vp.misc::image_msnset. The previous version of this method is still available through the image2 function.

+ +
plotNA

signature(object = "MSnSet", pNA = "numeric") @@ -359,6 +448,8 @@

Plotting

percentage of NA values in the full data set and the number of proteins retained. Default is 1/2. See also plotNA.

+ +
MAplot

signature(object = "MSnSet", log.it = "logical", base = "numeric", ...) @@ -371,26 +462,37 @@

Plotting

should be log-transformed (default is TRUE) using base. Further ... arguments will be passed to the respective functions.

+ +
addIdentificationData

signature(object = "MSnSet", ...): Adds identification data to a MSnSet instance. See addIdentificationData documentation for more details and examples.

+ +
removeNoId

signature(object = "MSnSet", fcol = "pepseq", keep = NULL): Removes non-identified features. See removeNoId documentation for more details and examples.

+ +
removeMultipleAssignment

signature(object = "MSnSet", fcol = "nprot"): Removes protein groups (or feature belong to protein groups) with more than one member. The latter is defined by extracting a feature variable (default is "nprot"). Also removes non-identified features.

+ +
idSummary

signature(object = "MSnSet", ...): Prints a summary that lists the percentage of identified features per file (called coverage).

+ + +

Functions

@@ -399,21 +501,29 @@

Functions

function updates object's featureData variable labels by appending label. By default, label is the variable name and the separator sep is ..

+ +
updateSampleNames

signature(object, label, sep) This function updates object's sample names by appending label. By default, label is the variable name and the separator sep is ..

+ +
updateFeatureNames

signature(object, label, sep) This function updates object's feature names by appending label. By default, label is the variable name and the separator sep is ..

+ +
ms2df

signature(x, fcols) Coerces the MSnSet instance to a data.frame. The direction of the data is retained and the feature variable labels that match fcol are appended to the expression values. See also as(x, "data.frame") above.

+ +
addMSnSetMetadata

signature(x, y) When coercing an MSnSet y to a SummarizedExperiment x @@ -424,6 +534,9 @@

Functions

the complete processingData, experimentData and protocolData slots. The downside of this is that MSnbase is now required to use the SummarizedExperiment object.

+ + +

Author

@@ -432,6 +545,7 @@

Author

See also

+

"eSet", "ExpressionSet" and quantify. MSnSet quantitation values and annotation can be exported to a file with @@ -439,6 +553,7 @@

See also

create and MSnSet using data available in a spreadsheet or data.frame.

+

Examples

data(msnset)
@@ -563,7 +678,7 @@ 

Examples

#> - - - Processing information - - - #> Data loaded: Wed May 11 18:54:39 2011 #> iTRAQ4 quantification by trapezoidation: Wed Apr 1 21:41:53 2015 -#> Subset [55,4][6,4] Wed May 15 16:29:13 2024 +#> Subset [55,4][6,4] Wed Sep 11 07:29:26 2024 #> MSnbase version: 1.1.22 as(msnset, "ExpressionSet") @@ -589,12 +704,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/MSnSetList-class.html b/reference/MSnSetList-class.html index 4b6409ab..6eccf284 100644 --- a/reference/MSnSetList-class.html +++ b/reference/MSnSetList-class.html @@ -4,6 +4,8 @@ + +
+ + +
+

A class for storing lists of MSnSet instances.

+ +

Details

+ +

There are two ways to store different sets of measurements pertaining an experimental unit, such as replicated measures of different conditions that were recorded over more than one MS @@ -93,12 +107,16 @@

Details

Objects from the Class

+ +

Objects can be created and manipluated with:

MSnSetList(x, log, featureDAta)

The class constructor that takes a list of valid MSnSet instances as input x, an optional logging list, and an optional feature metadata data.frame.

+ +
split(x, f)

An MSnSetList can be created from an MSnSet instance. x is a single @@ -114,14 +132,21 @@

Objects from the Class

determine if x will be split along the features (rows) or sample (columns). Hence, the length of f must match exactly to either dimension.

+ +
unsplit(value, f)

The unsplit method reverses the effect of splitting the value MSnSet along the groups f.

+ +
as(x, "MSnSetList")

Where x is an instance of class MzTab. See the class documentation for details.

+ + +

Slots

@@ -129,53 +154,77 @@

Slots

Object of class list containing valid MSnSet instances. Can be extracted with the msnsets() accessor.

+ +
log:

Object of class list containing an object creation log, containing among other elements the call that generated the object. Can be accessed with objlog().

+ +
featureData:

Object of class DataFrame that stores metadata for each object in the x slot. The number of rows of this data.frame must be equal to the number of items in the x slot and their respective (row)names must be identical.

+ +
.__classVersion__:

The version of the instance. For development purposes only.

+ +

Methods

"[["

Extracts a single MSnSet at position.

+ +
"["

Extracts one of more MSnSets as MSnSetList.

+ +
length

Returns the number of MSnSets.

+ +
names

Returns the names of MSnSets, if available. The replacement method is also available.

+
show

Display the object by printing a short summary.

+ +
lapply(x, FUN, ...)

Apply function FUN to each element of the input x. If the application of FUN returns and MSnSet, then the return value is an MSnSetList, otherwise a list

. +
sapply(x, FUN, ..., simplify = TRUE, USE.NAMES = TRUE)

A lapply wrapper that simplifies the ouptut to a vector, matric or array is possible. See ?base::sapply for details.

. +
fData

Returns the features metadata featureData slot.

+ +
fData<-

Features metadata featureData replacement method.

+ + +

See also

@@ -186,6 +235,7 @@

See also

Author

Laurent Gatto <lg390@cam.ac.uk>

+

Examples

library("pRolocdata")
@@ -349,12 +399,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/MSnbaseOptions.html b/reference/MSnbaseOptions.html index 4fa70115..665ff8f8 100644 --- a/reference/MSnbaseOptions.html +++ b/reference/MSnbaseOptions.html @@ -11,10 +11,13 @@ methods of OnDiskMSnExp that load data from the original files (such as spectrapply()). Users experiencing data I/O errors (observed mostly on macOS systems) should set this option to FALSE. + "> + +
+ + +
+

MSnbase defined a few options globally using the standard R options mechanism. The current values of these options can be @@ -86,6 +96,7 @@

MSnbase options

spectrapply()). Users experiencing data I/O errors (observed mostly on macOS systems) should set this option to FALSE.

+
MSnbaseOptions()
 
@@ -99,14 +110,18 @@ 

MSnbase options

isMSnbaseFastLoad()
+

Arguments

-
opt
+ + +
opt

The value of the new option

+

Value

-

A list of MSnbase options and the single option +

A list of MSnbase options and the single option values for the individual accessors.

@@ -117,17 +132,28 @@

Details

without argument, the verbosity setter inverts the current value of the option.

+
+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/MSpectra.html b/reference/MSpectra.html index 0c68d37e..bf49c9c9 100644 --- a/reference/MSpectra.html +++ b/reference/MSpectra.html @@ -13,6 +13,8 @@ + +
+ + +
+

MSpectra (Mass Spectra) objects allow to collect one or more Spectrum object(s) (Spectrum1 or Spectrum2) in @@ -84,6 +93,7 @@

List of Spectrum objects along with annotations

metadata columns present in mcols are exported as additional fields with the capitalized column names used as field names (see examples below).

+
MSpectra(..., elementMetadata = NULL)
 
@@ -181,55 +191,87 @@ 

List of Spectrum objects along with annotations

# S4 method for class 'MSpectra' filterMsLevel(object, msLevel.)
+

Arguments

-
...
+ + +
...

For MSpectra: Spectrum object(s) or a list of Spectrum objects. For all other methods optional arguments passed along.

+ +
elementMetadata

For MSpectra: DataFrame with optional information that should be added as metadata information (mcols) to the object. The number of rows has to match the number of Spectrum objects, each row is expected to represent additional metadata information for one spectrum.

+ +
object

For all functions: a MSpectra object.

+ +
x

For all functions: a MSpectra object.

+ +
con

For writeMgfData: character(1) defining the file name of the MGF file.

+ +
COM

For writeMgfData: optional character(1) providing a comment to be added to the file.

+ +
TITLE

For writeMgfData: optional character(1) defining the title for the MGF file.

+ +
all

For clean: if FALSE original 0-intensity values are retained around peaks.

+ +
msLevel.

For clean, removePeaks, filterMz, pickPeaks: optionally specify the MS level(s) of the spectra on which the operation should be performed. For filterMsLevels: MS level(s) to which the MSpectra should be reduced.

+ +
t

For removePeaks: numeric(1) specifying the threshold below which intensities are set to 0.

+ +
mz

For filterMz: numeric(2) defining the lower and upper m/z for the filter. See filterMz() for details.

+ +
halfWindowSize

For pickPeaks and smooth: see pickPeaks() and smooth() for details.

+ +
method

For pickPeaks and smooth: see pickPeaks() and smooth() for details.

+ +
SNR

For pickPeaks: see pickPeaks() for details.

+ +
refineMz

For pickPeaks: see pickPeaks() for details.

+

Details

@@ -239,12 +281,18 @@

Details

Constructor

+ + +

New MSpectra can be created with the MSpectra(...) function where ... can either be a single Spectrum object or a list of Spectrum objects (Spectrum1 and/or Spectrum2).

Accessing spectrum attributes

+ + +

These methods allow to access the attributes and values of the individual Spectrum (Spectrum1 or Spectrum2) objects within the list.

  • mz return the m/z values of each spectrum as a list of numeric vectors.

  • @@ -281,6 +329,8 @@

    Accessing spectrum attributes

Data manipulation methods

+ +
  • clean cleans each spectrum. See clean() for more details.

  • pickPeaks performs peak picking to generate centroided spectra. See pickPeaks() for more details.

  • @@ -290,6 +340,8 @@

    Data manipulation methods

Filtering and subsetting

+ +
  • [ can be used to subset the MSpectra object.

  • filterMsLevel filters MSpectra to retain only spectra from certain MS level(s).

  • @@ -300,6 +352,7 @@

    Filtering and subsetting

    Author

    Johannes Rainer

+

Examples


@@ -460,7 +513,7 @@ 

Examples

## Evaluate the written output. The ID of each spectrum (defined in the ## "id" metadata column) is exported as field "ID". readLines(tmpf) -#> [1] "COM=Experimentexported by MSnbase on Wed May 15 16:29:21 2024" +#> [1] "COM=Experimentexported by MSnbase on Wed Sep 11 07:29:33 2024" #> [2] "BEGIN IONS" #> [3] "SCANS=NA" #> [4] "TITLE=msLevel 1; retentionTime ; scanNum NA" @@ -490,7 +543,7 @@

Examples

writeMgfData(spl, tmpf) readLines(tmpf) -#> [1] "COM=Experimentexported by MSnbase on Wed May 15 16:29:21 2024" +#> [1] "COM=Experimentexported by MSnbase on Wed Sep 11 07:29:33 2024" #> [2] "BEGIN IONS" #> [3] "SCANS=NA" #> [4] "TITLE=msLevel 1; retentionTime ; scanNum NA" @@ -524,12 +577,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/MzTab-class.html b/reference/MzTab-class.html index d5ab1fa6..3b44e19f 100644 --- a/reference/MzTab-class.html +++ b/reference/MzTab-class.html @@ -1,5 +1,6 @@ Parse MzTab files — MzTab-class • MSnbasefeatureData slot.

Returns a numeric vector with names corresponding to the spectrum names.

+ +
intensity

intensity(signature(object="OnDiskMSnExp")): return the intensities from each spectrum in the data @@ -243,6 +279,8 @@

Getter/setter methods

original file).

The method returns a list of numeric intensity values. Each list element represents the intensities from one spectrum.

+ +
ionCount

ionCount(signature(object="OnDiskMSnExp", BPPARAM=bpparam())): @@ -255,27 +293,37 @@

Getter/setter methods

original file).

Returns a numeric vector with names corresponding to the spectrum names.

+ +
isolationWindowLowerMz

isolationWindowLowerMz(object = "OnDiskMSnExp"): return the lower m/z boundary for the isolation window.

Returns a numeric vector of length equal to the number of spectra with the lower m/z value of the isolation window or NA if not specified in the original file.

+ +
isolationWindowUpperMz

isolationWindowUpperMz(object = "OnDiskMSnExp"): return the upper m/z boundary for the isolation window.

Returns a numeric vector of length equal to the number of spectra with the upper m/z value of the isolation window or NA if not specified in the original file.

+ +
length

length(signature(object="OnDiskMSnExp")): Returns the number of spectra of the current experiment.

+ +
msLevel

msLevel(signature(object = "OnDiskMSnExp")): extract the MS level from the spectra. The relevant information is extracted from the object's featureData slot.

Returns a numeric vector with names corresponding to the spectrum names.

+ +
mz

mz(signature(object="OnDiskMSnExp")): return the M/Z values from each spectrum in the data @@ -289,6 +337,8 @@

Getter/setter methods

original file).

The method returns a list of numeric M/Z values. Each list element represents the values from one spectrum.

+ +
peaksCount

peaksCount(signature(object="OnDiskMSnExp", scans="numeric"), BPPARAM=bpparam()): @@ -304,23 +354,31 @@

Getter/setter methods

original file).

Returns a numeric vector with names corresponding to the spectrum names.

+ +
polarity

polarity(signature(object="OnDiskMSnExp")): returns a numeric vector with the polarity of the individual spectra in the data set. The relevant information is extracted from the featureData.

+ +
rtime

rtime(signature(object="OnDiskMSnExp")): extrac the retention time of the individual spectra in the data set (from the featureData).

Returns a numeric vector with names corresponding to the spectrum names.

+ +
scanIndex

scanIndex(signature(object="OnDiskMSnExp")): get the spectra scan indices within the respective file. The relevant information is extracted from the object's featureData slot. Returns a numeric vector of indices with names corresponding to the spectrum names.

+ +
smoothed,smoothed<-

smoothed(signature(object="OnDiskMSnExp", msLevel. = "numeric")): whether individual spectra are smoothed or @@ -330,6 +388,8 @@

Getter/setter methods

smoothed(object) <- value to update the information, with value being a logical vector of length equal to the number of spectra in the experiment.

+ +
spectra

spectra(signature(object="OnDiskMSnExp"), BPPARAM=bpparam()): extract spectrum data from the individual files. This causes the @@ -345,6 +405,8 @@

Getter/setter methods

extraction.

Returns a list of Spectrum1 objects with names corresponding to the spectrum names.

+ +
tic

tic(signature(object="OnDiskMSnExp"), initial = TRUE, BPPARAM = bpparam()): @@ -360,6 +422,8 @@

Getter/setter methods

BPPARAM parameter: see spectra method above.

Returns a numeric vector with names corresponding to the spectrum names.

+ +
bpi

bpi(signature(object="OnDiskMSnExp"), initial = TRUE, BPPARAM = bpparam()): @@ -375,10 +439,14 @@

Getter/setter methods

BPPARAM parameter: see spectra method above.

Returns a numeric vector with names corresponding to the spectrum names.

+ +
featureNames

tic(signature(object="OnDiskMSnExp")): return a character of length length(object) containing the feature names. A replacement method is also available.

+ +
spectrapply

spectrapply(signature(object = "OnDiskMSnExp"), FUN = NULL, BPPARAM = bpparam(), ...): applies the function FUN to each @@ -388,6 +456,8 @@

Getter/setter methods

BPPARAM allows to specify how and if parallel processing should be enabled.

Returns a list with the result for each of spectrum.

+ +

Data manipulation methods

@@ -408,6 +478,8 @@

Data manipulation methods

The method returns an OnDiskMSnExp object.

For more details see documentation of the clean method.

+ +
normalize

normalize(signature(object="OnDiskMSnExp"), method=c("max", "sum"), ...): @@ -416,6 +488,8 @@

Data manipulation methods

The method returns an OnDiskMSnExp object.

For more details see documentation of the normalize method.

+ +
removePeaks

removePeaks(signature(object="OnDiskMSnExp"), t="min", verbose=TRUE): add a removePeaks processing step to the lazy processing @@ -423,6 +497,8 @@

Data manipulation methods

The method returns an OnDiskMSnExp object.

For more details see documentation of the removePeaks method.

+ +
trimMz

trimMz(signature(object="OnDiskMSnExp", mzlim="numeric"),...): add a trimMz processing step to the lazy processing queue @@ -430,6 +506,8 @@

Data manipulation methods

The method returns an OnDiskMSnExp object.

For more details see documentation of the trimMz method.

+ +

Other methods and functions

@@ -439,10 +517,15 @@

Other methods and functions

addition to the standard validObject method, this method reads also all spectra from the original files, applies eventual processing steps and evaluates their validity.

+ +
as(from, "MSnExp")

Converts the OnDiskMSnExp object from, to an in-memory MSnExp. Also available as an S3 method as.MSnExp().

+ + +

Author

@@ -454,6 +537,7 @@

See also

MSnExp, readMSData

+

Examples

## Get some example mzML files
@@ -1033,8 +1117,8 @@ 

Examples

#> Number of spectra: 35 #> MSn retention times: 45:27 - 45:30 minutes #> - - - Processing information - - - -#> Data loaded [Wed May 15 16:29:30 2024] -#> Filter: select parent/children scans for 21945 [Wed May 15 16:29:31 2024] +#> Data loaded [Wed Sep 11 07:29:40 2024] +#> Filter: select parent/children scans for 21945 [Wed Sep 11 07:29:41 2024] #> MSnbase version: 2.31.1 #> - - - Meta data - - - #> phenoData @@ -1065,8 +1149,8 @@

Examples

#> Number of spectra: 3 #> MSn retention times: 45:27 - 45:27 minutes #> - - - Processing information - - - -#> Data loaded [Wed May 15 16:29:30 2024] -#> Filter: select parent/children scans for 21946 [Wed May 15 16:29:31 2024] +#> Data loaded [Wed Sep 11 07:29:40 2024] +#> Filter: select parent/children scans for 21946 [Wed Sep 11 07:29:41 2024] #> MSnbase version: 2.31.1 #> - - - Meta data - - - #> phenoData @@ -1093,12 +1177,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/ProcessingStep-class.html b/reference/ProcessingStep-class.html index 534fb41f..ce4c0707 100644 --- a/reference/ProcessingStep-class.html +++ b/reference/ProcessingStep-class.html @@ -5,6 +5,8 @@ + +
+ + +
+

The ProcessingStep class is a simple object to encapsule all relevant information of a data analysis processing step, i.e. the function name and all arguments.

+ +

Details

Objects of this class are mainly used to record all possible @@ -83,8 +95,11 @@

Objects from the Class

Slots

FUN:

The function name to be executed as a character string.

+
ARGS:

A named list with all arguments to the function.

+ +

Methods and functions

@@ -94,6 +109,8 @@

Methods and functions

ProcessingStep object along with potential additional arguments in ... to the function object@FUN.

+ +

Extends

@@ -107,6 +124,7 @@

Author

See also

+

Examples

## Define a simple ProcessingStep
@@ -122,12 +140,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/ReporterIons-class.html b/reference/ReporterIons-class.html index 810c3e10..b19338fd 100644 --- a/reference/ReporterIons-class.html +++ b/reference/ReporterIons-class.html @@ -12,19 +12,27 @@ iTRAQ4: ReporterIon object for the iTRAQ 4-plex set. Load with data(iTRAQ4). + iTRAQ5: ReporterIon object for the iTRAQ 4-plex set plus the isobaric tag. Load with data(iTRAQ5). + TMT6: ReporterIon object for the TMT 6-plex set. Load with data(TMT6). + TMT7: ReporterIon object for the TMT 6-plex set plus the isobaric tag. Load with data(TMT6). + + + '> + +
+ + +
+

The ReporterIons class allows to define a set of isobaric reporter ions that are used for quantification in MSMS @@ -95,16 +111,23 @@

The "ReporterIons" Class

are:

iTRAQ4:

ReporterIon object for the iTRAQ 4-plex set. Load with data(iTRAQ4).

+
iTRAQ5:

ReporterIon object for the iTRAQ 4-plex set plus the isobaric tag. Load with data(iTRAQ5).

+
TMT6:

ReporterIon object for the TMT 6-plex set. Load with data(TMT6).

+
TMT7:

ReporterIon object for the TMT 6-plex set plus the isobaric tag. Load with data(TMT6).

+ +
+ +

Objects from the Class

Objects can be created by calls of the form new("ReporterIons", ...).

@@ -114,31 +137,39 @@

Slots

name:

Object of class "character" to identify the ReporterIons instance.

+
reporterNames:

Object of class "character" naming each individual reporter of the ReporterIons instance. If not provided explicitely, they are names by concatenating the ReporterIons name and the respective MZ values.

+
description:

Object of class "character" to describe the ReporterIons instance.

+
mz:

Object of class "numeric" providing the MZ values of the reporter ions.

+
col:

Object of class "character" providing colours to highlight the reporters on plots.

+
width:

Object of class "numeric" indicating the width around the individual reporter ions MZ values were to search for peaks. This is dependent on the mass spectrometer's resolution and is used for peak picking when quantifying the reporters. See quantify for more details about quantification.

+
.__classVersion__:

Object of class "Versions" indicating the version of the ReporterIons instance. Intended for developer use and debugging.

+ +

Extends

@@ -148,37 +179,48 @@

Extends

Methods

show(object)

Displays object content as text.

+
object[]

Subsets one or several reporter ions of the ReporterIons object and returns a new instance of the same class.

+
length(object)

Returns the number of reporter ions in the instance.

+
mz(object, ...)

Returns the expected mz values of reporter ions. Additional arguments are currently ignored.

+
reporterColours(object) or reporterColors(object)

Returns the colours used to highlight the reporter ions.

+
reporterNames(object)

Returns the name of the individual reporter ions. If not specified or is an incorrect number of names is provided at initialisation, the names are generated automatically by concatenating the instance name and the reporter's MZ values.

+
reporterNames(object) <- value

Sets the reporter names to value, which must be a character of the same length as the number of reporter ions.

+
width(object)

Returns the widths in which the reporter ion peaks are expected.

+
names(object)

Returns the name of the ReporterIons object.

+
description(object)

Returns the description of the ReporterIons object.

+ +

References

@@ -207,6 +249,7 @@

Author

See also

TMT6 or iTRAQ4 for readily available examples.

+

Examples

## Code used for the iTRAQ4 set
@@ -239,12 +282,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/Spectrum-class.html b/reference/Spectrum-class.html index 8a28f9ea..84b0740c 100644 --- a/reference/Spectrum-class.html +++ b/reference/Spectrum-class.html @@ -8,6 +8,8 @@ + +
+ + +
+

Virtual container for spectrum data common to all different types of spectra. A Spectrum object can not be directly instanciated. Use @@ -73,6 +83,8 @@

The "Spectrum" Class

In version 1.19.12, the polarity slot has been added to this class (previously in "Spectrum1").

+ +

Slots

msLevel:
@@ -80,50 +92,64 @@

Slots

the MS level: 1 for MS1 level Spectrum1 objects and 2 for MSMSM Spectrum2 objects. Levels > 2 have not been tested and will be handled as MS2 spectra.

+
polarity:

Object of class "integer" indicating the polarity if the ion.

+
peaksCount:

Object of class "integer" indicating the number of MZ peaks.

+
rt:

Object of class "numeric" indicating the retention time (in seconds) for the current ions.

+
tic:

Object of class "numeric" indicating the total ion current, as reported in the original raw data file.

+
acquisitionNum:

Object of class "integer" corresponding to the acquisition number of the current spectrum.

+
scanIndex:

Object of class "integer" indicating the scan index of the current spectrum.

+
mz:

Object of class "numeric" of length equal to the peaks count (see peaksCount slot) indicating the MZ values that have been measured for the current ion.

+
intensity:

Object of class "numeric" of same length as mz indicating the intensity at which each mz datum has been measured.

+
centroided:

Object of class "logical" indicating if instance is centroided ('TRUE') of uncentroided ('FALSE'). Default is NA.

+
smoothed:

Object of class "logical" indicating if instance is smoothed ('TRUE') of unsmoothed ('FALSE'). Default is NA.

+
fromFile:

Object of class "integer" referencing the file the spectrum originates. The file names are stored in the processingData slot of the "MSnExp" or "MSnSet" instance that contains the current "Spectrum" instance.

+
.__classVersion__:

Object of class "Versions" indicating the version of the Spectrum class. Intended for developer use and debugging.

+ +

Extends

@@ -134,13 +160,18 @@

Methods

acquisitionNum(object)

Returns the acquisition number of the spectrum as an integer.

+
scanIndex(object)

Returns the scan index of the spectrum as an integer.

+ +
centroided(object)

Indicates whether spectrum is centroided (TRUE), in profile mode (FALSE), or unkown (NA).

+ +
isCentroided(object, k=0.025, qtl=0.9)

A heuristic assessing if a spectrum is in profile or centroided mode. The @@ -154,110 +185,141 @@

Methods

details. It should however be safe to use is at the experiment level, assuming that all MS level have the same mode. See class?MSnExp for an example.

+ + +
smoothed(object)

Indicates whether spectrum is smoothed (TRUE) or not (FALSE).

+ +
centroided(object) <- value

Sets the centroided status of the spectrum object.

+
smoothed(object) <- value

Sets the smoothed status of the spectrum object.

+
fromFile(object)

Returns the index of the raw data file from which the current instances originates as an integer.

+
intensity(object)

Returns an object of class numeric containing the intensities of the spectrum.

+
msLevel(object)

Returns an MS level of the spectrum as an integer.

+
mz(object, ...)

Returns an object of class numeric containing the MZ value of the spectrum peaks. Additional arguments are currently ignored.

+
peaksCount(object)

Returns the number of peaks (possibly of 0 intensity) as an integer.

+
rtime(object, ...)

Returns the retention time for the spectrum as an integer. Additional arguments are currently ignored.

+
ionCount(object)

Returns the total ion count for the spectrum as a numeric.

+
tic(object, ...)

Returns the total ion current for the spectrum as a numeric. Additional arguments are currently ignored. This is the total ion current as originally reported in the raw data file. To get the current total ion count, use ionCount.

+ %% -------------------------------------------------- %%
bin

signature(object = "Spectrum"): Bins Spectrum. See bin documentation for more details and examples.

+
clean

signature(object = "Spectrum"): Removes unused 0 intensity data points. See clean documentation for more details and examples.

+
compareSpectra

signature(x = "Spectrum", y = "Spectrum"): Compares spectra. See compareSpectra documentation for more details and examples.

+
estimateNoise

signature(object = "Spectrum"): Estimates the noise in a profile spectrum. See estimateNoise documentation for more details and examples.

+
pickPeaks

signature(object = "Spectrum"): Performs the peak picking to generate a centroided spectrum. See pickPeaks documentation for more details and examples.

+
plot

signature(x = "Spectrum", y = "missing"): Plots intensity against mz. See plot.Spectrum documentation for more details.

+
plot

signature(x = "Spectrum", y = "Spectrum"): Plots two spectra above/below each other. See plot.Spectrum.Spectrum documentation for more details.

+
plot

signature(x = "Spectrum", y = "character"): Plots an MS2 level spectrum and its highlight the fragmention peaks. See plot.Spectrum.character documentation for more details.

+
quantify

signature(object = "Spectrum"): Quatifies defined peaks in the spectrum. See quantify documentation for more details.

+
removePeaks

signature(object = "Spectrum"): Remove peaks lower that a threshold t. See removePeaks documentation for more details and examples.

+
smooth

signature(x = "Spectrum"): Smooths spectrum. See smooth documentation for more details and examples.

+
show

signature(object = "Spectrum"): Displays object content as text.

+
trimMz

signature(object = "Spectrum"): Trims the MZ range of all the spectra of the MSnExp instance. See trimMz documentation for more details and examples.

+
isEmpty

signature(x = "Spectrum"): Checks if the x is an empty Spectrum.

+ %% -------------------------------------------------- %%
as

signature(object = "Spectrum", "data.frame"): Coerces the Spectrum object to a two-column data.frame containing intensities and MZ values.

+ +

Author

@@ -272,17 +334,28 @@

See also

Instaciable sub-classes "Spectrum1" and "Spectrum2" for MS1 and MS2 spectra.

+
+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/Spectrum1-class.html b/reference/Spectrum1-class.html index e00647f9..7bcbb822 100644 --- a/reference/Spectrum1-class.html +++ b/reference/Spectrum1-class.html @@ -7,6 +7,8 @@ + +
+ + +
+

Spectrum1 extends the "Spectrum" class and introduces an MS1 specific attribute in addition to the slots in @@ -71,6 +81,8 @@

The "Spectrum1" Class for MS1 Spectra

created directly but are contained in the assayData slot of an "MSnExp".

+ +

Slots

See the "Spectrum" class for inherited slots.

@@ -86,6 +98,8 @@

Methods

methods to process Spectrum1 objects.

polarity(object)

Returns the polarity of the spectrum as an integer.

+ +

Author

@@ -97,17 +111,28 @@

See also

"Spectrum2" for MS2 spectra and "MSnExp" for a full experiment container.

+
+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/Spectrum2-class.html b/reference/Spectrum2-class.html index f5a89256..70c43bed 100644 --- a/reference/Spectrum2-class.html +++ b/reference/Spectrum2-class.html @@ -1,5 +1,6 @@ The "Spectrum2" Class for MSn Spectra — Spectrum2-class • MSnbase +
precScanNum:

See precAcquisitionNum.

+
calculateFragments

signature(sequence = "character", object = "Spectrum2"): @@ -147,6 +177,8 @@

Methods

sequence with the ones observed in a spectrum. See calculateFragments documentation for more details and examples.

+ +

Author

@@ -158,17 +190,28 @@

See also

"Spectrum1" for MS1 spectra and "MSnExp" for a full experiment container.

+ + +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/TMT6.html b/reference/TMT6.html index 1d0d23ce..b7c003eb 100644 --- a/reference/TMT6.html +++ b/reference/TMT6.html @@ -1,10 +1,12 @@ TMT 6/10-plex sets — TMT6 • MSnbase + +
+ + +
+
+ +

These methods add identification data to a raw MS experiment (an "MSnExp" object) or to quantitative data (an "MSnSet" object). The identification data needs @@ -76,8 +89,12 @@

Adds Identification Data

as an arbitrary data.frame. See details in the Methods section.

+ +

Details

+ +

The featureData slots in a "MSnExp" or a "MSnSet" instance provides only one row per MS2 spectrum but the identification is not always bijective. Prior to @@ -106,48 +123,72 @@

Details

Methods

+ +

signature(object = "MSnExp", id = "character", ...

Adds the identification data stored in mzIdentML files to a "MSnExp" instance. The method handles one or multiple mzIdentML files provided via id. id has to be a character vector of valid filenames. See below for additional arguments.

+ +
signature(object = "MSnExp", id = "mzID", ...)

Same as above but id is a mzID object generated by mzID::mzID. See below for additional arguments.

+ +
signature(object = "MSnExp", id = "mzIDCollection", ...)

Same as above but id is a mzIDCollection object. See below for additional arguments.

+ +
signature(object = "MSnExp", id = "mzRident", ...

Same as above but id is a mzRident object generated by mzR::openIdfile. See below for additional arguments.

+ + +
signature(object = "MSnExp", id = "data.frame", ...

Same as above but id could be a data.frame. See below for additional arguments.

+ +
signature(object = "MSnSet", id = "character", ...)

Adds the identification data stored in mzIdentML files to an "MSnSet" instance. The method handles one or multiple mzIdentML files provided via id. id has to be a character vector of valid filenames. See below for additional arguments.

+ +
signature(object = "MSnSet", id = "mzID", ...)

Same as above but id is a mzID object. See below for additional arguments.

+ +
signature(object = "MSnSet", id = "mzIDCollection", ...)

Same as above but id is a mzIDCollection object. See below for additional arguments.

+ +
signature(object = "MSnSet", id = "data.frame", ...)

Same as above but id is a data.frame. See below for additional arguments.

+ + +

The methods above take the following additional argument. These need to be set when adding identification data as a data.frame. In all other cases, the defaults are set automatically.

+

fcol
+

The matching between the features (raw spectra or quantiative features) and identification results is done by matching columns in the featue data (the featureData slot) and the @@ -158,39 +199,54 @@

Methods

"acquisition.num". Values need to be provided when id is a data.frame.

+ +
icol
+

The default values for the spectrum file and acquisition numbers in the identification data (the id argument) are "spectrumFile" and "acquisitionNum". Values need to be provided when id is a data.frame.

+ +
acc
+

The protein (group) accession number or identifier. Defaults are "DatabaseAccess" when passing filenames or mzRident objects and "accession" when passing mzID or mzIDCollection objects. A value needs to be provided when id is a data.frame.

+ +
desc
+

The protein (group) description. Defaults are "DatabaseDescription" when passing filenames or mzRident objects and "description" when passing mzID or mzIDCollection objects. A value needs to be provided when id is a data.frame.

+ +
pepseq
+

The peptide sequence variable name. Defaults are "sequence" when passing filenames or mzRident objects and "pepseq" when passing mzID or mzIDCollection objects. A value needs to be provided when id is a data.frame.

+ +
key
+

The key to be used when the identification data need to be reduced (see details section). Defaults are "spectrumID" when passing filenames or mzRident objects and @@ -198,8 +254,11 @@

Methods

mzIDCollection objects. A value needs to be provided when id is a data.frame.

+ +
decoy
+

The feature variable used to define whether the PSM was matched in the decoy of regular fasta database for PSM filtering. Defaults are "isDecoy" when passing filenames or mzRident @@ -208,25 +267,36 @@

Methods

id is a data.frame. See filterIdentificationDataFrame for details.

+ +
rank
+

The feature variable used to defined the rank of the PSM for filtering. Defaults is "rank". A value needs to be provided when id is a data.frame. See filterIdentificationDataFrame for details.

+ +
accession
+

The feature variable used to defined the protein (groupo) accession or identifier for PSM filterin. Defaults is to use the same value as acc . A value needs to be provided when id is a data.frame. See filterIdentificationDataFrame for details.

+ +
verbose

A logical defining whether to print out messages or not. Default is to use the session-wide open from isMSnbaseVerbose.

+ + +

Author

@@ -235,12 +305,14 @@

Author

See also

+

filterIdentificationDataFrame for the function that filters identification data, readMzIdData to read the identification data as a unfiltered data.frame and reduce,data.frame-method to reduce it to a data.frame that contains only unique PSMs per row.

+

Examples

## find path to a mzXML file
@@ -317,12 +389,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/aggvar.html b/reference/aggvar.html index 925ec163..bfa41bb2 100644 --- a/reference/aggvar.html +++ b/reference/aggvar.html @@ -5,6 +5,8 @@ + +
+ + +
+

This function evaluates the variability within all protein group of an MSnSet. If a protein group is composed only of a single feature, NA is returned.

+
aggvar(object, groupBy, fun)
+

Arguments

-
object
+ + +
object

An object of class MSnSet.

+ +
groupBy

A character containing the protein grouping feature variable name.

+ +
fun

A function the summarise the distance between features within protein groups, typically max or mean.median.

+

Value

-

A matrix providing the number of features per +

A matrix providing the number of features per protein group (nb_feats column) and the aggregation summarising distance (agg_dist column).

@@ -109,6 +127,7 @@

See also

Author

Laurent Gatto

+

Examples

library("pRolocdata")
@@ -129,12 +148,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/averageMSnSet.html b/reference/averageMSnSet.html index e5d83ecf..b2da0a13 100644 --- a/reference/averageMSnSet.html +++ b/reference/averageMSnSet.html @@ -5,6 +5,8 @@ + +
+ + +
+

Given a list of MSnSet instances, typically representing replicated experiments, the function returns an average MSnSet.

+
averageMSnSet(x, avg = function(x) mean(x, na.rm = TRUE), disp = npcv)
+

Arguments

-
x
+ + +
x

A list of valid MSnSet instances to be averaged.

+ +
avg

The averaging function. Default is the mean after removing missing values, as computed by function(x) mean(x, na.rm = TRUE).

+ +
disp

The disperion function. Default is an non-parametric coefficient of variation that replaces the standard deviation by @@ -87,10 +104,11 @@

Arguments

details. Note that the mad of a single value is 0 (as opposed to NA for the standard deviation, see example below).

+

Value

-

A new average MSnSet.

+

A new average MSnSet.

Details

@@ -123,6 +141,7 @@

See also

Author

Laurent Gatto

+

Examples

library("pRolocdata")
@@ -186,7 +205,7 @@ 

Examples

#> Loading required package: cluster #> Loading required package: BiocParallel #> -#> This is pRoloc version 1.44.0 +#> This is pRoloc version 1.44.1 #> Visit https://lgatto.github.io/pRoloc/ to get started. setStockcol(paste0(getStockcol(), "AA")) plot2D(avg, cex = 7.7 * disp) @@ -200,12 +219,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/bin-methods.html b/reference/bin-methods.html index 718284dc..d69db981 100644 --- a/reference/bin-methods.html +++ b/reference/bin-methods.html @@ -5,6 +5,8 @@ + +
+ + +
+

This method aggregates individual spectra (Spectrum instances) or whole experiments (MSnExp instances) into discrete bins. All intensity values which belong to the same bin are summed together.

+ +

Methods

signature(object = "MSnExp", binSize = "numeric", verbose = @@ -76,6 +88,8 @@

Methods

(in Dalton, default is 1). Displays a control bar if verbose set to TRUE (default). Returns a binned MSnExp instance.

+ +
signature(object = "Spectrum", binSize = "numeric", breaks = "numeric", msLevel. = "numeric")

Bin the @@ -87,6 +101,8 @@

Methods

!= msLevel.
, cleaning is ignored. Only relevant when called from OnDiskMSnExp and is only relevant for developers.

Returns a binned Spectrum instance.

+ +

Author

@@ -98,6 +114,7 @@

See also

removePeaks and trimMz for other spectra processing methods.

+

Examples

s <- new("Spectrum2", mz=1:10, intensity=1:10)
@@ -116,7 +133,7 @@ 

Examples

#> - - - Processing information - - - #> Data loaded: Wed May 11 18:54:39 2011 #> Updated from version 0.3.0 to 0.3.1 [Fri Jul 8 20:23:25 2016] -#> Spectra binned: Wed May 15 16:29:41 2024 +#> Spectra binned: Wed Sep 11 07:29:51 2024 #> MSnbase version: 1.1.22
@@ -125,12 +142,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/calculateFragments-methods.html b/reference/calculateFragments-methods.html index c12145dd..d86c5e57 100644 --- a/reference/calculateFragments-methods.html +++ b/reference/calculateFragments-methods.html @@ -4,6 +4,8 @@ + +
+ + +
+

These method calculates a-, b-, c-, x-, y- and z-ions produced by fragmentation.

+ +

Arguments

-
sequence
+

+
sequence

character, peptide sequence.

+
object

Object of class "Spectrum2" or "missing" .

+
tolerance

numeric tolerance between the theoretical and measured MZ values (only available if object is not missing).

+
method

method used for for duplicated matches. Choose "highest" or "closest" to select the peak with the highest intensity respectively the closest MZ in the tolerance range. If "all" is given all possible matches in the tolerance range are reported (only available if object is not missing).

+
type

character vector of target ions; possible values: c("a", "b", "c", "x", "y", "z"); default: type=c("b", "y").

+
z

numeric desired charge state; default z=1.

+
modifications

named numeric vector of used modifications. The name must correspond to the one-letter-code of the modified amino acid and @@ -94,6 +113,7 @@

Arguments

Carbamidomethyl modifications=c(C=57.02146). Use Nterm or Cterm as names for modifications that should be added to the amino respectively carboxyl-terminus.

+
neutralLoss

list, it has to have two named elments, namely water and ammonia that contain a @@ -106,9 +126,11 @@

Arguments

correct list. It has two arguments disableWaterLoss and disableAmmoniaLoss to remove single neutral loss options. See the example section for use cases.

+
verbose

logical if TRUE (default) the used modifications are printed.

+

Methods

@@ -116,6 +138,7 @@

Methods

Calculates the theoretical fragments for a peptide sequence. Returns a data.frame with the columns c("mz", "ion", "type", "pos", "z", "seq").

+
signature(sequence = "character", object = "Spectrum2", ...)

Calculates and matches the theoretical fragments for a peptide sequence and a "Spectrum2" object. @@ -137,11 +160,14 @@

Methods

is a column error that contains the difference between the observed MZ (from the spectrum) to the theoretical fragment MZ.

+ +

Author

Sebastian Gibb <mail@sebastiangibb.de>

+

Examples

## find path to a mzXML file
@@ -758,12 +784,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/chromatogram-MSnExp-method.html b/reference/chromatogram-MSnExp-method.html index c47fc276..04463921 100644 --- a/reference/chromatogram-MSnExp-method.html +++ b/reference/chromatogram-MSnExp-method.html @@ -7,6 +7,8 @@ + +
+ + +
+

The chromatogram method extracts chromatogram(s) from an MSnExp or OnDiskMSnExp object. @@ -72,6 +81,7 @@

Extract chromatogram object(s)

(TIC), a base peak chromatogram (BPC) or an extracted ion chromatogram (XIC) extracted from each sample/file.

+
# S4 method for class 'MSnExp'
 chromatogram(
@@ -84,18 +94,25 @@ 

Extract chromatogram object(s)

BPPARAM = bpparam() )
+

Arguments

-
object
+ + +
object

For chromatogram: a MSnExp or OnDiskMSnExp object from which the chromatogram should be extracted.

+ +
rt

A numeric(2) or two-column matrix defining the lower and upper boundary for the retention time range/window(s) for the chromatogram(s). If a matrix is provided, a chromatogram is extracted for each row. If not specified, a chromatogram representing the full retention time range is extracted. See examples below for details.

+ +
mz

A numeric(2) or two-column matrix defining the mass-to-charge (mz) range(s) for the chromatogram(s). For each @@ -103,25 +120,34 @@

Arguments

aggregated to result in the intensity value for the spectrum/retention time. If not specified, the full mz range is considered. See examples below for details.

+ +
aggregationFun

character defining the function to be used for intensity value aggregation along the mz dimension. Allowed values are "sum" (TIC), "max" (BPC), "min" and "mean".

+ +
missing

numeric(1) allowing to specify the intensity value for if for a given retention time (spectrum) no signal was measured within the mz range. Defaults to NA_real_.

+ +
msLevel

integer specifying the MS level from which the chromatogram should be extracted. Defaults to msLevel = 1L.

+ +
BPPARAM

Parallelisation backend to be used, which will depend on the architecture. Default is BiocParallel::bpparam().

+

Value

-

chromatogram returns a MChromatograms object with +

chromatogram returns a MChromatograms object with the number of columns corresponding to the number of files in object and number of rows the number of specified ranges (i.e. number of rows of matrices provided with arguments mz and/or @@ -163,6 +189,7 @@

See also

Author

Johannes Rainer

+

Examples

## Read a test data file.
@@ -259,12 +286,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/clean-methods.html b/reference/clean-methods.html index d23aadd6..9a92fc86 100644 --- a/reference/clean-methods.html +++ b/reference/clean-methods.html @@ -11,6 +11,8 @@ + +
+ + +
+

This method cleans out individual spectra (Spectrum instances), chromatograms (Chromatogram instances) @@ -79,6 +89,8 @@

Clean 'MSnExp', 'Spectrum' or 'Chromatogram' instances

only one 0-intensity value, it is retained. An illustrative example is shown below.

+ +

Methods

signature(object = "MSnExp", all = "logical", verbose = @@ -86,6 +98,8 @@

Methods

Cleans all spectra in MSnExp object. Displays a control bar if verbose set to TRUE (default). Returns a cleaned MSnExp instance.

+ +
signature(object = "Spectrum", all = "logical", msLevel. = "numeric")

Cleans the Spectrum @@ -94,12 +108,16 @@

Methods

level of the spectrum, and if msLevel(object) != msLevel., cleaning is ignored. Only relevant when called from OnDiskMSnExp and is only relevant for developers.

+ +
signature(object = "Chromatogram", all = "logical", na.rm = "logical")

Cleans the Chromatogram instance and returns a cleaned Chromatogram object. If na.rm is TRUE (default is FALSE) all NA intensities are removed before cleaning the chromatogram.

+ +

Author

@@ -110,6 +128,7 @@

See also

removePeaks and trimMz for other spectra processing methods.

+

Examples

int <- c(1,0,0,0,0,0,0,0,1,1,1,0,0,0,0,0,1,1,0,0,0,0,0,0,0,0,0,0,1,0,0,0)
@@ -142,7 +161,7 @@ 

Examples

#> - - - Processing information - - - #> Data loaded: Wed May 11 18:54:39 2011 #> Updated from version 0.3.0 to 0.3.1 [Fri Jul 8 20:23:25 2016] -#> Spectra cleaned: Wed May 15 16:29:53 2024 +#> Spectra cleaned: Wed Sep 11 07:30:01 2024 #> MSnbase version: 1.1.22 ## Create a simple Chromatogram object @@ -173,12 +192,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/combineFeatures.html b/reference/combineFeatures.html index 87928177..14258b19 100644 --- a/reference/combineFeatures.html +++ b/reference/combineFeatures.html @@ -1,5 +1,6 @@ Combines features in an MSnSet object — combineFeatures • MSnbase combineSpectra( @@ -93,34 +103,48 @@

Combine Spectra

# S4 method for class 'MSpectra' combineSpectra(object, fcol, method = meanMzInts, fun, ...)
+

Arguments

-
object
+ + +
object

A MSnExp or MSpectra

+ +
fcol

For MSpectra objects: mcols column name to be used to define the sets of spectra to be combined. If missing, all spectra are considered to be one set. For MSnExp/OnDiskMSnExp objects: column in fData(object) defining which spectra to combine. See examples below for more details.

+ +
method

function to be used to combine the spectra by fcol. Has to be a function that takes a list of spectra as input and returns a single Spectrum. See meanMzInts() for details.

+ +
...

additional arguments for fun.

+ +
BPPARAM

For MSnExp/OnDiskMSnExp objects: parallel processing setup to perform per-file parallel spectra combining. See bpparam() for more details.

+ +
fun

Deprecated use method instead.

+

Value

-

A MSpectra or MSnExp object with combined spectra. Metadata -(mcols) and all spectrum attributes other than mz and intensity

-

are taken from the first Spectrum in each set.

+

A MSpectra or MSnExp object with combined spectra. Metadata +(mcols) and all spectrum attributes other than mz and intensity +are taken from the first Spectrum in each set.

See also

@@ -130,6 +154,7 @@

See also

Author

Johannes Rainer, Laurent Gatto

+

Examples


@@ -241,12 +266,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/combineSpectraMovingWindow.html b/reference/combineSpectraMovingWindow.html index 2edd80c7..b1d18444 100644 --- a/reference/combineSpectraMovingWindow.html +++ b/reference/combineSpectraMovingWindow.html @@ -10,6 +10,8 @@ + +
+ + +
+

combineSpectraMovingWindow combines signal from consecutive spectra within a file. The resulting MSnExp has the same total number of spectra than the @@ -78,6 +87,7 @@

Combine signal from consecutive spectra of LCMS experiments

Note that the function returns always a MSnExp object, even if x was an OnDiskMSnExp object.

+
combineSpectraMovingWindow(
   x,
@@ -90,23 +100,34 @@ 

Combine signal from consecutive spectra of LCMS experiments

BPPARAM = bpparam() )
+

Arguments

-
x
+ + +
x

MSnExp or OnDiskMSnExp object.

+ +
halfWindowSize

integer(1) with the half window size for the moving window.

+ +
intensityFun

function to aggregate the intensity values per m/z group. Should be a function or the name of a function. The function is expected to return a numeric(1).

+ +
mzd

numeric(1) defining the maximal m/z difference below which mass peaks are considered to represent the same ion/mass peak. Intensity values for such grouped mass peaks are aggregated. If not specified this value is estimated from the distribution of differences of m/z values from the provided spectra (see details).

+ +
timeDomain

logical(1) whether definition of the m/z values to be combined into one m/z is performed on m/z values @@ -115,21 +136,28 @@

Arguments

on the time domain (see details). Note that a pre-defined mzd should also be estimated on the square root of m/z values if timeDomain = TRUE.

+ +
weighted

logical(1) whether m/z values per m/z group should be aggregated with an intensity-weighted mean. The default is to report the mean m/z.

+ +
ppm

numeric(1) to define an m/z relative deviation. Note that if only ppm should be considered but not mzd, mzd should be set to 0 (i.e. mzd = 0). This parameter is directly passed to meanMzInts().

+ +
BPPARAM

parallel processing settings.

+

Value

-

MSnExp with the same number of spectra than x.

+

MSnExp with the same number of spectra than x.

Details

@@ -176,6 +204,7 @@

See also

Author

Johannes Rainer, Sigurdur Smarason

+

Examples


@@ -238,12 +267,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/commonFeatureNames.html b/reference/commonFeatureNames.html index 09be86db..b109ff93 100644 --- a/reference/commonFeatureNames.html +++ b/reference/commonFeatureNames.html @@ -3,6 +3,8 @@ + +
+ + +
+

Subsets MSnSet instances to their common feature names.

+
commonFeatureNames(x, y)
+

Arguments

-
x
+ + +
x

An instance of class MSnSet or a list or MSnSetList with at least 2 MSnSet objects.

+ +
y

An instance of class MSnSet. Ignored if x is a list/MSnSetList.

+

Value

-

An linkS4class{MSnSetList} composed of the input +

An linkS4class{MSnSetList} composed of the input MSnSet containing only common features in the same order. The names of the output are either the names of the -x and y input variables or the names of x

-

if a list is provided.

+x and y input variables or the names of x +if a list is provided.

Author

Laurent Gatto

+

Examples

library("pRolocdata")
@@ -117,12 +134,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/compareMSnSets.html b/reference/compareMSnSets.html index 5cde2a2a..d946e84d 100644 --- a/reference/compareMSnSets.html +++ b/reference/compareMSnSets.html @@ -4,6 +4,8 @@ + +
+ + +
+

Compares two MSnSet instances. The qual and processingData slots are generally omitted.

+
compareMSnSets(x, y, qual = FALSE, proc = FALSE)
+

Arguments

-
x
+ + +
x

First MSnSet

+ +
y

Second MSnSet

+ +
qual

Should the qual slots be compared? Default is FALSE.

+ +
proc

Should the processingData slots be compared? Default is FALSE.

+

Value

-

A logical

+

A logical

Author

Laurent Gatto

+
+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/compareSpectra-methods.html b/reference/compareSpectra-methods.html index 36498883..b668be8c 100644 --- a/reference/compareSpectra-methods.html +++ b/reference/compareSpectra-methods.html @@ -19,6 +19,8 @@ + +
+ + +
+

This method compares spectra (Spectrum instances) pairwise or all spectra of an experiment (MSnExp instances). Currently @@ -95,6 +105,8 @@

Compare Spectra of an 'MSnExp' or 'Spectrum' instances

and ... as third argument. The function must return a single numeric value. See the example section.

+ +

Methods

signature(x = "MSnExp", y = "missing", fun = @@ -103,11 +115,17 @@

Methods

object. The ... arguments are passed to the internal functions. Returns a matrix of dimension length(x) by length(x).

+ + +
signature(x = "Spectrum", y = "Spectrum", fun = "character", ...)

Compares two Spectrum objects. See the above explanation for fun and .... Returns a single numeric value.

+ + +

Author

@@ -133,6 +151,7 @@

References

Proteomics, 7: 655-667. doi: https://doi.org/10.1002/pmic.200600625

+

Examples

s1 <- new("Spectrum2", mz=1:10, intensity=1:10)
@@ -170,12 +189,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/consensusSpectrum.html b/reference/consensusSpectrum.html index 2d758fb7..585742c9 100644 --- a/reference/consensusSpectrum.html +++ b/reference/consensusSpectrum.html @@ -5,6 +5,8 @@ + +
+ + +
+

consensusSpectrum takes a list of spectra and combines them to a consensus spectrum containing mass peaks that are present in a user definable proportion of spectra.

+
consensusSpectrum(
   x,
@@ -80,11 +90,16 @@ 

Combine spectra to a consensus spectrum

... )
+

Arguments

-
x
+ + +
x

list of Spectrum objects (either Spectrum1 or Spectrum2).

+ +
mzd

numeric(1) defining the maximal m/z difference below which mass peaks are grouped in to the same final mass peak (see details for @@ -92,29 +107,42 @@

Arguments

this value from the distribution of differences of m/z values from the spectra. See also parameter ppm below for the definition of an m/z dependent peak grouping.

+ +
minProp

numeric(1) defining the minimal proportion of spectra in which a mass peak has to be present in order to include it in the final consensus spectrum. Should be a number between 0 and 1 (present in all spectra).

+ +
intensityFun

function (or name of a function) to be used to define the intensity of the aggregated peak. By default the median signal for a mass peak is reported.

+ +
mzFun

function (or name of a function) to be used to define the intensity of the aggregated peak. By default the median m/z is reported. Note that setting weighted = TRUE overrides this parameter.

+ +
ppm

numeric(1) allowing to perform a m/z dependent grouping of mass peaks. See details for more information.

+ +
weighted

logical(1) whether the m/z of the aggregated peak represents the intensity-weighted average of the m/z values of all peaks of the peak group. If FALSE (the default), the m/z of the peak is calculated with mzFun.

+ +
...

additional arguments to be passed to intensityFun.

+

Details

@@ -138,6 +166,7 @@

See also

Author

Johannes Rainer

+

Examples

library(MSnbase)
@@ -186,12 +215,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/defunct.html b/reference/defunct.html index 0e891e56..1010ac6c 100644 --- a/reference/defunct.html +++ b/reference/defunct.html @@ -8,6 +8,8 @@ + +
+ + +
+

The function, class, or data object you have asked for has been deprecated or made defunct.

@@ -73,17 +83,30 @@

MSnbase Deprecated and Defunct

writeMzTabData, makeMTD, makePEP, makePRT, NAnnotatedDataFrame class.

+ + +
+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/estimateMzResolution.html b/reference/estimateMzResolution.html index 0a8081d3..d2ef6d07 100644 --- a/reference/estimateMzResolution.html +++ b/reference/estimateMzResolution.html @@ -6,6 +6,8 @@ + +
+ + +
+

estimateMzResolution estimates the m/z resolution of a profile-mode Spectrum (or of all spectra in an MSnExp or OnDiskMSnExp object. The m/z resolution is defined as the most frequent difference between a spectrum's m/z values.

+
# S4 method for class 'MSnExp'
 estimateMzResolution(object, ...)
@@ -77,16 +87,22 @@ 

Estimate the m/z resolution of a spectrum

# S4 method for class 'Spectrum' estimateMzResolution(object, ...)
+

Arguments

-
object
+ + +
object

either a Spectrum, MSnExp or OnDiskMSnExp object.

+ +
...

currently not used.

+

Value

-

numeric(1) with the m/z resolution. If called on a MSnExp or +

numeric(1) with the m/z resolution. If called on a MSnExp or OnDiskMSnExp a list of m/z resolutions are returned (one for each spectrum).

@@ -102,6 +118,7 @@

Note

Author

Johannes Rainer

+

Examples


@@ -133,12 +150,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/estimateMzScattering.html b/reference/estimateMzScattering.html index 784c3663..04ff89e7 100644 --- a/reference/estimateMzScattering.html +++ b/reference/estimateMzScattering.html @@ -4,6 +4,8 @@ + +
+ + +
+

Estimate scattering of m/z values (due to technical, instrument specific noise) for the same ion in consecutive scans of a LCMS experiment.

+
estimateMzScattering(x, halfWindowSize = 1L, timeDomain = FALSE)
+

Arguments

-
x
+ + +
x

MSnExp or OnDiskMSnExp object.

+ +
halfWindowSize

integer(1) defining the half window size for the moving window to combine consecutive spectra.

+ +
timeDomain

logical(1) whether m/z scattering should be estimated on mz (timeDomain = FALSE) or sqrt(mz) (timeDomain = TRUE) values. See combineSpectraMovingWindow() for details on this parameter.

+

Details

@@ -107,6 +125,7 @@

See also

Author

Johannes Rainer

+

Examples


@@ -140,12 +159,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/estimateNoise-method.html b/reference/estimateNoise-method.html index 2c1d2562..d2344fb0 100644 --- a/reference/estimateNoise-method.html +++ b/reference/estimateNoise-method.html @@ -9,6 +9,8 @@ + +
+ + +
+

This method performs a noise estimation on individual spectra (Spectrum instances). @@ -75,6 +85,8 @@

Noise Estimation for 'Spectrum' instances

as implemented in the MALDIquant::detectPeaks and MALDIquant::estimateNoise functions respectively.

+ +

Methods

signature(object = "Spectrum", method = "character", ...)
@@ -88,8 +100,12 @@

Methods

details. This method returns a two-column matrix with the m/z and intensity values in the first and the second column.

+ +
signature(object = "MSnExp", method = "character", ...)

Estimates noise for all spectra in object.

+ +

Author

@@ -107,6 +123,7 @@

References

Bioinformatics 28: 2270-2271. http://strimmerlab.org/software/maldiquant/

+

Examples

sp1 <- new("Spectrum1",
@@ -133,12 +150,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/extractPrecSpectra-methods.html b/reference/extractPrecSpectra-methods.html index 5643cf09..e2da5d0c 100644 --- a/reference/extractPrecSpectra-methods.html +++ b/reference/extractPrecSpectra-methods.html @@ -7,6 +7,8 @@ + +
+ + +
+

Extracts the MSMS spectra that originate from the precursor(s) having the same MZ value as defined in theprec argument.

@@ -71,16 +81,21 @@

Extracts precursor-specific spectra from an 'MSnExp' object

in prec are absent in the experiment precursor MZ values (i.e in precursorMz(object)).

+ +

Methods

signature(object = "MSnExp", prec = "numeric")

Returns an "MSnExp" containing MSMS spectra whose precursor MZ values are in prec.

+ +

Author

Laurent Gatto <lg390@cam.ac.uk>

+

Examples

file <- dir(system.file(package="MSnbase",dir="extdata"),
@@ -96,8 +111,8 @@ 

Examples

#> 645.3741 645.3741 processingData(bb) #> - - - Processing information - - - -#> Data loaded: Wed May 15 16:30:13 2024 -#> 1 (2) precursors (spectra) extracted: Wed May 15 16:30:13 2024 +#> Data loaded: Wed Sep 11 07:30:18 2024 +#> 1 (2) precursors (spectra) extracted: Wed Sep 11 07:30:18 2024 #> MSnbase version: 2.31.1
@@ -106,12 +121,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/extractSpectraData.html b/reference/extractSpectraData.html index caed6fea..5e87fc99 100644 --- a/reference/extractSpectraData.html +++ b/reference/extractSpectraData.html @@ -9,6 +9,8 @@ + +
+ + +
+

extractSpectraData extracts the spectra data (m/z and intensity values including metadata) from MSnExp, OnDiskMSnExp, @@ -76,24 +85,30 @@

Extract data from MSnbase objects for use in Spectra

to convert data from the old MSnbase package to the newer Spectra package.

+
extractSpectraData(x)
+

Arguments

-
x
+ + +
x

a list of Spectrum objects or an object extending MSnExp or a MSpectra object.

+

Value

-

DataFrame() with the full spectrum data that can be passed to the +

DataFrame() with the full spectrum data that can be passed to the Spectra::Spectra() function to create a Spectra object.

Author

Johannes Rainer

+

Examples


@@ -248,12 +263,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/fData-utils.html b/reference/fData-utils.html index 6be36b63..8beca8d7 100644 --- a/reference/fData-utils.html +++ b/reference/fData-utils.html @@ -8,6 +8,8 @@ + +
+ + +
+

The expandFeatureVars and mergeFeatureVars respectively expand and merge groups of feature variables. Using these functions, a @@ -74,34 +83,46 @@

Expand or merge feature variables

expanded into single feature columns. The original feature variables are removed.

+
expandFeatureVars(x, fcol, prefix)
 
 mergeFeatureVars(x, fcol, fcol2)
+

Arguments

-
x
+ + +
x

An object of class MSnSet.

+ +
fcol

A character() of feature variables to expand (for expandFeatureVars) or merge (for mergeFeatureVars).

+ +
prefix

A character(1) to use as prefix to the new feature variables. If missing (default), then fcol is used instead. If NULL, then no prefix is used.

+ +
fcol2

A character(1) defining the name of the new feature variable.

+

Value

-

An MSnSet for expanded (merged) feature variables.

+

An MSnSet for expanded (merged) feature variables.

Author

Laurent Gatto

+

Examples

library("pRolocdata")
@@ -201,12 +222,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/factorsAsStrings.html b/reference/factorsAsStrings.html index b206aea2..ad04bcff 100644 --- a/reference/factorsAsStrings.html +++ b/reference/factorsAsStrings.html @@ -5,6 +5,8 @@ + +
+ + +
+

This function produces the opposite as the stringsAsFactors argument in the data.frame or read.table functions; it converts factors columns to characters.

+
factorsAsStrings(x)
+

Arguments

-
x
+ + +
x

A data.frame

+

Value

-

A data.frame where factors are converted to +

A data.frame where factors are converted to characters.

Author

Laurent Gatto

+

Examples

data(iris)
@@ -109,12 +124,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/featureCV.html b/reference/featureCV.html index 26a1062e..42f1ff02 100644 --- a/reference/featureCV.html +++ b/reference/featureCV.html @@ -7,6 +7,8 @@ + +
+ + +
+

This function calculates the column-wise coefficient of variation (CV), i.e. the ration between the standard deviation and the @@ -72,32 +81,45 @@

Calculates coeffivient of variation for features

for the groups of features defined by groupBy. For groups defined by single features, NA is returned.

+
featureCV(x, groupBy, na.rm = TRUE, norm = "none", suffix = NULL)
+

Arguments

-
x
+ + +
x

An instance of class MSnSet.

+ +
groupBy

An object of class factor defining how to summarise the features.

+ +
na.rm

A logical(1) defining whether missing values should be removed.

+ +
norm

One of normalisation methods applied prior to CV calculation. See normalise() for more details. Here, the default is 'none', i.e. no normalisation.

+ +
suffix

A character(1) to be used to name the new CV columns. Default is NULL to ignore this. This argument should be set when CV values are already present in the MSnSet feature variables.

+

Value

-

A matrix of dimensions length(levels(groupBy)) by +

A matrix of dimensions length(levels(groupBy)) by ncol(x) with the respecive CVs. The column names are formed by pasting CV. and the sample names of object x, possibly suffixed by .suffix.

@@ -110,6 +132,7 @@

See also

Author

Laurent Gatto and Sebastian Gibb

+

Examples

data(msnset)
@@ -130,12 +153,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/fillUp.html b/reference/fillUp.html index 31596bd0..4fc74e86 100644 --- a/reference/fillUp.html +++ b/reference/fillUp.html @@ -8,6 +8,8 @@ + +
+ + +
+

This function replaces all the empty characters "" and/or NAs with the value of the closest preceding the preceding @@ -73,23 +83,28 @@

Fills up a vector

a set of partially identical rows are explicitly populated and the following are empty.

+
fillUp(x)
+

Arguments

-
x
+

+
x

a vector.

+

Value

-

A vector as x with all empty characters "" and NA

-

values replaced by the preceding non-NA/"" value.

+

A vector as x with all empty characters "" and NA + values replaced by the preceding non-NA/"" value.

Author

Laurent Gatto <lg390@cam.ac.uk>

+

Examples

d <- data.frame(protein=c("Prot1","","","Prot2","",""),
@@ -129,12 +144,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/filterIdentificationDataFrame.html b/reference/filterIdentificationDataFrame.html index 773219b3..97419b0d 100644 --- a/reference/filterIdentificationDataFrame.html +++ b/reference/filterIdentificationDataFrame.html @@ -4,6 +4,8 @@ + +
+ + +
+

A function to filter out PSMs matching to the decoy database, of rank greater than one and matching non-proteotypic peptides.

+
filterIdentificationDataFrame(
   x,
@@ -76,33 +86,47 @@ 

Filter out unreliable PSMs.

verbose = isMSnbaseVerbose() )
+

Arguments

-
x
+ + +
x

A data.frame containing PSMs.

+ +
decoy

The column name defining whether entries match the decoy database. Default is "isDecoy". The column should be a logical and only PSMs holding a FALSE are retained. Ignored is set to NULL.

+ +
rank

The column name holding the rank of the PSM. Default is "rank". This column should be a numeric and only PSMs having rank equal to 1 are retained. Ignored is set to NULL.

+ +
accession

The column name holding the protein (groups) accession. Default is "DatabaseAccess". Ignored is set to NULL.

+ +
spectrumID

The name of the spectrum identifier column. Default is spectrumID.

+ +
verbose

A logical verbosity flag. Default is to take isMSnbaseVerbose().

+

Value

-

A new data.frame with filtered out peptides and with the +

A new data.frame with filtered out peptides and with the same columns as the input x.

@@ -116,17 +140,28 @@

Details

Author

Laurent Gatto

+
+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/formatRt.html b/reference/formatRt.html index 756155c1..7428082f 100644 --- a/reference/formatRt.html +++ b/reference/formatRt.html @@ -5,6 +5,8 @@ + +
+ + +
+

This function is used to convert retention times. Conversion is seconds to/from the more human friendly format "mm:sec". The implementation is from MsCoreUtils::formatRt().

+
formatRt(rt)
+

Arguments

-
rt
+ + +
rt

retention time in seconds (numeric) or "mm:sec" (character).

+

Value

-

A vector of same length as rt.

+

A vector of same length as rt.

Author

Laurent Gatto and Sebastian Gibb

+

Examples


@@ -99,12 +114,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/getVariableName.html b/reference/getVariableName.html index 2a657a22..8d8fa873 100644 --- a/reference/getVariableName.html +++ b/reference/getVariableName.html @@ -3,6 +3,8 @@ + +
+ + +
+

Return the name of variable varname in call match_call.

+
getVariableName(match_call, varname)
+

Arguments

-
match_call
+ + +
match_call

An object of class call, as returned by match.call.

+ +
varname

An character of length 1 which is looked up in match_call.

+

Value

-

A character with the name of the variable passed as parameter +

A character with the name of the variable passed as parameter varname in parent close of match_call.

Author

Laurent Gatto

+

Examples

a <- 1
@@ -99,12 +116,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/grepEcols.html b/reference/grepEcols.html index ed42d387..97c9b1be 100644 --- a/reference/grepEcols.html +++ b/reference/grepEcols.html @@ -6,6 +6,8 @@ + +
+ + +
+

Given a text spread sheet f and a pattern to be matched to its header (first line in the file), the function returns the matching columns names or indices of the corresponding data.frame.

+
grepEcols(f, pattern, ..., n = 1)
 
 getEcols(f, ..., n = 1)
+

Arguments

-
f
+ + +
f

A connection object or a character string to be read in with readLines(f, n = 1).

+ +
pattern

A character string containing a regular expression to be matched to the file's header.

+ +
...

Additional parameters passed to strsplit to split the file header into individual column names.

+ +
n

An integer specifying which line in file f to grep (get). Default is 1. Note that this argument must be named.

+

Value

-

Depending on value, the matching column names of +

Depending on value, the matching column names of indices. In case of getEcols, a character of column names.

@@ -118,17 +138,28 @@

See also

Author

Laurent Gatto

+
+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/hasSpectraOrChromatograms.html b/reference/hasSpectraOrChromatograms.html index 218d29e7..2d96743e 100644 --- a/reference/hasSpectraOrChromatograms.html +++ b/reference/hasSpectraOrChromatograms.html @@ -4,6 +4,8 @@ + +
+ + +
+

Helper functions to check whether raw files contain spectra or chromatograms.

+
hasSpectra(files)
 
 hasChromatograms(files)
+

Arguments

-
files
+ + +
files

A character() with raw data filenames.

+

Value

-

A logical(n) where n == length(x) with TRUE if that +

A logical(n) where n == length(x) with TRUE if that files contains at least one spectrum, FALSE otherwise.

Author

Laurent Gatto

+

Examples

f <- msdata::proteomics(full.names = TRUE)[1:2]
@@ -105,12 +120,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/iPQF.html b/reference/iPQF.html index 1487ec13..823a8ca6 100644 --- a/reference/iPQF.html +++ b/reference/iPQF.html @@ -11,6 +11,8 @@ + +
+ + +
+

The iPQF spectra-to-protein summarisation method integrates peptide spectra characteristics and quantitative values for protein @@ -80,6 +89,7 @@

iPQF: iTRAQ (and TMT) Protein Quantification based on Features

See also combineFeatures for a more general overview of feature aggregation and examples.

+
iPQF(
   object,
@@ -90,37 +100,51 @@ 

iPQF: iTRAQ (and TMT) Protein Quantification based on Features

feature.weight = c(7, 6, 4, 3, 2, 1, 5)^2 )
+

Arguments

-
object
+ + +
object

An instance of class MSnSet containing absolute ion intensities.

+ +
groupBy

Vector defining spectra to protein matching. Generally, this is a feature variable such as fData(object)$accession.

+ +
low.support.filter

A logical specifying if proteins being supported by only 1-2 peptide spectra should be filtered out. Default is FALSE.

+ +
ratio.calc

Either "none" (don't calculate any ratios), "sum" (default), or a specific channel (one of sampleNames(object)) defining how to calculate relative peptides intensities.

+ +
method.combine

A logical defining whether to further use median polish to combine features.

+ +
feature.weight

Vector "numeric" giving weight to the different features. Default is the squared order of the features redundant -unique-distance metric, charge state, ion intensity, sequence length, identification score, modification state, and mass based on a robustness analysis.

+

Value

-

A matrix with estimated protein ratios.

+

A matrix with estimated protein ratios.

References

@@ -134,6 +158,7 @@

References

Author

Martina Fischer

+

Examples

data(msnset2)
@@ -167,12 +192,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/iTRAQ4.html b/reference/iTRAQ4.html index 1be6767d..4e447cff 100644 --- a/reference/iTRAQ4.html +++ b/reference/iTRAQ4.html @@ -9,6 +9,8 @@ + +
+ + +
+

This instance of class "ReporterIons" corresponds to the iTRAQ 4-plex set, i.e the 114, 115, 116 and 117 isobaric @@ -75,12 +85,14 @@

iTRAQ 4-plex set

MSMS spectra (see "Spectrum2") as well as for quantification (see quantify).

+
iTRAQ4
 iTRAQ5
 iTRAQ8
 iTRAQ9
+

References

Ross PL, Huang YN, Marchese JN, Williamson B, Parker K, Hattan S, @@ -95,6 +107,7 @@

References

See also

+

Examples

iTRAQ4
@@ -129,12 +142,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/imageNA2.html b/reference/imageNA2.html index 1bd72a44..ac2a897b 100644 --- a/reference/imageNA2.html +++ b/reference/imageNA2.html @@ -4,6 +4,8 @@ + +
+ + +
+

Produces a heatmap after reordring rows and columsn to highlight missing value patterns.

+
imageNA2(
   object,
@@ -77,43 +87,60 @@ 

NA heatmap visualisation for 2 groups

... )
+

Arguments

-
object
+ + +
object

An instance of class MSnSet

+ +
pcol

Either the name of a phenoData variable to be used to determine the group structure or a factor or any object that can be coerced as a factor of length equal to nrow(object). The resulting factor must have 2 levels. If missing (default) image(object) is called.

+ +
Rowv

Determines if and how the rows/features are reordered. If missing (default), rows are reordered according to order((nNA1 + 1)^2/(nNA2 + 1)), where NA1 and NA2 are the number of missing values in each group. Use a vector of numerics of feautre names to customise row order.

+ +
Colv

A logical that determines if columns/samples are reordered. Default is TRUE.

+ +
useGroupMean

Replace individual feature intensities by the group mean intensity. Default is FALSE.

+ +
plot

A logical specifying of an image should be produced. Default is TRUE.

+ +
...

Additional arguments passed to image.

+

Value

-

Used for its side effect of plotting. Invisibly returns +

Used for its side effect of plotting. Invisibly returns Rovw and Colv.

Author

Laurent Gatto, Samuel Wieczorek and Thomas Burger

+

Examples

library("pRolocdata")
@@ -138,12 +165,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/impute.html b/reference/impute.html index 99af3558..5e843690 100644 --- a/reference/impute.html +++ b/reference/impute.html @@ -10,6 +10,8 @@ + +
+ + +
+

The impute method performs data imputation on MSnSet instances using a variety of methods.

@@ -78,23 +87,33 @@

Quantitative proteomics data imputation

See MsCoreUtils::impute_matrix() for details on the different imputation methods available and strategies.

+
# S4 method for class 'MSnSet'
 impute(object, method, ...)
+

Arguments

-
object
+ + +
object

An MSnSet object with missing values to be imputed.

+ +
method

character(1) defining the imputation method. See MsCoreUtils::imputeMethods() for available ones. See MsCoreUtils::impute_matrix() for details.

+ +
...

Additional parameters passed to the inner imputation function. See MsCoreUtils::impute_matrix() for details.

+
+

Examples


@@ -134,7 +153,7 @@ 

Examples

#> experimentData: use 'experimentData(object)' #> Annotation: #> - - - Processing information - - - -#> Data imputation using min Wed May 15 16:30:20 2024 +#> Data imputation using min Wed Sep 11 07:30:25 2024 #> MSnbase version: 1.15.6 if (require("imputeLCMD")) { @@ -181,7 +200,7 @@

Examples

#> experimentData: use 'experimentData(object)' #> Annotation: #> - - - Processing information - - - -#> Data imputation using MinDet Wed May 15 16:30:20 2024 +#> Data imputation using MinDet Wed Sep 11 07:30:25 2024 #> MSnbase version: 1.15.6 if (require("norm")) @@ -205,7 +224,7 @@

Examples

#> experimentData: use 'experimentData(object)' #> Annotation: #> - - - Processing information - - - -#> Data imputation using MLE Wed May 15 16:30:21 2024 +#> Data imputation using MLE Wed Sep 11 07:30:26 2024 #> MSnbase version: 1.15.6 impute(naset, "mixed", @@ -228,7 +247,7 @@

Examples

#> experimentData: use 'experimentData(object)' #> Annotation: #> - - - Processing information - - - -#> Data imputation using mixed Wed May 15 16:30:21 2024 +#> Data imputation using mixed Wed Sep 11 07:30:26 2024 #> MSnbase version: 1.15.6 @@ -261,12 +280,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/index.html b/reference/index.html index 1ba22e77..a8fcbbe0 100644 --- a/reference/index.html +++ b/reference/index.html @@ -3,6 +3,8 @@ + +
+ + +
+

All functions

@@ -448,16 +457,27 @@

All functions

Export an MzTab object as mzTab file.

+
+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/isCentroidedFromFile.html b/reference/isCentroidedFromFile.html index 197edc68..5a8e5cdd 100644 --- a/reference/isCentroidedFromFile.html +++ b/reference/isCentroidedFromFile.html @@ -6,6 +6,8 @@ + +
+ + +
+

The function extracts the mode (profile or centroided) from the raw mass spectrometry file by parsing the mzML file directly. If the object x stems from any other type of file, NAs are returned.

+
isCentroidedFromFile(x)
+

Arguments

-
x
+ + +
x

An object of class OnDiskMSnExp.

+

Value

-

A named logical vector of the same length as x.

+

A named logical vector of the same length as x.

Details

@@ -93,6 +107,7 @@

Details

Author

Laurent Gatto

+

Examples

library("msdata")
@@ -111,12 +126,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/itraqdata.html b/reference/itraqdata.html index a4799e07..50b58456 100644 --- a/reference/itraqdata.html +++ b/reference/itraqdata.html @@ -1,5 +1,6 @@ Example MSnExp and MSnSet data sets — itraqdata • MSnbase -#> Set 150 values to NA Wed May 15 16:30:24 2024 +#> Set 150 values to NA Wed Sep 11 07:30:29 2024 #> MSnbase version: 1.17.12 sum(is.na(dunkleyNA)) #> [1] 150 @@ -151,7 +178,7 @@

Examples

dunkleyNA <- makeNaData(dunkley2006, nNA = 150, exclude = 1:10) processingData(dunkleyNA) #> - - - Processing information - - - -#> Set 150 values to NA Wed May 15 16:30:24 2024 +#> Set 150 values to NA Wed Sep 11 07:30:29 2024 #> (excluding 10 features) #> MSnbase version: 1.17.12 table(fData(dunkleyNA)$nNA[1:10]) @@ -173,9 +200,9 @@

Examples

#> Loaded on Thu Jul 16 22:53:08 2015. #> Normalised to sum of intensities. #> Added markers from 'mrk' marker vector. Thu Jul 16 22:53:08 2015 -#> Subset [689,16][100,5] Wed May 15 16:30:24 2024 +#> Subset [689,16][100,5] Wed Sep 11 07:30:29 2024 #> Set (1,2,3,4,5) NAs in (10,10,10,10,10) rows, -#> respectively Wed May 15 16:30:24 2024 +#> respectively Wed Sep 11 07:30:29 2024 #> MSnbase version: 1.17.12 (res <- table(fData(x)$nNA)) #> @@ -194,9 +221,9 @@

Examples

#> Loaded on Thu Jul 16 22:53:08 2015. #> Normalised to sum of intensities. #> Added markers from 'mrk' marker vector. Thu Jul 16 22:53:08 2015 -#> Subset [689,16][100,10] Wed May 15 16:30:24 2024 +#> Subset [689,16][100,10] Wed Sep 11 07:30:29 2024 #> Set (3,8,1,4) NAs in (5,12,11,8) rows, -#> respectively Wed May 15 16:30:24 2024 +#> respectively Wed Sep 11 07:30:29 2024 #> MSnbase version: 1.17.12 (res2 <- table(fData(x2)$nNA)) #> @@ -215,9 +242,9 @@

Examples

#> Loaded on Thu Jul 16 22:53:08 2015. #> Normalised to sum of intensities. #> Added markers from 'mrk' marker vector. Thu Jul 16 22:53:08 2015 -#> Subset [689,16][100,10] Wed May 15 16:30:24 2024 +#> Subset [689,16][100,10] Wed Sep 11 07:30:29 2024 #> Set (3,8,1,3) NAs in (5,12,11,8) rows, -#> respectively Wed May 15 16:30:24 2024 +#> respectively Wed Sep 11 07:30:29 2024 #> MSnbase version: 1.17.12 (res3 <- table(fData(x3)$nNA)) #> @@ -230,12 +257,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/meanMzInts.html b/reference/meanMzInts.html index 16b1f50d..247970df 100644 --- a/reference/meanMzInts.html +++ b/reference/meanMzInts.html @@ -9,6 +9,8 @@ + +
+ + +
+

Combine peaks from several spectra into a single spectrum. Intensity and m/z values from the input spectra are aggregated into a single peak if @@ -76,6 +85,7 @@

Combine a list of spectra to a single spectrum

values of grouped mass peaks are aggregated with the intensityFun, m/z values by the mean, or intensity weighted mean if weighted = TRUE.

+
meanMzInts(
   x,
@@ -89,33 +99,50 @@ 

Combine a list of spectra to a single spectrum

unionPeaks = TRUE )
+

Arguments

-
x
+ + +
x

list of Spectrum objects.

+ +
...

additional parameters that are passed to intensityFun.

+ +
intensityFun

function to aggregate the intensity values per m/z group. Should be a function or the name of a function. The function is expected to return a numeric(1).

+ +
weighted

logical(1) whether m/z values per m/z group should be aggregated with an intensity-weighted mean. The default is to report the mean m/z.

+ +
main

integer(1) defining the main spectrum, i.e. the spectrum which m/z and intensity values get replaced and is returned. By default the first spectrum in x is used.

+ +
mzd

numeric(1) defining the maximal m/z difference below which mass peaks are considered to represent the same ion/mass peak. Intensity values for such grouped mass peaks are aggregated. If not specified this value is estimated from the distribution of differences of m/z values from the provided spectra (see details).

+ +
ppm

numeric(1) allowing to perform a m/z dependent grouping of mass peaks. See details for more information.

+ +
timeDomain

logical(1) whether definition of the m/z values to be combined into one m/z is performed on m/z values @@ -124,15 +151,18 @@

Arguments

on the time domain (see details). Note that a pre-defined mzd should also be estimated on the square root of m/z values if timeDomain = TRUE.

+ +
unionPeaks

logical(1) whether the union of all peaks (peak groups) from all spectra are reported or only peak groups that contain peaks that are present in the main spectrum (defined by main). The default is to report the union of peaks from all spectra.

+

Value

-

Spectrum with m/z and intensity values representing the aggregated values +

Spectrum with m/z and intensity values representing the aggregated values across the provided spectra. The returned spectrum contains the union of all peaks from all spectra (if unionPeaks = TRUE), or the same number of m/z and intensity pairs than the spectrum with index main in x (if @@ -189,6 +219,7 @@

See also

Author

Johannes Rainer, Sigurdur Smarason

+

Examples


@@ -230,12 +261,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/missing-data.html b/reference/missing-data.html index a41c3be6..c0683879 100644 --- a/reference/missing-data.html +++ b/reference/missing-data.html @@ -1,5 +1,6 @@ Documenting missing data visualisation — missing-data • MSnbase + +
+ + +
+
+ +

There is a need for adequate handling of missing value impuation in quantitative proteomics. Before developing a framework to handle missing data imputation optimally, we propose a set of visualisation @@ -74,6 +87,8 @@

Documenting missing data visualisation

progress and ideas that will eventually materialise in exported functionality in the MSnbase package.

+ +

Details

The explore the structure of missing values, we propose to

@@ -97,6 +112,7 @@

Author

Laurent Gatto <lg390@cam.ac.uk>, Samuel Wieczorek and Thomas Burger

+

Examples

## Other suggestions
@@ -154,12 +170,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/mzRident2dfr.html b/reference/mzRident2dfr.html index de57abd7..56b2f13b 100644 --- a/reference/mzRident2dfr.html +++ b/reference/mzRident2dfr.html @@ -10,6 +10,8 @@ + +
+ + +
+

A function to convert the identification data contained in an mzRident object to a data.frame. Each row represents @@ -78,15 +87,20 @@

Coerce identification data to a data.frame

information pertaining a scan, use reduce.

+ +

Arguments

-
from
+ + +
from

An object of class mzRident defined in the mzR package.

+

Value

-

A data.frame

+

A data.frame

Details

@@ -97,6 +111,7 @@

Details

Author

Laurent Gatto

+

Examples

## find path to a mzIdentML file
@@ -151,12 +166,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/nFeatures.html b/reference/nFeatures.html index ef5521c7..65cbace7 100644 --- a/reference/nFeatures.html +++ b/reference/nFeatures.html @@ -5,6 +5,8 @@ + +
+ + +
+

This function computes the number of features in the group defined by the feature variable fcol and appends this information in the feature data of object.

+
nFeatures(object, fcol)
+

Arguments

-
object
+ + +
object

An instance of class MSnSet.

+ +
fcol

Feature variable defining the feature grouping structure.

+

Value

-

An updated MSnSet with a new feature variable +

An updated MSnSet with a new feature variable fcol.nFeatures.

Author

Laurent Gatto

+

Examples

library(pRolocdata)
@@ -114,12 +131,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/nQuants.html b/reference/nQuants.html index 29fbf803..08fb0a67 100644 --- a/reference/nQuants.html +++ b/reference/nQuants.html @@ -7,6 +7,8 @@ + +
+ + +
+

This function counts the number of quantified features, i.e non NA quantitation values, for each group of features @@ -72,23 +81,30 @@

Count the number of quantitfied features.

The group of features are defined by a feature variable names, i.e the name of a column of fData(object).

+
nQuants(x, groupBy)
+

Arguments

-
x
+ + +
x

An instance of class "MSnSet".

+ +
groupBy

An object of class factor defining how to summerise the features. (Note that this parameter was previously named fcol and referred to a feature variable label. This has been updated in version 1.19.12 for consistency with other functions.)

+

Value

-

A matrix of dimensions +

A matrix of dimensions length(levels(groupBy)) by ncol(x)

A matrix of dimensions length(levels(factor(fData(object)[, fcol]))) by @@ -110,6 +126,7 @@

Author

Laurent Gatto lg390@cam.ac.uk, Sebastian Gibb mail@sebastiangibb.de

+

Examples

data(msnset)
@@ -143,12 +160,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/naplot.html b/reference/naplot.html index da3aa8e2..e58a7906 100644 --- a/reference/naplot.html +++ b/reference/naplot.html @@ -4,6 +4,8 @@ + +
+ + +
+

Visualise missing values as a heatmap and barplots along the samples and features.

+
naplot(
   object,
@@ -75,30 +85,43 @@ 

Overview of missing value

... )
+

Arguments

-
object
+ + +
object

An object of class MSnSet.

+ +
verbose

If verbose (default is isMSnbaseVerbose()), print a table of missing values.

+ +
reorderRows

If reorderRows (default is TRUE) rows are ordered by number of NA.

+ +
reorderColumns

If reorderColumns (default is TRUE) columns are ordered by number of NA.

+ +
...

Additional parameters passed to image2.

+

Value

-

Used for its side effect. Invisibly returns NULL

+

Used for its side effect. Invisibly returns NULL

Author

Laurent Gatto

+

Examples

data(naset)
@@ -111,12 +134,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/navMS.html b/reference/navMS.html index 4d022465..46a59d11 100644 --- a/reference/navMS.html +++ b/reference/navMS.html @@ -4,6 +4,8 @@ + +
+ + +
+

Navigate an MSnExp object by moving to the next or previous spectrum.

+
navMS(i, object, msLevel, nav = c("nextMS", "prevMS"), ...)
 
@@ -73,25 +83,37 @@ 

Navigate an MSnExp object

prevMS(...)
+

Arguments

-
i
+ + +
i

The name or index of the current spectrum

+ +
object

The MSnExp object

+ +
msLevel

The MS level of the next or previous spectrum. If missing (default), then the level of the current spectrum is used.

+ +
nav

One of "nextMS" or "prevMS", to obtain the next or previous spectrum of level msLevel.

+ +
...

Additional parameters. Currently ignored.

+

Value

-

An object of class Spectrum1 or Spectrum2, +

An object of class Spectrum1 or Spectrum2, depending on the value of msLevel or NULL, of no spectrum is found.

@@ -99,6 +121,7 @@

Value

Author

Laurent Gatto

+

Examples

f <- msdata::proteomics(full.names = TRUE, pattern = "MS3")
@@ -154,12 +177,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/normToReference.html b/reference/normToReference.html index 3d868248..3579cee9 100644 --- a/reference/normToReference.html +++ b/reference/normToReference.html @@ -4,6 +4,8 @@ + +
+ + +
+

This function combines peptides into their proteins by normalising the intensity values to a reference run/sample for each protein.

+
normToReference(
   x,
@@ -73,21 +83,29 @@ 

Combine peptides into proteins.

reference = .referenceFractionValues(x = x, group = group) )
+

Arguments

-
x
+ + +
x

matrix, exprs matrix of an MSnSet object.

+ +
group

double or factor, grouping variable, i.e. protein accession; has to be of length equal nrow(x).

+ +
reference

double, vector of reference values, has to be of the same length as group and nrow(x).

+

Value

-

a matrix with one row per protein.

+

a matrix with one row per protein.

Details

@@ -124,6 +142,7 @@

See also

Author

Sebastian Gibb mail@sebastiangibb.de, Pavel Shliaha

+

Examples

library("MSnbase")
@@ -151,7 +170,7 @@ 

Examples

#> - - - Processing information - - - #> Data loaded: Wed May 11 18:54:39 2011 #> iTRAQ4 quantification by trapezoidation: Wed Apr 1 21:41:53 2015 -#> Combined 55 features into 40 using mean: Wed May 15 16:30:32 2024 +#> Combined 55 features into 40 using mean: Wed Sep 11 07:30:36 2024 #> MSnbase version: 2.31.1 # use a user-given reference @@ -177,7 +196,7 @@

Examples

#> - - - Processing information - - - #> Data loaded: Wed May 11 18:54:39 2011 #> iTRAQ4 quantification by trapezoidation: Wed Apr 1 21:41:53 2015 -#> Combined 55 features into 40 using mean: Wed May 15 16:30:32 2024 +#> Combined 55 features into 40 using mean: Wed Sep 11 07:30:37 2024 #> MSnbase version: 2.31.1
@@ -187,12 +206,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/normalise-methods.html b/reference/normalise-methods.html index 4fb08553..fd69a1d7 100644 --- a/reference/normalise-methods.html +++ b/reference/normalise-methods.html @@ -35,6 +35,8 @@ + +
+ + +
+

The normalise method (also available as normalize) performs basic normalisation on spectra @@ -127,39 +137,53 @@

Normalisation of MSnExp, MSnSet and Spectrum for "MSnSet" instances. See ?base::scale for details.

+ +

Arguments

-
object
+

+
object

An object of class "Spectrum", "Spectrum2", "MSnExp" or "MSnSet".

+
method

A character vector of length one that describes how to normalise the object. See description for details.

+
...

Additional arguments passed to the normalisation function.

+

Methods

The normalise methods:

signature(object = "MSnSet", method = "character")

Normalises the object reporter ions intensities using method.

+
signature(object = "MSnExp", method = "character")

Normalises the object peak intensities using method.

+
signature(object = "Spectrum", method = "character")

Normalises the object peak intensities using method.

+
signature(object = "Spectrum2", method = "character", precursorIntensity)

Normalises the object peak intensities using method. If method == "precursor", precursorIntensity allows to specify the intensity of the precursor manually.

+ +

The scale method:

signature(x = "MSnSet", center = "logical", scale = "logical")

See ?base::scale.

+ +
+

Examples

## quantifying full experiment
@@ -183,7 +207,7 @@ 

Examples

#> - - - Processing information - - - #> Data loaded: Wed May 11 18:54:39 2011 #> iTRAQ4 quantification by trapezoidation: Wed Apr 1 21:41:53 2015 -#> Normalised (quantiles): Wed May 15 16:30:32 2024 +#> Normalised (quantiles): Wed Sep 11 07:30:37 2024 #> MSnbase version: 1.1.22
@@ -192,12 +216,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/npcv.html b/reference/npcv.html index b9a71855..00286e7b 100644 --- a/reference/npcv.html +++ b/reference/npcv.html @@ -6,6 +6,8 @@ + +
+ + +
+

Calculates a non-parametric version of the coefficient of variation where the standard deviation is replaced by the median absolute deviations (see mad for details) and divided by the absolute value of the mean.

+
npcv(x, na.rm = TRUE)
+

Arguments

-
x
+ + +
x

A numeric.

+ +
na.rm

A logical (default is TRUE indicating whether NA values should be stripped before the computation of the median absolute deviation and mean.

+

Value

-

A numeric.

+

A numeric.

Details

@@ -95,6 +111,7 @@

Details

Author

Laurent Gatto

+

Examples

set.seed(1)
@@ -116,12 +133,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/pSet-class.html b/reference/pSet-class.html index 2c8172bc..4adcf2da 100644 --- a/reference/pSet-class.html +++ b/reference/pSet-class.html @@ -7,6 +7,8 @@ + +
+ + +
+

Container for high-throughput mass-spectrometry assays and experimental metadata. This class is based on Biobase's @@ -71,6 +81,8 @@

Class to Contain Raw Mass-Spectrometry Assays and Experimental Metadata

that 'assayData' slot is an environment contain objects of class "Spectrum".

+ +

Objects from the Class

A virtual Class: No objects may be created from it. @@ -82,12 +94,14 @@

Slots

Object of class "environment" containing the MS spectra (see "Spectrum1" and "Spectrum2").

+
phenoData:

Object of class "AnnotatedDataFrame" containing experimenter-supplied variables describing sample (i.e the individual tags for an labelled MS experiment) See phenoData for more details.

+
featureData:

Object of class "AnnotatedDataFrame" containing variables @@ -95,25 +109,32 @@

Slots

peptide sequence, identification score,... (inherited from "eSet"). See featureData for more details.

+
experimentData:

Object of class "MIAPE", containing details of experimental methods. See experimentData for more details.

+
protocolData:

Object of class "AnnotatedDataFrame" containing equipment-generated variables (inherited from "eSet"). See protocolData for more details.

+
processingData:

Object of class "MSnProcess" that records all processing.

+
.cache:

Object of class environment used to cache data. Under development.

+
.__classVersion__:

Object of class "Versions" describing the versions of the class.

+ +

Extends

@@ -127,168 +148,219 @@

Methods

[

signature(x = "pSet"): Subset current object and return object of same class.

+
[[

signature(x = "pSet"): Direct access to individual spectra.

+
$

signature(x = "pSet"): directly access a specific sample annotation column from the pData.

+
$<-

signature(x = "pSet"): replace or add a sample annotation column in the pData.

+
abstract

Access abstract in experimentData.

+
assayData

signature(object = "pSet"): Access the assayData slot. Returns an environment.

+
desciption

signature(x = "pSet"): Synonymous with experimentData.

+
dim

signature(x = "pSet"): Returns the dimensions of the phenoData slot.

+
experimentData

signature(x = "pSet"): Access details of experimental methods.

+
featureData

signature(x = "pSet"): Access the featureData slot.

+
fData

signature(x = "pSet"): Access feature data information.

+
featureNames

signature(x = "pSet"): Coordinate access of feature names (e.g spectra, peptides or proteins) in assayData slot.

+
fileNames

signature(object = "pSet"): Access file names in the processingData slot.

+
fromFile

signature(object = "pSet"): Access raw data file indexes (to be found in the processingData slot) from which the individual object's spectra where read from.

+
centroided

signature(object = "pSet"): Indicates whether individual spectra are centroided ('TRUE') of uncentroided ('FALSE'). Use centroided(object) <- value to update a whole experiment, ensuring that object and value have the same length.

+
smoothed

signature(object = "pSet"): Indicates whether individual spectra are smoothed ('TRUE') of unsmoothed ('FALSE'). Use smoothed(object) <- value to update a whole experiment, ensuring that object and value have the same length.

+
fvarMetadata

signature(x = "pSet"): Access metadata describing features reported in fData.

+
fvarLabels

signature(x = "pSet"): Access variable labels in featureData.

+
length

signature(x = "pSet"): Returns the number of features in the assayData slot.

+
notes

signature(x = "pSet"): Retrieve and unstructured notes associated with pSet in the experimentData slot.

+
pData

signature(x = "pSet"): Access sample data information.

+
pData<-

signature(x = "pSet", value): Replace sample data information with value, value being a data.frame.

+
phenoData

signature(x = "pSet"): Access the phenoData slot.

+
phenoData<-

signature(x = "pSet", value): Replace sample data information with value. value can be a data.frame or an AnnotatedDataFrame.

+
processingData

signature(object = "pSet"): Access the processingData slot.

+
protocolData

signature(x = "pSet"): Access the protocolData slot.

+
pubMedIds

signature(x = "pSet"): Access PMIDs in experimentData.

+
sampleNames

signature(x = "pSet"): Access sample names in phenoData. A replacement method is also available.

+
spectra

signature(x = "pSet", ...): Access the assayData slot, returning the features as a list. Additional arguments are currently ignored.

+
varMetadata

signature(x = "pSet"): Access metadata describing variables reported in pData.

+
varLabels

signature(x = "pSet"): Access variable labels in phenoData.

+
acquisitionNum

signature(object = "pSet"): Accessor for spectra acquisition numbers.

+
scanIndex

signature(object = "pSet"): Accessor for spectra scan indices.

+
collisionEnergy

signature(object = "pSet"): Accessor for MS2 spectra collision energies.

+
intensity

signature(object = "pSet", ...): Accessor for spectra instenities, returned as named list. Additional arguments are currently ignored.

+
msInfo

signature(object = "pSet"): Prints the MIAPE-MS meta-data stored in the experimentData slot.

+
msLevel

signature(object = "pSet"): Accessor for spectra MS levels.

+
mz

signature(object = "pSet", ...): Accessor for spectra M/Z values, returned as a named list. Additional arguments are currently ignored.

+
peaksCount

signature(object = "pSet"): Accessor for spectra preak counts.

+
peaksCount

signature(object = "pSet", scans = "numeric"): Accessor to scans spectra preak counts.

+
polarity

signature(object = "pSet"): Accessor for MS1 spectra polarities.

+
precursorCharge

signature(object = "pSet"): Accessor for MS2 precursor charges.

+
precursorIntensity

signature(object = "pSet"): Accessor for MS2 precursor intensity.

+
precursorMz

signature(object = "pSet"): Accessor for MS2 precursor M/Z values.

+
precAcquisitionNum

signature(object = "pSet"): Accessor for MS2 precursor scan numbers.

+
precScanNum

see precAcquisitionNum.

+
rtime

signature(object = "pSet", ...): Accessor for spectra retention times. Additional arguments are currently ignored.

+
tic

signature(object = "pSet", ...): Accessor for spectra total ion counts. Additional arguments are currently ignored.

+
ionCount

signature(object = "pSet"): Accessor for spectra total ion current.

+
header

signature(object = "pSet"): Returns a data frame containing all available spectra parameters (MSn only).

+
header

signature(object = "pSet", scans = "numeric"): Returns a data frame containing scans spectra parameters (MSn only).

+
spectrapply

spectrapply(signature(object = "pSet"), FUN = NULL, BPPARAM = bpparam(), ...): applies the function FUN to each @@ -298,16 +370,23 @@

Methods

BPPARAM allows to specify how and if parallel processing should be enabled.

Returns a list with the result for each of spectrum.

+ +
isolationWindowLowerMz

isolationWindowLowerMz(object = "pSet"): return the lower m/z boundary for the isolation window. Note that this method is at present only available for OnDiskMSnExp objects.

+ +
isolationWindowUpperMz

isolationWindowUpperMz(object = "pSet"): return the upper m/z boundary for the isolation window. Note that this method is at present only available for OnDiskMSnExp objects.

+ + +

Additional accessors for the experimental metadata (experimentData slot) are defined. See "MIAPE" for details.

@@ -325,6 +404,7 @@

See also

"MSnExp" for an instantiatable application of pSet.

+

Examples

showClass("pSet")
@@ -353,12 +433,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/pickPeaks-method.html b/reference/pickPeaks-method.html index 701c8570..a1dd2e8c 100644 --- a/reference/pickPeaks-method.html +++ b/reference/pickPeaks-method.html @@ -30,6 +30,8 @@ + +
+ + +
+

This method performs a peak picking on individual spectra (Spectrum instances) or whole experiments (MSnExp instances) to @@ -117,6 +127,8 @@

Peak Detection for 'MSnExp' or 'Spectrum' instances

By default (refineMz = "none", simply the m/z of the largest signal (the identified centroid) is reported. See below for examples.

+ +

Methods

signature(x = "MSnExp", halfWindowSize = "integer", @@ -145,12 +157,15 @@

Methods

description above for more details.

This method displays a progress bar if verbose = TRUE. Returns an MSnExp instance with centroided spectra.

+
signature(x = "Spectrum", method = "character", halfWindowSize = "integer", ...)

Performs the peak picking for the spectrum (Spectrum instance). This method is the same as above but returns a centroided Spectrum instead of an MSnExp object. It has no verbose argument. Please read the details for the above MSnExp method.

+ +

Author

@@ -170,6 +185,7 @@

References

Bioinformatics 28: 2270-2271. http://strimmerlab.org/software/maldiquant/

+

Examples

sp1 <- new("Spectrum1",
@@ -186,11 +202,11 @@ 

Examples

#> - - - Processing information - - - #> Data loaded: Wed May 11 18:54:39 2011 #> Updated from version 0.3.0 to 0.3.1 [Fri Jul 8 20:23:25 2016] -#> peak picking: MAD noise estimation and none centroid m/z refinement on spectra of MS level(s)2 [Wed May 15 16:30:33 2024] -#> peak picking: SuperSmoother noise estimation and kNeighbors centroid m/z refinement on spectra of MS level(s)2 [Wed May 15 16:30:33 2024] -#> peak picking: MAD noise estimation and kNeighbours centroid m/z refinement on spectra of MS level(s)2 [Wed May 15 16:30:33 2024] -#> peak picking: SuperSmoother noise estimation and descendPeak centroid m/z refinement on spectra of MS level(s)2 [Wed May 15 16:30:33 2024] -#> Spectra centroided: Wed May 15 16:30:33 2024 +#> peak picking: MAD noise estimation and none centroid m/z refinement on spectra of MS level(s)2 [Wed Sep 11 07:30:38 2024] +#> peak picking: SuperSmoother noise estimation and kNeighbors centroid m/z refinement on spectra of MS level(s)2 [Wed Sep 11 07:30:38 2024] +#> peak picking: MAD noise estimation and kNeighbours centroid m/z refinement on spectra of MS level(s)2 [Wed Sep 11 07:30:38 2024] +#> peak picking: SuperSmoother noise estimation and descendPeak centroid m/z refinement on spectra of MS level(s)2 [Wed Sep 11 07:30:38 2024] +#> Spectra centroided: Wed Sep 11 07:30:38 2024 #> MSnbase version: 1.1.22 @@ -219,12 +235,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/plot-methods.html b/reference/plot-methods.html index 00a0a3ee..38402d2f 100644 --- a/reference/plot-methods.html +++ b/reference/plot-methods.html @@ -1,5 +1,6 @@ Plotting 'MSnExp' and 'Spectrum' object(s) — plot-methods • MSnbase + +
+ + +
+
+ +

These methods provide the functionality to plot mass spectrometry data provided as MSnExp, OnDiskMSnExp or Spectrum @@ -100,37 +113,58 @@

Plotting 'MSnExp' and 'Spectrum' object(s)

expected fragement ions are calculated and matched/annotated on the spectum plot.

+ +

Arguments

-
x
+ + +

+
x

Objects of class "Spectrum", "Spectrum2" or "MSnExp" to be plotted.

+ +
y

Missing, "Spectrum" or "character".

+ +
reporters

An object of class "ReporterIons" that defines the peaks to be plotted. If not specified, full must be set to 'TRUE'.

+ +
full

Logical indicating whether full spectrum (respectively spectra) of only reporter ions of interest should be plotted. Default is 'FALSE', in which case reporters must be defined.

+ +
centroided.

Logical indicating if spectrum or spectra are in centroided mode, in which case peaks are plotted as histograms, rather than curves.

+ +
plot

Logical specifying whether plot should be printed to current device. Default is 'TRUE'.

+ +
w1

Width of sticks for full centroided spectra. Default is to use maximum MZ value divided by 500.

+ +
w2

Width of histogram bars for centroided reporter ions plots. Default is 0.01.

+ +

See below for more details.

@@ -139,6 +173,7 @@

Methods

type = c("spectra", "XIC"), reporters = "ReporterIons", full = "logical", plot = "logical", ...)
+

For type = "spectra": Plots all the spectra in the MSnExp object vertically. One of reporters must be defined or full set to 'TRUE'. In case of MSnExp @@ -160,21 +195,32 @@

Methods

Additional arguments for type = "XIC" are:

col

color for the border of the points. Defaults to col = "grey".

+ +
colramp

color function/ramp to be used for the intensity-dependent background color of data points. Defaults to colramp = topo.colors.

+ +
grid.color

color for the grid lines. Defaults to grid.color = "lightgrey"; use grid.color = NA to disable grid lines altogether.

+ +
pch

point character. Defaults to pch = 21

. +
...

additional parameters for the low-level plot function.

+ + +

+
plot(signature(x = "Spectrum", y = "missing"), reporters = "ReporterIons", full = "logical", centroided. = "logical", plot = "logical", w1, w2)
@@ -186,6 +232,8 @@

Methods

"Spectrum2" objects. Full "Spectrum1" spectra are plotted by default.

+ +
plot(signature(x = "Spectrum2", y = "character"), orientation = "numeric", add = "logical", col = "character", pch, xlab = "character", ylab = "character", xlim = "numeric", ylim = @@ -204,6 +252,9 @@

Methods

fragments=MSnbase:::calculateFragments_Spectrum2 and fragments.cex=0.75. Additional arguments ... are passed to plot.default.

+ + +

See also

@@ -216,6 +267,7 @@

See also

Author

Laurent Gatto <lg390@cam.ac.uk>, Johannes Rainer and Sebastian Gibb

+

Examples

data(itraqdata)
@@ -253,12 +305,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/plot2d-methods.html b/reference/plot2d-methods.html index 6148a54c..eedcaf02 100644 --- a/reference/plot2d-methods.html +++ b/reference/plot2d-methods.html @@ -8,6 +8,8 @@ + +
+ + +
+

These methods plot the retention time vs. precursor MZ for the whole "MSnExp" experiment. Individual dots will be @@ -73,33 +83,43 @@

The 'plot2d' method for 'MSnExp' quality assessment

The methods make use the ggplot2 system. An object of class 'ggplot' is returned invisibly.

+ +

Arguments

-
object
+

+
object

An object of class "MSnExp" or a data.frame. In the latter case, the data frame must have numerical columns named 'retention.time' and 'precursor.mz' and one of 'tic', 'file', 'peaks.count' or 'charge', depending on the z parameter. Such a data frame is typically generated using the header method on "MSnExp" object.

+
z

A character indicating according to what variable to colour the dots. One of, possibly abreviated, "ionCount" (total ion count), "file" (raw data file), "peaks.count" (peaks count) or "charge" (precursor charge).

+
alpha

Numeric [0,1] indicating transparence level of points.

+
plot

A logical indicating whether the plot should be printed (default is 'TRUE').

+

Methods

signature(object = "MSnExp", ...)

Plots a 'MSnExp' summary.

+
signature(object = "data.frame", ...)

Plots a summary of the 'MSnExp' experiment described by the data frame.

+ +

See also

@@ -110,6 +130,7 @@

See also

Author

Laurent Gatto <lg390@cam.ac.uk>

+

Examples

itraqdata
@@ -150,12 +171,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/plotDensity-methods.html b/reference/plotDensity-methods.html index cc44a5c2..9621049a 100644 --- a/reference/plotDensity-methods.html +++ b/reference/plotDensity-methods.html @@ -7,6 +7,8 @@ + +
+ + +
+

These methods plot the distribution of several parameters of interest for the different precursor charges for "MSnExp" @@ -71,33 +81,43 @@

The 'plotDensity' method for 'MSnExp' quality assessment

The methods make use the ggplot2 system. An object of class 'ggplot' is returned invisibly.

+ +

Arguments

-
object
+

+
object

An object of class "MSnExp" or and 'data.frame'. In the latter case, the data frame must have numerical columns named 'charge' and one of 'precursor.mz', 'peaks.count' or 'ionCount', depending on the z parameter. Such a data frame is typically generated using the header method on "MSnExp" object.

+
z

A character indicating which parameter's densitiy to plot. One of, possibly abreviated, "ionCount" (total ion count), "peaks.count" (peaks count) or "precursor.mz" (precursor MZ).

+
log

Logical, whether to log transform the data (default is 'FALSE').

+
plot

A logical indicating whether the plot should be printed (default is 'TRUE').

+

Methods

signature(object = "MSnExp", ...)

Plots a 'MSnExp' summary.

+
signature(object = "data.frame", ...)

Plots a summary of the 'MSnExp' experiment described by the data frame.

+ +

See also

@@ -108,6 +128,7 @@

See also

Author

Laurent Gatto <lg390@cam.ac.uk>

+

Examples

itraqdata
@@ -151,12 +172,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/plotMzDelta-methods.html b/reference/plotMzDelta-methods.html index 9f6d3217..6195774b 100644 --- a/reference/plotMzDelta-methods.html +++ b/reference/plotMzDelta-methods.html @@ -27,6 +27,8 @@ + +
+ + +
+

The m/z delta plot illustrates the suitability of MS2 spectra for identification by plotting the m/z differences of the most intense @@ -111,58 +121,75 @@

The delta m/z plot

Most of the code for plotMzDelta has kindly been contributed by Guangchuang Yu.

+ +

Arguments

-
object
+

+
object

An object of class MSnExp or mzRramp (from the mzR package) containing MS2 spectra.

+
reporters

An object of class class "ReporterIons" that defines which reporter ion peaks to set to 0. The default value NULL leaves the spectra as they are.

+
subset

A numeric between 0 and 1 to use a subset of object's MS2 spectra.

+
percentage

The percentage of most intense peaks to be used for the plot. Default is 0.1.

+
precMz

A numeric of length one or NULL default. In the latter (and preferred) case, the precursor m/z values are extracted from the individual MS2 spectra using the precursorMz method.

+
precMzWidth

A numeric of length 1 that specifies the width around the precursor m/z where peaks are set to 0. Default is 2.

+
bw

A numeric specifying the bandwith to be used to bin the delta m/z value to plot the histogram. Default if 1. See geom_histogram for more details.

+
xlim

A numeric of length 2 specifying the range of delta m/z to plot on the histogram. Default is c(40,200).

+
withLabels

A logical defining if amino acid residue labels are plotted on the figure. Default is TRUE.

+
size

A numeric of length 1 specifying the font size of amino acids lables. Default is 2.5.

+
plot

A logical of length 1 that defines whether the figure should be plotted on the active device. Default is TRUE. Note that the ggplot object is always returned invisibly.

+
verbose

A logical of length 1 specifying whether textual output and a progress bar illustration the progress of data processing should be printed. Default is TRUE

+

Methods

signature(object = "MSnExp", ...)

Plots and (invisibly) returns the m/z delta histogram.

+ +

See also

@@ -181,6 +208,7 @@

References

Author

Laurent Gatto <lg390@cam.ac.uk> and Guangchuang Yu

+

Examples

mzdplot <- plotMzDelta(itraqdata,
@@ -216,12 +244,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/plotNA-methods.html b/reference/plotNA-methods.html index 1050bb84..44447182 100644 --- a/reference/plotNA-methods.html +++ b/reference/plotNA-methods.html @@ -12,6 +12,8 @@ + +
+ + +
+

These methods produce plots that illustrate missing data.

is.na returns the expression matrix of it MSnSet @@ -81,6 +91,8 @@

Exploring missing data in 'MSnSet' instances

The methods make use the ggplot2 system. An object of class 'ggplot' is returned invisibly.

+ +

Methods

is.na
@@ -88,6 +100,7 @@

Methods

Returns the a matrix of logicals of dimensions dim(x) specifiying if respective values are missing in the MSnSet's expression matrix.

+
plotNA

signature(object = "MSnSet", pNA = "numeric") Plots missing data for an MSnSet instance. pNA is a @@ -96,6 +109,8 @@

Methods

highlighted with a point on the figure, illustrating the overall percentage of NA values in the full data set and the number of proteins retained. Default is 1/2.

+ +

Author

@@ -106,6 +121,7 @@

See also

See also the filterNA method to filter out features with a specified proportion if missing values.

+

Examples

data(msnset)
@@ -135,12 +151,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/plotSpectrumSpectrum-methods.html b/reference/plotSpectrumSpectrum-methods.html index 42ca6d93..8c2ac3be 100644 --- a/reference/plotSpectrumSpectrum-methods.html +++ b/reference/plotSpectrumSpectrum-methods.html @@ -7,6 +7,8 @@ + +
+ + +
+

These method plot mass spectra MZ values against the intensities as line plots. The first spectrum is plotted in the upper panel and the other in @@ -71,14 +81,20 @@

Plotting a 'Spectrum' vs another 'Spectrum' object.

colour. If a peptide sequence is provided it automatically calculates and labels the fragments.

+ +

Arguments

-
x
+

+
x

Object of class "Spectrum" .

+
y

Object of class "Spectrum" .

+
...

Further arguments passed to internal functions.

+

Methods

@@ -112,6 +128,8 @@

Methods

peaks.cex=0.5 of the peaks. The size of the fragment/legend labels could be set using fragments.cex=0.75 or legend.cex respectively. See par for details about graphical parameters in general.

+ +

Author

@@ -122,6 +140,7 @@

See also

More spectrum plotting available in plot.Spectrum.

More details about fragment calculation: calculateFragments.

+

Examples

## find path to a mzXML file
@@ -161,12 +180,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/precSelection.html b/reference/precSelection.html index 70955bdf..e63324aa 100644 --- a/reference/precSelection.html +++ b/reference/precSelection.html @@ -12,6 +12,8 @@ + +
+ + +
+

precSelection computes the number of selection events each precursor ions has undergone in an tandem MS experiment. This will be @@ -81,27 +91,32 @@

Number of precursor selection events

precSelectionTable is a wrapper around precSelection and returns a table with the number of single, 2-fold, ... selection events.

+
precSelection(object,n)
+

Arguments

-
object
+

+
object

An instane of class "MSnExp".

+
n

The number of decimal places to round the precursor MZ to. Is passed to the round function.

+

Value

-

A named integer in case of precSelection and a table for

-

-

precSelectionTable.

+

A named integer in case of precSelection and a table for + precSelectionTable.

Author

Laurent Gatto <lg390@cam.ac.uk>

+

Examples

precSelection(itraqdata)
@@ -150,12 +165,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/purityCorrect-methods.html b/reference/purityCorrect-methods.html index 5d0fe2fa..cdf65d75 100644 --- a/reference/purityCorrect-methods.html +++ b/reference/purityCorrect-methods.html @@ -31,6 +31,8 @@ + +
+ + +
+

Manufacturers sometimes provide purity correction values indicating the percentages of each reporter ion that have masses differing by @@ -119,15 +129,21 @@

Performs reporter ions purity correction

If edit = TRUE, the the matrix can be edited before it is returned.

+ +

Methods

signature(object = "MSnSet", impurities = "matrix")

+ +

Arguments

-
object
+

+
object

An object of class "MSnSet".

+
impurities

A square 'matrix' of dim equal to ncol(object) defining the correction coefficients to be applied. @@ -148,7 +164,9 @@

Arguments

.126127N127C128N128C129N129C130N130C131
% reporter 1260.9500.0000.0500.0000.0000.0000.0000.0000.0000.000
% reporter 127N0.0000.9400.0000.0580.0000.0000.0000.0000.0000.000
% reporter 127C0.0030.0000.9490.0000.0480.0000.0000.0000.0000.000
% reporter 128N0.0000.0040.0000.9550.0000.0410.0000.0000.0000.000
% reporter 128C0.0000.0000.0060.0000.9640.0000.0300.0000.0000.000
% reporter 129N0.0000.0000.0000.0080.0000.9570.0000.0350.0000.000
% reporter 129C0.0000.0000.0000.0000.0140.0000.9620.0000.0240.000
% reporter 130N0.0000.0000.0000.0010.0000.0150.0000.9280.0000.024
% reporter 130C0.0000.0000.0000.0000.0000.0000.0170.0000.9650.000
% reporter 1310.0000.0000.0000.0000.0000.0020.0000.0200.0000.956

These examples are provided as defaults impurity correction matrices in makeImpuritiesMatrix.

+
+

Examples

## quantifying full experiment
@@ -159,7 +177,7 @@ 

Examples

0.000,0.001,0.040,0.923), nrow=4, byrow = TRUE) ## or, using makeImpuritiesMatrix() -if (FALSE) impurities <- makeImpuritiesMatrix(4) +if (FALSE) impurities <- makeImpuritiesMatrix(4) # \dontrun{} msnset.crct <- purityCorrect(msnset, impurities) head(exprs(msnset)) #> iTRAQ4.114 iTRAQ4.115 iTRAQ4.116 iTRAQ4.117 @@ -181,7 +199,7 @@

Examples

#> - - - Processing information - - - #> Data loaded: Wed May 11 18:54:39 2011 #> iTRAQ4 quantification by trapezoidation: Wed Apr 1 21:41:53 2015 -#> Purity corrected: Wed May 15 16:30:43 2024 +#> Purity corrected: Wed Sep 11 07:30:46 2024 #> MSnbase version: 1.1.22 ## default impurity matrix for iTRAQ 8-plex @@ -216,12 +234,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/quantify-methods.html b/reference/quantify-methods.html index 71a262bf..0272b6ee 100644 --- a/reference/quantify-methods.html +++ b/reference/quantify-methods.html @@ -14,6 +14,8 @@ + +
+ + +
+

This method quantifies individual "Spectrum" objects or full "MSnExp" experiments. Current, @@ -85,11 +95,16 @@

Quantifies 'MSnExp' and 'Spectrum' objects

BiocParallel package and controlled by the BPPARAM argument.

+ +

Arguments

-
object
+

+
object

An instance of class "Spectrum" (isobaric tagging only) or "MSnExp".

+ +
method

Peak quantitation method. For isobaric tags, one of, possibly abreviated "trapezoidation", "max", or @@ -105,9 +120,13 @@

Arguments

as input to combineFeatures to implement spectra counting.

+ +
reporters

An instance of class "ReporterIons" that defines the peak(s) to be quantified. For isobaric tagging only.

+ +
strict

For isobaric tagging only. If strict is FALSE (default), the quantitation is performed using data points along the entire width @@ -115,6 +134,8 @@

Arguments

identified, only data points within apex +/- width of reporter (see "ReporterIons") are used for quantitation.

+ +
BPPARAM

Support for parallel processing using the BiocParallel infrastructure. When missing (default), the default registered @@ -123,20 +144,34 @@

Arguments

BiocParallelParam parameter instance: SnowParam, MulticoreParam, DoparParam, ... see the BiocParallel package for details.

+ +
parallel

Deprecated. Please see BPPARAM.

+ +
qual

Should the qual slot be populated. Default is TRUE.

+ +
pepseq

A character giving the peptide sequence column in the feature data. Default is "sequence".

+ + +
verbose

Verbose of the output (only for MSnExp objects).

+ +
...

Further arguments passed to the quantitation functions.

+

Details

+ +

"ReporterIons" define specific MZ at which peaks are expected and a window around that MZ value. A peak of interest is searched for in that window. Since version 1.1.2, warnings are not @@ -164,6 +199,7 @@

Methods

signature(object = "MSnExp", method = "character", reporters = "ReporterIons", verbose = "logical", ...)
+

For isobaric tagging, quantifies peaks defined in reporters using method in all spectra of the MSnExp object. If verbose is set to TRUE, a progress bar will be displayed.

@@ -179,9 +215,12 @@

Methods

containing the quantified feature expression and all meta data inherited from the MSnExp object argument.

+ +
signature(object = "Spectrum", method = "character", reporters = "ReporterIons")
+

Quantifies peaks defined in reporters using method in the Spectrum object (isobaric tagging only).

A list of length 2 will be returned. The first element, named @@ -197,9 +236,13 @@

Methods

('reporter') and precursor MZ value ('precursor') when available.

+ +

References

+ +

For details about the spectral index (SI), see Griffin NM, Yu J, Long F, Oh P, Shore S, Li Y, Koziol JA, Schnitzer JE. Label-free, normalized quantification of complex mass spectrometry data for @@ -217,6 +260,7 @@

Author

Laurent Gatto <lg390@cam.ac.uk> and Sebastian Gibb <mail@sebastiangibb.de>

+

Examples


@@ -241,7 +285,7 @@ 

Examples

#> - - - Processing information - - - #> Data loaded: Wed May 11 18:54:39 2011 #> Updated from version 0.3.0 to 0.3.1 [Fri Jul 8 20:23:25 2016] -#> iTRAQ4 quantification by trapezoidation: Wed May 15 16:30:44 2024 +#> iTRAQ4 quantification by trapezoidation: Wed Sep 11 07:30:47 2024 #> MSnbase version: 1.1.22 ## specifying a custom parallel framework @@ -278,11 +322,11 @@

Examples

si <- quantify(msexp, method = "SIn") processingData(si) #> - - - Processing information - - - -#> Data loaded: Wed May 15 16:30:45 2024 -#> Filtered 2 unidentified peptides out [Wed May 15 16:30:45 2024] -#> Quantitation by total ion current [Wed May 15 16:30:45 2024] -#> Combined 3 features into 3 using sum: Wed May 15 16:30:45 2024 -#> Quantification by SIn [Wed May 15 16:30:45 2024] +#> Data loaded: Wed Sep 11 07:30:48 2024 +#> Filtered 2 unidentified peptides out [Wed Sep 11 07:30:48 2024] +#> Quantitation by total ion current [Wed Sep 11 07:30:48 2024] +#> Combined 3 features into 3 using sum: Wed Sep 11 07:30:48 2024 +#> Quantification by SIn [Wed Sep 11 07:30:48 2024] #> MSnbase version: 2.31.1 exprs(si) #> dummyiTRAQ.mzXML @@ -293,12 +337,12 @@

Examples

saf <- quantify(msexp, method = "NSAF") processingData(saf) #> - - - Processing information - - - -#> Data loaded: Wed May 15 16:30:45 2024 -#> Filtered 2 unidentified peptides out [Wed May 15 16:30:45 2024] -#> Filtered 0 unidentified peptides out [Wed May 15 16:30:45 2024] -#> Quantitation by count [Wed May 15 16:30:45 2024] -#> Combined 3 features into 3 using user-defined function: Wed May 15 16:30:45 2024 -#> Quantification by NSAF [Wed May 15 16:30:45 2024] +#> Data loaded: Wed Sep 11 07:30:48 2024 +#> Filtered 2 unidentified peptides out [Wed Sep 11 07:30:48 2024] +#> Filtered 0 unidentified peptides out [Wed Sep 11 07:30:48 2024] +#> Quantitation by count [Wed Sep 11 07:30:49 2024] +#> Combined 3 features into 3 using user-defined function: Wed Sep 11 07:30:49 2024 +#> Quantification by NSAF [Wed Sep 11 07:30:49 2024] #> MSnbase version: 2.31.1 exprs(saf) #> dummyiTRAQ.mzXML @@ -313,12 +357,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/readMSData.html b/reference/readMSData.html index 88883f0f..31f31a73 100644 --- a/reference/readMSData.html +++ b/reference/readMSData.html @@ -6,6 +6,8 @@ + +
+ + +
+

Reads as set of XML-based mass-spectrometry data files and generates an MSnExp object. This function uses the functionality provided by the mzR package to access data and meta data in mzData, mzXML and mzML.

+
readMSData(
   files,
@@ -82,22 +92,33 @@ 

Imports mass-spectrometry raw data files as 'MSnExp' instances.

mode = c("inMemory", "onDisk") )
+

Arguments

-
files
+ + +
files

A character with file names to be read and parsed.

+ +
pdata

An object of class AnnotatedDataFrame or NULL (default).

+ +
msLevel.

MS level spectra to be read. In inMemory mode, use 1 for MS1 spectra or any larger numeric for MSn spectra. Default is 2 for InMemory mode. onDisk mode supports multiple levels and will, by default, read all the data.

+ +
verbose

Verbosity flag. Default is to use isMSnbaseVerbose().

+ +
centroided.

A logical, indicating whether spectra are centroided or not. Default is NA in which case the information @@ -106,22 +127,29 @@

Arguments

vector of logicals, where the first element is for MS1, the second element is for MS2, ... See OnDiskMSnExp for an example.

+ +
smoothed.

A logical indicating whether spectra already smoothed or not. Default is NA.

+ +
cache.

Numeric indicating caching level. Default is 0 for MS1 and 1 MS2 (or higher). Only relevant for inMemory mode.

+ +
mode

On of "inMemory" (default) or "onDisk". The former loads the raw data in memory, while the latter only generates the object and the raw data is accessed on disk when needed. See the benchmarking vignette for memory and speed implications.

+

Value

-

An MSnExp object for inMemory mode and a +

An MSnExp object for inMemory mode and a OnDiskMSnExp object for onDisk mode.

@@ -150,6 +178,7 @@

See also

Author

Laurent Gatto

+

Examples

file <- dir(system.file(package = "MSnbase", dir = "extdata"),
@@ -164,7 +193,7 @@ 

Examples

#> Number of spectra: 5 #> MSn retention times: 25:01 - 25:02 minutes #> - - - Processing information - - - -#> Data loaded: Wed May 15 16:30:46 2024 +#> Data loaded: Wed Sep 11 07:30:50 2024 #> MSnbase version: 2.31.1 #> - - - Meta data - - - #> phenoData @@ -188,7 +217,7 @@

Examples

#> Number of spectra: 5 #> MSn retention times: 25:01 - 25:02 minutes #> - - - Processing information - - - -#> Data loaded [Wed May 15 16:30:47 2024] +#> Data loaded [Wed Sep 11 07:30:51 2024] #> MSnbase version: 2.31.1 #> - - - Meta data - - - #> phenoData @@ -210,12 +239,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/readMSnSet.html b/reference/readMSnSet.html index bd0a3b6c..2dee38dc 100644 --- a/reference/readMSnSet.html +++ b/reference/readMSnSet.html @@ -1,5 +1,6 @@ Read 'MSnSet' — readMSnSet • MSnbase + +
+ + +
+
+ +

This function reads data files to generate an MSnSet instance. It is a wrapper around Biobase's readExpressionSet function with an @@ -84,6 +97,7 @@

Read 'MSnSet'

rownames as additional argument to defined feature names. It is ignored and used to set fnames if not provided otherwise.

+
readMSnSet(exprsFile,
            phenoDataFile,
@@ -104,66 +118,87 @@ 

Read 'MSnSet'

readMSnSet2(file, ecol, fnames, ...)
+

Arguments

+ +

Arguments direclty passed to readExpressionSet. The description is from the readExpressionSet documentation page.

+

exprsFile

(character) File or connection from which to read expression values. The file should contain a matrix with rows as features and columns as samples. read.table is called with this as its file argument and further arguments given by exprsArgs.

+
phenoDataFile

(character) File or connection from which to read phenotypic data. read.AnnotatedDataFrame is called with this as its file argument and further arguments given by phenoDataArgs.

+
experimentDataFile

(character) File or connection from which to read experiment data. read.MIAME is called with this as its file argument and further arguments given by experimentDataArgs.

+
notesFile

(character) File or connection from which to read notes; readLines is used to input the file.

+
path

(optional) directory in which to find all the above files.

+
annotation

(character) A single character string indicating the annotation associated with this ExpressionSet.

+
exprsArgs

A list of arguments to be used with read.table when reading in the expression matrix.

+
phenoDataArgs

A list of arguments to be used (with read.AnnotatedDataFrame) when reading the phenotypic data.

+
experimentDataArgs

A list of arguments to be used (with read.MIAME) when reading the experiment data.

+
sep, header, quote, stringsAsFactors, row.names

arguments used by the read.table-like functions.

+
widget

A boolean value indicating whether widgets can be used. Widgets are NOT yet implemented for read.AnnotatedDataFrame.

+
...

Further arguments that can be passed on to the read.table-like functions.

+ +

Additional argument, specific to readMSnSet:

featureDataFile

(character) File or connection from which to read feature data. read.AnnotatedDataFrame is called with this as its file argument and further arguments given by phenoDataArgs.

+
featureDataArgs

A list of arguments to be used (with read.AnnotatedDataFrame) when reading the phenotypic data.

+ +

Arguments for readMSnSet2:

+

file

A character indicating the spreadsheet file or a data.frame (new in version 1.19.8). Default, when file @@ -174,7 +209,10 @@

Arguments

spreadsheet is in Excel format. The appropriate sheet can first be read into R as a data.frame using, for example readxl::read_excel, and then pass it to readMSnSet2.

+

+ +
ecol

A numeric indicating the indices of the columns to be used as expression values. Can also be a character @@ -183,9 +221,14 @@

Arguments

- that will be converted to a .. If ecol does not match, the error message will dislpay the column names are see by R.

+ + +
fnames

An optional character or numeric of length 1 indicating the column to be used as feature names.

+ +

Value

@@ -198,20 +241,22 @@

Author

See also

+

The grepEcols and getEcols helper functions to identify the ecol values. The MSnbase-io vignette illustrates these functions in detail. It can be accessed with vignette("MSnbase-io").

+

Examples

-
if (FALSE) {
+    
if (FALSE) { # \dontrun{
 exprsFile <- "path_to_intensity_file.csv"
 fdatafile <- "path_to_featuredata_file.csv"
 pdatafile <- "path_to_sampledata_file.csv"
 ## Read ExpressionSet with appropriate parameters
 res <- readMSnSet(exprsFile, pdataFile, fdataFile, sep = "\t", header=TRUE)
-}
+} # }
 
 library("pRolocdata")
 f0 <- dir(system.file("extdata", package = "pRolocdata"),
@@ -264,12 +309,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/readMgfData.html b/reference/readMgfData.html index 9576da1c..45b3063b 100644 --- a/reference/readMgfData.html +++ b/reference/readMgfData.html @@ -4,6 +4,8 @@ + +
+ + +
+

Reads a mgf file and generates an "MSnExp" object.

+
readMgfData(filename, pdata = NULL, centroided = TRUE, smoothed = FALSE,
 verbose = isMSnbaseVerbose(), cache = 1)
+

Arguments

-
filename
+

+
filename

character vector with file name to be read.

+
pdata

an object of class "AnnotatedDataFrame".

+
smoothed

Logical indicating whether spectra already smoothed or not. Default is 'FALSE'. Used to initialise "MSnProcess" object in processingData slot.

+
centroided

Logical indicating whether spectra are centroided or not. Default is 'TRUE'. Used to initialise "MSnProcess" object in processingData slot.

+
cache

Numeric indicating caching level. Default is 1. Under development.

+
verbose

verbosity flag.

+

Value

-

An instance of

+

An instance of

Author

@@ -111,6 +130,7 @@

See also

objects to mgf files. Raw data files can also be read with the readMSData function.

+

Examples

  data(itraqdata)
@@ -147,7 +167,7 @@ 

Examples

#> Number of spectra: 3 #> MSn retention times: 17:08 - 18:47 minutes #> - - - Processing information - - - -#> Data loaded: Wed May 15 16:30:49 2024 +#> Data loaded: Wed Sep 11 07:30:52 2024 #> MSnbase version: 2.31.1 #> - - - Meta data - - - #> phenoData @@ -188,12 +208,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/readMzIdData.html b/reference/readMzIdData.html index 507ac25e..acfaf9ae 100644 --- a/reference/readMzIdData.html +++ b/reference/readMzIdData.html @@ -4,6 +4,8 @@ + +
+ + +
+

Reads as set of mzId files containing PSMs an generates a data.frame.

+
readMzIdData(files)
+

Arguments

-
files
+ + +
files

A character of mzid files.

+

Value

-

A data.frame containing the PSMs stored in the mzId

-

files.

+

A data.frame containing the PSMs stored in the mzId +files.

Details

@@ -93,6 +107,7 @@

See also

Author

Laurent Gatto

+

Examples

idf <- "TMT_Erwinia_1uLSike_Top10HCD_isol2_45stepped_60min_01-20141210.mzid"
@@ -34404,12 +34419,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/readMzTabData.html b/reference/readMzTabData.html index 3c17b819..c83337da 100644 --- a/reference/readMzTabData.html +++ b/reference/readMzTabData.html @@ -6,6 +6,8 @@ + +
+ + +
+

This function can be used to create an "MSnSet" by reading and parsing an mzTab file. The metadata section is always used to populate the MSnSet's experimentData()@other$mzTab slot.

+
readMzTabData(
   file,
@@ -78,27 +88,37 @@ 

Read an 'mzTab' file

verbose = isMSnbaseVerbose() )
+

Arguments

-
file
+ + +
file

A character with the mzTab file to be read in.

+ +
what

One of "PRT", "PEP" or "PSM", defining which of protein, peptide PSMs section should be returned as an MSnSet.

+ +
version

A character defining the format specification version of the mzTab file. Default is "1.0". Version "0.9" is available of backwards compatibility. See readMzTabData_v0.9 for details.

+ +
verbose

Produce verbose output.

+

Value

-

An instance of class MSnSet.

+

An instance of class MSnSet.

See also

@@ -109,6 +129,7 @@

See also

Author

Laurent Gatto

+

Examples

testfile <- "https://raw.githubusercontent.com/HUPO-PSI/mzTab/master/examples/1_0-Proteomics-Release/PRIDE_Exp_Complete_Ac_16649.xml-mztab.txt"
@@ -266,12 +287,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/readMzTabData_v0.9.html b/reference/readMzTabData_v0.9.html index 515f2cbe..e1e9a411 100644 --- a/reference/readMzTabData_v0.9.html +++ b/reference/readMzTabData_v0.9.html @@ -6,6 +6,8 @@ + +
+ + +
+

This function can be used to create a "MSnSet" by reading and parsing an mzTab file. The metadata section is always used to populate the MSnSet's experimentData slot.

+
readMzTabData_v0.9(file, what = c("PRT", "PEP"), verbose = isMSnbaseVerbose())
+

Arguments

-
file
+ + +
file

A character with the mzTab file to be read in.

+ +
what

One of "PRT" or "PEP", defining which of protein of peptide section should be parse. The metadata section, when available, is always used to populate the experimentData slot.

+ +
verbose

Produce verbose output.

+

Value

-

An instance of class MSnSet.

+

An instance of class MSnSet.

See also

@@ -99,6 +117,7 @@

See also

Author

Laurent Gatto

+

Examples

testfile <- "https://raw.githubusercontent.com/HUPO-PSI/mzTab/master/legacy/jmztab-1.0/examples/mztab_itraq_example.txt"
@@ -123,7 +142,7 @@ 

Examples

#> experimentData: use 'experimentData(object)' #> Annotation: #> - - - Processing information - - - -#> mzTab read: Wed May 15 16:30:57 2024 +#> mzTab read: Wed Sep 11 07:31:01 2024 #> MSnbase version: 2.31.1 pep <- readMzTabData_v0.9(testfile, "PEP") @@ -146,7 +165,7 @@

Examples

#> experimentData: use 'experimentData(object)' #> Annotation: #> - - - Processing information - - - -#> mzTab read: Wed May 15 16:30:57 2024 +#> mzTab read: Wed Sep 11 07:31:01 2024 #> MSnbase version: 2.31.1
@@ -155,12 +174,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/readSRMData.html b/reference/readSRMData.html index c7afce80..5a485ca0 100644 --- a/reference/readSRMData.html +++ b/reference/readSRMData.html @@ -4,6 +4,8 @@ + +
+ + +
+

The readSRMData function reads MRM/SRM data from provided mzML files and returns the results as a MChromatograms() object.

+
readSRMData(files, pdata = NULL)
+

Arguments

-
files
+ + +
files

character with the files containing the SRM/MRM data.

+ +
pdata

data.frame or AnnotatedDataFrame with file/sample descriptions.

+

Value

-

A MChromatograms() object. See details above for more information.

+

A MChromatograms() object. See details above for more information.

Details

@@ -112,6 +128,7 @@

Note

Author

Johannes Rainer

+

Examples


@@ -438,12 +455,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/reduce-data.frame-method.html b/reference/reduce-data.frame-method.html index c17a3bd2..1b6de4cb 100644 --- a/reference/reduce-data.frame-method.html +++ b/reference/reduce-data.frame-method.html @@ -6,6 +6,8 @@ + +
+ + +
+

Reduce a data.frame so that the (primary) key column contains only unique entries and other columns pertaining to that entry are combined into semicolon-separated values into a single row/observation.

+
# S4 method for class 'data.frame'
 reduce(x, key, sep = ";")
+

Arguments

-
x
+ + +
x

A data.frame.

+ +
key

The column name (currenly only one is supported) to be used as primary key.

+ +
sep

The separator. Default is ;.

+

Value

-

A reduced data.frame.

+

A reduced data.frame.

Details

@@ -99,6 +117,7 @@

Details

Author

Laurent Gatto

+

Examples

dfr <- data.frame(A = c(1, 1, 2),
@@ -147,12 +166,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/removeNoId-methods.html b/reference/removeNoId-methods.html index 5284eb02..697847e8 100644 --- a/reference/removeNoId-methods.html +++ b/reference/removeNoId-methods.html @@ -5,6 +5,8 @@ + +
+ + +
+

The method removes non-identifed features in MSnExp and MSnSet instances using relevant information from the feaureData slot of a user-provide filtering vector of logicals.

+ +

Methods

signature(object = "MSnExp", fcol = "pepseq", keep = @@ -76,9 +88,12 @@

Methods

NA. Alternatively, one can also manually define keep, a vector of logical, defining the feature to be retained.

+
signature(object = "MSnSet", fcol = "pepseq", keep = NULL)

As above of MSnSet instances.

+ +

Author

@@ -88,6 +103,7 @@

Author

See also

+

Examples

  quantFile <- dir(system.file(package = "MSnbase", dir = "extdata"),
@@ -146,12 +162,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/removePeaks-methods.html b/reference/removePeaks-methods.html index c26e9f1e..1e9a5971 100644 --- a/reference/removePeaks-methods.html +++ b/reference/removePeaks-methods.html @@ -16,6 +16,8 @@ + +
+ + +
+

This method sets low intensity peaks from individual spectra (Spectrum instances) or whole experiments (MSnExp @@ -89,6 +99,8 @@

Removes low intensity peaks

threshold are set to 0 and the object is not cleanded out (see clean). An illustrative example is shown below.

+ +

Methods

signature(object = "MSnExp", t, verbose = "logical" )
@@ -98,6 +110,8 @@

Methods

numeric values are valid. Displays a control bar if verbose set to TRUE (default). Returns a new MSnExp instance.

+ +
signature(object = "Spectrum", t, msLevel. = "numeric")

Removes low intensity peaks of Spectrum @@ -108,6 +122,9 @@

Methods

cleaning is ignored. Only relevant when called from OnDiskMSnExp and is only relevant for developers.

Returns a new Spectrum instance.

+ + +

Author

@@ -118,6 +135,7 @@

See also

clean and trimMz for other spectra processing methods.

+

Examples

int <- c(2, 0, 0, 0, 1, 5, 1, 0, 0, 1, 3, 1, 0, 0, 1, 4, 2, 1)
@@ -155,7 +173,7 @@ 

Examples

#> - - - Processing information - - - #> Data loaded: Wed May 11 18:54:39 2011 #> Updated from version 0.3.0 to 0.3.1 [Fri Jul 8 20:23:25 2016] -#> Curves <= 250000 set to '0': Wed May 15 16:31:01 2024 +#> Curves <= 250000 set to '0': Wed Sep 11 07:31:04 2024 #> MSnbase version: 1.1.22 ## difference between centroided and profile peaks @@ -185,12 +203,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/removeReporters-methods.html b/reference/removeReporters-methods.html index f6405fb6..ea3e54fd 100644 --- a/reference/removeReporters-methods.html +++ b/reference/removeReporters-methods.html @@ -12,6 +12,8 @@ + +
+ + +
+

This methods sets all the reporter tag ion peaks from one MS2 spectrum or all the MS2 spectra of an experiment to 0. Reporter data @@ -81,6 +91,8 @@

Removes reporter ion tag peaks

Note that this method only works for MS2 spectra or experiments that contain MS2 spectra. It will fail for MS1 spectrum.

+ +

Methods

signature(object = "MSnExp", reporters = "ReporterIons", @@ -92,6 +104,7 @@

Methods

value of reporters is NULL, which leaves the spectra as unchanged. The verbose parameter (default is TRUE) defines whether a progress bar should be showed.

+
signature(object = "Spectrum", reporters = "ReporterIons", clean = "FALSE")

The reporter ion peaks defined in the @@ -99,6 +112,8 @@

Methods

instance are set to 0 and, if clean is set to TRUE, cleaned. The default value of reporters is NULL, which leaves the spectrum as unchanged.

+ +

Author

@@ -109,6 +124,7 @@

See also

clean and removePeaks for other spectra processing methods.

+

Examples

sp1 <- itraqdata[[1]]
@@ -134,12 +150,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/selectFeatureData.html b/reference/selectFeatureData.html index ce67ddb5..19263a8c 100644 --- a/reference/selectFeatureData.html +++ b/reference/selectFeatureData.html @@ -6,6 +6,8 @@ + +
+ + +
+

Select feature variables to be retained.

requiredFvarLabels returns a character vector with the required feature data variable names (fvarLabels, i.e. the column names in the fData data.frame) for the specified object.

+
selectFeatureData(object, graphics = TRUE, fcol)
 
 requiredFvarLabels(x = c("OnDiskMSnExp", "MSnExp", "MSnSet"))
+

Arguments

-
object
+ + +
object

An MSnSet, MSnExp or OnDiskMSnExp.

+ +
graphics

A logical (default is TRUE) indicating whether a shiny application should be used if available. Otherwise, a text menu is used. Ignored if k is not missing.

+ +
fcol

A numeric, logical or character of valid feature variables to be passed directly.

+ +
x

character(1) specifying the class name for which the required feature data variable names should be returned.

+

Value

-

For selectFeatureData: updated object containing only +

For selectFeatureData: updated object containing only selected feature variables.

For requiredFvarLabels: character with the required feature variable names.

@@ -102,6 +122,7 @@

Value

Author

Laurent Gatto

+

Examples


@@ -112,11 +133,11 @@ 

Examples

fvarLabels(x) #> [1] "entry.name" "protein.description" "peptides.rep1" #> [4] "peptides.rep2" "psms.rep1" -if (FALSE) { +if (FALSE) { # \dontrun{ ## select via GUI x <- selectFeatureData(hyperLOPIT2015) fvarLabels(x) -} +} # } ## Subset the feature data of an OnDiskMSnExp object to the minimal ## required columns @@ -156,12 +177,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/smooth-methods.html b/reference/smooth-methods.html index ac3b763f..a306393a 100644 --- a/reference/smooth-methods.html +++ b/reference/smooth-methods.html @@ -8,6 +8,8 @@ + +
+ + +
+

This method smooths individual spectra (Spectrum instances) or whole experiments (MSnExp instances). @@ -73,11 +83,16 @@

Smooths 'MSnExp' or 'Spectrum' instances

available, as implemented in the MALDIquant::smoothIntensity function. Additional methods might be added at a later stage.

+ +

Methods

+ +

signature(x = "MSnExp", method = "character", halfWindowSize = "integer", verbose = "logical", ...)
+

Smooths all spectra in MSnExp. method could be "SavitzkyGolay" or "MovingAverage". "halfWindowSize" controls the @@ -98,15 +113,21 @@

Methods

polynomial order of the Savitzky-Golay Filter. This method displays a progress bar if verbose = TRUE. Returns an MSnExp instance with smoothed spectra.

+ +
signature(x = "Spectrum", method = "character", halfWindowSize = "integer", ...)
+

Smooths the spectrum (Spectrum instance). This method is the same as above but returns a smoothed Spectrum instead of an MSnExp object. It has no verbose argument. Please read the details for the above MSnExp method.

+ + +

@@ -131,6 +152,7 @@

References

Bioinformatics 28: 2270-2271. http://strimmerlab.org/software/maldiquant/

+

Examples

sp1 <- new("Spectrum1",
@@ -148,7 +170,7 @@ 

Examples

#> - - - Processing information - - - #> Data loaded: Wed May 11 18:54:39 2011 #> Updated from version 0.3.0 to 0.3.1 [Fri Jul 8 20:23:25 2016] -#> Spectra smoothed (MovingAverage): Wed May 15 16:31:03 2024 +#> Spectra smoothed (MovingAverage): Wed Sep 11 07:31:06 2024 #> MSnbase version: 1.1.22
@@ -157,12 +179,22 @@

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/trimMz-methods.html b/reference/trimMz-methods.html index 3e0e5855..d74e1bfb 100644 --- a/reference/trimMz-methods.html +++ b/reference/trimMz-methods.html @@ -1,5 +1,6 @@ Trims 'MSnExp' or 'Spectrum' instances — trimMz-methods • MSnbase + +
+ + +
+
+ +

This method selects a range of MZ values in a single spectrum (Spectrum instances) or all the spectra of an experiment (MSnExp instances). The regions to trim are defined by the range of mz argument, such that MZ values <= min(mz) and MZ values >= max(mz) are trimmed away.

+ +

Methods

signature(object = "MSnExp", mz = "numeric", msLevel. = @@ -79,6 +94,8 @@

Methods

Trims all spectra in MSnExp object according to mz. If msLevel. is defined, then only spectra of that level are trimmer.

+ +
signature(object = "Spectrum", mz = "numeric", msLevel. = "numeric")

Trims the Spectrum object and @@ -86,6 +103,9 @@

Methods

of the spectrum, and if msLevel(object) != msLevel., cleaning is ignored. Only relevant when called from OnDiskMSnExp and is only relevant for developers.

+ + +

Author

@@ -96,6 +116,7 @@

See also

removePeaks and clean for other spectra processing methods.

+

Examples

mz <- 1:100
@@ -128,12 +149,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/updateObject-methods.html b/reference/updateObject-methods.html index 7c720435..748185a6 100644 --- a/reference/updateObject-methods.html +++ b/reference/updateObject-methods.html @@ -1,10 +1,13 @@ Update MSnbase objects — updateObject-methods • MSnbase + +
+ + +
+
+ +

Methods for function updateObject for objects from the MSnbase package. See updateObject for details.

+ +

Methods

signature(object = "MSnExp")

Update the MSnExp object to the latest class version

+ +
signature(object = "Spectrum")

Update the Spectrum object (and it's sub-classes Spectrum1 and Spectrum2) to the latest class version.

+ + +
+
+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/writeMSData.html b/reference/writeMSData.html index 722492b5..9d2e04fc 100644 --- a/reference/writeMSData.html +++ b/reference/writeMSData.html @@ -5,6 +5,8 @@ + +
+ + +
+

The writeMSData,MSnExp and writeMSData,OnDiskMSnExp saves the content of a MSnExp or OnDiskMSnExp object to MS file(s) in either mzML or mzXML format.

+
# S4 method for class 'MSnExp,character'
 writeMSData(
@@ -80,30 +90,46 @@ 

Write MS data to mzML or mzXML files

software_processing = NULL )
+

Arguments

-
object
+ + +
object

OnDiskMSnExp or MSnExp object.

+ +
file

character with the file name(s). Its length has to match the number of samples/files of x.

+ +
outformat

character(1) defining the format of the output files. Default output format is "mzml".

+ +
merge

logical(1) whether the data should be saved into a single mzML file. Default is merge = FALSE, i.e. each sample is saved to a separate file. Note: merge = TRUE is not yet implemented.

+ +
verbose

logical(1) if progress messages should be displayed.

+ +
copy

logical(1) if metadata (data processings, original file names etc) should be copied from the original files. See details for more information.

+ +
software_processing

optionally provide specific data processing steps. See documentation of the software_processing parameter of mzR::writeMSData().

+

Details

@@ -138,17 +164,28 @@

Note

Author

Johannes Rainer

+
+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/writeMgfData-methods.html b/reference/writeMgfData-methods.html index 2edbc334..ff91cc4f 100644 --- a/reference/writeMgfData-methods.html +++ b/reference/writeMgfData-methods.html @@ -9,6 +9,8 @@ + +
+ + +
+

Methods writeMgfData write individual "Spectrum" instances of whole @@ -75,31 +85,41 @@

Write an experiment or spectrum to an mgf file

for more details). Function readMgfData read spectra from and mgf file and creates an "MSnExp" object.

+ +

Arguments

-
object
+

+
object

An instance of class "Spectrum" or "MSnExp".

+
con

A valid connection or a character string with the name of the file to save the object. In case of the latter, a file connection is created. If not specified, 'spectrum.mgf' or 'experiment.mgf' are used depending on the class of object. Note that existing files are overwritted.

+
COM

Optional character vector with the value for the 'COM' field.

+
TITLE

Optional character vector with the value for the spectrum 'TITLE' field. Not applicable for experiments.

+

Methods

signature(object = "MSnExp")

Writes the full exeriment to an mgf file.

+
signature(object = "Spectrum")

Writes an individual spectrum to an mgf file.

+ +

See also

@@ -113,6 +133,7 @@

Details

names will be identical, the spectra are not as a result of the reordering. See example below.

+

Examples

data(itraqdata)
@@ -156,12 +177,22 @@ 

Examples

+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/reference/writeMzTabData.html b/reference/writeMzTabData.html index 3d48d1cc..2a086f3b 100644 --- a/reference/writeMzTabData.html +++ b/reference/writeMzTabData.html @@ -4,6 +4,8 @@ + +
+ + +
+

writeMzTabData exports an MzTab object as mzTab file. Note that the comment section "COM" are not written out.

+
writeMzTabData(
   object,
@@ -73,32 +83,51 @@ 

Export an MzTab object as mzTab file.

what = c("MT", "PEP", "PRT", "PSM", "SML", "SMF", "SME") )
+

Arguments

-
object
+ + +
object

MzTab object, either read in by MzTab() or assembled.

+ +
file

character(1) with the file name.

+ +
what

character with names of the sections to be written out. Expected sections are "MT", "PEP", "PRT", "PSM", "SML", "SMF", or "SME".

+

Author

Steffen Neumann

+
+ +
+
-

Site built with pkgdown 2.0.9.9000.

+

Site built with pkgdown 2.1.0.9000.

+
+ + + + + + diff --git a/sitemap.xml b/sitemap.xml index 90fefcfc..5693b3f4 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -1,330 +1,112 @@ - - - - /404.html - - - /CONDUCT.html - - - /articles/index.html - - - /articles/v01-MSnbase-demo.html - - - /articles/v02-MSnbase-io.html - - - /articles/v03-MSnbase-centroiding.html - - - /articles/v04-benchmarking.html - - - /articles/v05-MSnbase-development.html - - - /authors.html - - - /index.html - - - /news/index.html - - - /reference/Chromatogram-class.html - - - /reference/FeatComp-class.html - - - /reference/FeaturesOfInterest-class.html - - - /reference/MChromatograms-class.html - - - /reference/MIAPE-class.html - - - /reference/MSmap-class.html - - - /reference/MSnExp-class.html - - - /reference/MSnProcess-class.html - - - /reference/MSnSet-class.html - - - /reference/MSnSetList-class.html - - - /reference/MSnbaseOptions.html - - - /reference/MSpectra.html - - - /reference/MzTab-class.html - - - /reference/OnDiskMSnExp-class.html - - - /reference/ProcessingStep-class.html - - - /reference/ReporterIons-class.html - - - /reference/Spectrum-class.html - - - /reference/Spectrum1-class.html - - - /reference/Spectrum2-class.html - - - /reference/TMT6.html - - - /reference/addIdentificationData-methods.html - - - /reference/aggvar.html - - - /reference/averageMSnSet.html - - - /reference/bin-methods.html - - - /reference/calculateFragments-methods.html - - - /reference/chromatogram-MSnExp-method.html - - - /reference/clean-methods.html - - - /reference/combineFeatures.html - - - /reference/combineSpectra.html - - - /reference/combineSpectraMovingWindow.html - - - /reference/commonFeatureNames.html - - - /reference/compareMSnSets.html - - - /reference/compareSpectra-methods.html - - - /reference/consensusSpectrum.html - - - /reference/defunct.html - - - /reference/estimateMzResolution.html - - - /reference/estimateMzScattering.html - - - /reference/estimateNoise-method.html - - - /reference/extractPrecSpectra-methods.html - - - /reference/extractSpectraData.html - - - /reference/fData-utils.html - - - /reference/factorsAsStrings.html - - - /reference/featureCV.html - - - /reference/fillUp.html - - - /reference/filterIdentificationDataFrame.html - - - /reference/formatRt.html - - - /reference/getVariableName.html - - - /reference/grepEcols.html - - - /reference/hasSpectraOrChromatograms.html - - - /reference/iPQF.html - - - /reference/iTRAQ4.html - - - /reference/imageNA2.html - - - /reference/impute.html - - - /reference/index.html - - - /reference/isCentroidedFromFile.html - - - /reference/itraqdata.html - - - /reference/listOf.html - - - /reference/makeCamelCase.html - - - /reference/makeNaData.html - - - /reference/meanMzInts.html - - - /reference/missing-data.html - - - /reference/mzRident2dfr.html - - - /reference/nFeatures.html - - - /reference/nQuants.html - - - /reference/naplot.html - - - /reference/navMS.html - - - /reference/normToReference.html - - - /reference/normalise-methods.html - - - /reference/npcv.html - - - /reference/pSet-class.html - - - /reference/pickPeaks-method.html - - - /reference/plot-methods.html - - - /reference/plot2d-methods.html - - - /reference/plotDensity-methods.html - - - /reference/plotMzDelta-methods.html - - - /reference/plotNA-methods.html - - - /reference/plotSpectrumSpectrum-methods.html - - - /reference/precSelection.html - - - /reference/purityCorrect-methods.html - - - /reference/quantify-methods.html - - - /reference/readMSData.html - - - /reference/readMSnSet.html - - - /reference/readMgfData.html - - - /reference/readMzIdData.html - - - /reference/readMzTabData.html - - - /reference/readMzTabData_v0.9.html - - - /reference/readSRMData.html - - - /reference/reduce-data.frame-method.html - - - /reference/removeNoId-methods.html - - - /reference/removePeaks-methods.html - - - /reference/removeReporters-methods.html - - - /reference/selectFeatureData.html - - - /reference/smooth-methods.html - - - /reference/trimMz-methods.html - - - /reference/updateObject-methods.html - - - /reference/writeMSData.html - - - /reference/writeMgfData-methods.html - - - /reference/writeMzTabData.html - + +/404.html +/CONDUCT.html +/articles/index.html +/articles/v01-MSnbase-demo.html +/articles/v02-MSnbase-io.html +/articles/v03-MSnbase-centroiding.html +/articles/v04-benchmarking.html +/articles/v05-MSnbase-development.html +/authors.html +/index.html +/news/index.html +/reference/Chromatogram-class.html +/reference/FeatComp-class.html +/reference/FeaturesOfInterest-class.html +/reference/MChromatograms-class.html +/reference/MIAPE-class.html +/reference/MSmap-class.html +/reference/MSnExp-class.html +/reference/MSnProcess-class.html +/reference/MSnSet-class.html +/reference/MSnSetList-class.html +/reference/MSnbaseOptions.html +/reference/MSpectra.html +/reference/MzTab-class.html +/reference/OnDiskMSnExp-class.html +/reference/ProcessingStep-class.html +/reference/ReporterIons-class.html +/reference/Spectrum-class.html +/reference/Spectrum1-class.html +/reference/Spectrum2-class.html +/reference/TMT6.html +/reference/addIdentificationData-methods.html +/reference/aggvar.html +/reference/averageMSnSet.html +/reference/bin-methods.html +/reference/calculateFragments-methods.html +/reference/chromatogram-MSnExp-method.html +/reference/clean-methods.html +/reference/combineFeatures.html +/reference/combineSpectra.html +/reference/combineSpectraMovingWindow.html +/reference/commonFeatureNames.html +/reference/compareMSnSets.html +/reference/compareSpectra-methods.html +/reference/consensusSpectrum.html +/reference/defunct.html +/reference/estimateMzResolution.html +/reference/estimateMzScattering.html +/reference/estimateNoise-method.html +/reference/extractPrecSpectra-methods.html +/reference/extractSpectraData.html +/reference/fData-utils.html +/reference/factorsAsStrings.html +/reference/featureCV.html +/reference/fillUp.html +/reference/filterIdentificationDataFrame.html +/reference/formatRt.html +/reference/getVariableName.html +/reference/grepEcols.html +/reference/hasSpectraOrChromatograms.html +/reference/iPQF.html +/reference/iTRAQ4.html +/reference/imageNA2.html +/reference/impute.html +/reference/index.html +/reference/isCentroidedFromFile.html +/reference/itraqdata.html +/reference/listOf.html +/reference/makeCamelCase.html +/reference/makeNaData.html +/reference/meanMzInts.html +/reference/missing-data.html +/reference/mzRident2dfr.html +/reference/nFeatures.html +/reference/nQuants.html +/reference/naplot.html +/reference/navMS.html +/reference/normToReference.html +/reference/normalise-methods.html +/reference/npcv.html +/reference/pSet-class.html +/reference/pickPeaks-method.html +/reference/plot-methods.html +/reference/plot2d-methods.html +/reference/plotDensity-methods.html +/reference/plotMzDelta-methods.html +/reference/plotNA-methods.html +/reference/plotSpectrumSpectrum-methods.html +/reference/precSelection.html +/reference/purityCorrect-methods.html +/reference/quantify-methods.html +/reference/readMSData.html +/reference/readMSnSet.html +/reference/readMgfData.html +/reference/readMzIdData.html +/reference/readMzTabData.html +/reference/readMzTabData_v0.9.html +/reference/readSRMData.html +/reference/reduce-data.frame-method.html +/reference/removeNoId-methods.html +/reference/removePeaks-methods.html +/reference/removeReporters-methods.html +/reference/selectFeatureData.html +/reference/smooth-methods.html +/reference/trimMz-methods.html +/reference/updateObject-methods.html +/reference/writeMSData.html +/reference/writeMgfData-methods.html +/reference/writeMzTabData.html +