source: branches/DataAnalysis.IslandAlgorithms/HeuristicLab.Algorithms.DataAnalysis.Symbolic/3.3/SymbolicDataAnalysisIslandOffspringSelectionGeneticAlgorithm.cs @ 15802

#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 <http://www.gnu.org/licenses/>.
 */
#endregion

using System;
using System.Collections.Generic;
using System.Linq;
using HeuristicLab.Algorithms.OffspringSelectionGeneticAlgorithm;
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 HeuristicLab.Problems.DataAnalysis.Symbolic;

namespace HeuristicLab.Algorithms.DataAnalysis.Symbolic {
  [Item("Symbolic Data Analysis Island Offspring Selection Genetic Algorithm", "A symbolic data analysis island offspring selection genetic algorithm.")]
  [Creatable("Data Analysis")]
  [StorableClass]
  public sealed class SymbolicDataAnalysisIslandOffspringSelectionGeneticAlgorithm : IslandOffspringSelectionGeneticAlgorithm {
    private const string FixedSamplesParameterName = "NumberOfFixedSamples";
    private const string FixedSamplesPartitionParameterName = "FixedSamplesPartition";
    private const string FixedSamplesPartitionsParameterName = "FixedSamplesPartitions";
    private const string EvaluatorParameterName = "IslandEvaluator";
    private const string IslandIndexParameterName = "IslandIndex";
    private const string ProblemEvaluatorParameterName = "ProblemEvaluator";

    #region Problem Properties
    public override Type ProblemType {
      get { return typeof(ISymbolicDataAnalysisSingleObjectiveProblem); }
    }
    public new ISymbolicDataAnalysisSingleObjectiveProblem Problem {
      get { return (ISymbolicDataAnalysisSingleObjectiveProblem)base.Problem; }
      set { base.Problem = value; }
    }
    #endregion

    #region parameters
    public IFixedValueParameter<PercentValue> FixedSamplesParameter {
      get { return (IFixedValueParameter<PercentValue>)Parameters[FixedSamplesParameterName]; }
    }
    public IValueParameter<ItemArray<IntRange>> FixedSamplesPartitionsParameter {
      get { return (IValueParameter<ItemArray<IntRange>>)Parameters[FixedSamplesPartitionsParameterName]; }
    }
    public IValueParameter<ISymbolicDataAnalysisIslandGeneticAlgorithmEvaluator> EvaluatorParameter {
      get { return (IValueParameter<ISymbolicDataAnalysisIslandGeneticAlgorithmEvaluator>)Parameters[EvaluatorParameterName]; }
    }
    private ILookupParameter<ISingleObjectiveEvaluator> ProblemEvaluatorParameter {
      get { return (ILookupParameter<ISingleObjectiveEvaluator>)Parameters[ProblemEvaluatorParameterName]; }
    }
    #endregion

    #region properties
    public double FixedSamples {
      get { return FixedSamplesParameter.Value.Value; }
      set { FixedSamplesParameter.Value.Value = value; }
    }
    public ItemArray<IntRange> FixedSamplesPartitions {
      get { return FixedSamplesPartitionsParameter.Value; }
      set { FixedSamplesPartitionsParameter.Value = value; }
    }

    private readonly ScopeTreeAssigner<IntValue> islandIndexAssigner;
    #endregion

    [StorableConstructor]
    private SymbolicDataAnalysisIslandOffspringSelectionGeneticAlgorithm(bool deserializing) : base(deserializing) { }
    [StorableHook(HookType.AfterDeserialization)]
    private void AfterDeserialization() {
      RegisterParameterEvents();
    }
    private SymbolicDataAnalysisIslandOffspringSelectionGeneticAlgorithm(SymbolicDataAnalysisIslandOffspringSelectionGeneticAlgorithm original, Cloner cloner)
      : base(original, cloner) {
      RegisterParameterEvents();
    }
    public override IDeepCloneable Clone(Cloner cloner) {
      return new SymbolicDataAnalysisIslandOffspringSelectionGeneticAlgorithm(this, cloner);
    }

    public SymbolicDataAnalysisIslandOffspringSelectionGeneticAlgorithm()
      : base() {
      Parameters.Add(new FixedValueParameter<PercentValue>(FixedSamplesParameterName, "The number of fixed samples used for fitness calculation in each island.", new PercentValue(0.2)));
      Parameters.Add(new ValueParameter<ItemArray<IntRange>>(FixedSamplesPartitionsParameterName, "The fixed samples partitions used for fitness calculation for every island."));
      Parameters.Add(new OptionalValueParameter<ISymbolicDataAnalysisIslandGeneticAlgorithmEvaluator>(EvaluatorParameterName, "The evaluator of the algorithm."));
      Parameters.Add(new LookupParameter<ISingleObjectiveEvaluator>(ProblemEvaluatorParameterName, "Internal parameter for name translation", "Evaluator"));

      islandIndexAssigner = new ScopeTreeAssigner<IntValue>();
      islandIndexAssigner.Name = "Insert island index";
      islandIndexAssigner.LeftSideParameter.ActualName = IslandIndexParameterName;
      var readonlyIslandIndexes = Enumerable.Range(0, NumberOfIslands.Value).Select(x => (IntValue)new IntValue(x).AsReadOnly());
      islandIndexAssigner.RightSideParameter.Value = new ItemArray<IntValue>(readonlyIslandIndexes);

      ScopeTreeAssigner<IntRange> fixedSamplesPartitionCreator = new ScopeTreeAssigner<IntRange>();
      fixedSamplesPartitionCreator.Name = "Create fixed evaluation partition";
      fixedSamplesPartitionCreator.LeftSideParameter.ActualName = FixedSamplesPartitionParameterName;
      fixedSamplesPartitionCreator.RightSideParameter.ActualName = FixedSamplesPartitionsParameterName;

      SubScopesCreator insertionPoint = OperatorGraph.Iterate().OfType<SubScopesCreator>().First();
      islandIndexAssigner.Successor = fixedSamplesPartitionCreator;
      fixedSamplesPartitionCreator.Successor = insertionPoint.Successor;
      insertionPoint.Successor = islandIndexAssigner;

      ReevaluateImmigrants = true;
      ReevaluteElites = true;

      RegisterParameterEvents();
      RecalculateFixedSamplesPartitions();
    }

