Package: nuggets 2.2.4

nuggets: Fast and Extensible Pattern Discovery in Tabular Data

Fast and extensible framework for discovering interesting patterns in tabular data. The package searches combinations of fuzzy or Boolean predicates and evaluates the resulting subgroups using statistical, logical, or structural measures. It supports a broad range of pattern-discovery tasks, including association rules (Agrawal et al., 1994, <https://www.vldb.org/conf/1994/P487.PDF>), contrast patterns (Chen, 2022, <doi:10.48550/arXiv.2209.13556>), emerging patterns (Dong et al., 1999, <doi:10.1145/312129.312191>), subgroup discovery (Atzmueller, 2015, <doi:10.1002/widm.1144>), and conditional correlations (Hájek, 1978, <doi:10.1007/978-3-642-66943-9>). User-defined functions may be supplied to guide custom pattern searches, making the framework applicable beyond traditional association-rule mining. Efficient implementation enables pattern discovery on large and dense data sets. Package includes methods for visualization and supports interactive exploration through integrated Shiny applications.

Authors:Michal Burda [aut, cre]

nuggets_2.2.4.tar.gz
nuggets_2.2.4.zip(r-4.7-x86_64)nuggets_2.2.4.zip(r-4.7-arm64)nuggets_2.2.4.zip(r-4.6-x86_64)nuggets_2.2.4.zip(r-4.6-arm64)nuggets_2.2.4.zip(r-4.5-x86_64)
nuggets_2.2.4.tgz(r-4.6-x86_64)nuggets_2.2.4.tgz(r-4.6-arm64)nuggets_2.2.4.tgz(r-4.5-x86_64)nuggets_2.2.4.tgz(r-4.5-arm64)
nuggets_2.2.4.tar.gz(r-4.7-arm64)nuggets_2.2.4.tar.gz(r-4.7-x86_64)nuggets_2.2.4.tar.gz(r-4.6-arm64)nuggets_2.2.4.tar.gz(r-4.6-x86_64)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
nuggets/json (API)

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

Bug tracker:https://github.com/beerda/nuggets/issues

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

Uses libs:
  • c++– GNU Standard C++ Library v3

On CRAN:

Conda:

association-rule-miningassociation-rulescontrast-pattern-miningdata-miningfrequent-itemset-miningfrequent-itemsetsfrequent-pattern-miningfrequent-patternsfuzzy-association-rulesfuzzy-logicknowledge-discoverypattern-miningpattern-recognitionsubgroup-discoverycpp

7.42 score 9 stars 29 scripts 514 downloads 35 exports 53 dependencies

Last updated from:a99fa5baec. Checks:14 OK, 1 FAIL. Indexed: yes.

TargetResultTimeFilesSyslog
linux-devel-arm64OK217
linux-devel-x86_64OK200
source / vignettesOK374
linux-release-arm64OK212
linux-release-x86_64OK256
macos-release-arm64OK307
macos-release-x86_64OK407
macos-oldrel-arm64OK216
macos-oldrel-x86_64OK360
windows-devel-arm64OK419
windows-devel-x86_64OK361
windows-release-arm64OK352
windows-release-x86_64OK331
windows-oldrel-x86_64OK193
wasm-releaseFAIL111

Exports:add_interestassociation_matrixbound_rangecluster_associationsdigdig_ancestorsdig_associationsdig_baseline_contrastsdig_complement_contrastsdig_correlationsdig_griddig_paired_baseline_contrastsdig_tautologiesexplorefireformat_conditiongeom_diamondis_almost_constantis_conditionis_degreeis_logicalishis_nuggetis_subsetnuggetparse_conditionpartitionpermuteplot_contingencyremove_almost_constantremove_ill_conditionsshorten_conditionvaluesvar_gridvar_nameswhich_antichain

Dependencies:briocallrclassclassIntclicpp11crayondescdiffobjdplyre1071evaluatefarverfastmatchfsgenericsggplot2gluegtableisobandjsonliteKernSmoothlabelinglifecyclemagrittrotelpillarpkgbuildpkgconfigpkgloadpraiseprocessxproxypspurrrR6RColorBrewerRcpprlangrprojrootS7scalesstringistringrtestthattibbletidyrtidyselectutf8vctrsviridisLitewaldowithr

Comparison of nuggets performance with arules and fim4r
Introduction | Materials and Methods | Results | Dense data: varying number of rows | Dense data: varying number of columns | Sparse data: varying number of rows | Sparse data: varying number of columns | Discussion | Summary

Last update: 2026-09-21
Started: 2026-08-17

Conditional Correlations
Introduction | A Small Working Dataset | Basic Conditional Correlation Search | Controlling the Search Space | Choosing the Correlation Method | Correlations on the Whole Dataset | Notes on Interpretation | Multiple Comparisons | Related Tools | Summary

Last update: 2026-08-08
Started: 2026-08-08

Contrast Patterns
Introduction | A Small Working Dataset | Selecting Conditions and Variables | Baseline Contrasts | Non-parametric Baseline Contrasts | Complement Contrasts | Comparing Variability Instead of Location | Paired Baseline Contrasts | Non-parametric Paired Contrasts | Controlling the Search | Which Contrast Family Should You Use? | Notes on Interpretation | Multiple Comparisons | Related Tools | Summary

Last update: 2026-08-08
Started: 2026-08-08

Data Preparation
Introduction | Data Preparation with partition() | Preparation of Predicates from Logical Columns | Preparation of Predicates from Factors | Preparation of Crisp Predicates from Numeric Columns | Data-Driven Breakpoint Selection with .style | Preparation of Fuzzy Predicates from Numeric Columns | Trapezoidal Fuzzy Predicates | Identifying and Removing Uninformative Columns | Testing for Almost Constant Columns | Removing Almost Constant Columns | Finding Tautologies in Data | What are Tautologies? | Using dig_tautologies() | Parameters | Using Tautologies to Filter Searches | Summary

Last update: 2026-08-08
Started: 2025-11-05

nuggets: Get Started
Introduction | Data Preparation | Crisp (Boolean) Predicates Example | Fuzzy Predicates Example | Advanced Data Preparation Capabilities | Pre-defined Patterns | Search for Association Rules | Conditional Correlations | Contrast Patterns | Baseline Contrasts | Complement Contrasts | Paired Baseline Contrasts | Post-processing and Visualization | Visualizing Association Rules with Diamond Plots | Interactive Exploration | Advanced Use | Custom Patterns with dig() | Grid-Based Patterns with dig_grid() | Summary | Next Steps

Last update: 2026-08-08
Started: 2024-11-16

Association Rules
Introduction | Data Preparation | Crisp Data Preparation | Fuzzy Data Preparation | Basic Association Rule Search | Specifying Antecedent and Consequent | Using the Disjoint Argument | Controlling Rule Length | Limiting the Number of Results | Fuzzy Association Rules | Computing Additional Interest Measures | Smoothing | GUHA Quantifiers | Excluding Redundant and Entailed Rules | Finding Near-Tautologies with dig_tautologies() | Using Axioms to Filter Association Rules | Manually Specifying Axioms | Summary

Last update: 2026-08-07
Started: 2026-07-14

Custom Pattern Search with dig()
Introduction | A Small Working Dataset | A Simple dig() Call | Condition and Focus | Using Foci | Filtering Foci | What the Callback Function Can Receive | Advanced Examples | Example: Fixed-Variable Correlations | Example: Handling Fuzzy Data | Practical Notes | Summary

Last update: 2026-08-07
Started: 2026-08-07

Readme and manuals

Help Manual

Help pageTopics
Add additional interest measures for association rulesadd_interest add_interest.associations
Create an association matrix from a nugget of flavour 'associations'.association_matrix
Bound a range of numeric valuesbound_range
Cluster association rulescluster_associations
Search for patterns of a custom typedig
Dig ancestors of an association ruledig_ancestors dig_ancestors.associations
Search for association rulesdig_associations
Search for conditions that yield in statistically significant one-sample test in selected variables.dig_baseline_contrasts
Search for conditions that provide significant differences in selected variables to the rest of the data tabledig_complement_contrasts
Search for conditional correlationsdig_correlations
Search for grid-based rulesdig_grid
Search for conditions that provide significant differences between paired variablesdig_paired_baseline_contrasts
Find tautologies or "almost tautologies" in a datasetdig_tautologies
Show interactive application to explore association rulesexplore.associations
Show interactive application to explore baseline contrastsexplore.baseline_contrasts
Show interactive application to explore complement contrastsexplore.complement_contrasts
Show interactive application to explore conditional correlationsexplore.correlations
Show interactive application to explore paired baseline contrastsexplore.paired_baseline_contrasts
Obtain truth-degrees of conditionsfire
Format a vector of predicates into a condition stringformat_condition
Geom for drawing diamond plots of lattice structuresgeom_diamond
Test whether a vector is almost constantis_almost_constant
Check whether a list of character vectors contains valid conditionsis_condition
Test whether an object contains numeric values from the interval [0,1]is_degree
Check if an object is logical or numeric with only 0s and 1sis_logicalish
Test whether an object is a nuggetis_nugget
Determine whether one vector is a subset of anotheris_subset
Create a nugget object of a given flavournugget
Convert condition strings into lists of predicate vectorsparse_condition
Convert data-frame columns into Boolean or fuzzy predicatespartition
Generate all permutations of a vectorpermute
Plot a mosaic plot for a contingency tableplot_contingency plot_contingency.data.frame plot_contingency.default
Remove almost constant columns from a data frameremove_almost_constant
Remove invalid conditions from a listremove_ill_conditions
Shorten predicates within conditionsshorten_condition
Extract values from predicate namesvalues
Create a tibble of combinations of selected column namesvar_grid
Extract variable names from predicate namesvar_names
Return indices of first elements of the list, which are incomparable with preceding elements.which_antichain