mutation_helpers (macula_tweann v0.18.1)

Helper functions for genome mutation operations.

This module provides utility functions used by mutation operators for linking network elements and weight management.

Summary

Functions

create_random_weight()

Create a random weight tuple.

find_splittable_link(AgentId)

Find a link that can be split to insert a neuron.

get_layer_coord(_)

Get layer coordinate from element ID.

get_link_weight(FromId, ToId)

Get weight of a link between two elements.

link_neuron_to_actuator(NeuronId, ActuatorId, Actuator)

Link a neuron to an actuator.

link_neuron_to_target(NeuronId, Neuron, TargetId)

Link a neuron to a target (neuron or actuator).

link_sensor_to_neuron(SensorId, Sensor, NeuronId)

Link a sensor to a neuron.

link_source_to_neuron(SourceId, NeuronId, Neuron)

Link a source (sensor or neuron) to a neuron.

perturb_ltc_weight_list(Weights, PerturbRange)

Perturb a list of LTC weights.

select_ltc_neuron(AgentId)

Select a random LTC or CfC neuron from the agent's network.

select_random_neuron(AgentId)

Select a random neuron from the agent's network.

update_source_output(FromId, OldToId, NewToId)

Update source element to output to new target.

update_target_input(ToId, OldFromId, NewFromId, Weight)

Update target element to receive from new source.

Functions

create_random_weight()

-spec create_random_weight() -> {float(), float(), float(), []}.

Create a random weight tuple.

find_splittable_link(AgentId)

-spec find_splittable_link(term()) ->
                              {term(), term(), {float(), float(), float(), list()}} | {error, no_links}.

Find a link that can be split to insert a neuron.

get_layer_coord(_)

-spec get_layer_coord(term()) -> float().

Get layer coordinate from element ID.

get_link_weight(FromId, ToId)

-spec get_link_weight(term(), term()) -> {float(), float(), float(), list()}.

Get weight of a link between two elements.

link_neuron_to_actuator(NeuronId, ActuatorId, Actuator)

-spec link_neuron_to_actuator(term(),
                              term(),
                              #actuator{id :: term(),
                                        name :: term(),
                                        type :: term(),
                                        cx_id :: term(),
                                        scape :: term(),
                                        vl :: term(),
                                        fanin_ids :: term(),
                                        generation :: term(),
                                        format :: term(),
                                        parameters :: term(),
                                        gt_parameters :: term(),
                                        phys_rep :: term(),
                                        vis_rep :: term(),
                                        pre_f :: term(),
                                        post_f :: term(),
                                        innovation :: term()}) ->
                                 ok.

Link a neuron to an actuator.

link_neuron_to_target(NeuronId, Neuron, TargetId)

-spec link_neuron_to_target(term(),
                            #neuron{id :: term(),
                                    generation :: term(),
                                    cx_id :: term(),
                                    pre_processor :: term(),
                                    signal_integrator :: term(),
                                    af :: term(),
                                    post_processor :: term(),
                                    pf :: term(),
                                    aggr_f :: term(),
                                    input_idps :: term(),
                                    input_idps_modulation :: term(),
                                    output_ids :: term(),
                                    ro_ids :: term(),
                                    neuron_type :: term(),
                                    time_constant :: term(),
                                    state_bound :: term(),
                                    ltc_backbone_weights :: term(),
                                    ltc_head_weights :: term(),
                                    internal_state :: term(),
                                    innovation :: term()},
                            term()) ->
                               ok.

Link a neuron to a target (neuron or actuator).

link_sensor_to_neuron(SensorId, Sensor, NeuronId)

-spec link_sensor_to_neuron(term(),
                            #sensor{id :: term(),
                                    name :: term(),
                                    type :: term(),
                                    cx_id :: term(),
                                    scape :: term(),
                                    vl :: term(),
                                    fanout_ids :: term(),
                                    generation :: term(),
                                    format :: term(),
                                    parameters :: term(),
                                    gt_parameters :: term(),
                                    phys_rep :: term(),
                                    vis_rep :: term(),
                                    pre_f :: term(),
                                    post_f :: term(),
                                    innovation :: term()},
                            term()) ->
                               ok.

Link a sensor to a neuron.

link_source_to_neuron(SourceId, NeuronId, Neuron)

-spec link_source_to_neuron(term(),
                            term(),
                            #neuron{id :: term(),
                                    generation :: term(),
                                    cx_id :: term(),
                                    pre_processor :: term(),
                                    signal_integrator :: term(),
                                    af :: term(),
                                    post_processor :: term(),
                                    pf :: term(),
                                    aggr_f :: term(),
                                    input_idps :: term(),
                                    input_idps_modulation :: term(),
                                    output_ids :: term(),
                                    ro_ids :: term(),
                                    neuron_type :: term(),
                                    time_constant :: term(),
                                    state_bound :: term(),
                                    ltc_backbone_weights :: term(),
                                    ltc_head_weights :: term(),
                                    internal_state :: term(),
                                    innovation :: term()}) ->
                               ok.

Link a source (sensor or neuron) to a neuron.

perturb_ltc_weight_list(Weights, PerturbRange)

-spec perturb_ltc_weight_list([float()], float()) -> [float()].

Perturb a list of LTC weights.

select_ltc_neuron(AgentId)

-spec select_ltc_neuron(term()) -> term() | {error, no_ltc_neurons | no_neurons}.

Select a random LTC or CfC neuron from the agent's network.

select_random_neuron(AgentId)

-spec select_random_neuron(term()) -> term() | {error, no_neurons}.

Select a random neuron from the agent's network.

update_source_output(FromId, OldToId, NewToId)

-spec update_source_output(term(), term(), term()) -> ok.

Update source element to output to new target.

update_target_input(ToId, OldFromId, NewFromId, Weight)

-spec update_target_input(term(), term(), term(), {float(), float(), float(), list()}) -> ok.

Update target element to receive from new source.