org.jenetics.engine

Class codecs

java.lang.Object

org.jenetics.engine.codecs

public final class codecs
extends Object

This class contains factory methods for creating common problem encodings.

Since:

3.2

Version:

3.4

Author:

Franz Wilhelmstötter

Method Summary

Modifier and Type	Method and Description
static Codec<int[],EnumGene<Integer>>	ofPermutation(int length) Create a permutation Codec of integer in the range [0, length).
static <T> Codec<T[],EnumGene<T>>	ofPermutation(T... alleles) Create a permutation Codec with the given alleles.
static Codec<Double,DoubleGene>	ofScalar(DoubleRange domain) Return a scalar Codec for the given range.
static Codec<Integer,IntegerGene>	ofScalar(IntRange domain) Return a scalar Codec for the given range.
static Codec<Long,LongGene>	ofScalar(LongRange domain) Return a scalar Codec for the given range.
static <A> Codec<A,AnyGene<A>>	ofScalar(Supplier<? extends A> supplier) Return a scala Codec with the given allele Supplier and allele validator.
static <A> Codec<A,AnyGene<A>>	ofScalar(Supplier<? extends A> supplier, Predicate<? super A> validator) Return a scala Codec with the given allele Supplier and allele validator.
static <T> Codec<ISeq<T>,BitGene>	ofSubSet(ISeq<? extends T> basicSet) The subset Codec can be used for problems where it is required to find the best variable-sized subset from given basic set.
static <T> Codec<ISeq<T>,EnumGene<T>>	ofSubSet(ISeq<? extends T> basicSet, int size) The subset Codec can be used for problems where it is required to find the best fixed-size subset from given basic set.
static Codec<double[],DoubleGene>	ofVector(DoubleRange... domains) Create a vector Codec for the given ranges.
static Codec<double[],DoubleGene>	ofVector(DoubleRange domain, int length) Return a vector Codec for the given range.
static Codec<int[],IntegerGene>	ofVector(IntRange... domains) Create a vector Codec for the given ranges.
static Codec<int[],IntegerGene>	ofVector(IntRange domain, int length) Return a vector Codec for the given range.
static Codec<long[],LongGene>	ofVector(LongRange... domains) Create a vector Codec for the given ranges.
static Codec<long[],LongGene>	ofVector(LongRange domain, int length) Return a vector Codec for the given range.
static <A> Codec<A[],AnyGene<A>>	ofVector(Supplier<? extends A> supplier, IntFunction<A[]> generator, int length) Return a scala Codec with the given allele Supplier and Chromosome length.
static <A> Codec<A[],AnyGene<A>>	ofVector(Supplier<? extends A> supplier, IntFunction<A[]> generator, Predicate<? super A> validator, int length) Return a scala Codec with the given allele Supplier, allele validator and Chromosome length.
static <A> Codec<A[],AnyGene<A>>	ofVector(Supplier<? extends A> supplier, IntFunction<A[]> generator, Predicate<? super A> alleleValidator, Predicate<? super ISeq<? super A>> alleleSeqValidator, int length) Return a scala Codec with the given allele Supplier, allele validator and Chromosome length.

Methods inherited from class java.lang.Object

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

Method Detail

ofScalar

public static Codec<Integer,IntegerGene> ofScalar(IntRange domain)

Return a scalar Codec for the given range.

Parameters:

domain - the domain of the returned Codec

Returns:

a new scalar Codec with the given domain.

Throws:

NullPointerException - if the given domain is null

ofScalar

public static Codec<Long,LongGene> ofScalar(LongRange domain)

Return a scalar Codec for the given range.

Parameters:

domain - the domain of the returned Codec

Returns:

a new scalar Codec with the given domain.

Throws:

NullPointerException - if the given domain is null

ofScalar

public static Codec<Double,DoubleGene> ofScalar(DoubleRange domain)

Return a scalar Codec for the given range.

Parameters:

domain - the domain of the returned Codec

Returns:

a new scalar Codec with the given domain.

Throws:

NullPointerException - if the given domain is null

ofScalar

public static <A> Codec<A,AnyGene<A>> ofScalar(Supplier<? extends A> supplier,
                                               Predicate<? super A> validator)

Return a scala Codec with the given allele Supplier and allele validator. The supplier is responsible for creating new random alleles, and the validator can verify it.

The following example shows a codec which creates and verifies BigInteger objects.

