Struct WeightedFramework 

pub struct WeightedFramework<A: Clone + Eq + Hash> { /* private fields */ }

A weighted argumentation framework: a set of arguments and a list of weighted attack edges between them.

Attack weights are validated at insert time via AttackWeight::new. Duplicate attack edges (same attacker and target) are NOT deduplicated — each add_weighted_attack call appends a new edge, even if one already exists. This matches Dunne 2011, which allows multigraphs with distinct-weight parallel edges. Consumers who want deduplication should call WeightedFramework::collapse_duplicate_attacks.

Implementations

impl<A: Clone + Eq + Hash> WeightedFramework<A>

pub fn new() -> Self

Create an empty framework.

pub fn add_argument(&mut self, a: A)

Add an argument. Adding an argument that already exists is a no-op.

pub fn add_weighted_attack( &mut self, attacker: A, target: A, weight: f64, ) -> Result<(), Error>

Add a weighted attack. Both endpoints are implicitly added to the framework. Returns Error::InvalidWeight if the weight fails validation. Parallel edges with the same endpoints but different weights are permitted.

pub fn collapse_duplicate_attacks(&mut self) -> Result<(), Error>

Collapse parallel edges: for each (attacker, target) pair, keep only one edge whose weight is the sum of all parallel edges’ weights. This is one valid aggregation strategy (sum); Dunne 2011 does not prescribe one. Consumers who want a different aggregation (max, min, mean) should implement it externally.

Returns Error::InvalidWeight if the summed weight overflows to infinity (e.g., two edges each with weight f64::MAX).

pub fn arguments(&self) -> impl Iterator<Item = &A>

Iterate over all arguments.

pub fn attacks(&self) -> impl Iterator<Item = &WeightedAttack<A>>

Iterate over all weighted attacks.

pub fn len(&self) -> usize

Number of arguments.

pub fn is_empty(&self) -> bool

Whether the framework has zero arguments.

pub fn attack_count(&self) -> usize

Number of attack edges (counting parallel edges separately).

pub fn sorted_weights(&self) -> Vec<f64>

Return all distinct weight values present in the framework, sorted ascending. Used by the threshold-sweep API: flip points can only occur at cumulative-sum values of these weights.

Trait Implementations

impl<A: Clone + Clone + Eq + Hash> Clone for WeightedFramework<A>

fn clone(&self) -> WeightedFramework<A>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<A: Debug + Clone + Eq + Hash> Debug for WeightedFramework<A>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<A: Clone + Eq + Hash> Default for WeightedFramework<A>

fn default() -> Self

Returns the “default value” for a type.