keel.Algorithms.Genetic_Rule_Learning.PSO_ACO

Class Particula

java.lang.Object

keel.Algorithms.Genetic_Rule_Learning.PSO_ACO.Particula

public class Particula
extends java.lang.Object

Title: Particula (Particle)

Description: Particle class: Implements the particles needed on the Particle Swarm Optimization algorithm (PSO). This class stores the position and velocity of a standard particle of this algorithm, also manage those variables by progressing through time, but also stores and manages information used by the ACO algorithm like the pheromone matrix. This allows to hybridize these tow algorithms.

Version:

1.0

Author:

Vicente Rubén del Pino Ruiz

Constructor Summary

Constructors

Constructor and Description
Particula() Default constructor.
Particula(int numCondiciones) Paramater Constructor.

Method Summary

Modifier and Type	Method and Description
void	actualizaFeromona(java.util.Vector particulas, int indice, int tamEntorno, java.util.Vector listaCondiciones) Updates the pheromone values following the environment of particles.
void	asignarCalidadMPosicion(float calidad) Assigns the given quality to the best position of the particle.
void	asignarCalidadPosActual(float calidad) Assigns the given quality to the actual position of the particle.
void	asignarClasePosicionActual(Atributo clase) Assigns the class for the actual position of the particle.
void	asignarClasePosicionMejor(Atributo clase) Assigns the class to the best position of the particle.
void	asignarCondicionContinuaPosicionActual(Condicion condicion) Assigns the given continuous condition to the actual position of the particle.
void	asignarCondicionContinuaPosicionMejor(Condicion condicion) Assigns the given continuous condition to the best position of the particle.
void	asignarCondicionNominalPosicionActual(Condicion condicion) Assigns the given nominal condition to the actual position of the particle.
void	asignarCondicionNominalPosicionMejor(Condicion condicion) Assigns the given nominal condition to the best position of the particle.
void	asignarMuestrasCubiertasActual(int numero) Assigns the number of examples covered by the actual position of the particle.
void	asignarMuestrasCubiertasPasado(int numero) Assigns the number of examples covered by the best position of the particle.
void	calculaVelocidad(int numCondiciones, java.util.Vector particulas, int entorno, int indice, float[][] intervalos, float x, float c1, float c2, Randomize generadorA) Computes the velocity of the particle.
void	copiaPosicionMejorPosicion() Copies the actual position as best position of the particle.
void	generaPosicion(java.util.Vector listaCondiciones, java.util.Vector listaCondicionesVacias, int minimoCasosRegla, ConjuntoDatos cTrain, Randomize generadorA, float[][] heuristica) Generates the particle position using the given posible conditions, its heuristic values and the data to be covered.
ComparadorParticulas	getComparadorParticulas() Returns the Particles comparative method.
Regla	getMejorPosicion() Returns the best position of the particle.
Regla	getPosActual() Returns the actual position of the particle.
void	imprimePosicion(int numCondiciones) Prints on the standard output the actual position.
void	inicializaFeromona(java.util.Vector listaCondiciones) Initializes the particle pheromone values for the given list of conditions.
void	inicializaMejorPosicionContinua(java.util.Vector pos) Initializes the best continuous particle position with the given conditions vector
void	inicializaMejorPosicionNominal(java.util.Vector pos) Initializes the best nominal particle position with the given conditions vector
void	inicializaPosicionActualContinua(java.util.Vector pos) Initializes the actual continuous particle position with the given conditions vector
void	inicializaPosicionActualNominal(java.util.Vector pos) Initializes the actual nominal particle position with the given conditions vector
void	inicializaVelocidad(float[][] intervalos, int numCondicionesContinuas, Randomize generadorA) Initializes the particle velocity using the given conditions intervals.
void	inicializaVelocidad(int numCondiciones, float valorInicial) Initializes the particle velocity with the given value for all the conditions considered.
void	limpiaCNominales() Removes all nominal conditions from the particle.
void	moverParticula(int numCondiciones, float[][] intervalos) Moves the particle to the next position, with the actual position and its velocity.
float	obtenerCalidadMejorPosicion() Returns the quality of the best position.
float	obtenerCalidadPosicionActual() Returns the quality of the actual position.
java.util.Vector	obtenerVecinos(int indice, int tamEntorno, java.util.Vector particulas) Returns a vector with the neighbours of the particle.
void	reservaVelocidad(int numCondiciones) Reserves memory enough to manage the particle velocity.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Particula

