Chromosome (evosuite-client 1.0.5 API)

java.lang.Object
- org.evosuite.ga.Chromosome

All Implemented Interfaces:

Serializable, Cloneable, Comparable<Chromosome>, PublicCloneable<Chromosome>

Direct Known Subclasses:

AbstractTestSuiteChromosome, ExecutableChromosome
```
public abstract class Chromosome
extends Object
implements Comparable<Chromosome>, Serializable, PublicCloneable<Chromosome>
```
Abstract base class of chromosomes

Author:

Gordon Fraser, Jose Miguel Rojas

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`protected int`	`age` Generation in which this chromosome was created
`protected double`	`distance`
`protected int`	`rank`
`protected boolean`	`toBeUpdated`

Constructor Summary

Constructors
Modifier Constructor and Description

protected Chromosome()
only used for testing/debugging

Constructors
Modifier	Constructor and Description
`protected`	`Chromosome()` only used for testing/debugging

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addFitness(FitnessFunction<?> ff)` Adds a fitness function and sets fitness, coverage, and numCoveredGoal default.
`void`	`addFitness(FitnessFunction<?> ff, double fitnessValue)` Adds a fitness function with an associated fitness value
`void`	`addFitness(FitnessFunction<?> ff, double fitnessValue, double coverage)` Adds a fitness function with an associated fitness value and coverage value
`void`	`addFitness(FitnessFunction<?> ff, double fitnessValue, double coverage, int numCoveredGoals)` Adds a fitness function with an associated fitness value, coverage value, and number of covered goals.
`abstract Chromosome`	`clone()` clone
`abstract <T extends Chromosome> int`	`compareSecondaryObjective(T o)` Secondary Objectives are specific to chromosome types
`int`	`compareTo(Chromosome c)` Determine relative ordering of this chromosome to another chromosome.
`void`	`crossOver(Chromosome other, int position)` Fixed single point cross over
`abstract void`	`crossOver(Chromosome other, int position1, int position2)` Single point cross over
`abstract boolean`	`equals(Object obj)`
`int`	`getAge()`
`double`	`getCoverage()` Getter for the field `coverage`.
`double`	`getCoverage(FitnessFunction<?> ff)` Gets the coverage value for a given fitness function
`double`	`getCoverageInstanceOf(Class<?> clazz)`
`Map<FitnessFunction<?>,Double>`	`getCoverageValues()`
`double`	`getDistance()`
`double`	`getFitness()` Return current fitness value
`<T extends Chromosome> double`	`getFitness(FitnessFunction<T> ff)`
`double`	`getFitnessInstanceOf(Class<?> clazz)`
`Map<FitnessFunction<?>,Double>`	`getFitnessValues()`
`int`	`getNumOfCoveredGoals()`
`int`	`getNumOfCoveredGoals(FitnessFunction<?> ff)` Gets the number of covered goals for a given fitness function
`int`	`getNumOfNotCoveredGoals()`
`int`	`getNumOfNotCoveredGoals(FitnessFunction<?> ff)` Gets the number of not covered goals for a given fitness function
`LinkedHashMap<FitnessFunction<?>,Integer>`	`getNumsNotCoveredGoals()`
`Map<FitnessFunction<?>,Integer>`	`getNumsOfCoveredGoals()`
`Map<FitnessFunction<?>,Double>`	`getPreviousFitnessValues()`
`int`	`getRank()`
`boolean`	`hasExecutedFitness(FitnessFunction<?> ff)`
`boolean`	`hasFitnessChanged()`
`abstract int`	`hashCode()`
`boolean`	`hasLocalSearchBeenApplied()`
`boolean`	`isChanged()` Return whether the chromosome has changed since the fitness value was computed last
`boolean`	`isToBeUpdated()`
`void`	`isToBeUpdated(boolean toBeUpdated)`
`abstract boolean`	`localSearch(LocalSearchObjective<? extends Chromosome> objective)` Apply the local search
`abstract void`	`mutate()` Apply mutation
`void`	`setChanged(boolean changed)` Set changed status to @param changed
`void`	`setCoverage(FitnessFunction<?> ff, double coverage)` Sets the coverage value for a given fitness function
`void`	`setCoverageValues(Map<FitnessFunction<?>,Double> coverages)`
`void`	`setDistance(double d)`
`void`	`setFitness(FitnessFunction<?> ff, double value)` Set new fitness value
`void`	`setFitnessValues(Map<FitnessFunction<?>,Double> fits)`
`void`	`setLocalSearchApplied(boolean localSearchApplied)`
`void`	`setNumOfCoveredGoals(FitnessFunction<?> ff, int numCoveredGoals)` Sets the number of covered goals for a given fitness function
`void`	`setNumOfNotCoveredGoals(FitnessFunction<?> ff, int numCoveredGoals)`
`void`	`setNumsOfCoveredGoals(Map<FitnessFunction<?>,Integer> fits)`
`void`	`setNumsOfNotCoveredGoals(Map<FitnessFunction<?>,Integer> fits)`
`void`	`setPreviousFitnessValues(Map<FitnessFunction<?>,Double> lastFits)`
`void`	`setRank(int r)`
`abstract int`	`size()` Return length of individual
`void`	`updateAge(int generation)`

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - toBeUpdated
```
protected boolean toBeUpdated
```
  - age
```
protected int age
```
    Generation in which this chromosome was created
  - rank
```
protected int rank
```
  - distance
```
protected double distance
```
- Constructor Detail
  - Chromosome
```
protected Chromosome()
```
    only used for testing/debugging
- Method Detail
  - getFitness
```
public double getFitness()
```
    Return current fitness value
    
    Returns:
    
    a double.
  - getFitness
```
public <T extends Chromosome> double getFitness(FitnessFunction<T> ff)
```
  - getFitnessValues
```
public Map<FitnessFunction<?>,Double> getFitnessValues()
```
  - getPreviousFitnessValues
```
public Map<FitnessFunction<?>,Double> getPreviousFitnessValues()
```
  - hasExecutedFitness
```
public boolean hasExecutedFitness(FitnessFunction<?> ff)
```
  - setFitnessValues
```
public void setFitnessValues(Map<FitnessFunction<?>,Double> fits)
```
  - setPreviousFitnessValues
```
public void setPreviousFitnessValues(Map<FitnessFunction<?>,Double> lastFits)
```
  - isToBeUpdated
```
public boolean isToBeUpdated()
```
  - isToBeUpdated
```
public void isToBeUpdated(boolean toBeUpdated)
```
  - addFitness
```
public void addFitness(FitnessFunction<?> ff)
```
    Adds a fitness function and sets fitness, coverage, and numCoveredGoal default.
    
    Parameters:
    
    ff - a fitness function
  - addFitness
```
public void addFitness(FitnessFunction<?> ff,
                       double fitnessValue)
