tbnb: Threshold-Based and Iterative Threshold-Based Naive Bayes Classifier

Implements the Threshold-Based Naive Bayes (Tb-NB) classifier and its iterative refinement (iTb-NB) for binary sentiment / text classification problems. The classifier computes a continuous log-likelihood ratio score per document and uses a data-driven decision threshold estimated via K-fold cross-validation on a user-selected criterion (accuracy, F1 score, Matthews correlation coefficient, balanced error, etc.). An optional iterative refinement procedure locally re-estimates the threshold in regions of class overlap using either Gaussian kernel density estimation or a Central Limit Theorem bootstrap approximation. The package exposes an idiomatic R formula + data.frame interface together with a 'quanteda'-based text preprocessing pipeline, supports user-supplied document-feature matrices, and includes an optional word-embedding extension that augments the Bag-of-Words with K nearest semantic neighbours of each token. The package additionally implements the p-value extension proposed by Romano (2025) for both document- and feature-level interpretability via tbnb_pvalues(). Methods are described in Romano, Contu, Mola, Conversano (2024) <doi:10.1007/s11634-023-00536-8>, Romano, Zammarchi, Conversano (2024) <doi:10.1007/s10260-023-00721-1>, and Romano (2025) <doi:10.1007/978-3-031-96736-8_41>.

Version: 0.1.0
Depends: R (≥ 4.0)
Imports: Matrix, methods, stats, grDevices, graphics, quanteda (≥ 3.0.0)
Suggests: text2vec, stopwords, SnowballC, cld2, cld3, dbscan, viridisLite, testthat (≥ 3.0.0), ggplot2
Published: 2026-07-21
DOI: 10.32614/CRAN.package.tbnb (may not be active yet)
Author: Maurizio Romano [aut, cre]
Maintainer: Maurizio Romano <romano.maurizio at unica.it>
License: GPL (≥ 3)
NeedsCompilation: no
Language: en-GB
Materials: README, NEWS
CRAN checks: tbnb results

Documentation:

Reference manual: tbnb.html , tbnb.pdf
Vignettes: Introduction to tbnb (source, R code)

Downloads:

Package source: tbnb_0.1.0.tar.gz
Windows binaries: r-devel: not available, r-release: not available, r-oldrel: not available
macOS binaries: r-release (arm64): tbnb_0.1.0.tgz, r-oldrel (arm64): tbnb_0.1.0.tgz, r-release (x86_64): tbnb_0.1.0.tgz, r-oldrel (x86_64): tbnb_0.1.0.tgz

Linking:

Please use the canonical form https://CRAN.R-project.org/package=tbnb to link to this page.