final Codec<BigInteger, AnyGene<BigInteger>> codec = codecs.of( // Create new random 'BigInteger' object. () -> { final byte[] data = new byte[100]; RandomRegistry.getRandom().nextBytes(data); return new BigInteger(data); }, // Verify that bit 7 is set. (For illustration purpose.) bi -> bi.testBit(7) );

Type Parameters:

A - the allele type

Parameters:

supplier - the allele-supplier which is used for creating new, random alleles

validator - the validator used for validating the created gene. This predicate is used in the AnyGene.isValid() method.

Returns:

a new Codec with the given parameters

Throws:

NullPointerException - if one of the parameters is null

See Also:

AnyGene.of(Supplier, Predicate), AnyChromosome.of(Supplier, Predicate)

ofScalar

public static <A> Codec<A,AnyGene<A>> ofScalar(Supplier<? extends A> supplier)

Return a scala Codec with the given allele Supplier and allele validator. The supplier is responsible for creating new random alleles.

Type Parameters:

A - the allele type

Parameters:

supplier - the allele-supplier which is used for creating new, random alleles

Returns:

a new Codec with the given parameters

Throws:

NullPointerException - if the parameter is null

See Also:

ofScalar(Supplier, Predicate), AnyGene.of(Supplier), AnyChromosome.of(Supplier)

ofVector

public static Codec<int[],IntegerGene> ofVector(IntRange domain,
                                                int length)

Return a vector Codec for the given range. All vector values are restricted by the same domain.

Parameters:

domain - the domain of the vector values

length - the vector length

Returns:

a new vector Codec

Throws:

NullPointerException - if the given domain is null

IllegalArgumentException - if the length is smaller than one.

ofVector

public static Codec<long[],LongGene> ofVector(LongRange domain,
                                              int length)

Return a vector Codec for the given range. All vector values are restricted by the same domain.

Parameters:

domain - the domain of the vector values

length - the vector length

Returns:

a new vector Codec

Throws:

NullPointerException - if the given domain is null

IllegalArgumentException - if the length is smaller than one.

ofVector

public static Codec<double[],DoubleGene> ofVector(DoubleRange domain,
                                                  int length)

Return a vector Codec for the given range. All vector values are restricted by the same domain.

Parameters:

domain - the domain of the vector values

length - the vector length

Returns:

a new vector Codec

Throws:

NullPointerException - if the given domain is null

IllegalArgumentException - if the length is smaller than one.

ofVector

public static Codec<int[],IntegerGene> ofVector(IntRange... domains)

Create a vector Codec for the given ranges. Each vector element might have a different domain. The vector length is equal to the number of domains.

Parameters:

domains - the domain ranges

Returns:

a new vector Codec

Throws:

NullPointerException - if one of the arguments is null

IllegalArgumentException - if the domains array is empty

ofVector

public static Codec<long[],LongGene> ofVector(LongRange... domains)

Create a vector Codec for the given ranges. Each vector element might have a different domain. The vector length is equal to the number of domains.

Parameters:

domains - the domain ranges

Returns:

a new vector Codec

Throws:

NullPointerException - if one of the arguments is null

IllegalArgumentException - if the domains array is empty

ofVector

public static Codec<double[],DoubleGene> ofVector(DoubleRange... domains)

Create a vector Codec for the given ranges. Each vector element might have a different domain. The vector length is equal to the number of domains.

Parameters:

domains - the domain ranges

Returns:

a new vector Codec

Throws:

NullPointerException - if one of the arguments is null

IllegalArgumentException - if the domains array is empty

ofVector

public static <A> Codec<A[],AnyGene<A>> ofVector(Supplier<? extends A> supplier,
                                                 IntFunction<A[]> generator,
                                                 Predicate<? super A> alleleValidator,
                                                 Predicate<? super ISeq<? super A>> alleleSeqValidator,
                                                 int length)

Return a scala Codec with the given allele Supplier, allele validator and Chromosome length. The supplier is responsible for creating new random alleles, and the validator can verify it.

The following example shows a codec which creates and verifies BigInteger object arrays.

final Codec<BigInteger[], AnyGene<BigInteger>> codec = codecs.of( // Create new random 'BigInteger' object. () -> { final byte[] data = new byte[100]; RandomRegistry.getRandom().nextBytes(data); return new BigInteger(data); }, // The array generator. BigInteger[]::new, // Verify that bit 7 is set. (For illustration purpose.) bi -> bi.testBit(7), // The 'Chromosome' length. 123 );

Type Parameters:

A - the allele type

Parameters:

supplier - the allele-supplier which is used for creating new, random alleles

generator - the array generator used for generating arrays of type A

alleleValidator - the validator used for validating the created gene. This predicate is used in the AnyGene.isValid() method.

alleleSeqValidator - the validator used for validating the created chromosome. This predicate is used in the AnyChromosome.isValid() method.

length - the vector length

Returns:

a new Codec with the given parameters

Throws:

NullPointerException - if one of the parameters is null

IllegalArgumentException - if the length of the vector is smaller than one.

See Also:

AnyChromosome.of(Supplier, Predicate, Predicate, int)

ofVector

public static <A> Codec<A[],AnyGene<A>> ofVector(Supplier<? extends A> supplier,
                                                 IntFunction<A[]> generator,
                                                 Predicate<? super A> validator,
                                                 int length)

Return a scala Codec with the given allele Supplier, allele validator and Chromosome length. The supplier is responsible for creating new random alleles, and the validator can verify it.

Type Parameters:

A - the allele type

Parameters:

supplier - the allele-supplier which is used for creating new, random alleles

generator - the array generator used for generating arrays of type A

validator - the validator used for validating the created gene. This predicate is used in the AnyGene.isValid() method.

length - the vector length

Returns:

a new Codec with the given parameters

Throws:

NullPointerException - if one of the parameters is null

IllegalArgumentException - if the length of the vector is smaller than one.

ofVector

public static <A> Codec<A[],AnyGene<A>> ofVector(Supplier<? extends A> supplier,
                                                 IntFunction<A[]> generator,
                                                 int length)

Return a scala Codec with the given allele Supplier and Chromosome length. The supplier is responsible for creating new random alleles.

Type Parameters:

A - the allele type

Parameters:

supplier - the allele-supplier which is used for creating new, random alleles

generator - the array generator used for generating arrays of type A

length - the vector length

Returns:

a new Codec with the given parameters

Throws:

NullPointerException - if one of the parameters is null

IllegalArgumentException - if the length of the vector is smaller than one.

ofPermutation

public static Codec<int[],EnumGene<Integer>> ofPermutation(int length)

Create a permutation Codec of integer in the range [0, length).

Parameters:

length - the number of permutation elements

Returns:

a permutation Codec of integers

Throws:

IllegalArgumentException - if the length is smaller than one.

ofPermutation

@SafeVarargs
public static <T> Codec<T[],EnumGene<T>> ofPermutation(T... alleles)

Create a permutation Codec with the given alleles.

Type Parameters:

T - the allele type

Parameters:

alleles - the alleles of the permutation

Returns:

a new permutation Codec

Throws:

IllegalArgumentException - if the given allele array is empty

NullPointerException - if one of the alleles is null

ofSubSet

public static <T> Codec<ISeq<T>,BitGene> ofSubSet(ISeq<? extends T> basicSet)

The subset Codec can be used for problems where it is required to find the best variable-sized subset from given basic set. A typical usage example of the returned Codec is the Knapsack problem.

The following code snippet shows a simplified variation of the Knapsack problem.

public final class Main { // The basic set from where to choose an 'optimal' subset. private final static ISeq<Integer> SET = ISeq.of(1, 2, 3, 4, 5, 6, 7, 8, 9, 10); // Fitness function directly takes an 'int' value. private static int fitness(final ISeq<Integer> subset) { assert(subset.size() <= SET.size()); final int size = subset.stream() .collect(Collectors.summingInt(Integer::intValue)); return size <= 20 ? size : 0; } public static void main(final String[] args) { final Engine<BitGene, Double> engine = Engine .builder(Main::fitness, codec.ofSubSet(SET)) .build(); ... } }

Type Parameters:

T - the element type of the basic set

Parameters:

basicSet - the basic set, from where to choose the optimal subset.

Returns:

a new codec which can be used for modelling subset problems.

Throws:

NullPointerException - if the given basicSet is null; null elements are allowed.

IllegalArgumentException - if the basicSet size is smaller than one.

ofSubSet

public static <T> Codec<ISeq<T>,EnumGene<T>> ofSubSet(ISeq<? extends T> basicSet,
                                                      int size)

The subset Codec can be used for problems where it is required to find the best fixed-size subset from given basic set.

Type Parameters:

T - the element type of the basic set

Parameters:

basicSet - the basic set, from where to choose the optimal subset.

size - the length of the desired subsets

Returns:

a new codec which can be used for modelling subset problems.

Throws:

NullPointerException - if the given basicSet is null; null elements are allowed.

IllegalArgumentException - if basicSet.size() < size, size <= 0 or basicSet.size()*size will cause an integer overflow.

Since:

3.4

See Also:

PermutationChromosome, PermutationChromosome.of(ISeq, int)