apbCatalogR apbCatalogR logo

apb-catalog's API in R: look up the fields of an APB result by meaning, such as a PEP or an unnormalized intensity, without naming vendor columns.

New API. This package is new, and its API may still change between releases. Feedback is very welcome: open an issue with what you need, what surprised you, or what broke.

Documentation: anndata-omics-bridge.github.io/apbCatalogR, with the vignette as the walkthrough.

Catalog viewer: fgcz-ms.uzh.ch/public/apb-catalog, every set with its entries, requirements and coverage, in the browser.

Contributing: the sets can be extended to suit your application, and you are welcome to create your own; see Contributing.

Who does what: apb2 converts the results of quantification software into an APB result and the integrator fills the catalog; Bioconductor applications such as prolfqua, exploreDE and QFeatures read the result by meaning through the apb-catalog API, in R with apbCatalogR.

APB

The AnnData Proteomics Bridge, apb2, converts the reports of proteomics quantification software into one result layout. Declarative parse rules describe each vendor table, so one parser reads them all.

Columns keep the vendor's names: the posterior error probability is PEP in MaxQuant and DIA-NN, EG_PEP in Spectronaut.

apb-catalog

apb-catalog records what those columns mean, in reviewed sets. A consumer asks a set by key, such as pep or intensity, and gets the column.

Set Fields
abundance_alpha Intensities, and whether the software normalizes them across runs
confidence_alpha PEP and q-values per run and per feature
proteobench_entrapment_alpha Precursor q-values for ProteoBench's entrapment scoring
apb_alpha Fields apb2 convert writes for every vendor: ProForma identifiers, decoy and contaminant flags
obs_annotation_alpha Each run's group and subject, from an SDRF or a prolfquapp table
fasta_peptides_alpha apb-fasta's peptide verification, once apb-fasta verify-peptides has run
fasta_proteins_alpha apb-fasta's protein annotation, once apb-fasta merge-annotations has run
chromatography_alpha Retention times, peak bounds and widths, with their unit

A lookup answers one of three ways:

This package

apbCatalogR is apb-catalog's Python API in R, as R6 classes with the same names and methods. Snapshots are not ported: DataCatalog$snapshot(), $resolve(), attach_snapshot() and ResolutionSnapshot have no R counterpart. It needs no Python: the catalog comes from a bundle shipped with the package.

Call Answers
Catalog$new(software, software_version, set_name) From the catalog alone, without data
DataCatalog$new(result, set) On one result, the named sets alone, and returns the data
sets(), rule_coverage(), catalog_table() The sets, how each rule covers a set, every entry as a table
read_parsed_levels(path) An APB result, .h5ad, .parquet or .duckdb, as ParsedLevels, one anndataR AnnData per level

It does not convert vendor files. Convert with apb2; any of its h5ad, Parquet or DuckDB results reads the same:

apb2 convert DATA --params PARAMETER_FILE --format parquet --output result   # writes result.parquet

Install

install.packages(c("BiocManager", "remotes"))
BiocManager::install("anndata-omics-bridge/apbCatalogR")

Reading .h5ad results needs nothing more. Parquet results need arrow, DuckDB results duckdb and DBI:

install.packages(c("arrow", "duckdb", "DBI"))

Use

Ask the catalog which column a software version reports:

library(apbCatalogR)
diann <- Catalog$new("DIA-NN", "2.2.0", "abundance_alpha")$levels$peptidoform_ion
diann$layers$keys()
#> [1] "intensity"                   "intensity_ms1"
#> [3] "intensity_ms1_norm_settings" "intensity_norm_settings"
diann$layers[["intensity"]]
#> [1] "Precursor_Quantity"

Get the data of a result:

result <- read_parsed_levels("result.parquet")
ion <- DataCatalog$new(result, "confidence_alpha", "apb_alpha")$levels$peptidoform_ion
ion$layers                     # key -> matrix, runs x features
ion$var                        # key -> vector, one value per feature
pep <- ion$layers$get("pep")   # runs x features matrix, NULL when absent
ion$var[c("peptidoform_ion")]  # a data.frame

The bundle

apb-catalog builds two bundles at each release:

How R gets the latest bundle:

AI use and provenance

AI coding agents helped write this package:

Provenance and licence:

The maintainer is responsible for all code in this package, whatever helped write it, and for its reliability and maintenance.