Package: NADIA 0.99.3

Sergio Ciordia

NADIA: Missing Value-Aware Differential Abundance Analysis of DIA Proteomics Data

Provides an end-to-end workflow for differential abundance analysis of protein quantification data, with particular attention to missing values in data-independent acquisition (DIA) proteomics. Quantification reports exported from Spectronaut, DIA-NN and Proteome Discoverer for TMT and label-free experiments (DDA/DIA) are converted into a common data structure, normalised, optionally batch-corrected, imputed and analysed using limma or limpa. The package includes individual and two-stage imputation strategies that treat values assumed to be missing at random and missing not at random separately. Data-driven functions evaluate and rank normalisation and imputation workflows using simulated missingness or spike-in datasets with known ground truth, allowing method selection to be justified for each dataset. Results can be explored through interactive Highcharts visualisations, static ggplot2 and ComplexHeatmap figures, and sortable tables.

Authors:Sergio Ciordia [aut, cre]

NADIA_0.99.3.tar.gz
NADIA_0.99.3.zip(r-4.7-any)NADIA_0.99.3.zip(r-4.6-any)NADIA_0.99.3.zip(r-4.5-any)
NADIA_0.99.3.tgz(r-4.6-any)NADIA_0.99.3.tgz(r-4.5-any)
NADIA_0.99.3.tar.gz(r-4.7-any)NADIA_0.99.3.tar.gz(r-4.6-any)
NADIA_0.99.3.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
NADIA/json (API)