```
    Adds a fitness function with an associated fitness value
    
    Parameters:
    
    ff - a fitness function
    
    fitnessValue - the fitness value for ff
  - addFitness
```
public void addFitness(FitnessFunction<?> ff,
                       double fitnessValue,
                       double coverage)
```
    Adds a fitness function with an associated fitness value and coverage value
    
    Parameters:
    
    ff - a fitness function
    
    fitnessValue - the fitness value for ff
    
    coverage - the coverage value for ff
  - addFitness
```
public void addFitness(FitnessFunction<?> ff,
                       double fitnessValue,
                       double coverage,
                       int numCoveredGoals)
```
    Adds a fitness function with an associated fitness value, coverage value, and number of covered goals.
    
    Parameters:
    
    ff - a fitness function
    
    fitnessValue - the fitness value for ff
    
    coverage - the coverage value for ff
    
    numCoveredGoals - the number of covered goals for ff
  - setFitness
```
public void setFitness(FitnessFunction<?> ff,
                       double value)
                throws IllegalArgumentException
```
    Set new fitness value
    
    Parameters:
    
    value - a double.
    
    Throws:
    
    IllegalArgumentException
  - hasFitnessChanged
```
public boolean hasFitnessChanged()
```
  - clone
```
public abstract Chromosome clone()
```
    clone
    Create a deep copy of the chromosome
    
    Specified by:
    
    clone in interface PublicCloneable<Chromosome>
    
    Overrides:
    
    clone in class Object
    
    Returns:
    
    a T object.
  - equals
```
public abstract boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
  - hashCode
```
public abstract int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - compareTo
```
public int compareTo(Chromosome c)
```
    Determine relative ordering of this chromosome to another chromosome. If the fitness values are equal, go through all secondary objectives and try to find one where the two are not equal.
    
    Specified by:
    
    compareTo in interface Comparable<Chromosome>
  - compareSecondaryObjective
```
public abstract <T extends Chromosome> int compareSecondaryObjective(T o)
```
    Secondary Objectives are specific to chromosome types
    
    Parameters:
    
    o - a Chromosome object.
    
    Returns:
    
    a int.
  - mutate
```
public abstract void mutate()
```
    Apply mutation
  - crossOver
```
public void crossOver(Chromosome other,
                      int position)
               throws ConstructionFailedException
```
    Fixed single point cross over
    
    Parameters:
    
    other - a Chromosome object.
    
    position - a int.
    
    Throws:
    
    ConstructionFailedException - if any.
  - crossOver
```
public abstract void crossOver(Chromosome other,
                               int position1,
                               int position2)
                        throws ConstructionFailedException
