Documentation of reins
Global Index (all files) (short | long)
| Local contents
| Local Index (files in subdir) (short | long)
Function Synopsis
[Chrom, ObjVCh] = reins(Chrom, SelCh, SUBPOPCh, SUBPOPSel, InsOpt, ObjVCh, ObjVSel, RankCh, RankSel, SelIx, SelFun);
Help text
high-level RE-INSertion function
This function performs insertion of offspring into the current
population, replacing parents with offspring and returning the
resulting population.
The offspring are contained in the matrix SelCh and the parents
in the matrix Chrom. Each row in Chrom and Selch corresponds
to one individual.
If the objective values of the population (ObjVCh) and the
offspring (ObjVSel) are input parameter and ObjVCh is output
parameter the objective values are copied, according to the
insertion of offspring, saving the recomputation of the objective
values for the whole population. The function can handle multiple
objective values per individual.
For fitness-based reinsertion the fitness values/ranking of the
population (RankCh) are needed. If omitted or empty single objective
scaling using the first column of ObjVCh is assumed.
If the number of offspring is greater than the number of offspring
to reinsert the fitness values/ranking of the offspring (RankSel)
is needed. If omitted or empty single objective scaling using the
first column of ObjVSel is assumed.
Different size of every subpopulation is supported.
For the actual reinsertion low-level functions corresponding the
used population model (regional or local model) are called.
Syntax: [Chrom, ObjVCh] = reins(Chrom, SelCh, SUBPOPCh, SUBPOPSel, InsOpt, ObjVCh, ObjVSel, RankCh, RankSel, SelIx, SelFun)
Input parameters:
Chrom - Matrix containing the individuals (parents) of the current
population. Each row corresponds to one individual.
SelCh - Matrix containing the offspring of the current
population. Each row corresponds to one individual.
SUBPOPCh - (optional) Vector/scalar containing number of individuals
per subpopulation/number of subpopulations of Chrom (parents)
if omitted or NaN, 1 subpopulation is assumed
SUBPOPSel - (optional) Vector/scalar containing number of individuals
per subpopulation/number of subpopulations of SelCh (offspring)
if omitted or NaN, the same as SUBPOPCh is initially assumed
InsOpt - (optional) Vector containing the insertion method parameters
InsOpt(1): Select - number indicating reinsertion method
kind of selection of parents to replace
for description see respective functions
reinsreg and reinsloc
InsOpt(2): INSR - Rate of offspring to be inserted per
subpopulation (% of subpopulation)
InsOpt(3): not used
InsOpt(4): not used
InsOpt(5): local dimension (see comploc)
InsOpt(6): local structure (see comploc)
InsOpt(7): local distance (see comploc)
ObjVCh - (optional) Column vector containing the objective values
of the individuals (parents - Chrom) in the current population,
needed for fitness-based insertion
saves recalculation of objective values for population
ObjVSel - (optional) Column vector containing the objective values
of the offspring (SelCh) in the current population, needed for
partial insertion of offspring,
saves recalculation of objective values for population
RankCh - (optional) Column vector containing the fitness values (obtained
by ranking) of the individuals (parents - Chrom) in the current
population, best individual has highest value,
if omitted or empty, single objective scaling using ObjVCh is assumed
RankSel - (optional) Column vector containing the fitness values (obtained
by ranking) of the offspring (SelCh) in the current
population, best offspring has highest value
if omitted or empty, single objective scaling using ObjVSel is assumed
SelIx - Matrix containing indices of selected parents in Chrom, output parameter
of selection/sellocal
SelFun - Vector containing numbers indicating used selection algorithm
Output parameters:
Chrom - Matrix containing the individuals of the current
population after reinsertion.
ObjVCh - if ObjVCh and ObjVSel are input parameter, than column vector containing
the objective values of the individuals of the current
generation after reinsertion.
See also: reinsreg, reinsloc, sellocal, ranking
Cross-Reference Information
This function calls |
This function is called by |
|
|
This document is part of
version 3.8 of the
GEATbx: Genetic and Evolutionary Algorithm Toolbox for use with Matlab -
www.geatbx.com.
The Genetic and Evolutionary Algorithm Toolbox is
not public domain.
© 1994-2006 Hartmut Pohlheim, All Rights Reserved,
(support@geatbx.com).