org.jenetics

Class CharacterChromosome

java.lang.Object

org.jenetics.AbstractChromosome<CharacterGene>

org.jenetics.CharacterChromosome

All Implemented Interfaces:

Serializable, CharSequence, Iterable<CharacterGene>, RandomAccess, Chromosome<CharacterGene>, Factory<Chromosome<CharacterGene>>, Verifiable

public class CharacterChromosome
extends AbstractChromosome<CharacterGene>
implements CharSequence, Serializable

CharacterChromosome which represents character sequences.

Since:

1.0

Version:

3.0

Author:

Franz Wilhelmstötter

See Also:

Serialized Form

Field Summary

Fields inherited from class org.jenetics.AbstractChromosome

_genes, _valid

Constructor Summary

Constructors

Modifier	Constructor and Description
	CharacterChromosome(CharSeq validCharacters, int length) Create a new chromosome with the validCharacters char set as valid characters.
protected	CharacterChromosome(ISeq<CharacterGene> genes) Create a new chromosome from the given genes array.

Method Summary

Modifier and Type	Method and Description
char	charAt(int index)
boolean	equals(Object obj)
int	hashCode()
CharacterChromosome	newInstance() Create a new, random chromosome.
CharacterChromosome	newInstance(ISeq<CharacterGene> genes) A factory method which creates a new Chromosome of specific type and the given genes.
static CharacterChromosome	of(int length) Create a new chromosome with the CharacterGene.DEFAULT_CHARACTERS char set as valid characters.
static CharacterChromosome	of(String alleles) Create a new chromosome from the given genes (given as string).
static CharacterChromosome	of(String alleles, CharSeq validChars) Create a new chromosome from the given genes (given as string).
CharacterChromosome	subSequence(int start, int end)
char[]	toArray() Returns an char array containing all of the elements in this chromosome in proper sequence.
char[]	toArray(char[] array) Returns an char array containing all of the elements in this chromosome in proper sequence.
String	toString()

Methods inherited from class org.jenetics.AbstractChromosome

getGene, isValid, iterator, length, toSeq

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.CharSequence

chars, codePoints, length

Methods inherited from interface org.jenetics.Chromosome

as, getGene, stream

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface org.jenetics.util.Factory

instances

Constructor Detail

CharacterChromosome

protected CharacterChromosome(ISeq<CharacterGene> genes)

Create a new chromosome from the given genes array. The genes array is copied, so changes to the given genes array doesn't effect the genes of this chromosome.

Parameters:

genes - the genes that form the chromosome.

Throws:

NullPointerException - if the given gene array is null.

IllegalArgumentException - if the length of the gene array is smaller than one.

CharacterChromosome

public CharacterChromosome(CharSeq validCharacters,
                           int length)

Create a new chromosome with the validCharacters char set as valid characters.

Parameters:

validCharacters - the valid characters for this chromosome.

length - the length of the new chromosome.

Throws:

NullPointerException - if the validCharacters is null.

IllegalArgumentException - if the length is smaller than one.

Method Detail

charAt

public char charAt(int index)

Specified by:

charAt in interface CharSequence

subSequence

public CharacterChromosome subSequence(int start,
                                       int end)

Specified by:

subSequence in interface CharSequence

newInstance

public CharacterChromosome newInstance(ISeq<CharacterGene> genes)

Description copied from interface: Chromosome

A factory method which creates a new Chromosome of specific type and the given genes.

Specified by:

newInstance in interface Chromosome<CharacterGene>

Parameters:

genes - the genes of the new chromosome. The given genes array is not copied.

Returns:

A new Chromosome of the same type with the given genes.

Throws:

NullPointerException - if the given gene array is null.

newInstance

public CharacterChromosome newInstance()

Create a new, random chromosome.

Specified by:

newInstance in interface Factory<Chromosome<CharacterGene>>

Returns:

a new instance of type T

hashCode

public int hashCode()

Overrides:

hashCode in class AbstractChromosome<CharacterGene>

equals

public boolean equals(Object obj)

Overrides:

equals in class AbstractChromosome<CharacterGene>

toString

public String toString()

Specified by:

toString in interface CharSequence

Overrides:

toString in class AbstractChromosome<CharacterGene>

toArray

public char[] toArray(char[] array)

Returns an char array containing all of the elements in this chromosome in proper sequence. If the chromosome fits in the specified array, it is returned therein. Otherwise, a new array is allocated with the length of this chromosome.

Parameters:

array - the array into which the elements of this chromosomes are to be stored, if it is big enough; otherwise, a new array is allocated for this purpose.

Returns:

an array containing the elements of this chromosome

Throws:

NullPointerException - if the given array is null

Since:

3.0

toArray

public char[] toArray()

Returns an char array containing all of the elements in this chromosome in proper sequence.

Returns:

an array containing the elements of this chromosome

Since:

3.0

of

public static CharacterChromosome of(int length)

Create a new chromosome with the CharacterGene.DEFAULT_CHARACTERS char set as valid characters.

Parameters:

length - the length of the new chromosome.

Returns:

a new CharacterChromosome with the given parameter

Throws:

IllegalArgumentException - if the length is smaller than one.

of

public static CharacterChromosome of(String alleles,
                                     CharSeq validChars)

Create a new chromosome from the given genes (given as string).

Parameters:

alleles - the character genes.

validChars - the valid characters.

Returns:

a new CharacterChromosome with the given parameter

Throws:

IllegalArgumentException - if the genes string is empty.

of

public static CharacterChromosome of(String alleles)

Create a new chromosome from the given genes (given as string).

Parameters:

alleles - the character genes.

Returns:

a new CharacterChromosome with the given parameter

Throws:

IllegalArgumentException - if the genes string is empty.