jcgp.backend.population

Class Output

java.lang.Object

jcgp.backend.population.Output

All Implemented Interfaces:

Mutable

public class Output
extends java.lang.Object
implements Mutable

This is a chromosome output. Outputs are a special type of mutable element with a single connection. It returns the value of its single connection, but it may not be connected to - it terminates a chromosome active connection path.

When mutating an output, it is easiest to use mutate(). Alternatively, you may also perform a specific mutation using setSource(...).

Author:

Eduardo Pedroni

Constructor Summary

Constructors

Constructor and Description
Output(Chromosome chromosome, int index) Makes a new instance of Output with the specified arguments.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	calculate()
boolean	copyOf(Mutable m) Asserts if the specified element is a copy of the elements this is called on. This method returns true if and only if: the elements being compared are not the same instance; the connections of the compared elements are not the same instance; the elements have the same function (in the case of Node); the grid position of the elements themselves are the same; the grid position of all equivalent connections are the same; The relationship computed by this method is: symmetric: a.copyOf(b) == b.copyOf(a); not reflexive: a.copyOf(a) returns false; not transitive: if a.copyOf(b) is true and b.copyOf(c) is true, a.copyOf(c) is not necessarily true since it is possible that a == c.
void	getActiveNodes(java.util.ArrayList<Node> activeNodes) Calls getActive(...) on this output's source.
int	getIndex()
Connection	getSource()
void	mutate() This method performs an arbitrary mutation on the Mutable.
void	setSource(Connection newConnection) This method sets the output source to the specified connection.
java.lang.String	toString()

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

Output

public Output(Chromosome chromosome,
              int index)

Makes a new instance of Output with the specified arguments.

Parameters:

chromosome - the chromosome this output belongs to.

index - the output index.

Method Detail

calculate

public java.lang.Object calculate()

Returns:

the value of the output's source.

getIndex

public int getIndex()

Returns:

this output's index.

setSource

public void setSource(Connection newConnection)

This method sets the output source to the specified connection.

Parameters:

newConnection - the Connection to connect to.

getSource

public Connection getSource()

Returns:

the source of this output's value.

getActiveNodes

public void getActiveNodes(java.util.ArrayList<Node> activeNodes)

Calls getActive(...) on this output's source. This kicks off a recursive process whereby all nodes connected to this output are added to the specified list of nodes. This is used to create a list of all active nodes.

Parameters:

activeNodes - the list to add all active nodes to.

copyOf

public boolean copyOf(Mutable m)

Description copied from interface: Mutable

Asserts if the specified element is a copy of the elements this is called on.
This method returns true if and only if:

• the elements being compared are not the same instance;
• the connections of the compared elements are not the same instance;
• the elements have the same function (in the case of Node);
• the grid position of the elements themselves are the same;
• the grid position of all equivalent connections are the same;

The relationship computed by this method is:

• symmetric: a.copyOf(b) == b.copyOf(a);
• not reflexive: a.copyOf(a) returns false;
• not transitive: if a.copyOf(b) is true and b.copyOf(c) is true, a.copyOf(c) is not necessarily true since it is possible that a == c.

Specified by:

copyOf in interface Mutable

Parameters:

m - the mutable element to compare to.

Returns:

true if element is a copy of this element.

mutate

public void mutate()

Description copied from interface: Mutable

This method performs an arbitrary mutation on the Mutable.

In the case of nodes, this chooses to mutate a function or connection fairly, and carries out the required mutation by using the node's own reference to chromosome.

In the case of outputs, this simply picks a random connection to serve as the source - any connection is allowed.

Specified by:

mutate in interface Mutable

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object