Module io.jenetics.base

Package io.jenetics

Class ShuffleMutator<G extends Gene<?,G>,C extends Comparable<? super C>>

java.lang.Object

io.jenetics.AbstractAlterer<G,C>

io.jenetics.Mutator<G,C>

io.jenetics.ShuffleMutator<G,C>

All Implemented Interfaces:

Alterer<G,C>

public class ShuffleMutator<G extends Gene<?,G>,C extends Comparable<? super C>>
extends Mutator<G,C>

The shuffle mutation, changes the order of the genes between two randomly chosen positions. The genes between the positions are shuffled. This mutation operator can also be used for combinatorial problems, where no duplicated genes within a chromosome are allowed, e.g., for the TSP.

Since:

8.0

Version:

8.0

See Also:

• Elements of evolutionary algorithms. Computational intelligence: A methodological introduction (pp. 255–285).
• Mutator

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	ShuffleMutator.Range	Represents the chromosome range which will be shuffled
static interface	ShuffleMutator.RangeRandom	Functional interface for creating random range objects for shuffling sequences of a given length.

Field Summary

Fields inherited from class io.jenetics.AbstractAlterer

_probability

Fields inherited from interface io.jenetics.Alterer

DEFAULT_ALTER_PROBABILITY

Constructor Summary

Constructors

Constructor	Description
ShuffleMutator()	Default constructor, with default mutation probability (Alterer.DEFAULT_ALTER_PROBABILITY).
ShuffleMutator(double probability)	Constructs an alterer with a given recombination probability.
ShuffleMutator(ShuffleMutator.RangeRandom random, double probability)	Constructs an alterer with a given recombination probability and random range generator.

Method Summary

Modifier and Type	Method	Description
protected MutatorResult<Chromosome<G>>	mutate(Chromosome<G> chromosome, double p, RandomGenerator random)	Changes the order of the genes between two points randomly.

Methods inherited from class io.jenetics.Mutator

alter, mutate, mutate, mutate, toString

Methods inherited from class io.jenetics.AbstractAlterer

probability

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface io.jenetics.Alterer

andThen, compose

Constructor Details

ShuffleMutator

public ShuffleMutator(ShuffleMutator.RangeRandom random,
 double probability)

Constructs an alterer with a given recombination probability and random range generator.

Parameters:

random - the random range generator used by the mutator

probability - the crossover probability.

Throws:

IllegalArgumentException - if the probability is not in the valid range of [0, 1].

ShuffleMutator

public ShuffleMutator(double probability)

Constructs an alterer with a given recombination probability.

Parameters:

probability - the crossover probability.

Throws:

IllegalArgumentException - if the probability is not in the valid range of [0, 1].

ShuffleMutator

public ShuffleMutator()

Default constructor, with default mutation probability (Alterer.DEFAULT_ALTER_PROBABILITY).

Method Details

mutate

protected MutatorResult<Chromosome<G>> mutate(Chromosome<G> chromosome,
 double p,
 RandomGenerator random)

Changes the order of the genes between two points randomly.

Overrides:

mutate in class Mutator<G extends Gene<?,G>,C extends Comparable<? super C>>

Parameters:

chromosome - the chromosome to mutate

p - the mutation probability for the underlying genetic objects

random - the random engine used for the genotype mutation

Returns:

the mutation result

See Also:

• Mutator.mutate(Gene, RandomGenerator)