VotingRecombinationCrossover.cs

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Linq;

namespace GeneticSharp
{
    /// <summary>
    /// Voting Recombination Crossover (VR).
    /// <remarks>
    /// <para>
    /// It can be seen as a P-sexual crossover operator, where p (parents number) is a natural number greater than, or equal to, 2.
    /// </para>
    /// <para>
    /// It starts by defining a threshold, which is a natural number smaller than, or equal to p.
    /// </para>
    /// <para>
    /// Next, for every; i E {l, 2, . . .N} the set of ith elements of all the parents is considered. 
    /// If in this set an element occurs at least the threshold number of times, it is copied into the offspring. 
    /// </para>
    /// <para>
    /// For example, if we consider the parents(p = 4) (1 4 3 5 2 6), (1 2 4 3 5 6), (3 2 1 5 4 6), (1 2 3 4 5 6) and we define the threshold to be equal to 3 we find(1 2 x x x 6). 
    /// The remaining positions of the offspring are filled with mutations.
    /// <see href="http://ictactjournals.in/paper/IJSC_V6_I1_paper_4_pp_1083_1092.pdf">Crossover operators in genetic algorithms: A review</see>
    /// </para>
    /// <para>
    /// The voting recombination produce one child of parents number (p) based on a threshold.
    /// <see href="https://www.cs.vu.nl/~gusz/papers/Handbook-Multiparent-Eiben.pdf">Multiparent Recombination</see>
    /// </para>
    /// </remarks>
    /// </summary>
    [DisplayName("Voting Recombination (VR)")]
    public sealed class VotingRecombinationCrossover : CrossoverBase
    {
        private readonly int _threshold;

        /// <summary>
        /// Initializes a new instance of the <see cref="GeneticSharp.VotingRecombinationCrossover"/> class.
        /// </summary>
        /// <param name="parentsNumber">The number of parents need for cross.</param>
        /// <param name="threshold">An element occurs at least the threshold number of times, it is copied into the offspring</param>
        public VotingRecombinationCrossover(int parentsNumber, int threshold)
            : base(parentsNumber, 1)
        {
            if (threshold > parentsNumber)
            {
                throw new ArgumentOutOfRangeException(nameof(threshold), "The threshold should be smaller or equal to the parents number.");
            }

            IsOrdered = false;
            _threshold = threshold;
        }

        /// <summary>
        /// Initializes a new instance of the <see cref="GeneticSharp.VotingRecombinationCrossover"/> class.
        /// </summary>
        public VotingRecombinationCrossover() : this(3, 2)
        {
        }

        /// <summary>
        /// Performs the cross with specified parents generating the children.
        /// </summary>
        /// <param name="parents">The parents chromosomes.</param>
        /// <returns>The offspring (children) of the parents.</returns>
        protected override IList<IChromosome> PerformCross(IList<IChromosome> parents)
        {
            var firstParent = parents[0];
            var child = firstParent.CreateNew();
            var mutableGenesIndexes = new List<int>();
           
            for (int i = 0; i < child.Length; i++)
            {
                // If in this set an element occurs at least the threshold number of times, it is copied into the offspring.
                 var moreOcurrencesGeneValue = parents
                                            .GroupBy(p => p.GetGene(i).Value)
                                            .Where(p => p.Count() >= _threshold)
                                            .OrderByDescending(g => g.Count())
                                            .FirstOrDefault();

                if (moreOcurrencesGeneValue != null)
                {
                    child.ReplaceGene(i, new Gene(moreOcurrencesGeneValue.Key));
                }
                else
                {
                    mutableGenesIndexes.Add(i);
                }
            }

            // The remaining positions of the offspring are filled with mutations.
            if (mutableGenesIndexes.Count > 0)
            {
                new UniformMutation(mutableGenesIndexes.ToArray())
                    .Mutate(child, 1);
            }

            return new List<IChromosome> { child };
        }
    }
}