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