Mutation.hh

#ifndef GRAIL_MUTATION_H
#define GRAIL_MUTATION_H
 
#include <memory>
#include <random>
#include <vector>
 
namespace grail
{
    namespace evolution
    {
        class EvoScript;
        class EvoParam;
 
        //REVIEW: this could probably be nested inside Mutation
        enum class MutationSelectionType
        {
            ITERATE_AND_TEST_P,
            SELECT_P_OF_N
        };
 
        struct Mutation
        {
        public:
            Mutation(double mutationPhaseRate = 1.0,
                     double mutateIndividualRate = 0.09,
                     double mutateChromosomeRate = 0.5,
                     bool mutateBothParentsAndChildren = true,
                     std::mt19937_64::result_type seed = std::random_device{}());
            virtual ~Mutation();
 
            //REVIEW: missing some doxygen comments
            virtual void Perform(const std::vector<std::unique_ptr<EvoScript>>& parentPopulation,
                                 const std::vector<std::unique_ptr<EvoScript>>& childrenPopulation);
 
            std::vector<std::unique_ptr<EvoScript>> populationAfter{};
 
            double MutationPhaseRate = 0.0;
 
            double MutateIndividualRate = 0.0;
 
            double MutateChromosomeRate = 0.0;
 
            bool MutateBothParentsAndChildren = false;
 
            MutationSelectionType RandomResolutionTypeForIndividual = MutationSelectionType::SELECT_P_OF_N;
            MutationSelectionType RandomResolutionTypeForChromosome = MutationSelectionType::SELECT_P_OF_N;
 
        protected:
            std::mt19937_64 randGen;
        protected:
            virtual void MutateIndividual(EvoScript& individual);
            virtual void MutateChromosome(EvoScript& individual, EvoParam& chromosome);
        };
    }
}
#endif /// GRAIL_MUTATION