Pbase
example dataPackage: Pbase
Authors: Laurent Gatto and
Sebastian Gibb
Last compiled: Thu May 2 21:01:20 2019
Last modified: 2019-05-02 17:02:59
This vignette briefly introduces the central data object of the
Pbase
package, namely Proteins
instances, as depicted below. They
contain a set of protein sequences (10 in the figure below), composed
of the protein sequences (grey boxes) and annotation data (table on
the left). Each protein links to a set of ranges of interest, such as
protein domains of experimentally observed peptides (also in grey)
that are also decorated with their own annotation data. The figure
also show the accessors for the different data slots, that are
detailed in ?Proteins
.
Proteins
objects are populated by protein sequences stemming from a
fasta file and the peptides typically originate from an LC-MSMS
experiment.
The original data used below is a 10 fmol
Peptide Retention Time Calibration Mixture
spiked into 50 ng HeLa background acquired on a Thermo Orbitrap Q
Exactive instrument. A restricted set of high scoring human proteins
from the UniProt release 2015_02
were searched using the MSGF+
search engine.
library("Biostrings")
## Loading required package: XVector
##
## Attaching package: 'Biostrings'
## The following object is masked from 'package:base':
##
## strsplit
fafile <- system.file("extdata/HUMAN_2015_02_selected.fasta",
package = "Pbase")
fa <- readAAStringSet(fafile)
fa
## A AAStringSet instance of length 9
## width seq names
## [1] 2602 MPVTEKDLAEDAPWKKIQQNTF...VLAVKWGEEHIPGSPFHVTVP sp|O75369|FLNB_HU...
## [2] 3374 MSPESGHSRIFEATAGPNKPES...YTLSKDSLSNGVPSGRQAEFS sp|A4UGR9|XIRP2_H...
## [3] 2624 MFRRARLSVKPNVRPGVGARGS...EATTVSEYFFNDIFIEVDETE sp|A6H8Y1|BDP1_HU...
## [4] 911 MVDYHAANQSYQYGPSSAGNGA...AVPGALDYKSFSTALYGESDL sp|O43707|ACTN4_H...
## [5] 417 MSLSNKLTLDKLDVKGKRVVMR...GASLELLEGKVLPGVDALSNI sp|P00558|PGK1_HU...
## [6] 375 MDDDIAALVVDNGSGMCKAGFA...MWISKQEYDESGPSIVHRKCF sp|P60709|ACTB_HU...
## [7] 664 METPSQRRATRSGAQASSTPLS...RSYLLGNSSPRTQSPQNCSIM sp|P02545|LMNA_HU...
## [8] 364 MPYQYPALTPEQKKELSDIAHR...TPSGQAGAAASESLFVSNHAY sp|P04075|ALDOA_H...
## [9] 418 MARRKPEGSSFNMTHLSMAMAF...TPSGQAGAAASESLFVSNHAY sp|P04075-2|ALDOA...
library("mzID")
idfile <- system.file("extdata/Thermo_Hela_PRTC_selected.mzid",
package = "Pbase")
id <- flatten(mzID(idfile))
## reading Thermo_Hela_PRTC_selected.mzid... DONE!
dim(id)
## [1] 137 29
head(id)
## spectrumid scan number(s)
## 1 index=173 12256
## 1.1 index=173 12256
## 2 index=163 11860
## 2.1 index=163 11860
## 3 index=200 13408
## 3.1 index=200 13408
## spectrum title
## 1 msLevel 2; retentionTime 2094.56706; scanNum 12256; precMz 1137.06665029649; precCharge 2
## 1.1 msLevel 2; retentionTime 2094.56706; scanNum 12256; precMz 1137.06665029649; precCharge 2
## 2 msLevel 2; retentionTime 2039.84424; scanNum 11860; precMz 1136.57450195803; precCharge 2
## 2.1 msLevel 2; retentionTime 2039.84424; scanNum 11860; precMz 1136.57450195803; precCharge 2
## 3 msLevel 2; retentionTime 2258.27868; scanNum 13408; precMz 703.038108542133; precCharge 3
## 3.1 msLevel 2; retentionTime 2258.27868; scanNum 13408; precMz 703.038108542133; precCharge 3
## acquisitionnum passthreshold rank calculatedmasstocharge
## 1 173 TRUE 1 1136.574
## 1.1 173 TRUE 1 1136.574
## 2 163 TRUE 1 1136.574
## 2.1 163 TRUE 1 1136.574
## 3 200 TRUE 1 703.037
## 3.1 200 TRUE 1 703.037
## experimentalmasstocharge chargestate ms-gf:denovoscore ms-gf:evalue
## 1 1137.0667 2 132 2.597097e-18
## 1.1 1137.0667 2 132 2.597097e-18
## 2 1136.5745 2 230 4.942664e-17
## 2.1 1136.5745 2 230 4.942664e-17
## 3 703.0381 3 145 4.080429e-10
## 3.1 703.0381 3 145 4.080429e-10
## ms-gf:rawscore ms-gf:specevalue assumeddissociationmethod isotopeerror
## 1 118 2.276758e-22 CID 1
## 1.1 118 2.276758e-22 CID 1
## 2 186 4.333009e-21 CID 0
## 2.1 186 4.333009e-21 CID 0
## 3 98 3.578068e-14 CID 0
## 3.1 98 3.578068e-14 CID 0
## isdecoy post pre end start accession length
## 1 FALSE C K 134 112 sp|P04075|ALDOA_HUMAN 364
## 1.1 FALSE C K 188 166 sp|P04075-2|ALDOA_HUMAN 418
## 2 FALSE C K 134 112 sp|P04075|ALDOA_HUMAN 364
## 2.1 FALSE C K 188 166 sp|P04075-2|ALDOA_HUMAN 418
## 3 FALSE Y K 173 154 sp|P04075|ALDOA_HUMAN 364
## 3.1 FALSE Y K 227 208 sp|P04075-2|ALDOA_HUMAN 418
## description
## 1 Fructose-bisphosphate aldolase A OS=Homo sapiens GN=ALDOA PE=1 SV=2
## 1.1 Isoform 2 of Fructose-bisphosphate aldolase A OS=Homo sapiens GN=ALDOA
## 2 Fructose-bisphosphate aldolase A OS=Homo sapiens GN=ALDOA PE=1 SV=2
## 2.1 Isoform 2 of Fructose-bisphosphate aldolase A OS=Homo sapiens GN=ALDOA
## 3 Fructose-bisphosphate aldolase A OS=Homo sapiens GN=ALDOA PE=1 SV=2
## 3.1 Isoform 2 of Fructose-bisphosphate aldolase A OS=Homo sapiens GN=ALDOA
## pepseq modified modification
## 1 GVVPLAGTNGETTTQGLDGLSER FALSE <NA>
## 1.1 GVVPLAGTNGETTTQGLDGLSER FALSE <NA>
## 2 GVVPLAGTNGETTTQGLDGLSER FALSE <NA>
## 2.1 GVVPLAGTNGETTTQGLDGLSER FALSE <NA>
## 3 IGEHTPSALAIMENANVLAR FALSE <NA>
## 3.1 IGEHTPSALAIMENANVLAR FALSE <NA>
## idFile spectrumFile
## 1 Thermo_Hela_PRTC_selected.mzid Thermo_Hela_PRTC_selected.mgf
## 1.1 Thermo_Hela_PRTC_selected.mzid Thermo_Hela_PRTC_selected.mgf
## 2 Thermo_Hela_PRTC_selected.mzid Thermo_Hela_PRTC_selected.mgf
## 2.1 Thermo_Hela_PRTC_selected.mzid Thermo_Hela_PRTC_selected.mgf
## 3 Thermo_Hela_PRTC_selected.mzid Thermo_Hela_PRTC_selected.mgf
## 3.1 Thermo_Hela_PRTC_selected.mzid Thermo_Hela_PRTC_selected.mgf
## databaseFile
## 1 HUMAN_2015_02_selected.fasta
## 1.1 HUMAN_2015_02_selected.fasta
## 2 HUMAN_2015_02_selected.fasta
## 2.1 HUMAN_2015_02_selected.fasta
## 3 HUMAN_2015_02_selected.fasta
## 3.1 HUMAN_2015_02_selected.fasta
library("Pbase")
p <- Proteins(fafile)
p <- addIdentificationData(p, idfile)
## Reading 1 identification files:
## 1. /tmp/RtmpqlkftZ/Rinst64f34431049c/Pbase/extdata/Thermo_Hela_PRTC_selected.mzid
## done.
p
## S4 class type : Proteins
## Class version : 0.2
## Created : Thu May 2 21:01:38 2019
## Number of Proteins: 9
## Sequences:
## [1] A4UGR9 [2] A6H8Y1 ... [8] P04075-2 [9] P60709
## Protein ranges:
## Peptides
A Proteins
object is composed of a set of protein sequences
accessible with the aa
accessor as well as an optional set of
peptides features that are mapped as coordinates along the proteins,
available with pranges
. The actual peptide sequences can be extraced
with pfeatures
. The names of the protein sequences can be extraced
with seqnames
.
aa(p)
## A AAStringSet instance of length 9
## width seq names
## [1] 3374 MSPESGHSRIFEATAGPNKPES...YTLSKDSLSNGVPSGRQAEFS A4UGR9
## [2] 2624 MFRRARLSVKPNVRPGVGARGS...EATTVSEYFFNDIFIEVDETE A6H8Y1
## [3] 911 MVDYHAANQSYQYGPSSAGNGA...AVPGALDYKSFSTALYGESDL O43707
## [4] 2602 MPVTEKDLAEDAPWKKIQQNTF...VLAVKWGEEHIPGSPFHVTVP O75369
## [5] 417 MSLSNKLTLDKLDVKGKRVVMR...GASLELLEGKVLPGVDALSNI P00558
## [6] 664 METPSQRRATRSGAQASSTPLS...RSYLLGNSSPRTQSPQNCSIM P02545
## [7] 364 MPYQYPALTPEQKKELSDIAHR...TPSGQAGAAASESLFVSNHAY P04075
## [8] 418 MARRKPEGSSFNMTHLSMAMAF...TPSGQAGAAASESLFVSNHAY P04075-2
## [9] 375 MDDDIAALVVDNGSGMCKAGFA...MWISKQEYDESGPSIVHRKCF P60709
seqnames(p)
## [1] "A4UGR9" "A6H8Y1" "O43707" "O75369" "P00558" "P02545"
## [7] "P04075" "P04075-2" "P60709"
pranges(p)
## DataFrame with 9 rows and 1 column
## Peptides
## <IRangesList>
## A4UGR9 2743-2760,307-318,1858-1870,...
## A6H8Y1 448-465,1284-1291,1120-1128,...
## O43707 51-65,495-512,438-450,...
## O75369 895-909,1746-1757,2563-2578,...
## P00558 193-206,268-275,333-350,...
## P02545 1-11,332-349,367-377,...
## P04075 112-134,112-134,154-173,...
## P04075-2 166-188,166-188,208-227,...
## P60709 184-196
pfeatures(p)
## AAStringSetList of length 9
## [["A4UGR9"]] A4UGR9=QEITQNKSFFSSVKESQR ... A4UGR9=QEITQNKSFFSSVK
## [["A6H8Y1"]] A6H8Y1=EDAEQVALEVDLNQKKRR ...
## [["O43707"]] O43707=QQRKTFTAWCNSHLR ... O43707=VGWEQLLTTIAR
## [["O75369"]] O75369=DLDIIDNYDYSHTVK ... O75369=VQAQGPGLKEAFTNK
## [["P00558"]] P00558=ELNYFAKALESPER P00558=DLMSKAEK ... P00558=GTKALMDEVVK
## [["P02545"]] P02545=METPSQRRATR ... P02545=RATRSGAQASSTPLSPTR
## [["P04075"]] P04075=GVVPLAGTNGETTTQGLDGLSER ...
## [["P04075-2"]] P04075-2=GVVPLAGTNGETTTQGLDGLSER ...
## [["P60709"]] P60709=DLTDYLMKILTER
A Proteins instance is further described by general metadata
list. Protein sequence and peptide features annotations can be
accessed with acols
and pcols
respectively, which return
DataFrame
instances.
metadata(p)
## $created
## [1] "Thu May 2 21:01:38 2019"
acols(p)
## DataFrame with 9 rows and 12 columns
## DB AccessionNumber EntryName IsoformName
## <Rle> <character> <character> <Rle>
## A4UGR9 sp A4UGR9 XIRP2_HUMAN NA
## A6H8Y1 sp A6H8Y1 BDP1_HUMAN NA
## O43707 sp O43707 ACTN4_HUMAN NA
## O75369 sp O75369 FLNB_HUMAN NA
## P00558 sp P00558 PGK1_HUMAN NA
## P02545 sp P02545 LMNA_HUMAN NA
## P04075 sp P04075 ALDOA_HUMAN NA
## P04075-2 sp P04075-2 ALDOA_HUMAN 2
## P60709 sp P60709 ACTB_HUMAN NA
## ProteinName OrganismName
## <character> <Rle>
## A4UGR9 Xin actin-binding repeat-containing protein 2 Homo sapiens
## A6H8Y1 Transcription factor TFIIIB component B'' homolog Homo sapiens
## O43707 Alpha-actinin-4 Homo sapiens
## O75369 Filamin-B Homo sapiens
## P00558 Phosphoglycerate kinase 1 Homo sapiens
## P02545 Prelamin-A/C Homo sapiens
## P04075 Fructose-bisphosphate aldolase A Homo sapiens
## P04075-2 Fructose-bisphosphate aldolase A Homo sapiens
## P60709 Actin, cytoplasmic 1 Homo sapiens
## GeneName ProteinExistence SequenceVersion Comment
## <Rle> <Rle> <Rle> <Rle>
## A4UGR9 XIRP2 Evidence at protein level 2 NA
## A6H8Y1 BDP1 Evidence at protein level 3 NA
## O43707 ACTN4 Evidence at protein level 2 NA
## O75369 FLNB Evidence at protein level 2 NA
## P00558 PGK1 Evidence at protein level 3 NA
## P02545 LMNA Evidence at protein level 1 NA
## P04075 ALDOA Evidence at protein level 2 NA
## P04075-2 ALDOA NA NA NA
## P60709 ACTB Evidence at protein level 1 NA
## Filename
## <Rle>
## A4UGR9 /tmp/RtmpqlkftZ/Rinst64f34431049c/Pbase/extdata/HUMAN_2015_02_selected.fasta
## A6H8Y1 /tmp/RtmpqlkftZ/Rinst64f34431049c/Pbase/extdata/HUMAN_2015_02_selected.fasta
## O43707 /tmp/RtmpqlkftZ/Rinst64f34431049c/Pbase/extdata/HUMAN_2015_02_selected.fasta
## O75369 /tmp/RtmpqlkftZ/Rinst64f34431049c/Pbase/extdata/HUMAN_2015_02_selected.fasta
## P00558 /tmp/RtmpqlkftZ/Rinst64f34431049c/Pbase/extdata/HUMAN_2015_02_selected.fasta
## P02545 /tmp/RtmpqlkftZ/Rinst64f34431049c/Pbase/extdata/HUMAN_2015_02_selected.fasta
## P04075 /tmp/RtmpqlkftZ/Rinst64f34431049c/Pbase/extdata/HUMAN_2015_02_selected.fasta
## P04075-2 /tmp/RtmpqlkftZ/Rinst64f34431049c/Pbase/extdata/HUMAN_2015_02_selected.fasta
## P60709 /tmp/RtmpqlkftZ/Rinst64f34431049c/Pbase/extdata/HUMAN_2015_02_selected.fasta
## npeps
## <integer>
## A4UGR9 36
## A6H8Y1 23
## O43707 6
## O75369 13
## P00558 5
## P02545 12
## P04075 21
## P04075-2 20
## P60709 1
pcols(p)
## DataFrame with 9 rows and 1 column
## Peptides
## <IRangesList>
## A4UGR9 2743-2760,307-318,1858-1870,...
## A6H8Y1 448-465,1284-1291,1120-1128,...
## O43707 51-65,495-512,438-450,...
## O75369 895-909,1746-1757,2563-2578,...
## P00558 193-206,268-275,333-350,...
## P02545 1-11,332-349,367-377,...
## P04075 112-134,112-134,154-173,...
## P04075-2 166-188,166-188,208-227,...
## P60709 184-196
Specific proteins can be extracted by index of name using
[
and proteins and their peptide features can be plotted
with the default plot method.
seqnames(p)
## [1] "A4UGR9" "A6H8Y1" "O43707" "O75369" "P00558" "P02545"
## [7] "P04075" "P04075-2" "P60709"
plot(p[c(1,9)])
More details can be found in ?Proteins
. The object generated above
is also directly available as data(p)
.
sessionInfo()
## R version 3.6.0 (2019-04-26)
## Platform: x86_64-pc-linux-gnu (64-bit)
## Running under: Ubuntu 18.04.2 LTS
##
## Matrix products: default
## BLAS: /home/biocbuild/bbs-3.9-bioc/R/lib/libRblas.so
## LAPACK: /home/biocbuild/bbs-3.9-bioc/R/lib/libRlapack.so
##
## locale:
## [1] LC_CTYPE=en_US.UTF-8 LC_NUMERIC=C
## [3] LC_TIME=en_US.UTF-8 LC_COLLATE=C
## [5] LC_MONETARY=en_US.UTF-8 LC_MESSAGES=en_US.UTF-8
## [7] LC_PAPER=en_US.UTF-8 LC_NAME=C
## [9] LC_ADDRESS=C LC_TELEPHONE=C
## [11] LC_MEASUREMENT=en_US.UTF-8 LC_IDENTIFICATION=C
##
## attached base packages:
## [1] grid stats4 parallel stats graphics grDevices utils
## [8] datasets methods base
##
## other attached packages:
## [1] mzID_1.22.0 Biostrings_2.52.0 XVector_0.24.0
## [4] Pbase_0.24.0 Gviz_1.28.0 GenomicRanges_1.36.0
## [7] GenomeInfoDb_1.20.0 IRanges_2.18.0 S4Vectors_0.22.0
## [10] Rcpp_1.0.1 BiocGenerics_0.30.0 BiocStyle_2.12.0
##
## loaded via a namespace (and not attached):
## [1] colorspace_1.4-1 biovizBase_1.32.0
## [3] htmlTable_1.13.1 base64enc_0.1-3
## [5] dichromat_2.0-0 rstudioapi_0.10
## [7] mzR_2.18.0 affyio_1.54.0
## [9] bit64_0.9-7 AnnotationDbi_1.46.0
## [11] codetools_0.2-16 splines_3.6.0
## [13] ncdf4_1.16.1 doParallel_1.0.14
## [15] impute_1.58.0 knitr_1.22
## [17] Formula_1.2-3 Rsamtools_2.0.0
## [19] cluster_2.0.9 vsn_3.52.0
## [21] BiocManager_1.30.4 compiler_3.6.0
## [23] httr_1.4.0 backports_1.1.4
## [25] assertthat_0.2.1 Matrix_1.2-17
## [27] lazyeval_0.2.2 limma_3.40.0
## [29] acepack_1.4.1 htmltools_0.3.6
## [31] prettyunits_1.0.2 tools_3.6.0
## [33] gtable_0.3.0 glue_1.3.1
## [35] GenomeInfoDbData_1.2.1 affy_1.62.0
## [37] dplyr_0.8.0.1 MALDIquant_1.19.2
## [39] Biobase_2.44.0 preprocessCore_1.46.0
## [41] rtracklayer_1.44.0 iterators_1.0.10
## [43] xfun_0.6 stringr_1.4.0
## [45] ensembldb_2.8.0 XML_3.98-1.19
## [47] zlibbioc_1.30.0 MASS_7.3-51.4
## [49] scales_1.0.0 BSgenome_1.52.0
## [51] MSnbase_2.10.0 VariantAnnotation_1.30.0
## [53] pcaMethods_1.76.0 hms_0.4.2
## [55] ProtGenerics_1.16.0 SummarizedExperiment_1.14.0
## [57] AnnotationFilter_1.8.0 RColorBrewer_1.1-2
## [59] yaml_2.2.0 curl_3.3
## [61] memoise_1.1.0 gridExtra_2.3
## [63] ggplot2_3.1.1 cleaver_1.22.0
## [65] biomaRt_2.40.0 rpart_4.1-15
## [67] latticeExtra_0.6-28 stringi_1.4.3
## [69] RSQLite_2.1.1 foreach_1.4.4
## [71] checkmate_1.9.1 GenomicFeatures_1.36.0
## [73] BiocParallel_1.18.0 rlang_0.3.4
## [75] pkgconfig_2.0.2 matrixStats_0.54.0
## [77] bitops_1.0-6 evaluate_0.13
## [79] lattice_0.20-38 purrr_0.3.2
## [81] GenomicAlignments_1.20.0 htmlwidgets_1.3
## [83] bit_1.1-14 tidyselect_0.2.5
## [85] plyr_1.8.4 magrittr_1.5
## [87] bookdown_0.9 Pviz_1.18.0
## [89] R6_2.4.0 Hmisc_4.2-0
## [91] DelayedArray_0.10.0 DBI_1.0.0
## [93] pillar_1.3.1 foreign_0.8-71
## [95] survival_2.44-1.1 RCurl_1.95-4.12
## [97] nnet_7.3-12 tibble_2.1.1
## [99] crayon_1.3.4 rmarkdown_1.12
## [101] progress_1.2.0 data.table_1.12.2
## [103] blob_1.1.1 digest_0.6.18
## [105] munsell_0.5.0