代码 | 自适应大邻域搜索系列之(5) - ALNS_Iteration_Status和ALNS_Parameters的代码解析

 1private:
 2
 3    //! Id of the iteration corresponding to this status.
 4    size_t iterationId;
 5
 6    //! Number of iteration since the last improvement of the BKS
 7    size_t nbIterationWithoutImprovement;
 8
 9    //! Number of iteration since the last improvement of the BKS
10    //! or the last reload of the best known solution.
11    size_t nbIterationWithoutImprovementSinceLastReload;
12
13    //! Number of iterations since the last improvement of the current
14    //! solution.
15    size_t nbIterationWithoutImprovementCurrent;
16
17    //! Number of iterations without transition.
18    size_t nbIterationWithoutTransition;
19
20    //! Indicate if a new best solution has been obtained.
21    State newBestSolution;
22
23    //! Indicate if the new solution has been accepted as the
24    //! current solution.
25    State acceptedAsCurrentSolution;
26
27    //! Indicate if the new solution is already known.
28    State alreadyKnownSolution;
29
30    //! Indicate if the new solution improve the current solution.
31    State improveCurrentSolution;
32
33    //! Indicate if a local search operator has been used.
34    State localSearchUsed;
35
36    //! Indicate if solution has been improved by local search.
37    State improveByLocalSearch;
38
39    //! Indicate if the solution has already been repaired.
40    State alreadyRepaired;
41
42    //! Indicate if the new solution has already been destroyed.
43    State alreadyDestroyed;
44
45};

  1public:
  2
  3    //! Enumeration representing the various kind of stopping criteria.
  4    //! MAX_IT: the maximum number of iterations.
  5    //! MAX_RT: the maximum run time.
  6    //! MAX_IT_NO_IMP: the maximum number of iterations without improvement.
  7    //! ALL: a mix of the MAX_IT, MAX_RT and MAX_IT_NO_IMP.
  8    enum StoppingCriteria {
  9        MAX_IT,
 10        MAX_RT,
 11        MAX_IT_NO_IMP,
 12        ALL
 13    };
 14
 15    //! An enumeration listing a set of packaged AcceptanceModule Implementation.
 16    enum AcceptanceCriterioKind {
 17        SA
 18    };
 19protected:
 20    //! Maximum number of iterations performed by the ALNS.
 21    size_t maxNbIterations;
 22
 23    //! Maximum running time of the ALNS.
 24    double maxRunningTime;
 25
 26    //! Maximum number of iterations without any improvement.
 27    size_t maxNbIterationsNoImp;
 28
 29    //! Which stopping criterion should be used.
 30    StoppingCriteria stopCrit;
 31
 32    //! Indicate if noise should be used.
 33    bool noise;
 34
 35    //! Indicate after how many iterations should the scores of
 36    //! the operators be recomputed.
 37    size_t timeSegmentsIt;
 38
 39    //! Indicate the number of iterations that should be performed
 40    //! before reinitialization of the scores of the operators.
 41    size_t nbItBeforeReinit;
 42
 43    //! score adjustment parameter in case the last remove-insert
 44    //! operation resulted in a new global best solution
 45    int sigma1;
 46
 47    //! score adjustment parameter in case that the last remove-insert
 48    //! operation resulted in a solution that has not been accepted before and
 49    //! the objective value is better than the objective value of current solution
 50    int sigma2;
 51
 52    //! score adjustment parameter in case that the last remove-insert
 53    //! operation resulted in a solution that has not been accepted before and such
 54    //! that the score objective value is worse than the one of current solution but
 55    //! the solution was accepted.
 56    int sigma3;
 57
 58    //! reaction factor 0 <= rho <= 1 for the update of the weights of the
 59    //! operators.
 60    double rho;
 61
 62    //! The minimum possible weight for an operator.
 63    double minimumWeight;
 64
 65    //! The maximum possible weight for an operator.
 66    double maximumWeight;
 67
 68    //! Indicates the probability of using noised operators.
 69    double probabilityOfNoise;
 70
 71    //! Kind of acceptance criterion used.
 72    AcceptanceCriterioKind acKind;
 73
 74    //! patht to the configuration file of the acceptance criterion.
 75    std::string acPath;
 76
 77    //! path to the file where the global stats have to be saved.
 78    std::string statsGlobPath;
 79
 80    //! path to the file where the operators stats have to be saved.
 81    std::string statsOpPath;
 82
 83    //! Indicate every each iteration logging is done. 不懂看后面。
 84    int logFrequency;
 85
 86    //! A set of forbidden operators. 不懂看后面。
 87    std::vector<std::string> forbidenOperators;
 88
 89    //! A set of forbidden local search operators. 不懂看后面。
 90    std::vector<std::string> forbidenLsOperators;
 91
 92    //! The minimum percentage of the solution destroyed by the destroy operators.
 93    int minDestroyPerc;
 94
 95    //! The maximum percentage of the solution destroyed by the destroy operators.
 96    int maxDestroyPerc;
 97
 98    //! Indicate after how many iterations without improvement
 99    //! does the best known solution is reloaded.
100    size_t reloadFrequency;
101
102    //! Indicate if local search should be used.
103    bool performLocalSearch;
104
105    //! When the optimization process start, the parameters
106    //! should not be modified. lock is set to true when the
107    //! optimization begin. If the setter of the value
108    //! of one parameter is called while lock is true, an
109    //! error is raised.
110    bool lock;
111
112};