org.aksw.limes.core.ml.algorithm.eagle.genes

Class StringPreprocessMeasure

java.lang.Object

org.jgap.gp.CommandGene

org.aksw.limes.core.ml.algorithm.eagle.genes.StringPreprocessMeasure

All Implemented Interfaces:

Serializable, Cloneable, Comparable, org.jgap.gp.IMutateable, org.jgap.util.ICloneable

public class StringPreprocessMeasure
extends org.jgap.gp.CommandGene
implements org.jgap.gp.IMutateable, org.jgap.util.ICloneable

Wraps around LIMES string similarity commands for the JGAP library, e.g. trigram or levensthein. They all build a expression like similarityMeasure(resource1, resource2)|threshold. Whereas the threshold is ignored if the expression is atomic, i.e. the similarity measure isn't part (argument) of another metric, such as AND). We now expect at least two parameters: 2 Terminals. Whereas the first is of sub return type ResourceTerminalType.SOURCE, the second of ResourceTerminalType.TARGET. This allows us to differentiate the different resources of the two endpoints and avoid silly measures comparing the same resources of the same endpoint. If mutation is turned on, the similarity command might be changed during the evolution process to one of the allowed measures.

Version:

Jul 21, 2016

Author:

Klaus Lyko, Mohamed Sherif (sherif@informatik.uni-leipzig.de)

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.jgap.gp.CommandGene

org.jgap.gp.CommandGene.COMMAND_TYPE

Field Summary

Fields inherited from class org.jgap.gp.CommandGene

BooleanClass, CharacterClass, DELTA, DoubleClass, FloatClass, IntegerClass, LongClass, nodeIndex, VoidClass

Fields inherited from interface org.jgap.gp.IMutateable

CVS_REVISION

Fields inherited from interface org.jgap.util.ICloneable

CVS_REVISION

Constructor Summary

Constructors

Constructor and Description
StringPreprocessMeasure(String opName, org.jgap.gp.impl.GPConfiguration a_conf, Class<?> a_returnType, boolean a_mutateable) Constructor for atomic similarity measures.

Method Summary

Modifier and Type	Method and Description
org.jgap.gp.CommandGene	applyMutation() Mutates this CommandGene.
org.jgap.gp.CommandGene	applyMutation(int a_index, double a_percentage)
Object	clone() Clones the object.
Object	execute_object(org.jgap.gp.impl.ProgramChromosome a_chrom, int a_n, Object[] args) Executes this CommandGene as object.
void	execute_void(org.jgap.gp.impl.ProgramChromosome a_chrom, int a_n, Object[] args)
Class<?>	getChildType(org.jgap.gp.IGPProgram a_ind, int a_chromNum) We expect the first 2 parameters to be resource identifier, the third to be an (optional) double value as the threshold for this Similarity command.
String	getName()
String	getOperationName()
boolean	isValid(org.jgap.gp.impl.ProgramChromosome a_program)
boolean	isValid(org.jgap.gp.impl.ProgramChromosome a_program, int a_index)
String	toString()

Methods inherited from class org.jgap.gp.CommandGene

check, check, cleanup, compareTo, dynamizeArity, ensureUniqueness, ensureUniqueness, ensureUniqueness2, equals, execute_boolean, execute_double, execute_float, execute_int, execute_long, execute, getAllele, getApplicationData, getArity, getArityMax, getArityMin, getCommandType, getEnergy, getGPConfiguration, getInternalValue, getPersistentRepresentation, getPersistentRepresentationExt, getReturnType, getSubChildType, getSubChildTypes, getSubReturnType, hashCode, init, isAffectGlobalState, isCompareApplicationData, isFloatType, isIntegerType, setAllele, setApplicationData, setArity, setArityMax, setArityMin, setCompareApplicationData, setEnergy, setNoValidation, setReturnType, setToRandomValue, setValueFromPersistentRepresentation, setValueFromString, size

Methods inherited from class java.lang.Object

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

Constructor Detail

StringPreprocessMeasure

public StringPreprocessMeasure(String opName,
                               org.jgap.gp.impl.GPConfiguration a_conf,
                               Class<?> a_returnType,
                               boolean a_mutateable)
                        throws org.jgap.InvalidConfigurationException

Constructor for atomic similarity measures. @FIXME antiquated and not actually used.

Parameters:

opName - Name of the LIMES similarity measure operation (e.g. "trigram").

a_conf - JGAP GPConfiguration.

a_returnType - The return type of this command.

a_mutateable - true: this Commandgene is mutateable, viz. the LIMES similarity measure might be changed to another one out of the allowed operations.

Throws:

org.jgap.InvalidConfigurationException - when an invalid value has been passed to a Configuration object

Method Detail

toString

public String toString()

Specified by:

toString in class org.jgap.gp.CommandGene

getChildType

public Class<?> getChildType(org.jgap.gp.IGPProgram a_ind,
                             int a_chromNum)

We expect the first 2 parameters to be resource identifier, the third to be an (optional) double value as the threshold for this Similarity command.

Overrides:

getChildType in class org.jgap.gp.CommandGene

Parameters:

a_ind - A GPProgram

a_chromNum - The number of the chromosome.

Returns:

type of the child.

getName

public String getName()

Overrides:

getName in class org.jgap.gp.CommandGene

getOperationName

public String getOperationName()

execute_object

public Object execute_object(org.jgap.gp.impl.ProgramChromosome a_chrom,
                             int a_n,
                             Object[] args)

Executes this CommandGene as object. Is called if the return type is set to String.class. Thereby returning the atomic LIMES expression "sim(a.resource, b.resource)|threshold".

Overrides:

execute_object in class org.jgap.gp.CommandGene

execute_void

public void execute_void(org.jgap.gp.impl.ProgramChromosome a_chrom,
                         int a_n,
                         Object[] args)

Overrides:

execute_void in class org.jgap.gp.CommandGene

applyMutation

public org.jgap.gp.CommandGene applyMutation(int a_index,
                                             double a_percentage)
                                      throws org.jgap.InvalidConfigurationException

Specified by:

applyMutation in interface org.jgap.gp.IMutateable

Throws:

org.jgap.InvalidConfigurationException

applyMutation

public org.jgap.gp.CommandGene applyMutation()
                                      throws org.jgap.InvalidConfigurationException

Mutates this CommandGene. A random command out of the set of allowed similarity measures is picked.

Returns:

A random command out of the set of allowed similarity measures

Throws:

org.jgap.InvalidConfigurationException - when an invalid value has been passed to a Configuration object

clone

public Object clone()

Clones the object.

Specified by:

clone in interface org.jgap.util.ICloneable

Overrides:

clone in class Object

Returns:

cloned instance of this object

isValid

public boolean isValid(org.jgap.gp.impl.ProgramChromosome a_program,
                       int a_index)

Overrides:

isValid in class org.jgap.gp.CommandGene

isValid

public boolean isValid(org.jgap.gp.impl.ProgramChromosome a_program)

Overrides:

isValid in class org.jgap.gp.CommandGene