goevo

type Activation int

type Agent[T any] struct {
	Genotype T
	Fitness  float64
}

type Buildable interface {
	// Build converts this genotype into a [Forwarder].
	// This may be an expensive operation, so it should be called sparingly.
	Build() Forwarder
}

type Cloneable interface {
	Clone() any
}

type Counter struct {
	// contains filtered or unexported fields
}

type CrossoverMutateReproduction[T any] struct {
	Crossover CrossoverStrategy[T]
	Mutate    MutationStrategy[T]
}

type CrossoverStrategy[T any] interface {
	// Crossover performs a crossover with this strategy on the given genotypes.
	// It can combine any number of genotypes (for example 1 for asexual, 2 for sexual, n for averaging of multiple?)
	Crossover([]T) T
	// NumParents returns the number of parents required for this crossover strategy
	NumParents() int
}

type Forwarder interface {
	// Forward takes a set of inputs and returns a set of outputs.
	Forward([]float64) []float64
}

type GeneticDistance[T any] interface {
	// DistanceBetween calculates the genetic distance between two genotypes.
	DistanceBetween(a, b T) float64
}

type MutationStrategy[T any] interface {
	// Mutate performs a mutation in-place with this strategy on the given genotype
	Mutate(T)
}

type Population[T any] interface {
	// NextGeneration returns the population resulting from agents selected using this population's selection strategy
	// reproducing using this population's reproduction strategy.
	NextGeneration() Population[T]

	// All returns every [Agent] in the population.
	// This may have no particular order.
	All() []*Agent[T]
}

type ReproductionStrategy[T any] interface {
	// Reproduce takes a set of parent genotypes and returns a child genotype.
	Reproduce([]T) T
	// NumParents returns the number of parents required for this reproduction strategy
	NumParents() int
}

type SelectionStrategy[T any] interface {
	// SetAgents caches the [Agent]s which this selection will use until it is called again.
	// This is called once per generation. You may wish to perform slow operations here such as sorting by fitness.
	SetAgents(agents []*Agent[T])
	// Select returns an [Agent] selected from the cached pool set by [SelectionStrategy.SetAgents].
	Select() *Agent[T]
}