Downloading CPTAC cohorts as MultiAssayExperiment objects

Overview

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")).

library(CPTACdata)
library(MultiAssayExperiment)

Which cohorts are available?

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_ratio

Some 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.

Downloading a cohort

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:

options(CPTACdata.acceptDUA = TRUE)

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      194

By 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 files

What the object contains

Each 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                  84

The 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..          G2

Each 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"

Session info

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