Version Compatibility
Reference examples tested with: numpy 1.26+, pandas 2.2+
Before using code patterns, verify installed versions match. If versions differ:
- Python:
pip show <package> then help(module.function) to check signatures
- R:
packageVersion('<pkg>') then ?function_name to verify parameters
- CLI:
<tool> --version then <tool> --help to confirm flags
If code throws ImportError, AttributeError, or TypeError, introspect the installed
package and adapt the example to match the actual API rather than retrying.
DIA Proteomics Analysis
"Analyze my DIA proteomics data" → Process data-independent acquisition MS data to identify and quantify proteins using library-free or library-based workflows.
- CLI:
diann for end-to-end DIA analysis with neural network scoring
- CLI:
EncyclopeDIA for chromatogram library-based quantification
DIA-NN Library-Free Analysis
Goal: Run DIA proteomics analysis without a pre-built spectral library, generating one from the data itself.
Approach: Use DIA-NN in library-free mode with FASTA-based in silico digestion and deep learning prediction.
# Library-free mode (generates library from data)
diann \
--f sample1.mzML \
--f sample2.mzML \
--lib "" \
--threads 8 \
--verbose 1 \
--out report.tsv \
--qvalue 0.01 \
--matrices \
--out-lib generated_lib.tsv \
--gen-spec-lib \
--predictor \
--fasta uniprot_human.fasta \
--fasta-search \
--min-fr-mz 200 \
--max-fr-mz 1800 \
--met-excision \
--cut K*,R* \
--missed-cleavages 1 \
--min-pep-len 7 \
--max-pep-len 30 \
--min-pr-mz 300 \
--max-pr-mz 1800 \
--min-pr-charge 1 \
--max-pr-charge 4 \
--unimod4 \
--var-mods 1 \
--var-mod UniMod:35,15.994915,M \
--reanalyse \
--smart-profiling
DIA-NN with Spectral Library
Goal: Analyze DIA data using a pre-built or predicted spectral library for targeted extraction.
Approach: Supply an existing spectral library to DIA-NN for guided peptide detection and quantification.
# Use pre-built or predicted library
diann \
--f sample1.mzML \
--f sample2.mzML \
--lib spectral_library.tsv \
--threads 8 \
--verbose 1 \
--out report.tsv \
--qvalue 0.01 \
--matrices \
--reanalyse \
--smart-profiling
DIA-NN Output Files
report.tsv # Main quantification report (long format)
report.stats.tsv # Run statistics
report.pg_matrix.tsv # Protein group quantities (wide format)
report.pr.matrix.tsv # Precursor quantities (wide format)
report.gg_matrix.tsv # Gene group quantities (wide format)
generated_lib.tsv # Generated spectral library (if requested)
Load DIA-NN Results in R
Goal: Import DIA-NN quantification output into R for downstream statistical analysis.
Approach: Read the protein group matrix, convert to numeric matrix, and log2-transform raw intensities.
library(tidyverse)
# Load main report
report <- read_tsv('report.tsv')
# Load protein matrix (already wide format)
proteins <- read_tsv('report.pg_matrix.tsv')
# Filter and reshape for analysis
protein_matrix <- proteins %>%
column_to_rownames('Protein.Group') %>%
select(starts_with('sample')) %>%
as.matrix()
# Log2 transform (DIA-NN outputs raw intensities)
log2_matrix <- log2(protein_matrix)
log2_matrix[is.infinite(log2_matrix)] <- NA
Load DIA-NN Results in Python
Goal: Import DIA-NN quantification output into Python for downstream analysis.
Approach: Read the protein group matrix with pandas and log2-transform, replacing zeros with NaN.
import pandas as pd
import numpy as np
# Load main report
report = pd.read_csv('report.tsv', sep='\t')
# Load protein matrix
proteins = pd.read_csv('report.pg_matrix.tsv', sep='\t')
proteins = proteins.set_index('Protein.Group')
# Log2 transform
log2_proteins = np.log2(proteins.replace(0, np.nan))
MSFragger-DIA Analysis
Goal: Perform DIA analysis using MSFragger as an alternative to DIA-NN.
Approach: Generate a predicted spectral library with EasyPQP from search results, then convert to the desired format.
# MSFragger for DIA (alternative to DIA-NN)
# Requires FragPipe GUI or command-line workflow
# Generate predicted library with EasyPQP
easypqp library \
--in psm_results.tsv \
--out library.pqp \
--psmtsv \
--rt_reference irt.tsv
# Convert to DIA-NN format
easypqp convert \
--in library.pqp \
--out library.tsv \
--format diann
Spectronaut Export Processing
Goal: Convert Spectronaut long-format report into a protein-level quantification matrix.
Approach: Pivot the Spectronaut output from long to wide format using protein group quantities.
# Load Spectronaut report
spectronaut <- read_tsv('spectronaut_report.tsv')
# Pivot to protein matrix
protein_matrix <- spectronaut %>%
select(PG.ProteinGroups, R.FileName, PG.Quantity) %>%
pivot_wider(names_from = R.FileName, values_from = PG.Quantity) %>%
column_to_rownames('PG.ProteinGroups')
DIA Quality Metrics
Goal: Assess DIA data quality by summarizing identification counts and missing value rates per run.
Approach: Count unique precursors, proteins, and genes per run, then calculate missing value percentages from the protein matrix.
library(tidyverse)
report <- read_tsv('report.tsv')
# Identifications per run
ids_per_run <- report %>%
group_by(Run) %>%
summarise(
precursors = n_distinct(Precursor.Id),
proteins = n_distinct(Protein.Group),
genes = n_distinct(Genes)
)
# Missing value analysis
proteins <- read_tsv('report.pg_matrix.tsv')
protein_values <- proteins %>% select(-Protein.Group)
missing_pct <- colSums(protein_values == 0 | is.na(protein_values)) / nrow(protein_values) * 100
Match Between Runs
Goal: Transfer peptide identifications between runs to reduce missing values.
Approach: Enable DIA-NN's two-pass reanalysis with the --reanalyse flag for automatic match-between-runs.
# DIA-NN MBR is automatic with --reanalyse flag
# First pass: identifies peptides per run
# Second pass: transfers IDs between runs
diann \
--f *.mzML \
--lib library.tsv \
--reanalyse \
--out report_mbr.tsv
DIA vs DDA Comparison
| Feature | DIA | DDA |
|---|
| Acquisition | All precursors fragmented | Top-N precursors selected |
| Missing values | Lower (5-20%) | Higher (30-50%) |
| Dynamic range | Better for low-abundance | Better for high-abundance |
| Library required | Optional (library-free) | Not applicable |
| Quantification | More reproducible | More variable |
| Analysis tools | DIA-NN, Spectronaut | MaxQuant, MSFragger |
Related Skills
- data-import - Load raw MS data
- spectral-libraries - Build and use spectral libraries
- quantification - Normalization methods
- differential-abundance - Statistical testing