#region License Information
/* HeuristicLab
* Copyright (C) 2002-2013 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 System.Collections.Generic;
using System.Drawing;
using System.Linq;
using HeuristicLab.Analysis;
using HeuristicLab.Collections;
using HeuristicLab.Common;
using HeuristicLab.Core;
using HeuristicLab.Data;
using HeuristicLab.Optimization;
using HeuristicLab.Optimization.Operators;
using HeuristicLab.Parameters;
using HeuristicLab.Persistence.Default.CompositeSerializers.Storable;
namespace HeuristicLab.Problems.ExternalEvaluation {
[Item("External Evaluation Problem", "A problem that is evaluated in a different process.")]
[Creatable("Problems")]
[StorableClass]
public sealed class ExternalEvaluationProblem : ParameterizedNamedItem, ISingleObjectiveHeuristicOptimizationProblem, IStorableContent {
public string Filename { get; set; }
public static new Image StaticItemImage {
get { return HeuristicLab.Common.Resources.VSImageLibrary.Type; }
}
public new ParameterCollection Parameters {
get { return base.Parameters; }
}
IKeyedItemCollection IParameterizedItem.Parameters {
get { return Parameters; }
}
#region Parameters
public IValueParameter> ClientsParameter {
get { return (IValueParameter>)Parameters["Clients"]; }
}
public IValueParameter EvaluatorParameter {
get { return (IValueParameter)Parameters["Evaluator"]; }
}
public ValueParameter MaximizationParameter {
get { return (ValueParameter)Parameters["Maximization"]; }
}
IParameter ISingleObjectiveHeuristicOptimizationProblem.MaximizationParameter {
get { return MaximizationParameter; }
}
public ValueParameter SolutionCreatorParameter {
get { return (ValueParameter)Parameters["SolutionCreator"]; }
}
IParameter IHeuristicOptimizationProblem.SolutionCreatorParameter {
get { return SolutionCreatorParameter; }
}
IParameter IHeuristicOptimizationProblem.EvaluatorParameter {
get { return EvaluatorParameter; }
}
public OptionalValueParameter BestKnownQualityParameter {
get { return (OptionalValueParameter)Parameters["BestKnownQuality"]; }
}
IParameter ISingleObjectiveHeuristicOptimizationProblem.BestKnownQualityParameter {
get { return BestKnownQualityParameter; }
}
public OptionalValueParameter BestKnownSolutionParameter {
get { return (OptionalValueParameter)Parameters["BestKnownSolution"]; }
}
public ValueParameter> OperatorsParameter {
get { return (ValueParameter>)Parameters["Operators"]; }
}
public OptionalValueParameter CacheParameter {
get { return (OptionalValueParameter)Parameters["Cache"]; }
}
#endregion
#region Properties
public BoolValue Maximization {
get { return MaximizationParameter.Value; }
set { MaximizationParameter.Value = value; }
}
public ISolutionCreator SolutionCreator {
get { return SolutionCreatorParameter.Value; }
set { SolutionCreatorParameter.Value = value; }
}
ISolutionCreator IHeuristicOptimizationProblem.SolutionCreator {
get { return SolutionCreatorParameter.Value; }
}
public IExternalEvaluationProblemEvaluator Evaluator {
get { return EvaluatorParameter.Value; }
set { EvaluatorParameter.Value = value; }
}
ISingleObjectiveEvaluator ISingleObjectiveHeuristicOptimizationProblem.Evaluator {
get { return EvaluatorParameter.Value; }
}
IEvaluator IHeuristicOptimizationProblem.Evaluator {
get { return EvaluatorParameter.Value; }
}
public DoubleValue BestKnownQuality {
get { return BestKnownQualityParameter.Value; }
set { BestKnownQualityParameter.Value = value; }
}
public IEnumerable Operators {
get { return OperatorsParameter.Value; }
}
private BestScopeSolutionAnalyzer BestScopeSolutionAnalyzer {
get { return OperatorsParameter.Value.OfType().FirstOrDefault(); }
}
#endregion
[StorableConstructor]
private ExternalEvaluationProblem(bool deserializing) : base(deserializing) { }
private ExternalEvaluationProblem(ExternalEvaluationProblem original, Cloner cloner)
: base(original, cloner) {
RegisterEventHandlers();
}
public override IDeepCloneable Clone(Cloner cloner) {
return new ExternalEvaluationProblem(this, cloner);
}
public ExternalEvaluationProblem()
: base() {
ExternalEvaluator evaluator = new ExternalEvaluator();
UserDefinedSolutionCreator solutionCreator = new UserDefinedSolutionCreator();
Parameters.Add(new ValueParameter>("Clients", "The clients that are used to communicate with the external application.", new CheckedItemCollection() { new EvaluationServiceClient() }));
Parameters.Add(new ValueParameter("Evaluator", "The evaluator that collects the values to exchange.", evaluator));
Parameters.Add(new ValueParameter("SolutionCreator", "An operator to create the solution components.", solutionCreator));
Parameters.Add(new ValueParameter("Maximization", "Set to false as most test functions are minimization problems.", new BoolValue(false)));
Parameters.Add(new OptionalValueParameter("BestKnownQuality", "The quality of the best known solution of this problem."));
Parameters.Add(new OptionalValueParameter("BestKnownSolution", "The best known solution for this external evaluation problem."));
Parameters.Add(new ValueParameter>("Operators", "The operators and items that the problem provides to the algorithms.", new ItemList()));
Parameters.Add(new OptionalValueParameter("Cache", "Cache of previously evaluated solutions."));
InitializeOperators();
RegisterEventHandlers();
}
[StorableHook(HookType.AfterDeserialization)]
private void AfterDeserialization() {
// BackwardsCompatibility3.3
#region Backwards compatible code, remove with 3.4
if (!Parameters.ContainsKey("Clients")) {
Parameters.Add(new ValueParameter>("Clients", "The clients that are used to communicate with the external application.", new CheckedItemCollection() { new EvaluationServiceClient() }));
if (Parameters.ContainsKey("Client")) {
var client = ((IValueParameter)Parameters["Client"]).Value;
if (client != null)
ClientsParameter.Value = new CheckedItemCollection() { client };
Parameters.Remove("Client");
}
}
if (Parameters.ContainsKey("Operators") && Parameters["Operators"] is ValueParameter>) {
ItemList tmp = ((ValueParameter>)Parameters["Operators"]).Value;
Parameters.Remove("Operators");
Parameters.Add(new ValueParameter>("Operators", "The operators and items that the problem provides to the algorithms.", new ItemList(tmp), false));
}
#endregion
RegisterEventHandlers();
}
#region Events
public event EventHandler SolutionCreatorChanged;
private void OnSolutionCreatorChanged() {
EventHandler handler = SolutionCreatorChanged;
if (handler != null) handler(this, EventArgs.Empty);
}
public event EventHandler EvaluatorChanged;
private void OnEvaluatorChanged() {
EventHandler handler = EvaluatorChanged;
if (handler != null) handler(this, EventArgs.Empty);
}
public event EventHandler OperatorsChanged;
private void OnOperatorsChanged() {
EventHandler handler = OperatorsChanged;
if (handler != null) handler(this, EventArgs.Empty);
}
public event EventHandler Reset;
private void OnReset() {
EventHandler handler = Reset;
if (handler != null) handler(this, EventArgs.Empty);
}
private void SolutionCreatorParameter_ValueChanged(object sender, EventArgs e) {
OnSolutionCreatorChanged();
}
private void EvaluatorParameter_ValueChanged(object sender, EventArgs e) {
Evaluator.QualityParameter.ActualNameChanged += new EventHandler(Evaluator_QualityParameter_ActualNameChanged);
ParameterizeOperators();
OnEvaluatorChanged();
}
private void Evaluator_QualityParameter_ActualNameChanged(object sender, EventArgs e) {
ParameterizeOperators();
}
private void OperatorsParameter_ValueChanged(object sender, EventArgs e) {
OnOperatorsChanged();
}
private void OperatorsParameter_Value_ItemsAdded(object sender, EventArgs e) {
OnOperatorsChanged();
}
private void OperatorsParameter_Value_ItemsRemoved(object sender, EventArgs e) {
OnOperatorsChanged();
}
private void OperatorsParameter_Value_CollectionReset(object sender, EventArgs e) {
OnOperatorsChanged();
}
#endregion
#region Helper
private void RegisterEventHandlers() {
SolutionCreatorParameter.ValueChanged += new EventHandler(SolutionCreatorParameter_ValueChanged);
EvaluatorParameter.ValueChanged += new EventHandler(EvaluatorParameter_ValueChanged);
Evaluator.QualityParameter.ActualNameChanged += new EventHandler(Evaluator_QualityParameter_ActualNameChanged);
OperatorsParameter.ValueChanged += new EventHandler(OperatorsParameter_ValueChanged);
OperatorsParameter.Value.ItemsAdded += new CollectionItemsChangedEventHandler>(OperatorsParameter_Value_ItemsAdded);
OperatorsParameter.Value.ItemsRemoved += new CollectionItemsChangedEventHandler>(OperatorsParameter_Value_ItemsRemoved);
OperatorsParameter.Value.CollectionReset += new CollectionItemsChangedEventHandler>(OperatorsParameter_Value_CollectionReset);
}
private void InitializeOperators() {
ItemList operators = OperatorsParameter.Value;
operators.Add(new BestScopeSolutionAnalyzer());
ParameterizeAnalyzers();
}
private void ParameterizeAnalyzers() {
BestScopeSolutionAnalyzer.ResultsParameter.ActualName = "Results";
BestScopeSolutionAnalyzer.QualityParameter.ActualName = Evaluator.QualityParameter.ActualName;
BestScopeSolutionAnalyzer.BestKnownQualityParameter.ActualName = BestKnownQualityParameter.Name;
BestScopeSolutionAnalyzer.BestKnownSolutionParameter.ActualName = BestKnownSolutionParameter.Name;
BestScopeSolutionAnalyzer.MaximizationParameter.ActualName = MaximizationParameter.Name;
}
private void ParameterizeEvaluator() {
Evaluator.ClientsParameter.ActualName = ClientsParameter.Name;
}
private void ParameterizeOperators() {
// This is a best effort approach to wiring
string qualityName = Evaluator.QualityParameter.ActualName;
foreach (IOperator op in OperatorsParameter.Value) {
foreach (ILookupParameter param in op.Parameters.OfType>()) {
if (param.Name.Equals("Quality")) param.ActualName = qualityName;
}
foreach (IScopeTreeLookupParameter param in op.Parameters.OfType>()) {
if (param.Name.Equals("Quality")) param.ActualName = qualityName;
}
}
}
#endregion
}
}