Most CPTAC data come from cohorts with their own patients rather than
TCGA tumors: the CPTAC-3 discovery and confirmatory cohorts (e.g. clear
cell renal cell carcinoma, glioblastoma, lung adenocarcinoma) and the
CPTAC-2 Prospective collections. Each cohort is profiled in several
Proteomic Data Commons (PDC) studies, one for each experiment, such as
the proteome and the phosphoproteome. getCPTAC() downloads
the studies of a cohort and combines them in one
MultiAssayExperiment, with the PDC clinical data of the
patients as colData.
To add CPTAC data run on TCGA tumors to a
MultiAssayExperiment from curatedTCGAData, use
appendCPTAC() instead; see the vignette “Adding CPTAC
proteomics to a TCGA MultiAssayExperiment”
(vignette("CPTACdata", package = "CPTACdata")).
cptacCohorts has one row per PDC study. Its columns
are:
cohort: the cohort the study belongs to.experiment: the name of the experiment in the
MultiAssayExperiment.pdc_study_id: the PDC study identifier.pdc_name: the PDC study name.pdc_project: the PDC project, “CPTAC3 Discovery and
Confirmatory” or “CPTAC-2”.analytical_fraction: the PDC analytical fraction, such
as Proteome, Phosphoproteome or Acetylome.experiment_type: the labeling or acquisition, such as
TMT10 or Label Free.data_type: the PDC quantification matrix that is
downloaded, or NA.cptacCohorts ships with the package and needs no network
access:
data("cptacCohorts", package = "CPTACdata")
table(cptacCohorts[["cohort"]])
#>
#> CPTAC AML Study CPTAC CCRCC Discovery Study
#> 6 4
#> CPTAC GBM Confirmatory Study CPTAC GBM Discovery Study
#> 6 5
#> CPTAC HNSCC Discovery Study CPTAC LSCC Discovery Study
#> 2 4
#> CPTAC LUAD Confirmatory Study CPTAC LUAD Discovery Study
#> 4 4
#> CPTAC non-ccRCC Study CPTAC PDA Discovery Study
#> 4 4
#> CPTAC SKCM Discovery Study CPTAC SKCM Validation Study
#> 11 6
#> CPTAC STAD Study CPTAC UCEC Confirmatory Study
#> 7 4
#> CPTAC UCEC Discovery Study IPMN Study
#> 3 6
#> Prospective Breast Prospective Colon
#> 3 3
#> Prospective Ovarian
#> 5
cptacCohorts[
cptacCohorts[["cohort"]] == "CPTAC CCRCC Discovery Study",
c("experiment", "pdc_study_id", "analytical_fraction", "data_type")
]
#> experiment pdc_study_id analytical_fraction data_type
#> 7 DIA_Proteome PDC000200 Proteome <NA>
#> 8 Intact_Glycoproteome PDC000471 Glycoproteome <NA>
#> 9 Phosphoproteome PDC000128 Phosphoproteome log2_ratio
#> 10 Proteome PDC000127 Proteome log2_ratioSome studies, such as most metabolome and lipidome studies, have
data_type = NA. The PDC holds their biospecimen records,
but its API returns no quantification matrix, so getCPTAC()
skips them.
The dry run and the download query the PDC API at
https://pdc.cancer.gov/graphql. Biospecimen and clinical
tables are cached for the R session, so a dry run followed by a download
fetches each one only once.
The CPTAC data are provided under the PDC Data Use Agreement at https://proteomic.datacommons.cancer.gov/pdc/data-use-guidelines. Read it before running the next chunk, which accepts it on your behalf for this document:
A dry run shows, for each study, whether it has a matrix and how many patients and aliquots it covers, without downloading any matrix:
getCPTAC("CPTAC CCRCC Discovery Study", dry_run = TRUE)
#> experiment pdc_study_id quant_available patients aliquots
#> 1 Phosphoproteome PDC000128 TRUE 110 194
#> 2 Proteome PDC000127 TRUE 110 194By default getCPTAC() downloads every study of the
cohort that has a matrix. Use experiments to choose some of
them. Here we download the proteome only:
ccrcc <- getCPTAC("CPTAC CCRCC Discovery Study", experiments = "Proteome")
ccrcc
#> A MultiAssayExperiment object of 1 listed
#> experiment with a user-defined name and respective class.
#> Containing an ExperimentList class object of length 1:
#> [1] Proteome: SummarizedExperiment with 9591 rows and 194 columns
#> Functionality:
#> experiments() - obtain the ExperimentList instance
#> colData() - the primary/phenotype DataFrame
#> sampleMap() - the sample coordination DataFrame
#> `$`, `[`, `[[` - extract colData columns, subset, or experiment
#> *Format() - convert into a long or wide DataFrame
#> assays() - convert ExperimentList to a SimpleList of matrices
#> exportClass() - save data to flat filesEach experiment is a SummarizedExperiment with one
assay, named after its data_type. For TMT studies this is
log2_ratio: the log2 ratio of a sample’s abundance to the
common reference the PDC used for the whole study. Label-free studies
have precursor_area instead, which is not on a log
scale.
Columns keep the labels of the PDC matrix, which for these cohorts
are the PDC aliquot identifiers. Technical replicates keep the
.1, .2 suffix the PDC gives them; use
replicates = "first" to keep only the first replicate of
each sample. Reference channels, such as the internal reference pool, QC
samples and NCI-7 cell lines, are dropped.
The colData of each experiment describes its
samples:
colData(ccrcc[["Proteome"]])
#> DataFrame with 194 rows and 5 columns
#> case_submitter_id sample_submitter_id aliquot_submitter_id
#> <character> <character> <character>
#> CPT0000640003 C3L-00103 C3L-00103-02 CPT0000640003
#> CPT0000660001 C3L-00103 C3L-00103-06 CPT0000660001
#> CPT0000780007 C3L-00097 C3L-00097-01 CPT0000780007
#> CPT0000790001 C3L-00097 C3L-00097-06 CPT0000790001
#> CPT0000870016 C3L-00088 C3L-00088-01 CPT0000870016
#> ... ... ... ...
#> CPT0092310003 C3L-01861 C3L-01861-06 CPT0092310003
#> CPT0092730003 C3L-01882 C3L-01882-01 CPT0092730003
#> CPT0092740003 C3L-01882 C3L-01882-06 CPT0092740003
#> CPT0092790003 C3L-01885 C3L-01885-03 CPT0092790003
#> CPT0092800003 C3L-01885 C3L-01885-06 CPT0092800003
#> sample_type pdc_column
#> <character> <character>
#> CPT0000640003 Primary Tumor CPT0000640003
#> CPT0000660001 Solid Tissue Normal CPT0000660001
#> CPT0000780007 Primary Tumor CPT0000780007
#> CPT0000790001 Solid Tissue Normal CPT0000790001
#> CPT0000870016 Primary Tumor CPT0000870016
#> ... ... ...
#> CPT0092310003 Solid Tissue Normal CPT0092310003
#> CPT0092730003 Primary Tumor CPT0092730003
#> CPT0092740003 Solid Tissue Normal CPT0092740003
#> CPT0092790003 Primary Tumor CPT0092790003
#> CPT0092800003 Solid Tissue Normal CPT0092800003
table(ccrcc[["Proteome"]][["sample_type"]])
#>
#> Primary Tumor Solid Tissue Normal
#> 110 84The sampleMap links each column to its patient, so a
patient’s tumor and normal samples share one row of the
colData of the MultiAssayExperiment. That
colData holds the PDC clinical data, with values kept as
the PDC reports them:
head(colData(ccrcc)[, c("gender", "primary_diagnosis", "tumor_grade")])
#> DataFrame with 6 rows and 3 columns
#> gender primary_diagnosis tumor_grade
#> <character> <character> <character>
#> C3L-00004 male Renal cell carcinoma.. G3
#> C3L-00010 male Renal cell carcinoma.. G3
#> C3L-00011 female Renal cell carcinoma.. G4
#> C3L-00026 female Renal cell carcinoma.. G3
#> C3L-00079 male Renal cell carcinoma.. G3
#> C3L-00088 male Renal cell carcinoma.. G2Each experiment also records where its data came from, including the PDC study version and the time the matrix was downloaded:
S4Vectors::metadata(ccrcc[["Proteome"]])
#> $pdc_study_id
#> [1] "PDC000127"
#>
#> $pdc_name
#> [1] "CPTAC CCRCC Discovery Study - Proteome"
#>
#> $data_type
#> [1] "log2_ratio"
#>
#> $source
#> [1] "https://pdc.cancer.gov/graphql"
#>
#> $pdc_study_version
#> [1] "1"
#>
#> $pdc_study_uuid
#> [1] "dbe94609-1fb3-11e9-b7f8-0a80fada099c"
#>
#> $retrieved
#> [1] "2026-11-18 17:40:34 UTC"
#>
#> $CPTACdata_version
#> [1] "0.99.10"sessionInfo()
#> R version 4.6.2 (2026-10-29)
#> Platform: x86_64-pc-linux-gnu
#> Running under: Ubuntu 26.04.1 LTS
#>
#> Matrix products: default
#> BLAS: /usr/lib/x86_64-linux-gnu/openblas-pthread/libblas.so.3
#> LAPACK: /usr/lib/x86_64-linux-gnu/openblas-pthread/libopenblasp-r0.3.32.so; LAPACK version 3.12.0
#>
#> locale:
#> [1] LC_CTYPE=en_US.UTF-8 LC_NUMERIC=C
#> [3] LC_TIME=en_US.UTF-8 LC_COLLATE=en_US.UTF-8
#> [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
#>
#> time zone: Etc/UTC
#> tzcode source: system (glibc)
#>
#> attached base packages:
#> [1] stats4 stats graphics grDevices utils datasets methods
#> [8] base
#>
#> other attached packages:
#> [1] MultiAssayExperiment_1.39.1 SummarizedExperiment_1.43.0
#> [3] Biobase_2.73.2 GenomicRanges_1.65.4
#> [5] Seqinfo_1.3.2 IRanges_2.47.5
#> [7] S4Vectors_0.51.10 BiocGenerics_0.59.13
#> [9] generics_0.1.4 MatrixGenerics_1.25.0
#> [11] matrixStats_1.5.0 CPTACdata_0.99.10
#> [13] BiocStyle_2.41.0
#>
#> loaded via a namespace (and not attached):
#> [1] Matrix_1.7-6 jsonlite_2.0.0 compiler_4.6.2
#> [4] BiocManager_1.30.27 jquerylib_0.1.4 yaml_2.3.12
#> [7] fastmap_1.2.0 lattice_0.23-1 XVector_0.53.0
#> [10] R6_2.6.1 S4Arrays_1.13.2 curl_8.1.0
#> [13] httr2_1.3.0 knitr_1.52 DelayedArray_0.39.8
#> [16] maketools_1.3.2 bslib_0.12.0 rlang_1.3.0
#> [19] cachem_1.1.0 xfun_0.62 sass_0.4.10
#> [22] sys_3.4.3 otel_0.3.0 SparseArray_1.13.5
#> [25] cli_3.6.6 magrittr_2.0.5 digest_0.6.39
#> [28] grid_4.6.2 lifecycle_1.0.5 glue_1.8.1
#> [31] evaluate_1.0.5 buildtools_1.0.0 abind_1.4-8
#> [34] rmarkdown_2.32 tools_4.6.2 htmltools_0.5.9