#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;
namespace HeuristicLab.Encodings.IntegerVectorEncoding {
///
/// A base class for operators creating int-valued vectors.
///
[Item("IntegerVectorCreator", "A base class for operators creating int-valued vectors.")]
[StorableType("c019cee0-96d6-4c3f-9903-8fe6b5dfc3c6")]
public abstract class IntegerVectorCreator : InstrumentedOperator, IIntegerVectorCreator, IStochasticOperator {
public override bool CanChangeName {
get { return false; }
}
public ILookupParameter RandomParameter {
get { return (LookupParameter)Parameters["Random"]; }
}
public ILookupParameter IntegerVectorParameter {
get { return (ILookupParameter)Parameters["IntegerVector"]; }
}
public IValueLookupParameter LengthParameter {
get { return (IValueLookupParameter)Parameters["Length"]; }
}
public IValueLookupParameter BoundsParameter {
get { return (IValueLookupParameter)Parameters["Bounds"]; }
}
[StorableConstructor]
protected IntegerVectorCreator(StorableConstructorFlag deserializing) : base(deserializing) { }
protected IntegerVectorCreator(IntegerVectorCreator original, Cloner cloner) : base(original, cloner) { }
protected IntegerVectorCreator()
: base() {
Parameters.Add(new LookupParameter("Random", "The pseudo random number generator which should be used for stochastic manipulation operators."));
Parameters.Add(new LookupParameter("IntegerVector", "The vector which should be manipulated."));
Parameters.Add(new ValueLookupParameter("Length", "The length of the vector."));
Parameters.Add(new ValueLookupParameter("Bounds", "The bounds matrix can contain one row for each dimension with three columns specifying minimum (inclusive), maximum (exclusive), and step size. If less rows are given the matrix is cycled."));
}
// BackwardsCompatibility3.3
#region Backwards compatible code, remove with 3.4
[StorableHook(HookType.AfterDeserialization)]
private void AfterDeserialization() {
if (!Parameters.ContainsKey("Bounds")) {
var min = ((IValueLookupParameter)Parameters["Minimum"]).Value as IntValue;
var max = ((IValueLookupParameter)Parameters["Maximum"]).Value as IntValue;
Parameters.Remove("Minimum");
Parameters.Remove("Maximum");
Parameters.Add(new ValueLookupParameter("Bounds", "The bounds matrix can contain one row for each dimension with three columns specifying minimum (inclusive), maximum (exclusive), and step size. If less rows are given the matrix is cycled."));
if (min != null && max != null) {
BoundsParameter.Value = new IntMatrix(new int[,] { { min.Value, max.Value, 1 } });
}
}
}
#endregion
public sealed override IOperation InstrumentedApply() {
IntegerVectorParameter.ActualValue = Create(RandomParameter.ActualValue, LengthParameter.ActualValue, BoundsParameter.ActualValue);
return base.InstrumentedApply();
}
protected abstract IntegerVector Create(IRandom random, IntValue length, IntMatrix bounds);
}
}