Documentation of terminat

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

Function Synopsis

[DoTerm, WhatTerm] = terminat(TERMMETHOD, TermOpt, ActGen, ActTime, GlobalOpt, BestObjV, ObjV, Chrom, VLUB);

Help text

 TERMINATion function

 This function is the high level termination function.
 Different methods for termination are supported. (See
 explanation of TERM_F input parameter below.)
 All termination methods can be combined. Then termination
 occurs, if any one of the termination methods is true 
 (the methods are OR combined).

 Syntax:  [DoTerm, WhatTerm] = terminat(TERM_F, TermOpt, ActGen, ActTime, ...
                               GlobalOpt, BestObjV, ObjV, Chrom, VLUB);

 Input parameters:
    TERMMETHOD- String/Scalar containing name of the termination
                function/termination method.
                   1: terminate, if maximal number of generations
                      TermOpt(1) is reached 
                   2: terminate, if maximal execution/computing
                      time TermOpt(2) is reached 
                   3: terminate, if global optimum with termination
                      precision TermOpt(3) is reached 
                   4: terminate, if difference between mean of best 
                      objective values of last xx generations and 
                      current best objective value is smaller than 
                      value in TermOpt(5)
                   5: terminate, if standard deviation of objective
                      values of current generation is smaller than
                      value in TermOpt(4)
                   6: terminate, if difference between the objective 
                      values of the current worst and best individual 
                      is smaller than value in TermOpt(6)
                   7: terminate, if the difference between 1 and the phi
                      value is smaller than value in TermOpt(7)
                   8: terminate, if the difference between 1 and the kappa
                      value is smaller than value in TermOpt(8)
                   9: terminate, if cluster analysis tells you
                      value is smaller than value in TermOpt(9)
                >=12: terminate for each of the single digit 
                       numbers
                 for example:
                  12: terminate for 1 or 2 
                  13: terminate for 1 or 3 
                  32: terminate for 3 or 2 
                 135: terminate for 1 or 3 or 5 
    TermOpt   - Vector/scalar containg parameters/values for ter-
                mination methods.
                TermOpt(1): maximal number of generations
                TermOpt(2): maximal execution/computing time
                TermOpt(3): difference to global optimum
                TermOpt(4): difference of best objective value and
                            running mean of last xx generation
                TermOpt(5): minimal standard deviation
                TermOpt(6): difference of best and worst objective
                            value in current generation
                TermOpt(7): difference between 1 and phi
                TermOpt(8): difference between 1 and kappa
                TermOpt(9): difference between 1 and cluster termination criteria
    ActGen    - (optional) Scalar containing actual number of generations.
    ActTime   - (optional) Scalar containing actual execution time in
                minutes.
    GlobalOpt - (optional) Scalar containg global optimum.
    BestObjV  - (optional) Vector/matrix containing best objective
                value(s) per generation for all previous generations.
    ObjV      - (optional) Vector/Matrix containing all objective 
                values of current generations.
    Chrom     - (optional) Matrix containing decoded variables of all 
                individuals in current generation
    VLUB      - (optional) Matrix containing boundaries of variables

 Output parameters:
    DoTerm    - Scalar indicating termination or not (termination
                criterion fullfilled or not)
                   0: do not terminate
                   1: do terminate
    WhatTerm  - Vector containing percent of termination criterion
                already reached, for instance: 10 from 100 
                generations would be result in WhatTerm(1) = 0.1,
                similar for other termination methods,
                if a criterion is not used, WhatTerm for this
                criterion will be NaN, max(WhatTerm) will give the
                current termination criterion

 See also: geamain

Cross-Reference Information