Documentation of reinsreg

Global Index (all files) (short | long) | Local contents | Local Index (files in subdir) (short | long)

Function Synopsis

[Chrom, ObjVCh] = reinsreg(Chrom, SelCh, SUBPOPCh, SUBPOPSel, InsOpt, ObjVCh, ObjVSel, RankCh, RankSel, Dummy);

Help text

 REINSertion of offspring in REGional population model replacing parents

 This function performs insertion of offspring into the current 
 population, replacing parents with offspring and returning the
 resulting population. The population can be divided in different
 subpopulation (regional model).
 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)
 are needed. If omitted or empty single objective scaling using the
 first column of ObjVSel is assumed.
 Different size of every subpopulation is supported.

 Syntax:  [Chrom, ObjVCh] = reinsreg(Chrom, SelCh, SUBPOPCh, SUBPOPSel, InsOpt, ObjVCh, ObjVSel, RankCh, RankSel)

 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 kind of insertion
                             0 - uniform insertion
                           >=2 - fitness-based insertion
                           if omitted or NaN, 0 is assumed
                InsOpt(2): INSR - Rate of offspring to be inserted per
                           subpopulation (% of subpopulation)
                           if omitted or NaN, 1.0 (100%) is assumed
    ObjVCh    - (optional) Column vector or matrix 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 or matrix 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

 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: reins, reinsloc, sellocal, ranking, geamain

Cross-Reference Information