Struct FuzzyLogicEngine 

pub struct FuzzyLogicEngine { /* private fields */ }

A complete fuzzy logic inference system.

Usage

1. Create an engine with FuzzyLogicEngine::new.
2. Register linguistic variables with FuzzyLogicEngine::add_variable.
3. Add IF-THEN rules with FuzzyLogicEngine::add_rule.
4. Call FuzzyLogicEngine::infer or FuzzyLogicEngine::evaluate to obtain a crisp output for a given set of crisp inputs.

Implementations

impl FuzzyLogicEngine

pub fn new(inference: InferenceMethod, defuzz: DefuzzMethod) -> Self

Create a new engine with the given inference and defuzzification strategies.

pub fn add_variable(&mut self, var: FuzzyVariable) -> Result<(), FuzzyError>

Register a linguistic variable.

Errors

Returns FuzzyError::DuplicateVariable if a variable with the same name already exists.

pub fn add_rule(&mut self, rule: FuzzyRule) -> Result<(), FuzzyError>

Register a fuzzy rule.

Validates that every variable and set referenced by the rule exists.

Errors

Returns FuzzyError::VariableNotFound or FuzzyError::SetNotFound if any reference is invalid.

pub fn rule_count(&self) -> usize

Return the number of registered rules.

pub fn variable_names(&self) -> Vec<&str>

Return the names of all registered variables.

pub fn membership_at( &self, variable: &str, set: &str, x: f64, ) -> Result<f64, FuzzyError>

Return the membership degree of x in a specific set of a variable.

Errors

Returns FuzzyError::VariableNotFound or FuzzyError::SetNotFound.

pub fn fuzzify( &self, variable: &str, crisp: f64, ) -> Result<Vec<(String, f64)>, FuzzyError>

Fuzzify a crisp value for a named variable.

Returns a vector of (set_name, degree) pairs for every set defined on the variable.

Errors

Returns FuzzyError::VariableNotFound if the variable is unknown.

pub fn fire_rule( &self, rule: &FuzzyRule, inputs: &HashMap<String, f64>, ) -> Result<f64, FuzzyError>

Evaluate the antecedent of rule given a map of crisp input values.

Returns the weighted activation degree α * rule.weight.

Errors

Returns FuzzyError::VariableNotFound or FuzzyError::SetNotFound.

pub fn infer( &self, inputs: &HashMap<String, f64>, output_var: &str, ) -> Result<f64, FuzzyError>

Run the complete fuzzy inference pipeline and return a crisp output for output_var.

Errors

• FuzzyError::VariableNotFound — output_var or any input variable is missing.
• FuzzyError::SetNotFound — a rule references an undefined set.
• FuzzyError::NoRulesForOutput — no rules target output_var.
• FuzzyError::NumericalError — all aggregate membership values are zero.

pub fn evaluate( &mut self, inputs: &HashMap<String, f64>, output_var: &str, ) -> Result<f64, FuzzyError>

Alias for infer; accepts &mut self for future stateful extensions.

Errors

Same as infer.

pub fn stats(&self) -> FuzzyStats

Return a snapshot of engine statistics.