source: branches/TerminationCriteria/HeuristicLab.Termination/3.3/Terminator.cs @ 12407

Last change on this file since 12407 was 12407, checked in by pfleck, 7 years ago

#2027
Inverted the conditions to check the continue criteria instead of termination criteria.
Conditions are then specified more naturally: "while generations < max" instead of "break if generations > min".
If any Continue-Check returns false, the algorithm will be terminated.

The naming "Terminator" has to be discussed because it suggest to specify the criteria when the algorithm should stop, instead of continue.

File size: 2.4 KB
Line 
1#region License Information
2/* HeuristicLab
3 * Copyright (C) 2002-2015 Heuristic and Evolutionary Algorithms Laboratory (HEAL)
4 *
5 * This file is part of HeuristicLab.
6 *
7 * HeuristicLab is free software: you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation, either version 3 of the License, or
10 * (at your option) any later version.
11 *
12 * HeuristicLab is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 * GNU General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with HeuristicLab. If not, see <http://www.gnu.org/licenses/>.
19 */
20#endregion
21
22using System.Drawing;
23using HeuristicLab.Common;
24using HeuristicLab.Core;
25using HeuristicLab.Data;
26using HeuristicLab.Operators;
27using HeuristicLab.Parameters;
28using HeuristicLab.Persistence.Default.CompositeSerializers.Storable;
29
30namespace HeuristicLab.Termination {
31  [Item("Terminator", "A base class for all termination criteria.")]
32  [StorableClass]
33  public abstract class Terminator : InstrumentedOperator, ITerminator {
34    public static new Image StaticItemImage {
35      get { return HeuristicLab.Common.Resources.VSImageLibrary.FlagRed; }
36    }
37
38    public ILookupParameter<BoolValue> TerminateParameter {
39      get { return (ILookupParameter<BoolValue>)Parameters["Terminate"]; }
40    }
41
42    [StorableConstructor]
43    protected Terminator(bool deserializing) : base(deserializing) { }
44    protected Terminator(Terminator original, Cloner cloner) : base(original, cloner) { }
45
46    protected Terminator()
47      : base() {
48      Parameters.Add(new LookupParameter<BoolValue>("Terminate", "The parameter which will be set to determine if execution should be terminated or should continue."));
49    }
50
51    public sealed override IOperation InstrumentedApply() {
52      if (!TerminateParameter.ActualValue.Value) { // If terminate flag is already set, no need to check further termination criteria.
53        bool terminate = !CheckContinueCriterion();
54        TerminateParameter.ActualValue = new BoolValue(terminate);
55      }
56      return base.InstrumentedApply();
57    }
58
59    protected abstract bool CheckContinueCriterion();
60  }
61}
Note: See TracBrowser for help on using the repository browser.