org.jgap.impl

Class MutipleIntegerGene

java.lang.Object

org.jgap.BaseGene

org.jgap.impl.NumberGene

org.jgap.impl.MutipleIntegerGene

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable, Gene, IBusinessKey, IPersistentRepresentation, IUniqueKey

public class MutipleIntegerGene
extends NumberGene
implements IPersistentRepresentation

Extension of IntegerGene. The only difference is that this gene allele has to be a multiple of a specific significance, ie Gene gene = new MutipleIntegerGene(configuration, -100,100,3); The genes allele must be between -100 and 100 and be a multiple of 3.

Since:

3.5

See Also:

Serialized Form

Field Summary

Fields inherited from class org.jgap.BaseGene

DELTA, S_APPLICATION_DATA

Fields inherited from interface org.jgap.Gene

PERSISTENT_FIELD_DELIMITER

Constructor Summary

Constructors

Constructor and Description
MutipleIntegerGene()
MutipleIntegerGene(Configuration a_config) Constructs a new IntegerGene with default settings.
MutipleIntegerGene(Configuration a_config, int a_lowerBound, int a_upperBound, int a_significance) Constructs a new IntegerGene with the specified lower and upper bounds for values (alleles) of this Gene instance.

Method Summary

Modifier and Type	Method and Description
void	applyMutation(int a_index, double a_percentage) See interface Gene for description.
int	getLowerBounds()
java.lang.String	getPersistentRepresentation() Retrieves a string representation of this Gene that includes any information required to reconstruct it at a later time, such as its value and internal state.
int	getSignificance()
int	getUpperBounds()
int	hashCode() Modified hashCode() function to return different hashcodes for differently ordered genes in a chromosome.
void	setToRandomValue(RandomGenerator a_numberGenerator) Sets the value (allele) of this Gene to a random Integer value between the lower and upper bounds (if any) of this Gene.
void	setValueFromPersistentRepresentation(java.lang.String a_representation) Sets the value and internal state of this Gene from the string representation returned by a previous invocation of the getPersistentRepresentation() method.
java.lang.String	toString() Retrieves a string representation of this Gene's value that may be useful for display purposes.

Methods inherited from class org.jgap.impl.NumberGene

compareTo, setAllele

Methods inherited from class org.jgap.BaseGene

cleanup, equals, getAllele, getApplicationData, getBusinessKey, getConfiguration, getConstraintChecker, getEnergy, getUniqueID, getUniqueIDTemplate, isCompareApplicationData, newGene, setApplicationData, setCompareApplicationData, setConstraintChecker, setEnergy, setUniqueIDTemplate, size

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

MutipleIntegerGene

public MutipleIntegerGene()
                   throws InvalidConfigurationException

Throws:

InvalidConfigurationException

MutipleIntegerGene

public MutipleIntegerGene(Configuration a_config)
                   throws InvalidConfigurationException

Constructs a new IntegerGene with default settings. No bounds will be put into effect for values (alleles) of this Gene instance, other than the standard range of Integer values.

Parameters:

a_config - the configuration to use

Throws:

InvalidConfigurationException

Since:

3.5

MutipleIntegerGene

public MutipleIntegerGene(Configuration a_config,
                          int a_lowerBound,
                          int a_upperBound,
                          int a_significance)
                   throws InvalidConfigurationException

Constructs a new IntegerGene with the specified lower and upper bounds for values (alleles) of this Gene instance.

Parameters:

a_config - the configuration to use

a_lowerBound - the lowest value that this Gene may possess, inclusively

a_upperBound - the highest value that this Gene may possess, inclusively

Throws:

InvalidConfigurationException

Since:

3.5

Method Detail

getPersistentRepresentation

public java.lang.String getPersistentRepresentation()

Retrieves a string representation of this Gene that includes any information required to reconstruct it at a later time, such as its value and internal state. This string will be used to represent this Gene in XML persistence. This is an optional method but, if not implemented, XML persistence and possibly other features will not be available. An UnsupportedOperationException should be thrown if no implementation is provided.

Specified by:

getPersistentRepresentation in interface Gene

Specified by:

getPersistentRepresentation in interface IPersistentRepresentation

Returns:

string representation of this Gene's current state

Since:

3.5

setValueFromPersistentRepresentation

public void setValueFromPersistentRepresentation(java.lang.String a_representation)
                                          throws UnsupportedRepresentationException

Sets the value and internal state of this Gene from the string representation returned by a previous invocation of the getPersistentRepresentation() method. This is an optional method but, if not implemented, XML persistence and possibly other features will not be available. An UnsupportedOperationException should be thrown if no implementation is provided.

Specified by:

setValueFromPersistentRepresentation in interface Gene

Specified by:

setValueFromPersistentRepresentation in interface IPersistentRepresentation

Parameters:

a_representation - the string representation retrieved from a prior call to the getPersistentRepresentation() method

Throws:

java.lang.UnsupportedOperationException - to indicate that no implementation is provided for this method

UnsupportedRepresentationException - if this Gene implementation does not support the given string representation

Since:

3.5

setToRandomValue

public void setToRandomValue(RandomGenerator a_numberGenerator)

Sets the value (allele) of this Gene to a random Integer value between the lower and upper bounds (if any) of this Gene.

Specified by:

setToRandomValue in interface Gene

Parameters:

a_numberGenerator - the random number generator that should be used to create any random values. It's important to use this generator to maintain the user's flexibility to configure the genetic engine to use the random number generator of their choice

Since:

3.5

applyMutation

public void applyMutation(int a_index,
                          double a_percentage)

See interface Gene for description.

Specified by:

applyMutation in interface Gene

Parameters:

a_index - ignored (because there is only 1 atomic element)

a_percentage - percentage of mutation (greater than -1 and smaller than 1)

Since:

3.5

hashCode

public int hashCode()

Modified hashCode() function to return different hashcodes for differently ordered genes in a chromosome.

Overrides:

hashCode in class BaseGene

Returns:

-1 if no allele set, otherwise value return by BaseGene.hashCode()

Since:

3.5

toString

public java.lang.String toString()

Description copied from class: BaseGene

Retrieves a string representation of this Gene's value that may be useful for display purposes.

Specified by:

toString in interface Gene

Overrides:

toString in class BaseGene

Returns:

string representation of this Gene's value that may be useful for display purposes

Since:

3.5

getLowerBounds

public int getLowerBounds()

Returns:

the lower bounds of the integer gene

Since:

3.5

getUpperBounds

public int getUpperBounds()

Returns:

the upper bounds of the integer gene

Since:

3.5

getSignificance

public int getSignificance()

Returns:

the upper bounds of the integer gene

Since:

3.5