#region License Information
/* HeuristicLab
* Copyright (C) 2002-2016 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 HeuristicLab.Common;
using HeuristicLab.Core;
using HeuristicLab.Data;
using HeuristicLab.Operators;
using HeuristicLab.Optimization;
using HeuristicLab.Parameters;
using HeuristicLab.Persistence.Default.CompositeSerializers.Storable;
using System.Collections.Generic;
using System.Linq;
namespace HeuristicLab.Analysis.QualityAnalysis {
[Item("QualityDistributionAnalyzer", "Analyzes the distribution of the quality values in that it adds a Histogram of them into the result collection.")]
[StorableClass]
public class QualityDistributionAnalyzer : SingleSuccessorOperator, IAnalyzer, IIterationBasedOperator, ISingleObjectiveOperator {
private const string TableDescription = "Shows the quality distributions in the current population.";
#region Parameter properties
public IScopeTreeLookupParameter QualityParameter {
get { return (IScopeTreeLookupParameter)Parameters["Quality"]; }
}
public IValueLookupParameter ResultsParameter {
get { return (IValueLookupParameter)Parameters["Results"]; }
}
private ValueParameter HistogramNameParameter {
get { return (ValueParameter)Parameters["HistogramName"]; }
}
private ValueParameter StoreHistoryParameter {
get { return (ValueParameter)Parameters["StoreHistory"]; }
}
public ILookupParameter IterationsParameter {
get { return (ILookupParameter)Parameters["Iterations"]; }
}
public IValueLookupParameter MaximumIterationsParameter {
get { return (IValueLookupParameter)Parameters["MaximumIterations"]; }
}
#endregion
public virtual bool EnabledByDefault {
get { return true; }
}
public string HistogramName {
get { return HistogramNameParameter.Value.Value; }
set { HistogramNameParameter.Value.Value = value; }
}
public bool StoreHistory {
get { return StoreHistoryParameter.Value.Value; }
set { StoreHistoryParameter.Value.Value = value; }
}
[StorableConstructor]
protected QualityDistributionAnalyzer(bool deserializing) : base(deserializing) { }
protected QualityDistributionAnalyzer(QualityDistributionAnalyzer original, Cloner cloner)
: base(original, cloner) {
}
public QualityDistributionAnalyzer()
: base() {
Parameters.Add(new ScopeTreeLookupParameter("Quality", "The value which represents the quality of a solution."));
Parameters.Add(new ValueLookupParameter("Results", "The results collection where the analysis values should be stored."));
Parameters.Add(new FixedValueParameter("HistogramName", "The name of the histogram that gets injected in to the results collection.", new StringValue("Quality Distribution")));
Parameters.Add(new FixedValueParameter("StoreHistory", "True if the history should be stored in addition to the current distribution", new BoolValue(false)));
Parameters.Add(new LookupParameter("Iterations", "Optional: A value indicating the current iteration."));
Parameters.Add(new ValueLookupParameter("MaximumIterations", "Unused", new IntValue(-1)));
QualityParameter.Hidden = true;
ResultsParameter.Hidden = true;
IterationsParameter.Hidden = true;
MaximumIterationsParameter.Hidden = true;
}
public override IDeepCloneable Clone(Cloner cloner) {
return new QualityDistributionAnalyzer(this, cloner);
}
public static DataTable PrepareTable(string qualityName = "Quality") {
var result = new DataTable("Population Quality Distribution", TableDescription);
result.VisualProperties.XAxisTitle = qualityName;
result.VisualProperties.YAxisTitle = "Frequency";
var row = new DataRow("QualityDistribution");
row.VisualProperties.ChartType = DataRowVisualProperties.DataRowChartType.Histogram;
result.Rows.Add(row);
return result;
}
public static void UpdateTable(DataTable table, IEnumerable qualities) {
var row = table.Rows["QualityDistribution"];
row.Values.Replace(qualities);
}
public override IOperation Apply() {
DataTable qualityDistribution = null;
var results = ResultsParameter.ActualValue;
if (results.ContainsKey(HistogramName)) {
qualityDistribution = (DataTable)results[HistogramName].Value;
} else {
qualityDistribution = PrepareTable(QualityParameter.ActualName);
results.Add(new Result(HistogramName, TableDescription, qualityDistribution));
}
UpdateTable(qualityDistribution, QualityParameter.ActualValue.Select(x => x.Value));
if (StoreHistory) {
var historyResultName = HistogramName + " History";
DataTableHistory qdHistory = null;
if (results.ContainsKey(historyResultName)) {
qdHistory = (DataTableHistory)results[historyResultName].Value;
} else {
qdHistory = new DataTableHistory();
results.Add(new Result(historyResultName, qdHistory));
}
var table = (DataTable)qualityDistribution.Clone();
var iteration = IterationsParameter.ActualValue;
if (iteration != null) {
var iterationName = IterationsParameter.ActualName;
if (iterationName.EndsWith("s")) iterationName = iterationName.Remove(iterationName.Length - 1);
var appendix = " at " + iterationName + " " + iteration.Value.ToString();
table.Name += appendix;
table.Rows["QualityDistribution"].VisualProperties.DisplayName += appendix;
}
qdHistory.Add(table);
}
return base.Apply();
}
}
}