Crate neat

Expand description

A simple crate that implements the Neuroevolution Augmenting Topologies algorithm using genetic-rs

You can get started by looking at genetic-rs docs and checking the examples for this crate.

Re-exports§

builtin
Built-in nextgen functions and traits to go with them.
prelude
Used to quickly import everything this crate has to offer. Simply add use genetic_rs::prelude::* to begin using this crate.
runnable
A module containing the main NeuralNetwork struct. This has state/cache and will run the predictions. Make sure to run NeuralNetwork::flush_state between uses of NeuralNetwork::predict.
topology
A module containing the NeuralNetworkTopology struct. This is what you want to use in the DNA of your agent, as it is the thing that goes through nextgens and suppors mutation.

DivisionReproduction
Used in dividually-reproducing next_gens
FitnessFn
Represents a fitness function. Inputs a reference to the genome and outputs an f32.
GenerateRandom
Helper trait used in the generation of random starting populations
GenerateRandomCollection
Blanket trait used on collections that contain objects implementing GenerateRandom
NextgenFn
Represents a nextgen function. Inputs genomes and rewards and produces the next generation
Prunable
Used in pruning next_gens
RandomlyMutable
Used in all of the builtin next_gens to randomly mutate genomes a given amount

division_pruning_nextgen
When making a new generation, it despawns half of the genomes and then spawns children from the remaining to reproduce. WIP: const generic for mutation rate, will allow for DivisionReproduction::divide to accept a custom mutation rate. Delayed due to current Rust limitations
scrambling_nextgen
When making a new generation, it mutates each genome a certain amount depending on their reward. This nextgen is very situational and should not be your first choice.