# Install 'NADIA' in R:
install.packages('NADIA', repos = c('https://bioc.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/sciordia/nadia/issues

Pkgdown/docs site:https://sciordia.github.io

Datasets:
  • nadia_dia - Example DIA experiment, already preprocessed

On CRAN:

Conda:

softwareproteomicsmassspectrometrydifferentialexpressionnormalizationqualitycontrolbatcheffect

6.41 score 3 stars 63 scripts 51 exports 82 dependencies

Last updated from:f07aa3c874. Checks:1 NOTE, 9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
bioc-checksNOTE260
linux-develOK666
source / vignettesOK424
linux-releaseOK722
macos-releaseOK640
macos-oldrelOK2634
windows-develOK732
windows-releaseOK523
windows-oldrelOK680
wasm-releaseOK177

Exports:batch_correct_proteomicsbenchmarking_multiplebenchmarking_proteomicsboxplot_highchart_listbuild_pca_scorescluster_centroids_highchartcluster_profile_highchartcluster_profile_highchart_listde_analysis_proteomicsdeps_with_clustersim_prepare_seimport_imp_matricesimport_norm_matricesimputation_metricsimpute_proteomicsnadia_add_pattern_profilernadia_connectnadia_deps_with_clustersnadia_export_parquetnadia_pattern_profilernadia_preprocessingnadia_resultnadia_skill_pathnadia_tablesnm_prepare_senm_run_normalizationsnormalization_metricsnormalize_proteomicspattern_profiler_analysispca_covariates_plotpca_highchart_listpreprocess_diannpreprocess_lfqpreprocess_sepreprocess_spectronautpreprocess_tmtprocess_proteomicsprotein_list_reactableprotein_list_widgetproteomics_heatmapproteomics_heatmap_listpvca_analysisquant_list_widgetread_nadiaread_pattern_profiler_dataresults_list_reactableresults_list_widgetsummarize_pattern_profilersummary_list_widgetvolcano_highchart_listwrite_nadia

Dependencies:abindbase64encBiobaseBiocGenericsbslibcachemcliclueclustercpp11DelayedArrayDEoptimRdigestdplyrevaluatefarverfastmapfontawesomefsgenericsGenomicRangesggplot2gluegtablehighrhtmltoolshtmlwidgetsIRangesisobandjquerylibjsonliteknitrlabelinglatticelifecyclelimmamagrittrMASSMatrixMatrixGenericsmatrixStatsmemoisemimeMsCoreUtilsmvtnormnormpcaPPpillarpkgconfigpROCpurrrR6rappdirsRColorBrewerRcpprlangrmarkdownrobustbaserrcovrrcovNAS4ArraysS4VectorsS7sassscalesSeqinfoSparseArraystatmodstringistringrSummarizedExperimenttibbletidyrtidyselecttinytexutf8vctrsviridisLitewithrxfunXVectoryaml

An introduction to NADIA
Introduction | Installation | Example data | How missing values are represented | Filtering, log2 transformation and normalization | Imputation of missing values | The workflow in a single call | Where the processed data are stored | Differential abundance results | Relationship with the missing values | Detection and non-detection patterns between conditions | Visualizing the results | Interactive figures | Static figure | NADIA and related Bioconductor packages | What NADIA adds | Using NADIA together with other packages | Next steps | Session information

Last update: 2026-10-17
Started: 2026-07-30

Batch correction: diagnose, correct, verify
Introduction | Installation | The sample annotation | A simulated batch effect | Step 1: is the design suitable for batch correction? | Step 2: how much variance does the batch explain? | Why the default hides it, and what to do | Step 3: correct, and keep the biology | Protecting a variable inside ComBat | Step 4: verify | Did the batch effect go? | Did the biology survive? | What it changed in the results | Removing two factors, one after the other | Inspecting the correction with PCA | Applying the workflow to a real batch effect | The batch has to be declared, not discovered | The decomposition finds it | Correcting it, and checking against biology | Visual assessment with PCA | Statistical significance and fold-change magnitude | References | Session information

Last update: 2026-10-17
Started: 2026-07-30

Benchmarking with a spike-in: scoring against known truth
Introduction | Installation | The experiment | Declaring the truth | Scoring a pipeline | The metrics_table summary | How TP, FP, TN and FN are defined | The confusion plots: the whole picture at once | Species-level confusion plot | Overall confusion plot | The metrics heatmap | The OpDEA metrics | Interpreting ROC curves | The full ROC curve | Zooming into the low-FPR region | Comparing search engines across FPR ranges | Volcano plots as diagnostic tools | Comparing multiple pipelines | Comparing TP, FP, TN and FN | Ranking pipelines with the OpDEA criteria | Comparing saved results and external pipelines | What this benchmark can and cannot show | References | Session information

Last update: 2026-10-17
Started: 2026-07-30

Choosing normalization and imputation methods
Introduction | Installation and packages | Normalization | What normalization does | Normalization methods available in NADIA | How normalization methods are evaluated | Comparing normalization methods with NADIA | Imputation | Why values are missing | How NADIA represents missing intensities | Imputation methods available in NADIA | How imputation methods are evaluated | Comparing imputation methods with NADIA | Applying the selected combination | Effect on differential abundance results | Practical decision guide | References and software | Session information

Last update: 2026-10-17
Started: 2026-07-30

Input formats: reports and SummarizedExperiment objects
Introduction | DIA: Spectronaut | DIA: DIA-NN | Declaring the experimental design | TMT: Proteome Discoverer | Label-free: Proteome Discoverer | Bioconductor: SummarizedExperiment | Where the design comes from | Naming the conditions | Five sources, one common object | Sample information | Identification evidence | Quantities and downstream analysis | Session information

Last update: 2026-10-17
Started: 2026-07-30

Missing values: what they mean and how to fill them
Introduction | Installation | Why values are missing | How NADIA represents missing intensities | Diagnosing missingness in the example data | Data processing shapes the missing-value pattern | Imputation strategies available in NADIA | Why one method may not represent every gap | The default hybrid: combo | softHybrid: a continuous combination | limpa: detection-aware estimates with uncertainty | Choosing among the strategies | References and software | Session information

Last update: 2026-10-17
Started: 2026-07-30

Pattern Profiler: identifying shared protein profiles
Introduction | Setup and example data | Running Pattern Profiler | Selecting proteins for clustering | Choosing the number of clusters | Understanding the soft-clustering output | Visualizing the expression patterns | Protein profiles within each cluster | Comparing cluster centroids | Saving and reusing the results | Saving the long-format table as Parquet | Storing Pattern Profiler in a NADIA project | Practical recommendations | References | Session information

Last update: 2026-10-17
Started: 2026-07-30

Results and export: sharing and preserving an analysis
Introduction | Prepare an example analysis | Install and load NADIA | Run the processing workflow | Choose an output for the task | Export tabular results | Choose between TSV and Parquet | Create a set of TSV and/or Parquet files | Archive a complete analysis | Write and read a .nadia file | Restore and verify the result | Inspect stored tables and provenance | Query or extract the archive | Combine differential abundance with clustering | Explore results with interactive tables | Save interactive HTML | Save a complete widget page | Save an individual widget as one file | Preserve reproducibility | References | Session information

Last update: 2026-10-17
Started: 2026-07-30

Visualization: exploring and presenting results
Introduction | Setup and example data | Installation | Processing the example dataset | Choosing the appropriate visualization | Interactive and static output | Highcharts license | Volcano plots | Summarizing the selected comparison | Creating and reading the plot | Labeling selected proteins and multiple comparisons | Boxplots of sample distributions | Comparing assays numerically | Creating and reading the boxplot | Principal component analysis | Comparing protein subsets | Creating and reading the PCA plot | Subset modes, ellipses, and sample filtering | Heatmaps | Selecting proteins for the heatmap | Creating and reading a focused heatmap | Annotations and repeated heatmaps | Protein pattern clusters | Building and summarizing the example clusters | Comparing cluster centroids | Inspecting representative protein profiles | Colors and consistent presentation | Exporting figures and data | Interactive charts | Static heatmaps | Practical recommendations | Session information

Last update: 2026-10-17
Started: 2026-07-30

Readme and manuals

Help Manual

Help pageTopics
Batch Correction with BERTbatch_correct_proteomics
Multiple-method OpDEA Benchmarkingbenchmarking_multiple
Benchmark Proteomics Differential Expression Resultsbenchmarking_proteomics
Interactive Highcharts Boxplot for Proteomicsboxplot_highchart_list
Build the clustering matrix aggregated by conditionbuild_clustering_matrix
Build the output table in LONG formatbuild_long_output
Build a PCA scores data frame from data in long formatbuild_pca_scores
Centroid plot for all the clusterscluster_centroids_highchart
Cluster profile plot with Highchartscluster_profile_highchart
List of cluster profile plots with Highchartscluster_profile_highchart_list
Compute the confidence ellipse per groupcompute_confidence_ellipse
Compute the convex hull (enclosing polygon) per groupcompute_hulls
Configure the colour palette for the clustersconfigure_cluster_palette
Create an ExpressionSet for Mfuzzcreate_expression_set
Perform differential expression analysis on proteomics datade_analysis_proteomics
Differential abundance with the Pattern Profiler cluster of each proteindeps_with_clusters
Detect the condition columns (z-scores)detect_condition_columns
Evaluate a range of cluster numbersevaluate_cluster_range
Extract data from a SummarizedExperimentextract_se_data
Filter features by significancefilter_significant_features
Build the Colour Palette for Categorical Annotationsget_annotation_palette
Build the Colour Palette for the Heatmap Valuesget_heatmap_palette
Build a SummarizedExperiment for imputation benchmarkingim_prepare_se
Import imputed matrices into a SummarizedExperimentimport_imp_matrices
Import normalized matrices into a SummarizedExperimentimport_norm_matrices
Generate imputation quality metric plots and rankingimputation_metrics
Impute proteomics dataimpute_proteomics
Merge significance information from DEPs_resultsmerge_significance_info
Add a Pattern Profiler run to an existing '.nadia' filenadia_add_pattern_profiler
Open a connection to a '.nadia' filenadia_connect
Differential abundance with clusters, from a '.nadia' filenadia_deps_with_clusters
Example DIA experiment, already preprocessednadia_dia
Export the tables of a '.nadia' file to Parquetnadia_export_parquet
Rebuild the Pattern Profiler table from a '.nadia' filenadia_pattern_profiler
Rebuild the preprocessing object from a '.nadia' filenadia_preprocessing
Rebuild the processing result from a '.nadia' filenadia_result
Locate the NADIA agent skillnadia_skill_path
List the contents of a '.nadia' file without loading itnadia_tables
Prepare a SummarizedExperiment from a proteomics_data objectnm_prepare_se
Run multiple normalization methods from a baseline assaynm_run_normalizations
Generate quality metric plots for normalization comparisonnormalization_metrics
Normalize proteomics datanormalize_proteomics
Pattern Profiler Analysispattern_profiler_analysis
PCA Plots Colored by Covariatespca_covariates_plot
Build a List of PCA Plots for Multiple Subsetspca_highchart_list
Prepare Long-Format Data for tidyHeatmapprepare_heatmap_data
Preprocess DIA-NN protein-group matricespreprocess_diann
Preprocess Proteome Discoverer LFQ exportspreprocess_lfq
Import Protein Intensities from a SummarizedExperimentpreprocess_se
Preprocess Spectronaut reportspreprocess_spectronaut
Preprocess Proteome Discoverer TMT exportspreprocess_tmt
Print a summary of a DIA-NN preprocessing resultprint.diann_data
Print a summary of an LFQ preprocessing resultprint.lfq_data
Print a summary of a '.nadia' fileprint.nadia_db
Draw a proteomics heatmapprint.proteomics_heatmap
Print method for proteomics_resultprint.proteomics_result
Print a Summary of Data Imported from a SummarizedExperimentprint.se_data
Print a summary of a Spectronaut preprocessing resultprint.spectronaut_data
Print a summary of a TMT preprocessing resultprint.tmt_data
Process proteomics dataprocess_proteomics
Interactive Reactable Table for Protein_ID Data (post-Spectronaut)protein_list_reactable
Full Widget for the Protein_ID Table with Filters, Search and Excel Exportprotein_list_widget
Create a tidyHeatmap Heatmap for Proteomicsproteomics_heatmap
Build a List of Heatmaps for Several Subsetsproteomics_heatmap_list
PVCA Analysis - Orchestratorpvca_analysis
Full Widget for the Protein_QUANT Table with the log2 Matrix Appendedquant_list_widget
Read a '.nadia' fileread_nadia
Read Pattern Profiler data from a parquet fileread_pattern_profiler_data
Interactive Reactable Table for Differential Expression Resultsresults_list_reactable
Full Widget with Filters, Search, Export and CSSresults_list_widget
Run Mfuzz clusteringrun_mfuzz_clustering
Select the optimal number of clustersselect_optimal_clusters
Standardise an ExpressionSet (row-wise z-score)standardize_eset
Summary of the Pattern Profiler datasummarize_pattern_profiler
Interactive Reactable Table for the Sample Metadatasummary_list_widget
Interactive Volcano Plot with Highchartervolcano_highchart_list
Wrap a Heatmap Together With Its Titlewrap_heatmap_with_title
Write a complete analysis to a single '.nadia' filewrite_nadia