public Particula()

Default constructor. An empty particle is built.

Particula

public Particula(int numCondiciones)

Paramater Constructor. Creates an particle with the number of taken condictions given.

Parameters:

numCondiciones - number of continuous conditions given.

Method Detail

reservaVelocidad

public void reservaVelocidad(int numCondiciones)

Reserves memory enough to manage the particle velocity. The velocity vector will be as bigger as the number of conditions taken by the rule.

Parameters:

numCondiciones - number of conditions taken by the rule.

getComparadorParticulas

public ComparadorParticulas getComparadorParticulas()

Returns the Particles comparative method.

Returns:

the Particles comparative method.

inicializaPosicionActualContinua

public void inicializaPosicionActualContinua(java.util.Vector pos)

Initializes the actual continuous particle position with the given conditions vector

Parameters:

pos - given conditions vector.

inicializaPosicionActualNominal

public void inicializaPosicionActualNominal(java.util.Vector pos)

Initializes the actual nominal particle position with the given conditions vector

Parameters:

pos - given conditions vector.

inicializaMejorPosicionContinua

public void inicializaMejorPosicionContinua(java.util.Vector pos)

Initializes the best continuous particle position with the given conditions vector

Parameters:

pos - given conditions vector.

inicializaMejorPosicionNominal

public void inicializaMejorPosicionNominal(java.util.Vector pos)

Initializes the best nominal particle position with the given conditions vector

Parameters:

pos - given conditions vector.

inicializaVelocidad

public void inicializaVelocidad(int numCondiciones,
                                float valorInicial)

Initializes the particle velocity with the given value for all the conditions considered.

Parameters:

numCondiciones - number of continuous conditions considered.

valorInicial - initial velocity value.

inicializaFeromona

public void inicializaFeromona(java.util.Vector listaCondiciones)

Initializes the particle pheromone values for the given list of conditions.

Parameters:

listaCondiciones - conditions to computes their pheromone values.

asignarClasePosicionActual

public void asignarClasePosicionActual(Atributo clase)

Assigns the class for the actual position of the particle.

Parameters:

clase - class to be assgined.

asignarClasePosicionMejor

public void asignarClasePosicionMejor(Atributo clase)

Assigns the class to the best position of the particle.

Parameters:

clase - class to be assigned.

asignarCondicionNominalPosicionMejor

public void asignarCondicionNominalPosicionMejor(Condicion condicion)

Assigns the given nominal condition to the best position of the particle.

Parameters:

condicion - given condition to be assigned.

asignarCondicionContinuaPosicionMejor

public void asignarCondicionContinuaPosicionMejor(Condicion condicion)

Assigns the given continuous condition to the best position of the particle.

Parameters:

condicion - given condition to be assigned.

asignarCondicionNominalPosicionActual

public void asignarCondicionNominalPosicionActual(Condicion condicion)

Assigns the given nominal condition to the actual position of the particle.

Parameters:

condicion - given condition to be assigned.

asignarCondicionContinuaPosicionActual

public void asignarCondicionContinuaPosicionActual(Condicion condicion)

Assigns the given continuous condition to the actual position of the particle.

Parameters:

condicion - given condition to be assigned.

getPosActual

public Regla getPosActual()

Returns the actual position of the particle.

Returns:

the actual position of the particle.

getMejorPosicion

public Regla getMejorPosicion()

Returns the best position of the particle.

Returns:

the best position of the particle.

asignarCalidadPosActual

public void asignarCalidadPosActual(float calidad)

