edu.pm

Class Population<I extends Individual>

java.lang.Object

edu.pm.Population<I>

All Implemented Interfaces:

java.io.Serializable

public class Population<I extends Individual>
extends java.lang.Object
implements java.io.Serializable

Популяция.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Population(Community community, java.lang.String name) Создать популяцию.

Method Summary

Methods

Modifier and Type	Method and Description
void	addWeight(java.lang.String weightName, Weight<I> weight) Добавить весовую функцию.
boolean	delete(I individual) Удалить индивидуума из популяции.
I	drawRandomIndividual() Получить случайного индивидуума, распределённого равномерно, и удалить его из популяции (выборка без возвращения).
I	drawRandomIndividual(int weightId) Получить случайного индивидуума, распределённого пропорционально данному весу, и удалить его из популяции (выборка без возвращения).
int	getActiveSize()
int	getSize()
double	getTotalWeight(int k) Получить суммарный вес для данного номера весов.
java.lang.String	name()
I	peekRandomIndividual() Получить случайного индивидуума, распределённого равномерно, но не удалять его из популяции (выборка с возвращением).
I	peekRandomIndividual(int weightId) Получить случайного индивидуума, распределённого пропорционально данному весу, но не удалять его из популяции (выборка с возвращением).
void	putIndividual(I individual) Добавить индивидуума в популяцию.
protected I	removeFromActive(int id) Удалить индивидуума с данным номером из популяции.

Methods inherited from class java.lang.Object

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

Constructor Detail

Population

public Population(Community community,
          java.lang.String name)
           throws PmException

Создать популяцию. Созданная популяция добавляет себя в данное сообщество и регистрирует переменные:

• [имя популяции].size — количество индивидуумов в популяции, в начале текущего шага моделирования (getSize());
• [имя популяции].activeSize — количество индивидуумов в популяции, еще не принимавших участия во взаимодействиях и событиях, происходящих на текущем шаге моделирования (getActiveSize()).

Parameters:

community - сообщество, к которому добавляется эта популяция (не null}.

name - имя популяции (не null}.

Throws:

java.lang.NullPointerException - если один из аргументов равен null.

PmException - если в сообщество уже добавлена популяция с данным именем.

Method Detail

addWeight

public void addWeight(java.lang.String weightName,
             Weight<I> weight)
               throws PmException

Добавить весовую функцию.

Parameters:

weightName - название веса (не null).

weight - весовая функция (не null).

Throws:

PmException - если в сообществе уже зарегистрирована переменная с именем [имя популяции].[имя веса].

name

public java.lang.String name()

Returns:

имя популяции.

getSize

public int getSize()

Returns:

количество индивидуумов в популяции, в начале текущего шага моделирования.

getActiveSize

public int getActiveSize()

Returns:

количество индивидуумов в популяции, еще не принимавших участия во взаимодействиях и событиях, происходящих на текущем шаге моделирования.

putIndividual

public void putIndividual(I individual)

Добавить индивидуума в популяцию.

Parameters:

individual - индивидуум.

peekRandomIndividual

public I peekRandomIndividual()

Получить случайного индивидуума, распределённого равномерно, но не удалять его из популяции (выборка с возвращением).

Returns:

случайный индивидуум, распределённый равномерно; null, если активных индивидуумов нет.

drawRandomIndividual

public I drawRandomIndividual()
                                          throws PmException

Получить случайного индивидуума, распределённого равномерно, и удалить его из популяции (выборка без возвращения).

Returns:

случайный индивидуум, распределённый равномерно; null, если активных индивидуумов нет.

Throws:

PmException - если нарушены ограничения модели.

removeFromActive

protected I removeFromActive(int id)
                                         throws PmException

Удалить индивидуума с данным номером из популяции.

Parameters:

id - номер индивидуума.

Returns:

удалённый индивидуум.

Throws:

PmException - если нарушены ограничения модели.

delete

public boolean delete(I individual)
               throws PmException

Удалить индивидуума из популяции.

Parameters:

individual - индивидуум.

Returns:

true, если индивидуум был удалён.

Throws:

PmException - если индекс индивидуума оказался не корректным.

peekRandomIndividual

public I peekRandomIndividual(int weightId)

Получить случайного индивидуума, распределённого пропорционально данному весу, но не удалять его из популяции (выборка с возвращением).

Parameters:

weightId - идентификатор веса в массиве весов.

Returns:

случайный индивидуум, распределённый равномерно; null, если активных индивидуумов нет.

drawRandomIndividual

public I drawRandomIndividual(int weightId)
                                          throws PmException

Получить случайного индивидуума, распределённого пропорционально данному весу, и удалить его из популяции (выборка без возвращения).

Parameters:

weightId - идентификатор веса в массиве весов.

Returns:

случайный индивидуум, распределённый равномерно; null, если активных индивидуумов нет.

Throws:

PmException - если нарушены ограничения модели.

getTotalWeight

public double getTotalWeight(int k)

Получить суммарный вес для данного номера весов.

Parameters:

k - номер веса.

Returns:

суммарный вес для данного номера весов.