    private void RegisterParameterEvents() {
      if (Problem != null) Problem.FitnessCalculationPartition.ValueChanged += Problem_Reset;
      NumberOfIslandsParameter.ValueChanged += NumberOfIslandsParameter_ValueChanged;
      NumberOfIslandsParameter.Value.ValueChanged += (o, ev) => NumberOfIslandsParameterValue_Changed();
      FixedSamplesParameter.Value.ValueChanged += (o, e) => {
        RecalculateFixedSamplesPartitions();
        ReevaluateImmigrants = FixedSamples < Problem.FitnessCalculationPartition.Size;
      };
      Analyzer.Operators.PropertyChanged += (o, e) => ParameterizeAnalyzers();
      EvaluatorParameter.ValueChanged += (o, e) => ParameterizeEvaluator();
    }

    protected override void ParameterizeSolutionsCreator() {
      base.ParameterizeSolutionsCreator();
      SolutionsCreator.EvaluatorParameter.ActualName = EvaluatorParameterName;
    }

    protected override void ParameterizeMainLoop() {
      base.ParameterizeMainLoop();
      MainLoop.EvaluatorParameter.ActualName = EvaluatorParameterName;
      MainLoop.QualityParameter.ActualName = EvaluatorParameter.Value.QualityParameter.ActualName;
    }

    protected override void ParameterizeAnalyzers() {
      base.ParameterizeAnalyzers();
      foreach (var analyzer in Analyzer.Operators.OfType<ISymbolicDataAnalysisAnalyzer>()) {
        IParameter evaluatorParameter;
        if (analyzer.Parameters.TryGetValue("Evaluator", out evaluatorParameter)) {
          ILookupParameter param = evaluatorParameter as ILookupParameter;
          if (evaluatorParameter != null) param.ActualName = ProblemEvaluatorParameterName;
        }
      }
    }

    private void ParameterizeEvaluator() {
      var evaluator = EvaluatorParameter.Value;
      evaluator.IterationsParameter.ActualName = "Generations";
      evaluator.MaximumIterationsParameter.ActualName = MaximumGenerationsParameter.Name;
      evaluator.DataMigrationIntervalParameter.ActualName = MigrationIntervalParameter.Name;

      ParameterizeStochasticOperator(evaluator);
    }

    private void NumberOfIslandsParameter_ValueChanged(object sender, EventArgs e) {
      NumberOfIslands.ValueChanged += (o, ev) => NumberOfIslandsParameterValue_Changed();
      NumberOfIslandsParameterValue_Changed();
    }
    private void NumberOfIslandsParameterValue_Changed() {
      var readonlyIslandIndexes = Enumerable.Range(0, NumberOfIslands.Value).Select(x => (IntValue)new IntValue(x).AsReadOnly());
      islandIndexAssigner.RightSideParameter.Value = new ItemArray<IntValue>(readonlyIslandIndexes);
      RecalculateFixedSamplesPartitions();
    }

    protected override void Problem_Reset(object sender, EventArgs e) {
      base.Problem_Reset(sender, e);
      RecalculateFixedSamplesPartitions();
    }

    protected override void OnProblemChanged() {
      Problem.FitnessCalculationPartition.ValueChanged += Problem_Reset;

      if (Problem != null && EvaluatorParameter.Value == null) {
        EvaluatorParameter.Value = new RandomSamplesEvaluator();
      } else if (Problem == null)
        EvaluatorParameter.Value = null;

      ParameterizeStochasticOperator(EvaluatorParameter.Value);
      RecalculateFixedSamplesPartitions();
      base.OnProblemChanged();
    }

    private void RecalculateFixedSamplesPartitions() {
      if (Problem == null) {
        FixedSamplesPartitions = new ItemArray<IntRange>(Enumerable.Repeat(new IntRange(), NumberOfIslands.Value));
        return;
      }
      var samplesStart = Problem.FitnessCalculationPartition.Start;
      var samplesEnd = Problem.FitnessCalculationPartition.End;
      var totalSamples = Problem.FitnessCalculationPartition.Size;
      var fixedSamples = (int)(FixedSamples * totalSamples);
      var islands = NumberOfIslands.Value;

      double shift = (double)((totalSamples - fixedSamples)) / (islands - 1);
      int offset = (int)Math.Floor(shift);
      double remainder = shift - offset;

      List<IntRange> partitions = new List<IntRange>();
      for (int i = 0; i < islands; i++) {
        var partitionStart = samplesStart + offset * i + (int)(remainder * i);
        partitions.Add(new IntRange(partitionStart, partitionStart + fixedSamples));
      }

      //it can be the case that the last partitions exceeds the allowed samples
      //move the last partition forward.
      int exceedsSamples = partitions[partitions.Count - 1].End - samplesEnd;
      if (exceedsSamples > 0) {
        partitions[partitions.Count - 1].Start -= exceedsSamples;
        partitions[partitions.Count - 1].End -= exceedsSamples;
      }
      FixedSamplesPartitions = new ItemArray<IntRange>(partitions);
    }

  }
}