Assigns the given quality to the actual position of the particle.

Parameters:

calidad - given quality to be assigned.

asignarCalidadMPosicion

public void asignarCalidadMPosicion(float calidad)

Assigns the given quality to the best position of the particle.

Parameters:

calidad - given quality to be assigned.

actualizaFeromona

public void actualizaFeromona(java.util.Vector particulas,
                              int indice,
                              int tamEntorno,
                              java.util.Vector listaCondiciones)

Updates the pheromone values following the environment of particles.

Parameters:

particulas - All the particles in the environment.

indice - Position of particle to update its pheromone.

tamEntorno - Environment size.

listaCondiciones - Conditions list.

generaPosicion

public void generaPosicion(java.util.Vector listaCondiciones,
                           java.util.Vector listaCondicionesVacias,
                           int minimoCasosRegla,
                           ConjuntoDatos cTrain,
                           Randomize generadorA,
                           float[][] heuristica)

Generates the particle position using the given posible conditions, its heuristic values and the data to be covered.

Parameters:

listaCondiciones - all posible conditions to be used to generate the position (rule).

listaCondicionesVacias - empty/null conditions list.

minimoCasosRegla - minimum number of cases that have to be covered to consider the rule as valid.

cTrain - the data to be covered.

generadorA - Random numbers generator.

heuristica - Heuristic values for the different conditions.

obtenerCalidadPosicionActual

public float obtenerCalidadPosicionActual()

Returns the quality of the actual position.

Returns:

the quality of the actual position.

obtenerCalidadMejorPosicion

public float obtenerCalidadMejorPosicion()

Returns the quality of the best position.

Returns:

the quality of the best position.

copiaPosicionMejorPosicion

public void copiaPosicionMejorPosicion()

Copies the actual position as best position of the particle.

inicializaVelocidad

public void inicializaVelocidad(float[][] intervalos,
                                int numCondicionesContinuas,
                                Randomize generadorA)

Initializes the particle velocity using the given conditions intervals.

Parameters:

intervalos - continuous conditions intervals.

numCondicionesContinuas - number of continuous conditions considered.

generadorA - Random numbers generator.

obtenerVecinos

public java.util.Vector obtenerVecinos(int indice,
                                       int tamEntorno,
                                       java.util.Vector particulas)

Returns a vector with the neighbours of the particle.

Parameters:

indice - position of the particle in the environment.

tamEntorno - size of the environment.

particulas - vector of considered particles, environment.

Returns:

a vector with the neighbours of the particle.

calculaVelocidad

public void calculaVelocidad(int numCondiciones,
                             java.util.Vector particulas,
                             int entorno,
                             int indice,
                             float[][] intervalos,
                             float x,
                             float c1,
                             float c2,
                             Randomize generadorA)

Computes the velocity of the particle.

Parameters:

numCondiciones - number of conditions considered.

particulas - vector of considered particles, environment.

entorno - size of the environment.

indice - particle position in the environment.

intervalos - continuous conditions intervals.

x - Factor X

c1 - Factor c1

c2 - Factor c2

generadorA - Random numbers generator.

moverParticula

public void moverParticula(int numCondiciones,
                           float[][] intervalos)

Moves the particle to the next position, with the actual position and its velocity.

Parameters:

numCondiciones - number of conditions considered.

intervalos - continuous conditions intervals.

imprimePosicion

public void imprimePosicion(int numCondiciones)

Prints on the standard output the actual position.

Parameters:

numCondiciones - number of conditions considered.

limpiaCNominales

public void limpiaCNominales()

Removes all nominal conditions from the particle.

asignarMuestrasCubiertasActual

public void asignarMuestrasCubiertasActual(int numero)

Assigns the number of examples covered by the actual position of the particle.

Parameters:

numero - number of examples covered.

asignarMuestrasCubiertasPasado

public void asignarMuestrasCubiertasPasado(int numero)

Assigns the number of examples covered by the best position of the particle.

Parameters:

numero - number of examples covered.