01 /*
02 * Java Genetic Algorithm Library (jenetics-6.1.0).
03 * Copyright (c) 2007-2020 Franz Wilhelmstötter
04 *
05 * Licensed under the Apache License, Version 2.0 (the "License");
06 * you may not use this file except in compliance with the License.
07 * You may obtain a copy of the License at
08 *
09 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 *
17 * Author:
18 * Franz Wilhelmstötter (franz.wilhelmstoetter@gmail.com)
19 */
20 package io.jenetics.ext;
21
22 import io.jenetics.Gene;
23 import io.jenetics.engine.Engine.Builder;
24 import io.jenetics.engine.Engine.Setup;
25 import io.jenetics.internal.util.Requires;
26
27 /**
28 * Configures the evolution engine to execute the
29 * <a href="https://en.wikipedia.org/wiki/Weasel_program">Weasel program</a>
30 * algorithm.
31 *
32 * <pre>{@code
33 * final Engine<CharacterGene, Integer> engine = Engine.builder(problem)
34 * .setup(new WeaselProgram<>())
35 * .build();
36 * }</pre>
37 *
38 * @see WeaselSelector
39 * @see WeaselMutator
40 *
41 * @param <G> the gene type
42 * @param <C> the fitness result type
43 *
44 * @author <a href="mailto:franz.wilhelmstoetter@gmail.com">Franz Wilhelmstötter</a>
45 * @version 6.0
46 * @since 6.0
47 */
48 public final class WeaselProgram<
49 G extends Gene<?, G>,
50 C extends Comparable<? super C>
51 >
52 implements Setup<G, C>
53 {
54
55 private final double _mutationProbability;
56
57 /**
58 * Create a new weasel program setup with the give mutation probability.
59 *
60 * @param mutationProbability the mutation probability
61 * @throws IllegalArgumentException if the {@code mutationProbability} is
62 * not in the valid range of {@code [0, 1]}.
63 */
64 public WeaselProgram(final double mutationProbability) {
65 _mutationProbability = Requires.probability(mutationProbability);
66 }
67
68 /**
69 * Create a new weasel program setup with the <em>default</em> mutation
70 * probability of {@code 0.05}.
71 */
72 public WeaselProgram() {
73 this(0.05);
74 }
75
76 @Override
77 public void apply(final Builder<G, C> builder) {
78 builder
79 .selector(new WeaselSelector<>())
80 .offspringFraction(1)
81 .alterers(new WeaselMutator<>(_mutationProbability));
82 }
83
84 }
|