#region License Information
/* HeuristicLab
* Copyright (C) 2002-2012 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.Linq;
using HeuristicLab.Common;
using HeuristicLab.Core;
using HeuristicLab.Data;
using HeuristicLab.Parameters;
using HeuristicLab.Persistence.Default.CompositeSerializers.Storable;
namespace HeuristicLab.Encodings.SymbolicExpressionTreeEncoding {
///
/// Takes two parent individuals P0 and P1 each. Selects a random node N0 of P0 and a random node N1 of P1.
/// And replaces the branch with root0 N0 in P0 with N1 from P1 if the tree-size limits are not violated.
/// When recombination with N0 and N1 would create a tree that is too large or invalid the operator randomly selects new N0 and N1
/// until a valid configuration is found.
///
[Item("SubtreeCrossover", "An operator which performs subtree swapping crossover.")]
[StorableClass]
public sealed class SubtreeCrossover : TracingSymbolicExpressionTreeCrossover, ISymbolicExpressionTreeSizeConstraintOperator {
private const string InternalCrossoverPointProbabilityParameterName = "InternalCrossoverPointProbability";
private const string MaximumSymbolicExpressionTreeLengthParameterName = "MaximumSymbolicExpressionTreeLength";
private const string MaximumSymbolicExpressionTreeDepthParameterName = "MaximumSymbolicExpressionTreeDepth";
#region Parameter Properties
public IValueLookupParameter InternalCrossoverPointProbabilityParameter {
get { return (IValueLookupParameter)Parameters[InternalCrossoverPointProbabilityParameterName]; }
}
public IValueLookupParameter MaximumSymbolicExpressionTreeLengthParameter {
get { return (IValueLookupParameter)Parameters[MaximumSymbolicExpressionTreeLengthParameterName]; }
}
public IValueLookupParameter MaximumSymbolicExpressionTreeDepthParameter {
get { return (IValueLookupParameter)Parameters[MaximumSymbolicExpressionTreeDepthParameterName]; }
}
#endregion
#region Properties
public PercentValue InternalCrossoverPointProbability {
get { return InternalCrossoverPointProbabilityParameter.ActualValue; }
}
public IntValue MaximumSymbolicExpressionTreeLength {
get { return MaximumSymbolicExpressionTreeLengthParameter.ActualValue; }
}
public IntValue MaximumSymbolicExpressionTreeDepth {
get { return MaximumSymbolicExpressionTreeDepthParameter.ActualValue; }
}
#endregion
[StorableConstructor]
private SubtreeCrossover(bool deserializing) : base(deserializing) { }
private SubtreeCrossover(SubtreeCrossover original, Cloner cloner) : base(original, cloner) { }
public SubtreeCrossover()
: base() {
Parameters.Add(new ValueLookupParameter(MaximumSymbolicExpressionTreeLengthParameterName, "The maximal length (number of nodes) of the symbolic expression tree."));
Parameters.Add(new ValueLookupParameter(MaximumSymbolicExpressionTreeDepthParameterName, "The maximal depth of the symbolic expression tree (a tree with one node has depth = 0)."));
Parameters.Add(new ValueLookupParameter(InternalCrossoverPointProbabilityParameterName, "The probability to select an internal crossover point (instead of a leaf node).", new PercentValue(0.9)));
}
public override IDeepCloneable Clone(Cloner cloner) {
return new SubtreeCrossover(this, cloner);
}
protected override ISymbolicExpressionTree Cross(IRandom random,
ISymbolicExpressionTree parent0, ISymbolicExpressionTree parent1) {
return Cross(random, parent0, parent1, InternalCrossoverPointProbability.Value,
MaximumSymbolicExpressionTreeLength.Value, MaximumSymbolicExpressionTreeDepth.Value);
}
public static ISymbolicExpressionTree Cross(IRandom random,
ISymbolicExpressionTree parent0, ISymbolicExpressionTree parent1,
double internalCrossoverPointProbability, int maxTreeLength, int maxTreeDepth) {
// select a random crossover point in the first parent
CutPoint crossoverPoint0;
SelectCrossoverPoint(random, parent0, internalCrossoverPointProbability, maxTreeLength, maxTreeDepth, out crossoverPoint0);
int childLength = crossoverPoint0.Child != null ? crossoverPoint0.Child.GetLength() : 0;
// calculate the max length and depth that the inserted branch can have
int maxInsertedBranchLength = maxTreeLength - (parent0.Length - childLength);
int maxInsertedBranchDepth = maxTreeDepth - GetBranchLevel(parent0.Root, crossoverPoint0.Parent);
List allowedBranches = new List();
parent1.Root.ForEachNodePostfix((n) => {
if (n.GetLength() <= maxInsertedBranchLength &&
n.GetDepth() <= maxInsertedBranchDepth &&
IsMatchingPointType(crossoverPoint0, n))
allowedBranches.Add(n);
});
// empty branch
if (IsMatchingPointType(crossoverPoint0, null)) allowedBranches.Add(null);
if (allowedBranches.Count == 0) {
return parent0;
} else {
var selectedBranch = SelectRandomBranch(random, allowedBranches, internalCrossoverPointProbability);
if (crossoverPoint0.Child != null) {
// manipulate the tree of parent0 in place
// replace the branch in tree0 with the selected branch from tree1
crossoverPoint0.Parent.RemoveSubtree(crossoverPoint0.ChildIndex);
if (selectedBranch != null) {
crossoverPoint0.Parent.InsertSubtree(crossoverPoint0.ChildIndex, selectedBranch);
}
} else {
// child is null (additional child should be added under the parent)
if (selectedBranch != null) {
crossoverPoint0.Parent.AddSubtree(selectedBranch);
}
}
return parent0;
}
}
private static bool IsMatchingPointType(CutPoint cutPoint, ISymbolicExpressionTreeNode newChild) {
var parent = cutPoint.Parent;
if (newChild == null) {
// make sure that one subtree can be removed and that only the last subtree is removed
return parent.Grammar.GetMinimumSubtreeCount(parent.Symbol) < parent.SubtreeCount &&
cutPoint.ChildIndex == parent.SubtreeCount - 1;
} else {
// check syntax constraints of direct parent - child relation
if (!parent.Grammar.ContainsSymbol(newChild.Symbol) ||
!parent.Grammar.IsAllowedChildSymbol(parent.Symbol, newChild.Symbol, cutPoint.ChildIndex)) return false;
bool result = true;
// check point type for the whole branch
newChild.ForEachNodePostfix((n) => {
result =
result &&
parent.Grammar.ContainsSymbol(n.Symbol) &&
n.SubtreeCount >= parent.Grammar.GetMinimumSubtreeCount(n.Symbol) &&
n.SubtreeCount <= parent.Grammar.GetMaximumSubtreeCount(n.Symbol);
});
return result;
}
}
private static void SelectCrossoverPoint(IRandom random, ISymbolicExpressionTree parent0, double internalNodeProbability, int maxBranchLength, int maxBranchDepth, out CutPoint crossoverPoint) {
if (internalNodeProbability < 0.0 || internalNodeProbability > 1.0) throw new ArgumentException("internalNodeProbability");
List internalCrossoverPoints = new List();
List leafCrossoverPoints = new List();
parent0.Root.ForEachNodePostfix((n) => {
if (n.Subtrees.Any() && n != parent0.Root) {
foreach (var child in n.Subtrees) {
if (child.GetLength() <= maxBranchLength &&
child.GetDepth() <= maxBranchDepth) {
if (child.Subtrees.Any())
internalCrossoverPoints.Add(new CutPoint(n, child));
else
leafCrossoverPoints.Add(new CutPoint(n, child));
}
}
// add one additional extension point if the number of sub trees for the symbol is not full
if (n.SubtreeCount < n.Grammar.GetMaximumSubtreeCount(n.Symbol)) {
// empty extension point
internalCrossoverPoints.Add(new CutPoint(n, n.SubtreeCount));
}
}
});
if (random.NextDouble() < internalNodeProbability) {
// select from internal node if possible
if (internalCrossoverPoints.Count > 0) {
// select internal crossover point or leaf
crossoverPoint = internalCrossoverPoints[random.Next(internalCrossoverPoints.Count)];
} else {
// otherwise select external node
crossoverPoint = leafCrossoverPoints[random.Next(leafCrossoverPoints.Count)];
}
} else if (leafCrossoverPoints.Count > 0) {
// select from leaf crossover point if possible
crossoverPoint = leafCrossoverPoints[random.Next(leafCrossoverPoints.Count)];
} else {
// otherwise select internal crossover point
crossoverPoint = internalCrossoverPoints[random.Next(internalCrossoverPoints.Count)];
}
}
private static ISymbolicExpressionTreeNode SelectRandomBranch(IRandom random, IEnumerable branches, double internalNodeProbability) {
if (internalNodeProbability < 0.0 || internalNodeProbability > 1.0) throw new ArgumentException("internalNodeProbability");
List allowedInternalBranches;
List allowedLeafBranches;
if (random.NextDouble() < internalNodeProbability) {
// select internal node if possible
allowedInternalBranches = (from branch in branches
where branch != null && branch.Subtrees.Any()
select branch).ToList();
if (allowedInternalBranches.Count > 0) {
return allowedInternalBranches.SelectRandom(random);
} else {
// no internal nodes allowed => select leaf nodes
allowedLeafBranches = (from branch in branches
where branch == null || !branch.Subtrees.Any()
select branch).ToList();
return allowedLeafBranches.SelectRandom(random);
}
} else {
// select leaf node if possible
allowedLeafBranches = (from branch in branches
where branch == null || !branch.Subtrees.Any()
select branch).ToList();
if (allowedLeafBranches.Count > 0) {
return allowedLeafBranches.SelectRandom(random);
} else {
allowedInternalBranches = (from branch in branches
where branch != null && branch.Subtrees.Any()
select branch).ToList();
return allowedInternalBranches.SelectRandom(random);
}
}
}
private static int GetBranchLevel(ISymbolicExpressionTreeNode root, ISymbolicExpressionTreeNode point) {
if (root == point) return 0;
foreach (var subtree in root.Subtrees) {
int branchLevel = GetBranchLevel(subtree, point);
if (branchLevel < int.MaxValue) return 1 + branchLevel;
}
return int.MaxValue;
}
}
}