Struct Clustering 

pub struct Clustering { /* private fields */ }

The Clustering problem.

Given a set of n elements with pairwise distances, a cluster count bound K, and a diameter bound B, determine whether there exists a partition of the elements into at most K non-empty clusters such that for every cluster, all pairwise distances within that cluster are at most B.

Representation

Each element i is assigned a cluster index config[i] ∈ {0, ..., K-1}. The problem is satisfiable iff every non-empty cluster has all pairwise distances ≤ B.

Example

use problemreductions::models::misc::Clustering;
use problemreductions::{Problem, BruteForce};

// 4 elements, 2 clusters, diameter bound 1
let distances = vec![
    vec![0, 1, 3, 3],
    vec![1, 0, 3, 3],
    vec![3, 3, 0, 1],
    vec![3, 3, 1, 0],
];
let problem = Clustering::new(distances, 2, 1);
let solver = BruteForce::new();
let solution = solver.solve(&problem).unwrap();
assert!(solution.is_some());

Implementations

impl Clustering

pub fn new( distances: Vec<Vec<i64>>, num_clusters: usize, diameter_bound: i64, ) -> Self

Create a new Clustering instance.

Panics

Panics if:

• distances is empty
• distances is not square
• distances is not symmetric
• diagonal entries are not zero
• num_clusters is zero

pub fn distances(&self) -> &[Vec<i64>]

Returns the distance matrix.

pub fn num_elements(&self) -> usize

Returns the number of elements.

pub fn num_clusters(&self) -> usize

Returns the maximum number of clusters K.

pub fn diameter_bound(&self) -> i64

Returns the diameter bound B.

Trait Implementations

impl BruteForceProblem for Clustering

fn dimensions(&self) -> Vec<usize>

Cardinality of each coordinate in the brute-force search space.

fn num_variables(&self) -> usize

Number of coordinates in the brute-force search space.

impl Clone for Clustering

fn clone(&self) -> Clustering

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Clustering

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

Formats the value using the given formatter.

impl DeclaredVariant for Clustering

impl<'de> Deserialize<'de> for Clustering

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Problem for Clustering

const NAME: &'static str = "Clustering"

Base name of this problem type (e.g., “MaximumIndependentSet”).

type Solution = Vec<usize>

Mathematical witness type for this problem.

type Value = Or

The evaluation value type.

fn parameter_names() -> &'static [&'static str]

Canonical parameter names for this problem model.

fn parameters(&self) -> ProblemParameters

Measure the complete canonical parameters of this concrete instance.

fn variant() -> Vec<(&'static str, &'static str)>

Returns variant attributes derived from type parameters.

fn evaluate(&self, config: &Self::Solution) -> Result<Or, EvaluationError>

Evaluate the problem on a solution.

fn problem_type() -> ProblemType

Look up this problem’s catalog entry.

impl ReduceTo<Clustering> for KColoring<K3, SimpleGraph>

type Result = ReductionKColoringToClustering

The reduction result type.

fn reduce_to(&self) -> Result<Self::Result, ReductionError>

Reduce this problem to the target problem type.

fn target_construction(error: ConstructionError) -> ReductionError

where Self: Sized,

Attach this reduction edge to a target-construction failure.

fn exact_i64( value: usize, operation: impl Into<String>, ) -> Result<i64, ReductionError>

where Self: Sized,

Convert a structural count used by the target’s exact integer algebra.

impl ReduceTo<ILP> for Clustering

type Result = ReductionClusteringToILP

The reduction result type.

fn reduce_to(&self) -> Result<Self::Result, ReductionError>

Reduce this problem to the target problem type.

fn target_construction(error: ConstructionError) -> ReductionError

where Self: Sized,

Attach this reduction edge to a target-construction failure.

fn exact_i64( value: usize, operation: impl Into<String>, ) -> Result<i64, ReductionError>

where Self: Sized,

Convert a structural count used by the target’s exact integer algebra.

impl Serialize for Clustering

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.