Struct Factoring 

pub struct Factoring { /* private fields */ }

The Integer Factoring problem.

Given a number to factor, find two integers that multiply to give the target number. Variables represent the bits of the two factors.

Example

use problemreductions::models::misc::Factoring;
use problemreductions::{Problem, Solver, BruteForce};

// Factor 6 with 2-bit factors (allowing factors 0-3)
let problem = Factoring::new(2, 2, 6);

let solver = BruteForce::new();
let solutions = solver.find_all_best(&problem);

// Should find: 2*3=6 or 3*2=6
for sol in &solutions {
    let (a, b) = problem.read_factors(sol);
    assert_eq!(a * b, 6);
}

Implementations

impl Factoring

pub fn new(m: usize, n: usize, target: u64) -> Self

Create a new Factoring problem.

Arguments

• m - Number of bits for the first factor
• n - Number of bits for the second factor
• target - The number to factor

pub fn m(&self) -> usize

Get the number of bits for the first factor.

pub fn n(&self) -> usize

Get the number of bits for the second factor.

pub fn num_bits_first(&self) -> usize

Get the number of bits for the first factor (alias for m()).

pub fn num_bits_second(&self) -> usize

Get the number of bits for the second factor (alias for n()).

pub fn target(&self) -> u64

Get the target number to factor.

pub fn read_factors(&self, config: &[usize]) -> (u64, u64)

Read the two factors from a configuration.

The first m bits represent the first factor, the next n bits represent the second factor.

pub fn is_valid_solution(&self, config: &[usize]) -> bool

Check if a configuration is a valid factorization.

pub fn is_valid_factorization(&self, config: &[usize]) -> bool

Check if the configuration is a valid factorization.

Trait Implementations

impl Clone for Factoring

fn clone(&self) -> Factoring

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Factoring

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Factoring

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl OptimizationProblem for Factoring

type Value = i32

The inner objective value type (e.g., i32, f64).

fn direction(&self) -> Direction

Whether to maximize or minimize the metric.

impl Problem for Factoring

const NAME: &'static str = "Factoring"

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

type Metric = SolutionSize<i32>

The evaluation metric type.

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

Configuration space dimensions. Each entry is the cardinality of that variable.

fn evaluate(&self, config: &[usize]) -> SolutionSize<i32>

Evaluate the problem on a configuration.

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

Returns variant attributes derived from type parameters.

fn num_variables(&self) -> usize

Number of variables (derived from dims).

impl ReduceTo<CircuitSAT> for Factoring

type Result = ReductionFactoringToCircuit

The reduction result type.

fn reduce_to(&self) -> Self::Result

Reduce this problem to the target problem type.

impl ReduceTo<ILP<i32>> for Factoring

type Result = ReductionFactoringToILP

The reduction result type.

fn reduce_to(&self) -> Self::Result

Reduce this problem to the target problem type.

impl Serialize for Factoring

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl DeclaredVariant for Factoring