#region License Information
/* HeuristicLab
* Copyright (C) 2002-2014 Heuristic and Evolutionary Algorithms Laboratory (HEAL)
*
* This file is part of HeuristicLab.
*
* HeuristicLab is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* HeuristicLab is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with HeuristicLab. If not, see .
*/
#endregion
using System;
using HeuristicLab.Common;
using HeuristicLab.Core;
using HeuristicLab.Data;
using HeuristicLab.Operators;
using HeuristicLab.Optimization;
using HeuristicLab.Optimization.Operators;
using HeuristicLab.Parameters;
using HeuristicLab.Persistence.Default.CompositeSerializers.Storable;
namespace HeuristicLab.Analysis {
///
/// An operator which analyzes the best, average and worst quality of solutions in the scope tree.
///
[Item("BestAverageWorstQualityAnalyzer", "An operator which analyzes the best, average and worst quality of solutions in the scope tree.")]
[StorableClass]
public sealed class BestAverageWorstQualityAnalyzer : AlgorithmOperator, IAnalyzer {
#region Parameter properties
public ValueLookupParameter MaximizationParameter {
get { return (ValueLookupParameter)Parameters["Maximization"]; }
}
public ScopeTreeLookupParameter QualityParameter {
get { return (ScopeTreeLookupParameter)Parameters["Quality"]; }
}
public ValueLookupParameter BestKnownQualityParameter {
get { return (ValueLookupParameter)Parameters["BestKnownQuality"]; }
}
public ValueLookupParameter BestQualityParameter {
get { return (ValueLookupParameter)Parameters["BestQuality"]; }
}
public ValueLookupParameter CurrentBestQualityParameter {
get { return (ValueLookupParameter)Parameters["CurrentBestQuality"]; }
}
public ValueLookupParameter CurrentAverageQualityParameter {
get { return (ValueLookupParameter)Parameters["CurrentAverageQuality"]; }
}
public ValueLookupParameter CurrentWorstQualityParameter {
get { return (ValueLookupParameter)Parameters["CurrentWorstQuality"]; }
}
public ValueLookupParameter QualitiesParameter {
get { return (ValueLookupParameter)Parameters["Qualities"]; }
}
public ValueLookupParameter AbsoluteDifferenceBestKnownToBestParameter {
get { return (ValueLookupParameter)Parameters["AbsoluteDifferenceBestKnownToBest"]; }
}
public ValueLookupParameter RelativeDifferenceBestKnownToBestParameter {
get { return (ValueLookupParameter)Parameters["RelativeDifferenceBestKnownToBest"]; }
}
public ValueLookupParameter ResultsParameter {
get { return (ValueLookupParameter)Parameters["Results"]; }
}
#endregion
#region Properties
public bool EnabledByDefault {
get { return true; }
}
private BestQualityMemorizer BestQualityMemorizer {
get { return (BestQualityMemorizer)OperatorGraph.InitialOperator; }
}
private BestAverageWorstQualityCalculator BestAverageWorstQualityCalculator {
get { return (BestAverageWorstQualityCalculator)BestQualityMemorizer.Successor; }
}
#endregion
#region Storing & Cloning
[StorableConstructor]
private BestAverageWorstQualityAnalyzer(bool deserializing) : base(deserializing) { }
private BestAverageWorstQualityAnalyzer(BestAverageWorstQualityAnalyzer original, Cloner cloner)
: base(original, cloner) {
Initialize();
}
public override IDeepCloneable Clone(Cloner cloner) {
return new BestAverageWorstQualityAnalyzer(this, cloner);
}
#endregion
public BestAverageWorstQualityAnalyzer()
: base() {
#region Create parameters
Parameters.Add(new ValueLookupParameter("Maximization", "True if the problem is a maximization problem, otherwise false."));
Parameters.Add(new ScopeTreeLookupParameter("Quality", "The value which represents the quality of a solution."));
Parameters.Add(new ValueLookupParameter("BestKnownQuality", "The best known quality value found so far."));
Parameters.Add(new ValueLookupParameter("BestQuality", "The best quality value found in the current run."));
Parameters.Add(new ValueLookupParameter("CurrentBestQuality", "The best quality value found in the current population."));
Parameters.Add(new ValueLookupParameter("CurrentAverageQuality", "The average quality value of all solutions in the current population."));
Parameters.Add(new ValueLookupParameter("CurrentWorstQuality", "The worst quality value found in the current population."));
Parameters.Add(new ValueLookupParameter("Qualities", "The data table to store the current best, current average, current worst, best and best known quality value."));
Parameters.Add(new ValueLookupParameter("AbsoluteDifferenceBestKnownToBest", "The absolute difference of the best known quality value to the best quality value."));
Parameters.Add(new ValueLookupParameter("RelativeDifferenceBestKnownToBest", "The relative difference of the best known quality value to the best quality value."));
Parameters.Add(new ValueLookupParameter("Results", "The results collection where the analysis values should be stored."));
BestQualityParameter.Hidden = true;
CurrentBestQualityParameter.Hidden = true;
CurrentAverageQualityParameter.Hidden = true;
CurrentWorstQualityParameter.Hidden = true;
QualitiesParameter.Hidden = true;
AbsoluteDifferenceBestKnownToBestParameter.Hidden = true;
RelativeDifferenceBestKnownToBestParameter.Hidden = true;
#endregion
#region Create operators
BestQualityMemorizer bestQualityMemorizer = new BestQualityMemorizer();
BestAverageWorstQualityCalculator bestAverageWorstQualityCalculator = new BestAverageWorstQualityCalculator();
DataTableValuesCollector dataTableValuesCollector = new DataTableValuesCollector();
QualityDifferenceCalculator qualityDifferenceCalculator = new QualityDifferenceCalculator();
ResultsCollector resultsCollector = new ResultsCollector();
bestQualityMemorizer.BestQualityParameter.ActualName = BestQualityParameter.Name;
bestQualityMemorizer.MaximizationParameter.ActualName = MaximizationParameter.Name;
bestQualityMemorizer.QualityParameter.ActualName = QualityParameter.Name;
bestQualityMemorizer.QualityParameter.Depth = QualityParameter.Depth;
bestAverageWorstQualityCalculator.AverageQualityParameter.ActualName = CurrentAverageQualityParameter.Name;
bestAverageWorstQualityCalculator.BestQualityParameter.ActualName = CurrentBestQualityParameter.Name;
bestAverageWorstQualityCalculator.MaximizationParameter.ActualName = MaximizationParameter.Name;
bestAverageWorstQualityCalculator.QualityParameter.ActualName = QualityParameter.Name;
bestAverageWorstQualityCalculator.QualityParameter.Depth = QualityParameter.Depth;
bestAverageWorstQualityCalculator.WorstQualityParameter.ActualName = CurrentWorstQualityParameter.Name;
dataTableValuesCollector.CollectedValues.Add(new LookupParameter("CurrentBestQuality", null, CurrentBestQualityParameter.Name));
dataTableValuesCollector.CollectedValues.Add(new LookupParameter("CurrentAverageQuality", null, CurrentAverageQualityParameter.Name));
dataTableValuesCollector.CollectedValues.Add(new LookupParameter("CurrentWorstQuality", null, CurrentWorstQualityParameter.Name));
dataTableValuesCollector.CollectedValues.Add(new LookupParameter("BestQuality", null, BestQualityParameter.Name));
dataTableValuesCollector.CollectedValues.Add(new LookupParameter("BestKnownQuality", null, BestKnownQualityParameter.Name));
dataTableValuesCollector.DataTableParameter.ActualName = QualitiesParameter.Name;
qualityDifferenceCalculator.AbsoluteDifferenceParameter.ActualName = AbsoluteDifferenceBestKnownToBestParameter.Name;
qualityDifferenceCalculator.FirstQualityParameter.ActualName = BestKnownQualityParameter.Name;
qualityDifferenceCalculator.RelativeDifferenceParameter.ActualName = RelativeDifferenceBestKnownToBestParameter.Name;
qualityDifferenceCalculator.SecondQualityParameter.ActualName = BestQualityParameter.Name;
resultsCollector.CollectedValues.Add(new LookupParameter("CurrentBestQuality", null, CurrentBestQualityParameter.Name));
resultsCollector.CollectedValues.Add(new LookupParameter("CurrentAverageQuality", null, CurrentAverageQualityParameter.Name));
resultsCollector.CollectedValues.Add(new LookupParameter("CurrentWorstQuality", null, CurrentWorstQualityParameter.Name));
resultsCollector.CollectedValues.Add(new LookupParameter("BestQuality", null, BestQualityParameter.Name));
resultsCollector.CollectedValues.Add(new LookupParameter("BestKnownQuality", null, BestKnownQualityParameter.Name));
resultsCollector.CollectedValues.Add(new LookupParameter("AbsoluteDifferenceBestKnownToBest", null, AbsoluteDifferenceBestKnownToBestParameter.Name));
resultsCollector.CollectedValues.Add(new LookupParameter("RelativeDifferenceBestKnownToBest", null, RelativeDifferenceBestKnownToBestParameter.Name));
resultsCollector.CollectedValues.Add(new LookupParameter(QualitiesParameter.Name));
resultsCollector.ResultsParameter.ActualName = ResultsParameter.Name;
#endregion
#region Create operator graph
OperatorGraph.InitialOperator = bestQualityMemorizer;
bestQualityMemorizer.Successor = bestAverageWorstQualityCalculator;
bestAverageWorstQualityCalculator.Successor = dataTableValuesCollector;
dataTableValuesCollector.Successor = qualityDifferenceCalculator;
qualityDifferenceCalculator.Successor = resultsCollector;
resultsCollector.Successor = null;
#endregion
Initialize();
}
[StorableHook(HookType.AfterDeserialization)]
private void AfterDeserialization() {
Initialize();
// BackwardsCompatibility3.3
#region Backwards compatible code, remove with 3.4
if (Parameters["Results"] is ValueLookupParameter) {
Parameters.Remove("Results");
Parameters.Add(new ValueLookupParameter("Results", "The results collection where the analysis values should be stored."));
}
#endregion
}
private void Initialize() {
QualityParameter.DepthChanged += new EventHandler(QualityParameter_DepthChanged);
}
private void QualityParameter_DepthChanged(object sender, System.EventArgs e) {
BestQualityMemorizer.QualityParameter.Depth = QualityParameter.Depth;
BestAverageWorstQualityCalculator.QualityParameter.Depth = QualityParameter.Depth;
}
}
}