File: genetic_operators.rst

package info (click to toggle)
pagmo 2.19.1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 85,228 kB
  • sloc: cpp: 1,753,592; makefile: 223; sh: 121; python: 46
file content (66 lines) | stat: -rw-r--r-- 3,153 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
Genetic Operators
======================================================

Some utilities to perform common genetic operations

*#include <pagmo/utils/genetic_operators.hpp>*

.. cpp:namespace-push:: pagmo

.. versionadded:: 2.16

.. cpp:function:: std::pair<vector_double, vector_double> sbx_crossover(const vector_double &parent1, const vector_double &parent2, const std::pair<vector_double, vector_double> &bounds, vector_double::size_type nix, const double p_cr, const double eta_c, detail::random_engine_type &random_engine)

   :param parent1: first parent.
   :param parent2: second parent.
   :param bounds: problem bounds.
   :param nix: integer dimension of the problem.
   :param p_cr: crossover probability.
   :param eta_c: crossover distribution index.
   :param random_engine: the pagmo random engine

   :exception std\:\:invalid_argument: if the *bounds* size is zero.
   :exception std\:\:invalid_argument: if *parent1*, *parent2* and *bounds* have unequal length.
   :exception std\:\:invalid_argument: if *bounds* contain any nan or infs.
   :exception std\:\:invalid_argument: if any lower bound is greater than the corresponding upper bound.
   :exception std\:\:invalid_argument: if *nix* is larger than bounds size.
   :exception std\:\:invalid_argument: if any of the integer bounds are not integers.
   :exception std\:\:invalid_argument: if *p_cr* or *eta_c* are not finite numbers.


   This function perform a simulated binary crossover (SBX) among two parents.
   The SBX genetic operator was designed to preserve average property and the
   spread factor property of one-point crossover in binary encoded chromosomes.
   This version of the SBX will act as a simple two-points crossover over the
   integer part of the chromosome / decision vector.
  
   See: https://www.slideshare.net/paskorn/simulated-binary-crossover-presentation

.. versionadded:: 2.16

.. cpp:function:: void polynomial_mutation(vector_double &dv, const std::pair<vector_double, vector_double> &bounds, vector_double::size_type nix, const double p_m, const double eta_m, detail::random_engine_type &random_engine)

   :param dv: decision vector to be mutated in place.
   :param bounds: problem bounds.
   :param nix: integer dimension of the problem.
   :param m_cr: mutation probability.
   :param m_c: mutation distribution index.
   :param random_engine: the pagmo random engine

   :exception std\:\:invalid_argument: if the *bounds* size is zero.
   :exception std\:\:invalid_argument: if *dv*, and *bounds* have unequal length.
   :exception std\:\:invalid_argument: if *bounds* contain any nan or infs.
   :exception std\:\:invalid_argument: if any lower bound is greater than the corresponding upper bound.
   :exception std\:\:invalid_argument: if *nix* is larger than bounds size.
   :exception std\:\:invalid_argument: if any of the integer bounds are not integers.
   :exception std\:\:invalid_argument: if *m_cr* or *m_c* are not finite numbers.


   This function performs the polynomial mutation proposed by Agrawal and Deb over some chromosome / decision vector.
  
   See: https://www.egr.msu.edu/~kdeb/papers/k2012016.pdf