TRSCustomGeneticAlgorithm Class

Create(TComponent)

Initializes a new instance of the TRSCustomGeneticAlgorithm class. (Overrides RSGeneticBase.TRSCustomGeneticComponent.Create(TComponent).)

Destroy

Represents the destructor of the TRSCustomGeneticAlgorithm class. (Overrides RSGeneticBase.TRSCustomGeneticComponent.Destroy.)

AvgFitness

Returns the average fitness level of the   Population.
 (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

AvgWeightedFitness

Returns the average weighted fitness level of the   Population.
 (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

CrossoverMethod

Controls how the genetic algorithm does crossover (also known as recombination) when two parents of the current generation reproduce to create a new child.

Crossover is one of the evolutionary biology techniques used by the genetic algorithm component, along with inheritance, mutation, and selection. In crossover, the genetic algorithm component splices out the first random n-bits of one parent and concatenates it with the last chromosome size-n bits of the other parent. The chromosome size of the child is the same as its parents.

The CrossoverMethod property controls how the break is selected: on a gene boundary, bit boundary, or byte, word, or longword boundary. Note that crossover on a non-gene boundary could possibly cause invalid gene values because the newly combined gene at the crossover point is a random mixture of bits from the 2 parents.

The Operations property controls whether crossover occurs at all during evolution, while the CrossoverProbability property controls the likelihood that crossover will occur when 2 parents are selected to create a child (e.g., if there are 100 children created each generation, the CrossoverProbability will be tested 100 times).

CrossoverProbability

Controls the likelihood that crossover (also known as recombination) will occur when 2 parents are selected to create a new child. When crossover occurs, the 2 parents genes or DNA are combined to make the child. The crossover probability is checked for each new child (e.g., if there are 100 children created each generation, the CrossoverProbability will be tested 100 times).

The Operations property controls whether crossover occurs at all during evolution.

CumNormFitnesses

Contains the cumulative normalized fitnesses of the current generation (   Population) (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

Diversity

Returns the genetic diversity of the current Population, which is the   AvgFitness /   MaxFitness. In other words, how different (based upon fitness) are the individuals in the population from each other? If the population is not diverse enough, it is hard to breed a solution as everyone is alike. The genetic component can use the Diversity with the   DiversityLimit to automatically abort evolution if the diversity indicates we are in an evolutionary dead-end.
 (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

DiversityLimit

Specifies the minimum diversity the population must have in order to be considered viable. If the Diversity of the Population falls below this limit, the     Evolve method will abort evolution.

Note the     UseDiversityLimit property must be True to use the diversity limit.
 

ElitistPct

Controls the percentage of "elite" parents used every generation for evolution. 0 means 0% of the population, 0.5 means 50% of the population, and 1 means 100% of the population. The ElitistPct property is used when the   SelectionMethod is smElitist.
 (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

FitnessCutoff

Specifies the Fitness level desired for the evolutionary search. If the     FittestIndividual of the     Population has a fitness greater than or less than (depending on the     FitnessMethod) the fitness cutoff, the     Evolve method will abort evolution.

Note the     UseFitnessCutoff property must be True to use the fitness cutoff.
 
 

FitnessMethod

Controls how the genetic component evolves: should it seek to maximize fitness or minimize fitness (or weighted fitness) (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

FitnessSum

Contains the sum of all fitness values for the entire population (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

FittestIndividual

Returns the fittest individual in the   Population. The individual is chosen based on the FitnessMethod and the Fitness evaluations of all the individuals in the population. The FittestIndividual is re-chosen every time the population is evolved.
 

Generation

Returns the current generation number of population. When the   Initialize method is called, the Generation is reset to 0. Every time the   Evolve method creates a new generation, this property is incremented.
 (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

GenerationLimit

Specifies the maximum number of generations to breed before quitting
 
Note the   UseGenerationLimit property must be True to use the generation limit.
 (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

Genes

Allows you to define the genes that make up the DNA of the Population's chromosomes. The chromosomes are created by taking the parameters or factors (integers, booleans, floats, and enumerations) of your search problem and concatenating them together into a sequence of bits. The Genes property allows you to define the sequence of genes ( RSGeneticAlgorithm.TRSGAGene ) that make up these bits.

Each TRSGAGene provides a mapping that gives meaning to a certain number of bits in the individual. The TRSGAGene class is a helper class which helps you define and manipulate the genes of your population easily by defining n-bit integers, booleans, floats, etc. Each gene defines a characteristic of an individual. While the chromosomes are specific to an individual, the gene definition (TRSGAGene) defines the meaning of each gene for the entire population.

As an alternative to defining the genes of your population, you can use the GeneSize property to just define the number of bits in the chromosome with no mapping.
 

GeneSize

Defines the size of the chromosomes for all the Population. This value is automatically calculated for you if you define genes using the   Genes collection. Alternatively, if you don't want to define the Genes specifically, you can just set this property.
 

Halt

Controls   Evolve method execution. Set Halt to true to stop evolution (useful for multi-threading) (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

InitialDuplicatesRetries

Specifies the number of times to retry generating an individual on initialization if it is a duplicate

Initialized

Returns true if the genetic component has been initialized (and initial population has been created and evaluated for fitness) (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

InitialPopulation

Specifies the initial number of individuals to make in the   Population before attempting to solve your solution. Use this property to quickly and easily define the population size. The InitialPopulation property specifies the minimum initial population.

InversionProbability

Controls the likelihood that inversion will occur in a child's DNA or chromosome, e.g., whether a portion of the child's chromosome will be flipped. The probability is between 0 (no chance) and 1 (always). When 2 parents reproduce and create a new child, their chromosomes are combined using Crossover and then the child's chromosome may be mutated and/or inverted. The InversionProbability is checked once per child.

The Operations property controls whether inversion occurs at all during evolution.
 

MaxFitness

Returns the highest fitness level of the   Population.
 
 (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

MaxWeightedFitness

Returns the highest weighted fitness level of the   Population.
 (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

MinFitness

Returns the lowest fitness level of the   Population.
 (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

MinWeightedFitness

Returns the lowest weighted fitness level of the   Population.
 (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

MutationProbability

Controls the likelihood that a child's chromosomes will be mutated.

For genetic algorithms, this is the likelihood that each bit of a child's chromosome will be mutated (flipped) between 0 (no chance) and 1 (always). When 2 parents reproduce and create a new child, their chromosomes are combined using Crossover and then the child's chromosome may be mutated. Because this probability is used for each bit of a child's chromosome, its value should be set very low (like 0.01). As a general rule, the probability that a chromosome will be flipped should be no more than 1 bit per individual. Any more bits flipping will keep the genetic algorithms from finding a solution.

For genetic programs, this is the likelihood that one mutation will occur in the genetic program tree, so its value should be higher than for genetic algorithms. Genetic programming has a whole suite of mutations (subtree, point, constant, etc) that can occur; which mutation occurs depends on their MutationWeights.
 
The     Operations property controls whether mutation occurs at all during evolution.
 
 

OnEvolve

Occurs each time the   Evolve method is called. The OnEvolve event handler is called once at the end of the Evolve method. Use the OnEvolve event handler to take action when the Population evolves. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

Operations

Defines the set of genetic operations to perform at each evolutionary step. By default, the genetic component provides crossover, mutation, and inversion operations. You can also specify the chances of each operation occurring every generation using the     CrossoverProbability,     MutationProbability, and     InversionProbability properties.

In addition to the standard genetic operations provided by the TRSCustomGeneticComponent, you can perform your own by writing an     OnReproduction event handler.
 
 
 
 

Population

Represents the entire population of candidate individuals ( RSGeneticAlgorithm.TRSGAIndividual ) in the current Generation, including the     FittestIndividual.

The TRSCustomGeneticAlgorithm component seeks to solve your optimization or search problems by evolving a group or population of candidate individuals through successive generations, selecting fitter (or better) child individuals for each generation, until a solution is found. After every call to Evolve , the Population property contains the next generation of individuals (the children), with the     PreviousGeneration property holding the previous generation (the parents, what was the Population before the Evolve call).

PreviousGeneration

Contains the parents of the current generation, which is represented by the   Population property. After every call to Evolve, the Population property contains the next generation of individuals (the children), with the PreviousGeneration property holding the previous generation (the parents, what was the Population before the Evolve call).

PriorityQueue

Returns the population sorted by fitness (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

RouletteIndex

Index of the individual next up in Elitist selection method or index of winner of roulette wheel selection method (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

SelectionMethod

Specifies how the genetic component selects individuals from the current generation to be used as parents of the next generation. The genetic component provides some built-in methods and allows you to write your own by using the   OnSelection event.
 (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

TournamentField

Specifies how many times the tournament must run for selecting a parent when     SelectionMethod is smTournament or smStochasticTournament. In other words, when selecting a parent, the genetic component runs a tournament, where the best or fittest individual is selected out of all the TournamentField number of contests.
 

UseDiversityLimit

Controls whether the genetic component attempts to abort evolution when the     Population's diversity falls below the     DiversityLimit. The DiversityLimit property aborts the evolutionary process when the diversity of the children falls below the DiversityLimit, e.g., all the children are too alike to go any further.

The Evolve method starts "breeding" the population towards your goal. The Evolve method may be called with the number of generations to execute. You can use the DiversityLimit, GenerationLimit and the FitnessCutoff as three properties to automatically abort evolution when they are exceeded. If the UseDiversityLimit is false, the     DiversityLimit will not abort evolution.
 
 

UseFitnessCutoff

Controls whether the genetic component attempts to abort evolution when the     FitnessCutoff is exceeded. The FitnessCutoff property aborts the evolutionary process if the     FittestIndividual of the Population has a fitness greater than or less than (depending on the     FitnessMethod) the fitness cutoff, the     Evolve method will abort evolution.

The Evolve method starts "breeding" the population towards your goal. The Evolve method may be called with the number of generations to execute. You can use the DiversityLimit, GenerationLimit and the FitnessCutoff as three properties to automatically abort evolution when they are exceeded. If the     UseFitnessCutoff is false, the FitnessCutoff will not abort evolution.
 
 

UseGenerationLimit

Controls whether the genetic component attempts to abort evolution when the maximum number of generations is exceeded. If     Generation exceeds     GenerationLimit, the     Evolve method will abort evolution.

The Evolve method starts "breeding" the population towards your goal. The Evolve method may be called with the number of generations to execute. You can use the DiversityLimit, GenerationLimit and the FitnessCutoff as three properties to automatically abort evolution when they are exceeded. If the     UseGenerationLimit is false, the GenerationLimit will not abort evolution.
 
 

WeightedFitnessSum

Contains the sum of all weighted fitness values for the entire population (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

Assign(TPersistent)

Represents method Assign(TPersistent). (Overrides RSGeneticBase.TRSCustomGeneticComponent.Assign(TPersistent).)

CalculateCumulativeNormalizedFitnesses

Calculates the cumulative normalized fitness values of the   Population (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

CompareFitness(TRSIndividual,TRSIndividual,Boolean)

Compares the two individuals and returns an evaluation of who is fitter. If the result is -1, Parent1 is fitter. If the result is 1, Parent2 is fitter. If the two individuals are equally fit, the function returns 0.

The function uses the RSGeneticBase.TRSIndividual.Fitness property or RSGeneticBase.TRSIndividual.WeightedFitness to determine which parent is fitter. The     FitnessMethod controls the interpretation of the fitness.

The UsePureFitness parameter tells the function if it should ignore WeightedFitness or not.

CreateGenes(TRSGeneClass)

Creates the Genes collection

CreatePopulation(TRSIndividualClass)

Creates the population collection (Overrides RSGeneticBase.TRSCustomGeneticComponent.CreatePopulation(TRSIndividualClass).)

Crossover(TRSIndividual,TRSIndividual,TRSIndividual)

Overloaded.  Combines the DNA of the two parents to make the DNA of the children. Note that crossover is not guaranteed to occur but is dependent on the     CrossoverProbability. The function calls the     OnCrossover event and then  DoCrossover method.

The Crossover method is called by the     Reproduce method. The function returns true if crossover occurred.
 

Crossover(TRSIndividual,TRSIndividual,TRSIndividual,TRSIndividual)

Overloaded.  Combines the DNA of the two parents to make the DNA of the children. Note that crossover is not guaranteed to occur but is dependent on the     CrossoverProbability. The function calls the     OnCrossover event and then  DoCrossover method.

The Crossover method is called by the     Reproduce method. The function returns true if crossover occurred.
 

DefineProperties(TFiler)

Represents method DefineProperties(TFiler). (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

Describe(TStrings,String)

Provides a description of the genetic programming component and its important properties. The description is added to the Strings parameter. The TabStr parameter specifies the indentation to use when adding sub-strings. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

DoCalculateFitnessStatistics

Calculates the fitness statistics (max, min, avg) for one generation. The method accesses each individual's Fitness property which may force a fitness evaulation to occur. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

DoCalculateWeightedFitnessStatistics

Calculates the weighted fitness statistics (max, min, avg) for one generation. The method accesses each individual's WeightedFitness property which may force a fitness evaulation to occur. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

DoCrossover(TRSIndividual,TRSIndividual,TRSIndividual,TRSIndividual)

Performs the actual crossover operation. The decision to crossover has already been decided by the time this method is called. (Overrides RSGeneticBase.TRSCustomGeneticComponent.DoCrossover(TRSIndividual,TRSIndividual,TRSIndividual,TRSIndividual).)

DoEvaluateWeightedFitness(TRSIndividual)

Calls the OnEvaluateWeightedFitness event and returns the result. If the event handler has not been defined, this method returns the regular fitness (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

DoEvolve

Performs the actual evolve for one generation with each new pair of children being created in sequence (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

DoEvolveOneStep(Integer)

Performs the actual evolve for one pair of children (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

DoFinishEvolve

Performs final steps for one evolution phase. Called by DoEvolve. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

DoInitialize

Performs the actual initialization of the Population before evolution occurs.

The method returns number of duplicates fixed.

DoInvert(TRSIndividual)

Performs the actual inversion of the individual. The decision to invert the individual has already been made before calling this method. (Overrides RSGeneticBase.TRSCustomGeneticComponent.DoInvert(TRSIndividual).)

DoMutate(TRSIndividual)

Performs the actual mutation of the individual. The decision to mutat the individual has already been made before calling this method. (Overrides RSGeneticBase.TRSCustomGeneticComponent.DoMutate(TRSIndividual).)

DoParallelEvolveOneStep(Integer)

Performs the actual evolve for one pair of children (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

DoReproduce(TRSIndividual,TRSIndividual,TRSIndividual)

Overloaded. Performs the actual reproduction operation by combining the two parents to make the new Child. The Child must already exist but may be uninitialized. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

DoReproduce(TRSIndividual,TRSIndividual,TRSIndividual,TRSIndividual)

Overloaded. Performs the actual reproduction operation by combining the two parents to make two new children. The children must already exist but may be uninitialized. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

DoSelectionPreparation

Performs any steps necessary for selecting parents in the newly evolved Population.

This method is called when evaluating fitness for everyone.
 

DoSelectParent(TRSPopulation)

Performs the selection of a parent from the Population. This method is only called if the   SelectionMethod is Custom. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

DoStartEvolve

Performs initial steps for one evolution phase. Called by DoEvolve. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

EvaluateFitness

Overloaded.  Evaluates the fitness for every individual of the Population (and calculates the     MaxFitness,     MinFitness, and     AvgFitness). It calculates a fitness estimation for every RSGeneticBase.TRSIndividual by calling the overloaded     EvaluateFitness method. It uses your     OnEvaluateFitness event handler to calculate values. After every individual is evaluated, it sets the MaxFitness, MinFitness, and AvgFitness values and sets the     FittestIndividual property.

Defining your fitness function is a highly important part of defining a genetic algorithm or genetic program. The fitness function returns a floating point value that specifies the correctness of the individual solution. The fitness function needs to be able to allow the genetic component to decide which solution is better than another. The genetic component will seek to either maximize the solution (e.g., keep evolving for individuals whose fitness are greater than other individuals in the population) or to minimize the solution (e.g., find the individuals whose fitness are less than other individuals). Note you can specify which direction to evolve towards with the     FitnessMethod property.
 

EvaluateFitness(TRSIndividual,Boolean)

Overloaded.  Returns a fitness estimation of the passed in RSGeneticBase.TRSIndividual . It uses your     OnEvaluateFitness event handler to return the value.

Defining your fitness function is a highly important part of defining a genetic algorithm or genetic program. The fitness function returns a floating point value that specifies the correctness of the individual solution. The fitness function needs to be able to allow the genetic component to decide which solution is better than another. The genetic component will seek to either maximize the solution (e.g., keep evolving for individuals whose fitness are greater than other individuals in the population) or to minimize the solution (e.g., find the individuals whose fitness are less than other individuals). Note you can specify which direction to evolve towards with the     FitnessMethod property.

The overloaded     EvaluateFitness method evaluates the fitness for every individual of the Population (and calculates the     MaxFitness,     MinFitness, and     AvgFitness).
 

Evolve

Overloaded.  The Evolve method is the heart of the genetic component. The Evolve method is responsible for "breeding" the     Population towards an answer for your goal. Each generation, the Evolve method selects parents and then     Reproduces children for the new generation by using the genetic operations: first crossover, then mutation, and finally inversion. Each call to Evolve with breed one new generation. If you want to evolve many new generations at once (perhaps with a cutoff using the     FitnessCutoff,     GenerationLimit and     DiversityLimit properties), use the overloaded Evolve method. Successive calls to the Evolve method continues the evolutionary process from where the Evolve method stopped (use     Initialize to reset the process). If this is your first call to Evolve, it automatically calls the Initialize method.

Specify the     Operations to control which operations are performed while evolving: crossover, mutation, and inversion operations. You can also specify the chances of each operation occurring every generation using the     CrossoverProbability,     MutationProbability, and     InversionProbability properties.

The     SelectionMethod property (or     OnSelection event) specifies how the genetic component selects individuals from the current generation to be used as parents of the next generation.

The FitnessCutoff property aborts the evolutionary process when any child meets or exceeds (if FitnessMethod is fmMaximize) or is less than (if FitnessMethod is fmMinimize) the cutoff value. The     UseFitnessCutoff property must be true to use the fitness cutoff.

The DiversityLimit property aborts the evolutionary process when the diversity of the children falls below the DiversityLimit, e.g., all the children are too alike to go any further. The     UseDiversityLimit property must be true to use the diversity limit.

The GenerationLimit property aborts the evolutionary process when the required number of generations have been evolved. The     UseGenerationLimit property must be true to use the generation limit.
 
 

Evolve(Integer)

Overloaded.  The Evolve method is the heart of the genetic component. The Evolve method is responsible for "breeding" the     Population towards an answer for your goal. Each generation, the Evolve method selects parents and then     Reproduces children for the new generation by using the genetic operations: first crossover, then mutation, and finally inversion. You can specify the number of generations to evolve or use the     FitnessCutoff,     GenerationLimit and     DiversityLimit properties to automatically stop the genetic process. Successive calls to the Evolve method continues the evolutionary process from where the Evolve method stopped (use     Initialize to reset the process). If this is your first call to Evolve, it automatically calls the Initialize method.

Specify the     Operations to control which operations are performed while evolving: crossover, mutation, and inversion operations. You can also specify the chances of each operation occurring every generation using the     CrossoverProbability,     MutationProbability, and     InversionProbability properties.

The     SelectionMethod property (or     OnSelection event) specifies how the genetic component selects individuals from the current generation to be used as parents of the next generation.

The FitnessCutoff property aborts the evolutionary process when any child meets or exceeds (if FitnessMethod is fmMaximize) or is less than (if FitnessMethod is fmMinimize) the cutoff value. The     UseFitnessCutoff property must be true to use the fitness cutoff.

The DiversityLimit property aborts the evolutionary process when the diversity of the children falls below the DiversityLimit, e.g., all the children are too alike to go any further. The     UseDiversityLimit property must be true to use the diversity limit.

The GenerationLimit property aborts the evolutionary process when the required number of generations have been evolved. The     UseGenerationLimit property must be true to use the generation limit.
 
 
 

Fittest(TRSIndividual,TRSIndividual,Boolean)

Returns the "fitter" of the two parent individuals. It compares the Fitness properties (or WeightedFitness) of both individuals, and, based on the FitnessMethod, selects the better individual. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

GeneNotify(TRSGAGene,TCollectionNotification)

Called when a gene is added or deleted

GenesSizeChange

Called when the size of the entire genome has changed

GeneUpdate(TRSGAGene)

Called when a gene is changed

GetAdjustedFitness(TGAFitness)

Calculates the adjusted fitness, a value between 0 and 1, where a bigger value (closer to 1) represents better individuals.

The adjusted fitness equals 1/(1 + StandardizedFitness) when minimizing, and 1/(1+(MaxFitness - StandardizedFitness)) when maximizing.
 

GetNormalizedFitness(TGAFitness)

Calculates the normalized fitness, a value between 0 and 1.

The normalized fitness equals Fitness / Sum of All Fitness

GetNormalizedWeightedFitness(TGAFitness)

Calculates the normalized weighted fitness, a value between 0 and 1.

The normalized fitness equals Fitness / Sum of All Weighted Fitness

Initialize

Prepares the genetic component for evolution (or resets the genetic population to start over). On calling the Initialization method, the Population is set to the   InitialPopulation size. The   OnInitialization method is called. Then, the Population's DNA are randomized and each individual's fitness is evaluated. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

InitializeChild(TRSIndividual,TRSIndividual,TRSIndividual)

Initializes the Child with the two parents (usually just a copy of the first parent) (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

Invert(TRSIndividual)

Inverts the DNA of the individual. Inversion for genetic algorithms means flipping the bits of the chromosome. For genetic programs, inversion means a point mutation (replacing a node with another node of the same arity in the tree).

Note that inversion is not guaranteed to occur but is dependent on the     InversionProbability. The function calls the     OnInversion event and then DoInvert method.
 
The Invert method is called by the     Reproduce method. The function returns true if inversion occurred.
 

IsCustomSelection

Returns true if   SelectionMethod is custom (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

IsFinished

Returns true if the evolution process is complete. The process is complete if the Fitness meets the   FitnessCutoff (if   UseFitnessCutoff is true) or the population diversity meets the   DiversityLimit (if   UseDiversityLimit is true) or the   Generation exceeds the   GenerationLimit (if   UseGenerationLimit is true). (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

LoadFromFile(string)

Loads the entire genetic component from the XML file specified by the Filename parameter, including the Genes (genetic algorithms) or Instructions (genetic programming) and the Population. Use the LoadFromFile and SaveToFile methods to stream in and out the genetic component in XML format. The format of the XML is defined in the GeneticAlgorithm.xsd and GeneticProgramming.xsd schema files. (Overrides RSGeneticBase.TRSCustomGeneticComponent.LoadFromFile(string).)

LoadFromStream(TStream)

Loads the entire genetic component from the XML stream specified by the stream parameter, including the Genes (genetic algorithms) or Instructions (genetic programming) and the Population. Use the LoadFromStream and SaveToStream methods to stream in and out the genetic component in XML format. The format of the XML is defined in the GeneticAlgorithm.xsd and GeneticProgramming.xsd schema files. (Overrides RSGeneticBase.TRSCustomGeneticComponent.LoadFromStream(TStream).)

LoadFromXML(IXMLGADomainType)

Overloaded.  Loads the Genes and the Population from the IXMLGADomainType interface. Use the     LoadFromXML and     SaveToXML methods to read and write only the Genes and Population to XML. The format of the XML is defined in the GeneticAlgorithm.xsd schema file. The TRSCustomGeneticAlgorithm component uses the RSGeneticAlgorithmXML.pas unit and its IXMLGADomainType interface to the XML.

Use the overloaded     LoadFromXML and     SaveToXML methods to read and write the entire TRSCustomGeneticAlgorithm component in XML.
 

LoadFromXML(IXMLGeneticAlgorithm)

Overloaded.  Loads the entire genetic algorithm component from the IXMLGeneticAlgorithm interface, including the     Genes and the     Population. Use the     LoadFromXML and     SaveToXML methods to read and write the genetic algorithm component to XML. The format of the XML is defined in the GeneticAlgorithm.xsd schema file. The TRSCustomGeneticAlgorithm component uses the RSGeneticAlgorithmXML.pas unit and its IXMLGeneticAlgorithm interface to the XML.

Use the overloaded     LoadFromXML and     SaveToXML methods to only read and write the Genes and Population in XML (without the rest of the TRSCustomGeneticAlgorithm properties).
 

Mutate(TRSIndividual)

Mutates the DNA of the individual. Mutation for genetic algorithms means flipping the bits of the chromosome. For genetic programs, mutation means changing nodes of the program tree.

Note that mutation is not guaranteed to occur but is dependent on the     MutationProbability. The function calls the     OnMutation event and then DoMutate method.
 
The Mutate method is called by the     Reproduce method. The function returns true if mutation occurred.
 

PopulationNotify(TRSIndividual,TCollectionNotification)

Called when an individual is added or removed from the   Population (Overrides RSGeneticBase.TRSCustomGeneticComponent.PopulationNotify(TRSIndividual,TCollectionNotification).)

PopulationUpdate(TRSIndividual)

Called when an individual has changed (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

PrioritizePopulation

Prioritizes or sorts the population based on Fitness or WeightedFitness and the   FitnessMethod. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

Reproduce(TRSIndividual,TRSIndividual,TRSIndividual)

Overloaded.  The Reproduce method takes the two Parents and "mates" them to create the new Children. The Child parameters must exist but all of their information will be overwritten by the Parents. The New Child is copied from its first parent and then     Crossover,     Mutate, and     Invert are called according to the Operations property and the respective probability of the operation. Finally, an     OnReproduction event occurs.

The Evolve method calls the Reproduce methods.
 

Reproduce(TRSIndividual,TRSIndividual,TRSIndividual,TRSIndividual)

Overloaded.  The Reproduce method takes the two Parents and "mates" them to create the new Children. The Child parameters must exist but all of their information will be overwritten by the Parents. Child1 is copied from the first parent and Child2 is copied from the second parent, and then     Crossover,     Mutate, and     Invert are called according to the Operations property and the respective probability of the operation. Finally, an     OnReproduction event occurs.

The Evolve method calls the Reproduce methods.
 

SaveToFile(string)

Saves the entire genetic component to the XML file specified by the Filename parameter, including the Genes (genetic algorithms) or Instructions (genetic programming) and the Population. Use the LoadFromFile and SaveToFile methods to stream in and out the genetic component in XML format. The format of the XML is defined in the GeneticAlgorithm.xsd and GeneticProgramming.xsd schema files. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

SaveToStream(TStream)

Saves the entire genetic component to the XML stream specified by the stream parameter, including the Genes (genetic algorithms) or Instructions (genetic programming) and the Population. Use the LoadFromFile and SaveToFile methods to stream in and out the genetic component in XML format. The format of the XML is defined in the GeneticAlgorithm.xsd and GeneticProgramming.xsd schema files. (Overrides RSGeneticBase.TRSCustomGeneticComponent.SaveToStream(TStream).)

SaveToXML(IXMLGADomainType)

Overloaded.  Saves the Genes and the Population to the IXMLGADomainType interface. Use the     LoadFromXML and     SaveToXML methods to read and write only the Genes and Population to XML. The format of the XML is defined in the GeneticAlgorithm.xsd schema file. The TRSCustomGeneticAlgorithm component uses the RSGeneticAlgorithmXML.pas unit and its IXMLGADomainType interface to the XML.

Use the overloaded     LoadFromXML and     SaveToXML methods to read and write the entire TRSCustomGeneticAlgorithm component in XML.
 

SaveToXML(IXMLGeneticAlgorithm)

Overloaded.  Saves the entire genetic algorithm component to the IXMLGeneticAlgorithm interface, including the     Genes and the     Population. Use the     LoadFromXML and     SaveToXML methods to read and write the genetic algorithm component to XML. The format of the XML is defined in the GeneticAlgorithm.xsd schema file. The TRSCustomGeneticAlgorithm component uses the RSGeneticAlgorithmXML.pas unit and its IXMLGeneticAlgorithm interface to the XML.

Use the overloaded     LoadFromXML and     SaveToXML methods to only read and write the Genes and Population in XML (without the rest of the TRSCustomGeneticAlgorithm properties).
 

SaveToXML(IXMLGeneticDocumentType)

Overloaded. Saves the entire genetic component to the XML specified by the parameter, including the Genes (genetic algorithms) or Instructions (genetic programming) and the Population. Use the LoadFromFile and SaveToFile methods to stream in and out the genetic component in XML format. The format of the XML is defined in the GeneticAlgorithm.xsd and GeneticProgramming.xsd schema files. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

SelectElitist(TObject,TRSPopulation,TRSIndividual)

Selected a Parent individual from the Population using the Elitist method.

The top nth percentile parents are chosen (and re-chosen) using this method. Elitist is a heavy-weight selection algorithm (in our implementation at least) because we must figure out the top nth percentile population first
 

SelectParent(TRSPopulation)

Selects a parent for the new generation using the   SelectionMethod or the   OnSelection event. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

SelectRandom(TObject,TRSPopulation,TRSIndividual)

Selected a Parent individual from the Population at random.
 (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

SelectRoulette(TObject,TRSPopulation,TRSIndividual)

Selected a Parent individual from the Population using the Roulette Wheel (fitness proportional) method.

The better "fit" parents are more likely to be chosen (and re-chosen), e.g., the probability of selection is proportional to the fitness of the parent. Also known as fitness proportionate selection.
 

SelectStochasticTournament(TObject,TRSPopulation,TRSIndividual)

Selected a Parent individual from the Population using the Elitist method.

Select "best" (in this case using roulette wheel) parents from a tournament field (size of tournament field is determined by the     TournamentField property), e.g., select the best parent by selecting better fit individuals proportionally TournamentField times and then choosing the "winner" of the tournament. Note: for speed purposes, this selection method does not ensure that the same individual cannot be picked twice
 

SelectTournament(TObject,TRSPopulation,TRSIndividual)

Selected a Parent individual from the Population using the Tournament method.

Select "best" parents from a tournament field (size of tournament field is determined by the     TournamentField property), e.g., select the best parent from randomly selecting individuals TournamentField times and then choosing the "winner" of the tournament. Note: for speed purposes, this selection method does not ensure that the same individual cannot be picked twice
 

SwapGenerations

Swaps the Population and PreviousGeneration collections in preparation for evolving a new generation. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

ToString

Provides a strings description of the genetic programming component and its important properties. The function uses the  Describe method to build the string. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

UnfitFitness

Returns a value that represents extreme unfitness. Useful for breeding out an individual by settings its fitness to this value (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

OnCrossover

Occurs when two parents ( RSGeneticAlgorithm.TRSGAIndividual ) have reproduced to create a new child and some portion of the chromosomes are about to be combined from the parents. The DoMutation parameter controls whether the crossover will occur. It has already been set based on the CrossoverProbability (and so sometimes will be True and sometimes will be False). Set the DoMutation parameter either to force the crossover to occur or to prohibit it from occurring.

OnEvaluateFitness

Occurs when the     EvaluateFitness method is called. Use the OnEvaluateFitness event to define your fitness function for the genetic algorithm. Defining your fitness function is another highly important part of defining a genetic algorithm. The fitness function returns a floating point value that specifies the correctness of the individual solution. The fitness function needs to be able to allow the genetic component to decide which solution is better than another. The genetic component will seek to either maximize the solution (e.g., keep evolving for individuals whose fitness are greater than other individuals in the population) or to minimize the solution (e.g., find the individuals whose fitness are less than other individuals). Note you can specify which direction to evolve towards with the     FitnessMethod property.

Use the OnEvaluateFitness event to calculate each TRSIndividual's fitness level. Without an OnEvaluateFitness event handler all individuals in the population will have a default Fitness of 0. Every generation, when the Evolve method is called, the OnEvaluateFitness event will occur Population.Count number of times.
 

OnEvaluateWeightedFitness

Occurs when the genetic component needs to evaluate weighted fitness for an individual.

Weighted Fitness allows weighting the fitness for searching the solution space to guide the search. Fitness still evaluates if an individual solves the problem, but the weighted fitness can help constrain the search. For example, genetic programs can weight the fitness by reducing the fitness by the size of the program (limiting growth).

OnInitialization

Occurs when the   Initialize method is called. Use the OnInitialization event to react to the initialization of the genetic algorithm problem or to pre-seed the   Population with specific individuals. The OnInitialization event occurs after the Population is created but before their DNA are randomized and their fitness evaluated. Set the Initialized variable to True to prevent the Initialize method from randomizing the Population's DNA. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

OnInitializeChild

Occurs when the two Parent parameters are reproducing to create the new Child (Reproduce method). The OnInitializeChild event occurs after the Child has been created and been copied from the first Parent and before the genetic Operations are performed. Use the OnInitializeChild event to react to the creation of the new Child or to modify the Child. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

OnInversion

Occurs when two parents (TRSIndividual) have reproduced to create a new child and some portion of the child's DNA is about to be inverted. The DoMutation parameter controls whether the inversion will occur. It has already been set based on the   InversionProbability (and so sometimes will be True and sometimes will be False). Set the DoMutation parameter either to force the inversion to occur or to prohibit it from occurring. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

OnMutation

Occurs when two parents (TRSIndividual) have reproduced to create a new child and some portion of the child's DNA is about to be mutated. The DoMutation parameter controls whether the mutation will occur. It has already been set based on the   MutationProbability (and so sometimes will be True and sometimes will be False). Set the DoMutation parameter either to force the mutation to occur or to prohibit it from occurring. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

OnReproduction

Occurs when two parent individuals (TRSIndividual)   Reproduce to create a new child. The OnReproduction event occurs after the child has been created and then its DNA possibly combined, mutated, and inverted. Use the OnReproduction event to perform some action after reproduction has occurred. The OnReproduction event can also be useful for validation, to verify the various   Operations haven't produced an invalid child. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)

OnSelection

Occurs when the genetic component needs to select parents for Reproduction. The OnSelection event is only called if the   SelectionMethod is smCustom. Use the OnSelection event to write your own selection method. (Inherited from RSGeneticBase.TRSCustomGeneticComponent.)