givp 1.0.0

GRASP-ILS-VND with Path Relinking metaheuristic for continuous black-box optimization
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

// SPDX-FileCopyrightText: 2026 Arnaldo Mendes Pires Junior
// SPDX-License-Identifier: MIT

use crate::config::Direction;
use std::collections::HashMap;

/// Why the optimizer stopped.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
pub enum TerminationReason {
    Converged,
    MaxIterationsReached,
    TimeLimitReached,
    EarlyStop,
    NoFeasible,
    Unknown,
}

impl TerminationReason {
    pub fn from_message(msg: &str) -> Self {
        let lower = msg.to_lowercase();
        if lower.contains("converged") {
            Self::Converged
        } else if lower.contains("max") && lower.contains("iteration") {
            Self::MaxIterationsReached
        } else if lower.contains("time") {
            Self::TimeLimitReached
        } else if lower.contains("early") || lower.contains("stagnation") {
            Self::EarlyStop
        } else if lower.contains("no feasible") || lower.contains("no_feasible") {
            Self::NoFeasible
        } else {
            Self::Unknown
        }
    }
}

/// Optimization result.
#[derive(Debug, Clone)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
pub struct OptimizeResult {
    /// Best solution found.
    pub x: Vec<f64>,
    /// Best objective value.
    pub fun: f64,
    /// Number of iterations.
    pub nit: usize,
    /// Number of function evaluations.
    pub nfev: usize,
    /// Whether the optimization succeeded.
    pub success: bool,
    /// Human-readable termination message.
    pub message: String,
    /// Optimization direction used.
    pub direction: Direction,
    /// Termination reason.
    pub termination: TerminationReason,
    /// Extra metadata.
    pub meta: HashMap<String, String>,
}

impl OptimizeResult {
    pub(crate) fn new(direction: Direction) -> Self {
        Self {
            x: Vec::new(),
            fun: f64::INFINITY,
            nit: 0,
            nfev: 0,
            success: true,
            message: String::new(),
            direction,
            termination: TerminationReason::Unknown,
            meta: HashMap::new(),
        }
    }
}