metaheuristic_designer.initializers.direct_initializer module#

Initializer that uses a set of predefined solutions as the first generation.

class DirectInitializer(default_init, solutions, encoding=None, rng=None)[source]#

Bases: Initializer

Initializer that seeds the population with a given set of solutions.

If the number of individuals requested exceeds the size of the stored set, individuals are cycled through. Random individuals from a fallback initializer are used when generate_random() is called directly.

Parameters:
default_initInitializer

Fallback initializer for generate_random().

solutionsPopulation, list or ndarray

The set of solutions to draw from.

encodingEncoding, optional

Encoding attached to the population (used when solutions is a Population).

rngRNGLike, optional

Random number generator.

Parameters:

Methods

generate_individual()

Return a chosen individual from the stored solution set in cyclic order.

generate_population([n_individuals])

Create a population by drawing from the stored solutions.

generate_random()

Return a completely random individual generated from a fallback initializer strategy

get_state()

Return a minimal dictionary identifying this initializer.

generate_random()[source]#

Return a completely random individual generated from a fallback initializer strategy

Return type:

ndarray[tuple[int], floating] | ndarray[tuple[int], integer] | ndarray[tuple[int], uint8 | bool]

Returns:
VectorLike

A 1-D array sampled from a fallback distribution.

generate_individual()[source]#

Return a chosen individual from the stored solution set in cyclic order.

Return type:

ndarray[tuple[int], floating] | ndarray[tuple[int], integer] | ndarray[tuple[int], uint8 | bool]

Returns:
VectorLike

A 1-D array taken from the predefined solutions.

generate_population(n_individuals=None)[source]#

Create a population by drawing from the stored solutions.

Return type:

Population

Parameters:
objfuncObjectiveFunc

The objective function.

n_individualsint, optional

Number of individuals to generate. Defaults to population_size.

Returns:
Population

A population built from the predefined solutions.

Parameters:

n_individuals (int | None)