Skip to content
AdafedePublic

Repository files navigation

sapid

Lifecycle: experimental R-CMD-check Codecov test coverage r-universe badge DOI

A Strategy to Analyze Plant Extracts Taste in Depth (SAPID).

sapid integrates sensory panel data (free profiling, projective napping, Chasselas model-wine modulation, and 3-AFC recognition threshold testing) with untargeted LC-MS feature tables, Charged Aerosol Detection (CAD) semi-quantification, taxonomically informed metabolite annotations (TIMA), and 1D proton NMR spectral clustering. It accompanies the study of Swertia chirayita bitter extracts published in Current Research in Food Science (https://doi.org/10.1016/j.crfs.2025.101043).

Installation

Install sapid along with its CRAN, Bioconductor, and R-universe dependencies:

if (!requireNamespace("BiocManager", quietly = TRUE)) {
  install.packages("BiocManager", repos = "https://cloud.r-project.org")
}
install.packages(
  "sapid",
  repos = c(
    "https://adafede.r-universe.dev",
    "https://taxonomicallyinformedannotation.r-universe.dev",
    BiocManager::repositories(),
    "https://cloud.r-project.org"
  )
)

Quick Start

The bundled datasets let you run descriptor harmonization and panel consistency filtering immediately after installation:

library(sapid)
#> Welcome to sapid
#> To cite sapid in publications use:  Rutz A (2026). _sapid: A Strategy to Analyze Plant Extracts Taste In
#>   Depth_. R package, version 0.0.0.9002.  Adriano Rutz; Pascale Deneulin; Ivano Tonutti; Benoit Bach and
#>   Jean-Luc Wolfender. (5 April 2025). SAPID: a Strategy to Analyze
#>   Plant Extracts Taste In Depth. Application to the complex taste of
#>   Swertia chirayita (Roxb.) H.Karst. Current Research in Food Science.
#>   doi:10.1016/j.crfs.2025.101043.To see these entries in BibTeX format, use 'format(<citation>,
#> bibtex=TRUE)', or 'toBibtex(.)'.

harmonize_terms(
  dictionary = dictionary_generic,
  x = c("amer", "acidité", "ferreux"),
  mode = "word"
)
#> [1] "BITTER"   "ACID"     "METALLIC"

consistent <- load_consistent_profiles(profiles, min_jury = 2L)
head(
  consistent[, c("fraction", "session", "jury", "taste_original", "taste", "value")],
  6L
)
#>      fraction    session    jury taste_original  taste value
#> 1 fraction_17 session_01 jury_08       AMERTUME BITTER   0.0
#> 2 fraction_17 session_01 jury_11           AMER BITTER   2.5
#> 3 fraction_17 session_01 jury_13   MINERAL AMER BITTER   3.8
#> 4 fraction_17 session_01 jury_16       AMERTUME BITTER   3.3
#> 5 fraction_18 session_01 jury_08       AMERTUME BITTER   4.7
#> 6 fraction_18 session_01 jury_11           AMER BITTER   2.4

Package Scope and Data Requirements

sapid includes 10 datasets (chasselas, concentration_afc, dictionary_generic, dictionary_napping, dictionary_specific, fractions, groups, napping_coordinates, napping_descriptors, profiles) and 24 exported functions. End-to-end LC-MS/CAD/NMR ingestion functions require external raw files that are not bundled in the installed package due to file size.

Workflow stage Exported functions Required input
Term harmonization and filtering harmonize_terms(), harmonize_terms_df(), load_consistent_profiles() Bundled dictionaries and profiles (or user data frames)
Sensory and psychophysical visualization plot_profiles() (sensory mode), plot_napping(), plot_chasselas_variation(), plot_chasselas_modulation(), plot_concentration(), plot_descriptors_network(), plot_matrices(), geom_sigmoid(), sigmoid() Bundled datasets (profiles, napping_*, chasselas, concentration_afc, fractions)
Raw sensory spreadsheet import load_session(), get_session_info(), prepare_profiles(), prepare_napping(), prepare_chasselas(), prepare_concentration(), plot_informed_tasting() External tasting session .xlsx/TSV exports and fraction mass tables
LC-MS, CAD, and TIMA correlation prepare_chemical_profiles(), correlate_ion_taste_intensities(), plot_correlations(), plot_profiles() (chemical/combined modes) External MZmine .csv, .mzML, CAD peak lists, and TIMA annotations
1D proton NMR clustering cluster_nmr(), plot_chromatograms() External 1D NMR directories (AlpsNMR) and chromatographic index tables

Documentation and Contributing

Main Citations

If you use sapid or its upstream metabolomics tools, please cite the relevant publications and specific database versions used in your analysis:

SAPID

mzmine

SIRIUS

LOTUS

ISDB

TIMA

Others

Additional Software Credits

Package Version Citation
AlpsNMR 4.14.0 Madrid-Gambin et al. (2020)
base 4.6.2 R Core Team (2026)
BiocManager 1.30.27 Morgan and Ramos (2025)
BiocVersion 3.23.1 Morgan (2025)
cascade 0.0.0.9003 Rutz and Wolfender (2023); Rutz (2026a)
data.table 1.18.6.1 Barrett et al. (2026)
dendextend 1.19.1 Galili (2015)
FactoMineR 2.18 Lê et al. (2008)
ggpubr 1.0.0 Kassambara (2026)
ggraph 2.2.2 Pedersen (2025)
ggrepel 0.9.8 Slowikowski (2026)
igraph 2.3.4 Csárdi and Nepusz (2006); Antonov et al. (2023); Csárdi et al. (2026)
knitr 1.52 Xie (2014); Xie (2015); Xie (2026)
rmarkdown 2.32 Xie et al. (2018); Xie et al. (2020); Allaire et al. (2026)
sapid 0.0.0.9002 Rutz et al. (2025); Rutz (2026b)
SensoMineR 1.28 Husson et al. (2025)
tidyverse 2.0.0 Wickham et al. (2019)
tinytest 1.4.3 van der Loo (2020)
treemapify 2.6.1 Wilkins (2026)
withr 3.0.3 Hester et al. (2026)

Allaire, JJ, Yihui Xie, Christophe Dervieux, et al. 2026. rmarkdown: Dynamic Documents for r. https://github.com/rstudio/rmarkdown.

Antonov, Michael, Gábor Csárdi, Szabolcs Horvát, et al. 2023. “Igraph Enables Fast and Robust Network Analysis Across Programming Languages.” arXiv Preprint arXiv:2311.10260, ahead of print. https://doi.org/10.48550/arXiv.2311.10260.

Barrett, Tyson, Matt Dowle, Arun Srinivasan, et al. 2026. data.table: Extension of “data.frame”. https://doi.org/10.32614/CRAN.package.data.table.

Csárdi, Gábor, and Tamás Nepusz. 2006. “The Igraph Software Package for Complex Network Research.” InterJournal Complex Systems: 1695. https://igraph.org.

Csárdi, Gábor, Tamás Nepusz, Vincent Traag, et al. 2026. igraph: Network Analysis and Visualization in r. https://doi.org/10.5281/zenodo.7682609.

Galili, Tal. 2015. “dendextend: An r Package for Visualizing, Adjusting, and Comparing Trees of Hierarchical Clustering.” Bioinformatics, ahead of print. https://doi.org/10.1093/bioinformatics/btv428.

Hester, Jim, Lionel Henry, Kirill Müller, Kevin Ushey, Hadley Wickham, and Winston Chang. 2026. withr: Run Code “With” Temporarily Modified Global State. https://doi.org/10.32614/CRAN.package.withr.

Husson, Francois, Sebastien Le, and Marine Cadoret. 2025. SensoMineR: Sensory Data Analysis. https://doi.org/10.32614/CRAN.package.SensoMineR.

Kassambara, Alboukadel. 2026. ggpubr: “ggplot2” Based Publication Ready Plots. https://CRAN.R-project.org/package=ggpubr.

Lê, Sébastien, Julie Josse, and François Husson. 2008. “FactoMineR: A Package for Multivariate Analysis.” Journal of Statistical Software 25 (1): 1–18. https://doi.org/10.18637/jss.v025.i01.

Madrid-Gambin, Francisco, Oller-Moreno, et al. 2020. “AlpsNMR: An r Package for Signal Processing of Fully Untargeted NMR-Based Metabolomics.” Bioinformatics, ahead of print, January. https://doi.org/10.1093/bioinformatics/btaa022.

Morgan, Martin. 2025. BiocVersion: Set the Appropriate Version of Bioconductor Packages.

Morgan, Martin, and Marcel Ramos. 2025. BiocManager: Access the Bioconductor Project Package Repository. https://doi.org/10.32614/CRAN.package.BiocManager.

Pedersen, Thomas Lin. 2025. ggraph: An Implementation of Grammar of Graphics for Graphs and Networks. https://doi.org/10.32614/CRAN.package.ggraph.

R Core Team. 2026. R: A Language and Environment for Statistical Computing. R Foundation for Statistical Computing. https://doi.org/10.32614/R.manuals.

Rutz, Adriano. 2026a. cascade: Contextualizing Untargeted Annotation with Semi-Quantitative Charged Aerosol Detection for Pertinent Characterization of Natural Extracts.

Rutz, Adriano. 2026b. sapid: A Strategy to Analyze Plant Extracts Taste in Depth.

Rutz, Adriano, Pascale Deneulin, Ivano Tonutti, Benoit Bach, and Jean-Luc Wolfender. 2025. “SAPID: A Strategy to Analyze Plant Extracts Taste in Depth. Application to the Complex Taste of Swertia Chirayita (Roxb.) h.karst.” Current Research in Food Science, ahead of print. https://doi.org/10.1016/j.crfs.2025.101043.

Rutz, Adriano, and Jean-Luc Wolfender. 2023. “Automated Composition Assessment of Natural Extracts: Untargeted Mass Spectrometry-Based Metabolite Profiling Integrating Semiquantitative Detection.” Journal of Agricultural and Food Chemistry 71 (46). https://doi.org/10.1021/acs.jafc.3c03099.

Slowikowski, Kamil. 2026. ggrepel: Automatically Position Non-Overlapping Text Labels with “ggplot2”. https://doi.org/10.32614/CRAN.package.ggrepel.

van der Loo, MPJ. 2020. “A Method for Deriving Information from Running r Code.” The R Journal 13: 42–52. https://journal.r-project.org/articles/RJ-2021-056/.

Wickham, Hadley, Mara Averick, Jennifer Bryan, et al. 2019. “Welcome to the tidyverse.” Journal of Open Source Software 4 (43): 1686. https://doi.org/10.21105/joss.01686.

Wilkins, David. 2026. treemapify: Draw Treemaps in “ggplot2”. https://doi.org/10.32614/CRAN.package.treemapify.

Xie, Yihui. 2014. “knitr: A Comprehensive Tool for Reproducible Research in R.” In Implementing Reproducible Computational Research, edited by Victoria Stodden, Friedrich Leisch, and Roger D. Peng. Chapman; Hall/CRC.

Xie, Yihui. 2015. Dynamic Documents with R and Knitr. 2nd ed. Chapman; Hall/CRC. https://yihui.org/knitr/.

Xie, Yihui. 2026. knitr: A General-Purpose Package for Dynamic Report Generation in R. https://yihui.org/knitr/.

Xie, Yihui, J. J. Allaire, and Garrett Grolemund. 2018. R Markdown: The Definitive Guide. Chapman; Hall/CRC. https://pkg.yihui.org/rmarkdown-book/.

Xie, Yihui, Christophe Dervieux, and Emily Riederer. 2020. R Markdown Cookbook. Chapman; Hall/CRC. https://pkg.yihui.org/rmarkdown-cookbook/.

Releases

Sponsor this project

Packages

Used by

Contributors

Languages