```
    Single point cross over
    
    Parameters:
    
    other - a Chromosome object.
    
    position1 - a int.
    
    position2 - a int.
    
    Throws:
    
    ConstructionFailedException - if any.
  - localSearch
```
public abstract boolean localSearch(LocalSearchObjective<? extends Chromosome> objective)
```
    Apply the local search
    
    Parameters:
    
    objective - a LocalSearchObjective object.
  - size
```
public abstract int size()
```
    Return length of individual
    
    Returns:
    
    a int.
  - isChanged
```
public boolean isChanged()
```
    Return whether the chromosome has changed since the fitness value was computed last
    
    Returns:
    
    a boolean.
  - setChanged
```
public void setChanged(boolean changed)
```
    Set changed status to @param changed
    
    Parameters:
    
    changed - a boolean.
  - hasLocalSearchBeenApplied
```
public boolean hasLocalSearchBeenApplied()
```
  - setLocalSearchApplied
```
public void setLocalSearchApplied(boolean localSearchApplied)
```
  - getCoverage
```
public double getCoverage()
```
    Getter for the field coverage.
    Returns a single coverage value if Properties.COMPOSITIONAL_FITNESS is false. Otherwise ( Properties.COMPOSITIONAL_FITNESS==true), returns the average of coverage values for all fitness functions.
    
    Returns:
    
    a double.
  - getNumOfCoveredGoals
```
public int getNumOfCoveredGoals()
```
  - getNumOfNotCoveredGoals
```
public int getNumOfNotCoveredGoals()
```
  - setNumsOfCoveredGoals
```
public void setNumsOfCoveredGoals(Map<FitnessFunction<?>,Integer> fits)
```
  - setNumsOfNotCoveredGoals
```
public void setNumsOfNotCoveredGoals(Map<FitnessFunction<?>,Integer> fits)
```
  - setNumOfNotCoveredGoals
```
public void setNumOfNotCoveredGoals(FitnessFunction<?> ff,
                                    int numCoveredGoals)
```
  - getNumsOfCoveredGoals
```
public Map<FitnessFunction<?>,Integer> getNumsOfCoveredGoals()
```
  - getNumsNotCoveredGoals
```
public LinkedHashMap<FitnessFunction<?>,Integer> getNumsNotCoveredGoals()
```
  - getCoverageValues
```
public Map<FitnessFunction<?>,Double> getCoverageValues()
```
  - setCoverageValues
```
public void setCoverageValues(Map<FitnessFunction<?>,Double> coverages)
```
  - getCoverage
```
public double getCoverage(FitnessFunction<?> ff)
```
    Gets the coverage value for a given fitness function
    
    Parameters:
    
    ff - a fitness function
    
    Returns:
    
    the number of covered goals for ff
  - setCoverage
```
public void setCoverage(FitnessFunction<?> ff,
                        double coverage)
```
    Sets the coverage value for a given fitness function
    
    Parameters:
    
    ff - a fitness function
    
    coverage - the coverage value
  - getNumOfCoveredGoals
```
public int getNumOfCoveredGoals(FitnessFunction<?> ff)
```
    Gets the number of covered goals for a given fitness function
    
    Parameters:
    
    ff - a fitness function
    
    Returns:
    
    the number of covered goals for ff
  - getNumOfNotCoveredGoals
```
public int getNumOfNotCoveredGoals(FitnessFunction<?> ff)
```
    Gets the number of not covered goals for a given fitness function
    
    Parameters:
    
    ff - a fitness function
    
    Returns:
    
    the number of covered goals for ff
  - setNumOfCoveredGoals
```
public void setNumOfCoveredGoals(FitnessFunction<?> ff,
                                 int numCoveredGoals)
```
    Sets the number of covered goals for a given fitness function
    
    Parameters:
    
    ff - a fitness function
    
    numCoveredGoals - the number of covered goals
  - updateAge
```
public void updateAge(int generation)
```
  - getAge
```
public int getAge()
```
  - getRank
```
public int getRank()
```
  - setRank
```
public void setRank(int r)
```
  - getDistance
```
public double getDistance()
```
  - setDistance
```
public void setDistance(double d)
```
  - getFitnessInstanceOf
```
public double getFitnessInstanceOf(Class<?> clazz)
```
  - getCoverageInstanceOf
```
public double getCoverageInstanceOf(Class<?> clazz)
```

Class Chromosome

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

toBeUpdated

age

rank

distance

Constructor Detail

Chromosome

Method Detail

getFitness

getFitness

getFitnessValues

getPreviousFitnessValues

hasExecutedFitness

setFitnessValues

setPreviousFitnessValues

isToBeUpdated

isToBeUpdated

addFitness

addFitness

addFitness

addFitness

setFitness

hasFitnessChanged

clone

equals

hashCode

compareTo

compareSecondaryObjective

mutate

crossOver

crossOver

localSearch

size

isChanged

setChanged

hasLocalSearchBeenApplied

setLocalSearchApplied

getCoverage

getNumOfCoveredGoals

getNumOfNotCoveredGoals

setNumsOfCoveredGoals

setNumsOfNotCoveredGoals

setNumOfNotCoveredGoals

getNumsOfCoveredGoals

getNumsNotCoveredGoals

getCoverageValues

setCoverageValues

getCoverage

setCoverage

getNumOfCoveredGoals

getNumOfNotCoveredGoals

setNumOfCoveredGoals

updateAge

getAge

getRank

setRank

getDistance

setDistance

getFitnessInstanceOf

getCoverageInstanceOf