Struct RuleMiner 

pub struct RuleMiner { /* private fields */ }

Main rule mining engine

Implementations

impl RuleMiner

pub fn new(config: MiningConfig) -> Self

Create new rule miner with config

pub fn add_transactions(&mut self, transactions: Vec<Transaction>) -> Result<()>

Add transactions to mine

pub fn add_transaction(&mut self, transaction: Transaction) -> Result<()>

Add transactions from an iterator (streaming support)

This method allows adding transactions one-by-one from a stream, maintaining constant memory usage for the loading phase.

Example

use rust_rule_miner::{RuleMiner, MiningConfig, data_loader::DataLoader, Transaction};
use chrono::Utc;

let mut miner = RuleMiner::new(MiningConfig::default());

// Add transactions one by one
let transaction = Transaction::new("tx1".to_string(), vec!["A".to_string()], Utc::now());
miner.add_transaction(transaction)?;

let rules = miner.mine_association_rules()?;

pub fn add_transactions_from_iter<I>(&mut self, iter: I) -> Result<()>

where I: Iterator<Item = Result<Transaction>>,

Add transactions from an iterator (batch streaming)

More efficient than add_transaction() when you have an iterator.

Example

use rust_rule_miner::{RuleMiner, MiningConfig, data_loader::{DataLoader, ColumnMapping}};

let mut miner = RuleMiner::new(MiningConfig::default());

// Load from CSV and add to miner
let mapping = ColumnMapping::simple(0, 1, 2);
let transactions = DataLoader::from_csv("file.csv", mapping)?;
miner.add_transactions_from_iter(transactions.into_iter().map(Ok))?;

let rules = miner.mine_association_rules()?;

pub fn transaction_count(&self) -> usize

Get transaction count

pub fn mine_association_rules(&mut self) -> Result<Vec<AssociationRule>>

Mine association rules using configured algorithm

pub fn stats(&self) -> &MiningStats

Get mining statistics