Advanced Search Procedures in Herb.jl

A more verbose getting started with Herb.jl described the concept of a program space and showed how to search it with Herb.jl, using a simple breadth-first-search (BFS) iterator for the search. This tutorial takes a closer look at advanced search procedures that can be employed to define the iterator.

More specifically, you will learn about

  • Parameters that can be specified and their effect on the search procedure.

  • Deterministic search methods BFS and DFS.

  • Stochastic search methods, which introduce randomness to search the program space. We will look at Metropolis-Hastings, Very Large Scale Neighbourhood Search, Simulated Annealing, and Genetic Search.

Let's import all the Herb modules that we will use throughout the tutorial.

begin
    import Pkg
    Pkg.activate(Base.current_project())
    Pkg.instantiate()
end
using Herb

We start with a simple grammar:.

g_1 = @csgrammar begin
    Number = |(1:2)
    Number = x
    Number = Number + Number
    Number = Number * Number
end
1: Number = 1
2: Number = 2
3: Number = x
4: Number = Number + Number
5: Number = Number * Number

Let's use the simple program 2x+1 as our problem and generate some input-output examples for the problem specification.

problem_1 = Problem([IOExample(Dict(:x => x), 2x+1) for x ∈ 1:5])
Problem{Vector{IOExample{Int64, Int64}}}("", IOExample{Int64, Int64}[IOExample{Int64, Int64}(Dict(:x => 1), 3), IOExample{Int64, Int64}(Dict(:x => 2), 5), IOExample{Int64, Int64}(Dict(:x => 3), 7), IOExample{Int64, Int64}(Dict(:x => 4), 9), IOExample{Int64, Int64}(Dict(:x => 5), 11)])

Parameters

Search procedures typically include hyperparameters that you can configure.

max_depth

max_depth controls the maximum depth of program trees explored during the search, effectively limiting the size and complexity of the synthesized program. The parameter is configured when constructing the iterator.

In the following example, we consider two different values for max_depth, and see the effect on memory allocations using the @timed macro.

begin
    iterator_3 = BFSIterator(g_1, :Number, max_depth=3)
    solution_3 = @timed synth(problem_1, iterator_3)
end
(value = (4{1,4{3,3}}, optimal_program), time = 1.520435793, bytes = 70428480, gctime = 0.0, gcstats = Base.GC_Diff(70428480, 1302, 0, 1383777, 3, 0, 0, 0, 0), lock_conflicts = 0, compile_time = 1.51799199, recompile_time = 0.0)
begin
    iterator_6 = BFSIterator(g_1, :Number, max_depth=6)
    solution_6 = @timed synth(problem_1, iterator_6)
end
(value = (4{4{1,3},3}, optimal_program), time = 0.000685844, bytes = 376240, gctime = 0.0, gcstats = Base.GC_Diff(376240, 4, 0, 7593, 0, 0, 0, 0, 0), lock_conflicts = 0, compile_time = 0.0, recompile_time = 0.0)

Since the problem we consider has a solution of depth 3, with both iteretaors we get the same solution:

rulenode2expr(solution_3[1][1], g_1)
:(1 + (x + x))
rulenode2expr(solution_6[1][1], g_1)
:((1 + x) + x)

But for max_depth = 6, we allocate more memory:

solution_3[3]
70428480
solution_6[3]
376240

While increasing max_depth allows us to explore more complex program trees, which may help solve harder problems, it also requires more memory allocation and can increase the execution time.

max_enumerations

max_enumerations defines the maximum number of candidate programs that can be evaluated before the search is terminated.

Let's explore how many enumerations are necessary to solve our simple problem.

begin
    solutions = []
    times = []
    nodes = []
    iterations = []
    for i in range(1, 50)
        iterator = BFSIterator(g_1, :Number, max_depth=i)
        solution = @timed synth(problem_1, iterator)
        push!(times, solution.time)
        push!(nodes, solution[1][1])
        push!(solutions, rulenode2expr(solution[1][1], g_1))
        push!(iterations, i)
    end
       pretty_table(HTML, [iterations nodes solutions times], column_labels=[["Iteration", "RuleNode", "Program", "Duration"]])
end
IterationRuleNodeProgramDuration
13x0.00345667
24{3,2}x + 20.000148953
34{1,4{3,3}}1 + (x + x)0.000310246
44{1,4{3,3}}1 + (x + x)0.000408472
54{4{1,3},3}(1 + x) + x0.000487213
64{4{1,3},3}(1 + x) + x0.000509063
74{4{1,3},3}(1 + x) + x0.000529348
84{4{1,3},3}(1 + x) + x0.000517566
94{4{1,3},3}(1 + x) + x0.000523511
104{4{1,3},3}(1 + x) + x0.000508794
114{4{1,3},3}(1 + x) + x0.000563198
124{4{1,3},3}(1 + x) + x0.000520638
134{4{1,3},3}(1 + x) + x0.000528518
144{4{1,3},3}(1 + x) + x0.000505229
154{4{1,3},3}(1 + x) + x0.000520274
164{4{1,3},3}(1 + x) + x0.000506425
174{4{1,3},3}(1 + x) + x0.00053115
184{4{1,3},3}(1 + x) + x0.000521154
194{4{1,3},3}(1 + x) + x0.000509977
204{4{1,3},3}(1 + x) + x0.0195775
214{4{1,3},3}(1 + x) + x0.00054426
224{4{1,3},3}(1 + x) + x0.000533083
234{4{1,3},3}(1 + x) + x0.000522016
244{4{1,3},3}(1 + x) + x0.000535743
254{4{1,3},3}(1 + x) + x0.000512641
264{4{1,3},3}(1 + x) + x0.000529897
274{4{1,3},3}(1 + x) + x0.000510863
284{4{1,3},3}(1 + x) + x0.000526448
294{4{1,3},3}(1 + x) + x0.000511345
304{4{1,3},3}(1 + x) + x0.000521219
314{4{1,3},3}(1 + x) + x0.000512519
324{4{1,3},3}(1 + x) + x0.000536425
334{4{1,3},3}(1 + x) + x0.000558692
344{4{1,3},3}(1 + x) + x0.000526662
354{4{1,3},3}(1 + x) + x0.000530667
364{4{1,3},3}(1 + x) + x0.000513088
374{4{1,3},3}(1 + x) + x0.000523169
384{4{1,3},3}(1 + x) + x0.000513249
394{4{1,3},3}(1 + x) + x0.000525681
404{4{1,3},3}(1 + x) + x0.00050518
414{4{1,3},3}(1 + x) + x0.000520461
424{4{1,3},3}(1 + x) + x0.000511518
434{4{1,3},3}(1 + x) + x0.000529214
444{4{1,3},3}(1 + x) + x0.0005316
454{4{1,3},3}(1 + x) + x0.000541886
464{4{1,3},3}(1 + x) + x0.000532367
474{4{1,3},3}(1 + x) + x0.000533836
484{4{1,3},3}(1 + x) + x0.000517306
494{4{1,3},3}(1 + x) + x0.000538194
504{4{1,3},3}(1 + x) + x0.000533321

At i = 3, we observe that an optimal program is found. Increasing the number of enumerations beyond that does not affect the solution or the number of memory allocations.

allow_evaluation_errors

A final parameter we consider here is allow_evaluation_errors, which is false by default. When true, the search continues even if an exception occurs during the evaluation of a candidate program. This allows the search process to handle faulty candidate programs and explore other ones, instead of throwing an error and terminating prematurely.

We will use a new example to see the effect of allow_evaluation_errors. We begin defining a new simple grammar. We then create some input-output examples to specify the problem we want to solve. This time, we choose a problem that we cannot solve with the provided grammar.

g_2 = @csgrammar begin
    Number = 1
    List = []
    Index = List[Number]
end
1: Number = 1
2: List = []
3: Index = List[Number]
problem_2 = Problem([IOExample(Dict{Symbol,Any}(), x) for x ∈ 1:5])
Problem{Vector{IOExample{Any, Int64}}}("", IOExample{Any, Int64}[IOExample{Any, Int64}(Dict{Symbol, Any}(), 1), IOExample{Any, Int64}(Dict{Symbol, Any}(), 2), IOExample{Any, Int64}(Dict{Symbol, Any}(), 3), IOExample{Any, Int64}(Dict{Symbol, Any}(), 4), IOExample{Any, Int64}(Dict{Symbol, Any}(), 5)])
Test.@test_throws HerbSearch.EvaluationError synth(problem_2, iterator_3)
�[32m�[1mTest Passed�[22m�[39m
      Thrown: EvaluationError

As expected, an exception occurs during the synthesis process. Now we try the same again, with allow_evaluation_errors=true.

solution_4 = synth(problem_2, iterator_3, allow_evaluation_errors=true)
(5{5{1,1},1}, suboptimal_program)

This time we find a solution, although a suboptimal one.

Herb.jl provides already implemented, ready-to-use search methods. The core building block of the search is the program iterator, which represents a walk through the program space. All program iterators share the top-level abstract type ProgramIterator. For more information on iterators and how to customize them, see this tutorial.

First, we explore two fundamental deterministic top-down search algorithms: breadth-first search (BFS) and depth-first search (DFS). Both algorithms are implemented using the abstract type TopDownIterator, which can be customized through the functions

  • priority_function

  • derivation_heuristic

  • hole_heuristic

First, we explore two fundamental deterministic top-down search algorithms: breadth-first search (BFS) and depth-first search (DFS). Both algorithms are implemented using the abstract type TopDownIterator, which can be customized through the functions priorityfunction, derivationheuristic, and hole_heuristic.

The BFSIterator enumerates all possible programs at a given depth before progressing to the next level, ensuring that trees are explored in increasing order of size. This guarantees that smaller programs are evaluated first, and larger, more complex ones are considered only after all smaller ones have been processed.

To explore BFSIterator, we define another very simple grammar.

g_3 = @csgrammar begin
        Real = 1 | 2
        Real = Real * Real
end
1: Real = 1
2: Real = 2
3: Real = Real * Real

Next, we define a BFSIterator with a max_depth of 2 and a max_size of infinite (which we approximate with the maximum value of Int), and a starting symbol of type Real. By default, BFSIterator uses the heuristic 'left-most first', i.e., the left-most child in the tree is always explored first.

iterator_bfs = BFSIterator(g_3, :Real, max_depth=2, max_size=typemax(Int))
BFSIterator(GenericSolver(1: Real = 1
2: Real = 2
3: Real = Real * Real
, SolverState(Hole[Bool[1, 1, 1]], Set{AbstractLocalConstraint}(), true), DataStructures.PriorityQueue{AbstractLocalConstraint, Int64, Base.Order.ForwardOrdering}(), nothing, false, 9223372036854775807, 2))

To see all possible solution programs the iterator explores, we use collect. It returs a list of the programs, ordered by increasing size and depth.

programs_bfs = collect(iterator_bfs)
6-element Vector{RuleNode}:
 1
 2
 3{1,1}
 3{1,2}
 3{2,1}
 3{2,2}

Let's verify that the iterator returns the programs we expect (keep in mind we use a leftmost-first heuristic).

answer_programs = [
    RuleNode(1),
    RuleNode(2),
    RuleNode(3, [RuleNode(1), RuleNode(1)]),
    RuleNode(3, [RuleNode(1), RuleNode(2)]),
    RuleNode(3, [RuleNode(2), RuleNode(1)]),
    RuleNode(3, [RuleNode(2), RuleNode(2)])
]
6-element Vector{RuleNode}:
 1
 2
 3{1,1}
 3{1,2}
 3{2,1}
 3{2,2}
rulenode_programs = [rulenode2expr(r, g_3) for r in answer_programs]
6-element Vector{Any}:
 1
 2
  :(1 * 1)
  :(1 * 2)
  :(2 * 1)
  :(2 * 2)
found_all_programs = all(p ∈ programs_bfs for p ∈ answer_programs)
true

The DFSIterator explores one branch of the search tree at a time, fully traversing it unitl a correct program is found or the specified max_depth is reached. Only after completing the current branch, it proceeds to the next branch.

As before, we collect the candidate programs using the same grammar, but a DFSIterator.

iterator_dfs = DFSIterator(g_3, :Real, max_depth=2, max_size=typemax(Int))
DFSIterator(GenericSolver(1: Real = 1
2: Real = 2
3: Real = Real * Real
, SolverState(Hole[Bool[1, 1, 1]], Set{AbstractLocalConstraint}(), true), DataStructures.PriorityQueue{AbstractLocalConstraint, Int64, Base.Order.ForwardOrdering}(), nothing, false, 9223372036854775807, 2))
programs_dfs = collect(iterator_dfs)
6-element Vector{RuleNode}:
 1
 3{1,1}
 3{1,2}
 3{2,1}
 3{2,2}
 2

DFSIterator also uses by default a leftmost-first heuristic. If we want to use a rightmost-first heuristic instead, we can create our own iterator DFSIteratorRightmost as a sub-type of TopDownIterator, using the @programiterator macro. Then we implement the functions priority_function and hole_heuristic. Also see the tutorial Top Down Iterator for how to build iterators is Herb.jl.

@programiterator DFSIteratorRightmost() <: TopDownIterator
DFSIteratorRightmost

By default, priority_function for a TopDownIterator is that of a BFS iterator. Hence, we need to provide a new implementation.

function priority_function(
    ::DFSIteratorRightmost, 
    ::AbstractGrammar, 
    ::AbstractRuleNode, 
    parent_value::Union{Real, Tuple{Vararg{Real}}},
    isrequeued::Bool
)
    if isrequeued
        return parent_value;
    end
    return parent_value - 1;
end
priority_function (generic function with 1 method)

Next, we need to implement the hole_heuristic to be rightmost-first.

function hole_heuristic(::DFSIteratorRightmost, node::AbstractRuleNode, max_depth::Int)::Union{ExpandFailureReason, HoleReference}
    return heuristic_rightmost(node, max_depth);
end
hole_heuristic (generic function with 1 method)
iteratordfs_rightmost = DFSIteratorRightmost(g_3, :Real, max_depth=2, max_size=typemax(Int))
DFSIteratorRightmost(GenericSolver(1: Real = 1
2: Real = 2
3: Real = Real * Real
, SolverState(Hole[Bool[1, 1, 1]], Set{AbstractLocalConstraint}(), true), DataStructures.PriorityQueue{AbstractLocalConstraint, Int64, Base.Order.ForwardOrdering}(), nothing, false, 9223372036854775807, 2))
programs_dfs_rightmost = collect(iteratordfs_rightmost)
6-element Vector{RuleNode}:
 1
 2
 3{1,1}
 3{1,2}
 3{2,1}
 3{2,2}

We observe that the order of programs has changed. We can also test if both DFS iterators return the same programs:

Set(programs_dfs)==Set(programs_dfs_rightmost)
true

While deterministic search methods explore the search space in a predictable way, stochastic ones introduce randomness to allow for more flexibility.

In this section, we will look at the stochastic search algorithms: Metropolis-Hastings (MH), Very Large Scale Neighbourhood Search (VLSNS), and Simulated Annealing (SA). In Herb.jl, all of these search methodsthe share a common supertype StochasticSearchIterator, which defines the following fields

  • examples

  • cost_function

  • initial_temperature

  • evaluation_function.

They are customized by overriding the functions neighbourhood, propose, accept and temperature as required.

We start with a simple grammar and a helper function to create the input-output examples for the problem we want to solve.

g_4 = @csgrammar begin
    X = |(1:5)
    X = X * X
    X = X + X
    X = X - X
    X = x
end
1: X = 1
2: X = 2
3: X = 3
4: X = 4
5: X = 5
6: X = X * X
7: X = X + X
8: X = X - X
9: X = x
function create_problem(f, range=20)
    examples = [IOExample(Dict(:x => x), f(x)) for x ∈ 1:range]
    return Problem(examples), examples
end
create_problem (generic function with 2 methods)

Throughout the stochastic search examples, we will use mean-squared-error as cost function. The cost function helps to guide the search by evaluating how well a candidate program solves the given task. This is used to decide whether a proposed program should be accepted or rejected.

cost_function = mean_squared_error
mean_squared_error (generic function with 1 method)

Metropolis-Hastings

Metropolis-Hastings (MH) is a method to produce samples from a distribution that may otherwise be difficult to sample. In the context of program synthesis, we sample from a distribution of programs defined by the grammar.

For more information on MH, see for example this webpage.

To illustrate MH, we use a simple arithmetic example.

e_mh = x -> x * x + 4
#14 (generic function with 1 method)
problem_mh, examples_mh = create_problem(e_mh)
(Problem{Vector{IOExample{Int64, Int64}}}("", IOExample{Int64, Int64}[IOExample{Int64, Int64}(Dict(:x => 1), 5), IOExample{Int64, Int64}(Dict(:x => 2), 8), IOExample{Int64, Int64}(Dict(:x => 3), 13), IOExample{Int64, Int64}(Dict(:x => 4), 20), IOExample{Int64, Int64}(Dict(:x => 5), 29), IOExample{Int64, Int64}(Dict(:x => 6), 40), IOExample{Int64, Int64}(Dict(:x => 7), 53), IOExample{Int64, Int64}(Dict(:x => 8), 68), IOExample{Int64, Int64}(Dict(:x => 9), 85), IOExample{Int64, Int64}(Dict(:x => 10), 104), IOExample{Int64, Int64}(Dict(:x => 11), 125), IOExample{Int64, Int64}(Dict(:x => 12), 148), IOExample{Int64, Int64}(Dict(:x => 13), 173), IOExample{Int64, Int64}(Dict(:x => 14), 200), IOExample{Int64, Int64}(Dict(:x => 15), 229), IOExample{Int64, Int64}(Dict(:x => 16), 260), IOExample{Int64, Int64}(Dict(:x => 17), 293), IOExample{Int64, Int64}(Dict(:x => 18), 328), IOExample{Int64, Int64}(Dict(:x => 19), 365), IOExample{Int64, Int64}(Dict(:x => 20), 404)]), IOExample{Int64, Int64}[IOExample{Int64, Int64}(Dict(:x => 1), 5), IOExample{Int64, Int64}(Dict(:x => 2), 8), IOExample{Int64, Int64}(Dict(:x => 3), 13), IOExample{Int64, Int64}(Dict(:x => 4), 20), IOExample{Int64, Int64}(Dict(:x => 5), 29), IOExample{Int64, Int64}(Dict(:x => 6), 40), IOExample{Int64, Int64}(Dict(:x => 7), 53), IOExample{Int64, Int64}(Dict(:x => 8), 68), IOExample{Int64, Int64}(Dict(:x => 9), 85), IOExample{Int64, Int64}(Dict(:x => 10), 104), IOExample{Int64, Int64}(Dict(:x => 11), 125), IOExample{Int64, Int64}(Dict(:x => 12), 148), IOExample{Int64, Int64}(Dict(:x => 13), 173), IOExample{Int64, Int64}(Dict(:x => 14), 200), IOExample{Int64, Int64}(Dict(:x => 15), 229), IOExample{Int64, Int64}(Dict(:x => 16), 260), IOExample{Int64, Int64}(Dict(:x => 17), 293), IOExample{Int64, Int64}(Dict(:x => 18), 328), IOExample{Int64, Int64}(Dict(:x => 19), 365), IOExample{Int64, Int64}(Dict(:x => 20), 404)])

Run the following code block to define the iterator and perform the program synthesis multiple times. Since the search process is stochastic, you will likely see different solution programs with each run.

begin
    rules = []
    programs = []
    iters = []
    for i in range(1, 3)
        iterator_mh = MHSearchIterator(g_4, :X, examples_mh, cost_function, max_depth=3) 
        program_mh = synth(problem_mh, iterator_mh)
        push!(rules, program_mh[1])
        push!(programs, rulenode2expr(program_mh[1], g_4))
        push!(iters, i)
    end
       pretty_table(HTML, [iters rules programs], column_labels=[["Run", "RuleNode", "Program"]])
end
RunRuleNodeProgram
17{6{9,9},4}x * x + 4
27{6{9,9},4}x * x + 4
37{7{1,3},6{9,9}}(1 + 3) + x * x

The second stochastic search method we consider is Very Large Scale Neighbourhood Search (VLSN). In each iteration, the algorithm searches the neighbourhood of the current candidate program for a local optimum, aiming to find a better candidate solution.

For more information, see this article.

Given the same grammar as before, we can try it with some simple examples.

e_vlsn = x -> 10
#17 (generic function with 1 method)
problem_vlsn1, examples_vlsn1 = create_problem(e_vlsn)
(Problem{Vector{IOExample{Int64, Int64}}}("", IOExample{Int64, Int64}[IOExample{Int64, Int64}(Dict(:x => 1), 10), IOExample{Int64, Int64}(Dict(:x => 2), 10), IOExample{Int64, Int64}(Dict(:x => 3), 10), IOExample{Int64, Int64}(Dict(:x => 4), 10), IOExample{Int64, Int64}(Dict(:x => 5), 10), IOExample{Int64, Int64}(Dict(:x => 6), 10), IOExample{Int64, Int64}(Dict(:x => 7), 10), IOExample{Int64, Int64}(Dict(:x => 8), 10), IOExample{Int64, Int64}(Dict(:x => 9), 10), IOExample{Int64, Int64}(Dict(:x => 10), 10), IOExample{Int64, Int64}(Dict(:x => 11), 10), IOExample{Int64, Int64}(Dict(:x => 12), 10), IOExample{Int64, Int64}(Dict(:x => 13), 10), IOExample{Int64, Int64}(Dict(:x => 14), 10), IOExample{Int64, Int64}(Dict(:x => 15), 10), IOExample{Int64, Int64}(Dict(:x => 16), 10), IOExample{Int64, Int64}(Dict(:x => 17), 10), IOExample{Int64, Int64}(Dict(:x => 18), 10), IOExample{Int64, Int64}(Dict(:x => 19), 10), IOExample{Int64, Int64}(Dict(:x => 20), 10)]), IOExample{Int64, Int64}[IOExample{Int64, Int64}(Dict(:x => 1), 10), IOExample{Int64, Int64}(Dict(:x => 2), 10), IOExample{Int64, Int64}(Dict(:x => 3), 10), IOExample{Int64, Int64}(Dict(:x => 4), 10), IOExample{Int64, Int64}(Dict(:x => 5), 10), IOExample{Int64, Int64}(Dict(:x => 6), 10), IOExample{Int64, Int64}(Dict(:x => 7), 10), IOExample{Int64, Int64}(Dict(:x => 8), 10), IOExample{Int64, Int64}(Dict(:x => 9), 10), IOExample{Int64, Int64}(Dict(:x => 10), 10), IOExample{Int64, Int64}(Dict(:x => 11), 10), IOExample{Int64, Int64}(Dict(:x => 12), 10), IOExample{Int64, Int64}(Dict(:x => 13), 10), IOExample{Int64, Int64}(Dict(:x => 14), 10), IOExample{Int64, Int64}(Dict(:x => 15), 10), IOExample{Int64, Int64}(Dict(:x => 16), 10), IOExample{Int64, Int64}(Dict(:x => 17), 10), IOExample{Int64, Int64}(Dict(:x => 18), 10), IOExample{Int64, Int64}(Dict(:x => 19), 10), IOExample{Int64, Int64}(Dict(:x => 20), 10)])
iterator_vlsn1 = VLSNSearchIterator(g_4, :X, examples_vlsn1, cost_function, max_depth=2) 
VLSNSearchIterator(GenericSolver(1: X = 1
2: X = 2
3: X = 3
4: X = 4
5: X = 5
6: X = X * X
7: X = X + X
8: X = X - X
9: X = x
, SolverState(Hole[Bool[1, 1, 1, 1, 1, 1, 1, 1, 1]], Set{AbstractLocalConstraint}(), true), DataStructures.PriorityQueue{AbstractLocalConstraint, Int64, Base.Order.ForwardOrdering}(), nothing, false, 9223372036854775807, 2), IOExample{Int64, Int64}[IOExample{Int64, Int64}(Dict(:x => 1), 10), IOExample{Int64, Int64}(Dict(:x => 2), 10), IOExample{Int64, Int64}(Dict(:x => 3), 10), IOExample{Int64, Int64}(Dict(:x => 4), 10), IOExample{Int64, Int64}(Dict(:x => 5), 10), IOExample{Int64, Int64}(Dict(:x => 6), 10), IOExample{Int64, Int64}(Dict(:x => 7), 10), IOExample{Int64, Int64}(Dict(:x => 8), 10), IOExample{Int64, Int64}(Dict(:x => 9), 10), IOExample{Int64, Int64}(Dict(:x => 10), 10), IOExample{Int64, Int64}(Dict(:x => 11), 10), IOExample{Int64, Int64}(Dict(:x => 12), 10), IOExample{Int64, Int64}(Dict(:x => 13), 10), IOExample{Int64, Int64}(Dict(:x => 14), 10), IOExample{Int64, Int64}(Dict(:x => 15), 10), IOExample{Int64, Int64}(Dict(:x => 16), 10), IOExample{Int64, Int64}(Dict(:x => 17), 10), IOExample{Int64, Int64}(Dict(:x => 18), 10), IOExample{Int64, Int64}(Dict(:x => 19), 10), IOExample{Int64, Int64}(Dict(:x => 20), 10)], mean_squared_error, 2, 1, execute_on_input)
program_vlsn1 = synth(problem_vlsn1, iterator_vlsn1)
(6{2,5}, optimal_program)
e_vlsn2 = x -> x
#20 (generic function with 1 method)
problem_vlsn2, examples_vlsn2 = create_problem(e_vlsn2)
(Problem{Vector{IOExample{Int64, Int64}}}("", IOExample{Int64, Int64}[IOExample{Int64, Int64}(Dict(:x => 1), 1), IOExample{Int64, Int64}(Dict(:x => 2), 2), IOExample{Int64, Int64}(Dict(:x => 3), 3), IOExample{Int64, Int64}(Dict(:x => 4), 4), IOExample{Int64, Int64}(Dict(:x => 5), 5), IOExample{Int64, Int64}(Dict(:x => 6), 6), IOExample{Int64, Int64}(Dict(:x => 7), 7), IOExample{Int64, Int64}(Dict(:x => 8), 8), IOExample{Int64, Int64}(Dict(:x => 9), 9), IOExample{Int64, Int64}(Dict(:x => 10), 10), IOExample{Int64, Int64}(Dict(:x => 11), 11), IOExample{Int64, Int64}(Dict(:x => 12), 12), IOExample{Int64, Int64}(Dict(:x => 13), 13), IOExample{Int64, Int64}(Dict(:x => 14), 14), IOExample{Int64, Int64}(Dict(:x => 15), 15), IOExample{Int64, Int64}(Dict(:x => 16), 16), IOExample{Int64, Int64}(Dict(:x => 17), 17), IOExample{Int64, Int64}(Dict(:x => 18), 18), IOExample{Int64, Int64}(Dict(:x => 19), 19), IOExample{Int64, Int64}(Dict(:x => 20), 20)]), IOExample{Int64, Int64}[IOExample{Int64, Int64}(Dict(:x => 1), 1), IOExample{Int64, Int64}(Dict(:x => 2), 2), IOExample{Int64, Int64}(Dict(:x => 3), 3), IOExample{Int64, Int64}(Dict(:x => 4), 4), IOExample{Int64, Int64}(Dict(:x => 5), 5), IOExample{Int64, Int64}(Dict(:x => 6), 6), IOExample{Int64, Int64}(Dict(:x => 7), 7), IOExample{Int64, Int64}(Dict(:x => 8), 8), IOExample{Int64, Int64}(Dict(:x => 9), 9), IOExample{Int64, Int64}(Dict(:x => 10), 10), IOExample{Int64, Int64}(Dict(:x => 11), 11), IOExample{Int64, Int64}(Dict(:x => 12), 12), IOExample{Int64, Int64}(Dict(:x => 13), 13), IOExample{Int64, Int64}(Dict(:x => 14), 14), IOExample{Int64, Int64}(Dict(:x => 15), 15), IOExample{Int64, Int64}(Dict(:x => 16), 16), IOExample{Int64, Int64}(Dict(:x => 17), 17), IOExample{Int64, Int64}(Dict(:x => 18), 18), IOExample{Int64, Int64}(Dict(:x => 19), 19), IOExample{Int64, Int64}(Dict(:x => 20), 20)])
iterator_vlsn2 = VLSNSearchIterator(g_4, :X, examples_vlsn2, cost_function, max_depth=1) 
VLSNSearchIterator(GenericSolver(1: X = 1
2: X = 2
3: X = 3
4: X = 4
5: X = 5
6: X = X * X
7: X = X + X
8: X = X - X
9: X = x
, SolverState(Hole[Bool[1, 1, 1, 1, 1, 1, 1, 1, 1]], Set{AbstractLocalConstraint}(), true), DataStructures.PriorityQueue{AbstractLocalConstraint, Int64, Base.Order.ForwardOrdering}(), nothing, false, 9223372036854775807, 1), IOExample{Int64, Int64}[IOExample{Int64, Int64}(Dict(:x => 1), 1), IOExample{Int64, Int64}(Dict(:x => 2), 2), IOExample{Int64, Int64}(Dict(:x => 3), 3), IOExample{Int64, Int64}(Dict(:x => 4), 4), IOExample{Int64, Int64}(Dict(:x => 5), 5), IOExample{Int64, Int64}(Dict(:x => 6), 6), IOExample{Int64, Int64}(Dict(:x => 7), 7), IOExample{Int64, Int64}(Dict(:x => 8), 8), IOExample{Int64, Int64}(Dict(:x => 9), 9), IOExample{Int64, Int64}(Dict(:x => 10), 10), IOExample{Int64, Int64}(Dict(:x => 11), 11), IOExample{Int64, Int64}(Dict(:x => 12), 12), IOExample{Int64, Int64}(Dict(:x => 13), 13), IOExample{Int64, Int64}(Dict(:x => 14), 14), IOExample{Int64, Int64}(Dict(:x => 15), 15), IOExample{Int64, Int64}(Dict(:x => 16), 16), IOExample{Int64, Int64}(Dict(:x => 17), 17), IOExample{Int64, Int64}(Dict(:x => 18), 18), IOExample{Int64, Int64}(Dict(:x => 19), 19), IOExample{Int64, Int64}(Dict(:x => 20), 20)], mean_squared_error, 2, 1, execute_on_input)
program_vlsn2 = synth(problem_vlsn2, iterator_vlsn2)
(9, optimal_program)

Simulated Annealing

Simulated Annealing (SA) explores smaller, incremental changes to the candidate program in each iteration, gradually refining the solution. It is a variation of the hill-climbing algorithm: Instead of always selecting the best move, SA picks a random move. If the move improves the solution (i.e., the candidate program), it is accepted.

Occasionally, SA will accept a move that worsens the solution. This allows the algorithm to escape local optima and explore more of the solution space. However, this strategy follows a cooling (annealing) schedule: at the beginning (high temperature), the algorithm explores more broadly and is more likely to accept worse solutions. As the temperature decreases, it becomes more selective, accepting worse solutions less often.

For more information, see this page.

We use the same example as for MH. SA additionally has the option to specify the initial_temperature for the annealing (default initial_temperature=1). Let's see what effect changing the temperature from 1 to 2 has on the solution program.

We define the problem:

problem_sa, examples_sa = create_problem(e_mh)
(Problem{Vector{IOExample{Int64, Int64}}}("", IOExample{Int64, Int64}[IOExample{Int64, Int64}(Dict(:x => 1), 5), IOExample{Int64, Int64}(Dict(:x => 2), 8), IOExample{Int64, Int64}(Dict(:x => 3), 13), IOExample{Int64, Int64}(Dict(:x => 4), 20), IOExample{Int64, Int64}(Dict(:x => 5), 29), IOExample{Int64, Int64}(Dict(:x => 6), 40), IOExample{Int64, Int64}(Dict(:x => 7), 53), IOExample{Int64, Int64}(Dict(:x => 8), 68), IOExample{Int64, Int64}(Dict(:x => 9), 85), IOExample{Int64, Int64}(Dict(:x => 10), 104), IOExample{Int64, Int64}(Dict(:x => 11), 125), IOExample{Int64, Int64}(Dict(:x => 12), 148), IOExample{Int64, Int64}(Dict(:x => 13), 173), IOExample{Int64, Int64}(Dict(:x => 14), 200), IOExample{Int64, Int64}(Dict(:x => 15), 229), IOExample{Int64, Int64}(Dict(:x => 16), 260), IOExample{Int64, Int64}(Dict(:x => 17), 293), IOExample{Int64, Int64}(Dict(:x => 18), 328), IOExample{Int64, Int64}(Dict(:x => 19), 365), IOExample{Int64, Int64}(Dict(:x => 20), 404)]), IOExample{Int64, Int64}[IOExample{Int64, Int64}(Dict(:x => 1), 5), IOExample{Int64, Int64}(Dict(:x => 2), 8), IOExample{Int64, Int64}(Dict(:x => 3), 13), IOExample{Int64, Int64}(Dict(:x => 4), 20), IOExample{Int64, Int64}(Dict(:x => 5), 29), IOExample{Int64, Int64}(Dict(:x => 6), 40), IOExample{Int64, Int64}(Dict(:x => 7), 53), IOExample{Int64, Int64}(Dict(:x => 8), 68), IOExample{Int64, Int64}(Dict(:x => 9), 85), IOExample{Int64, Int64}(Dict(:x => 10), 104), IOExample{Int64, Int64}(Dict(:x => 11), 125), IOExample{Int64, Int64}(Dict(:x => 12), 148), IOExample{Int64, Int64}(Dict(:x => 13), 173), IOExample{Int64, Int64}(Dict(:x => 14), 200), IOExample{Int64, Int64}(Dict(:x => 15), 229), IOExample{Int64, Int64}(Dict(:x => 16), 260), IOExample{Int64, Int64}(Dict(:x => 17), 293), IOExample{Int64, Int64}(Dict(:x => 18), 328), IOExample{Int64, Int64}(Dict(:x => 19), 365), IOExample{Int64, Int64}(Dict(:x => 20), 404)])

First with temperature 1:

initial_temperature1 = 1
1
iterator_sa1 = SASearchIterator(g_4, :X, examples_sa, cost_function, max_depth=3, initial_temperature = initial_temperature1) 
SASearchIterator(GenericSolver(1: X = 1
2: X = 2
3: X = 3
4: X = 4
5: X = 5
6: X = X * X
7: X = X + X
8: X = X - X
9: X = x
, SolverState(Hole[Bool[1, 1, 1, 1, 1, 1, 1, 1, 1]], Set{AbstractLocalConstraint}(), true), DataStructures.PriorityQueue{AbstractLocalConstraint, Int64, Base.Order.ForwardOrdering}(), nothing, false, 9223372036854775807, 3), IOExample{Int64, Int64}[IOExample{Int64, Int64}(Dict(:x => 1), 5), IOExample{Int64, Int64}(Dict(:x => 2), 8), IOExample{Int64, Int64}(Dict(:x => 3), 13), IOExample{Int64, Int64}(Dict(:x => 4), 20), IOExample{Int64, Int64}(Dict(:x => 5), 29), IOExample{Int64, Int64}(Dict(:x => 6), 40), IOExample{Int64, Int64}(Dict(:x => 7), 53), IOExample{Int64, Int64}(Dict(:x => 8), 68), IOExample{Int64, Int64}(Dict(:x => 9), 85), IOExample{Int64, Int64}(Dict(:x => 10), 104), IOExample{Int64, Int64}(Dict(:x => 11), 125), IOExample{Int64, Int64}(Dict(:x => 12), 148), IOExample{Int64, Int64}(Dict(:x => 13), 173), IOExample{Int64, Int64}(Dict(:x => 14), 200), IOExample{Int64, Int64}(Dict(:x => 15), 229), IOExample{Int64, Int64}(Dict(:x => 16), 260), IOExample{Int64, Int64}(Dict(:x => 17), 293), IOExample{Int64, Int64}(Dict(:x => 18), 328), IOExample{Int64, Int64}(Dict(:x => 19), 365), IOExample{Int64, Int64}(Dict(:x => 20), 404)], mean_squared_error, 1, 0.99, execute_on_input)
program_sa1 = @timed synth(problem_sa, iterator_sa1)
(value = (7{4,6{9,9}}, optimal_program), time = 0.383859451, bytes = 68922272, gctime = 0.055355094, gcstats = Base.GC_Diff(68922272, 120, 0, 1162694, 0, 1928, 55355094, 1, 0), lock_conflicts = 0, compile_time = 0.190642535, recompile_time = 0.0)

and get the following solution and runtime:

program_sa1[1]
(7{4,6{9,9}}, optimal_program)
program_sa1[2]
0.383859451

And now the same with tempeture 2:

initial_temperature2 = 2
2
iterator_sa2 = SASearchIterator(g_4, :X, examples_sa, cost_function, max_depth=3, initial_temperature = initial_temperature2) 
SASearchIterator(GenericSolver(1: X = 1
2: X = 2
3: X = 3
4: X = 4
5: X = 5
6: X = X * X
7: X = X + X
8: X = X - X
9: X = x
, SolverState(Hole[Bool[1, 1, 1, 1, 1, 1, 1, 1, 1]], Set{AbstractLocalConstraint}(), true), DataStructures.PriorityQueue{AbstractLocalConstraint, Int64, Base.Order.ForwardOrdering}(), nothing, false, 9223372036854775807, 3), IOExample{Int64, Int64}[IOExample{Int64, Int64}(Dict(:x => 1), 5), IOExample{Int64, Int64}(Dict(:x => 2), 8), IOExample{Int64, Int64}(Dict(:x => 3), 13), IOExample{Int64, Int64}(Dict(:x => 4), 20), IOExample{Int64, Int64}(Dict(:x => 5), 29), IOExample{Int64, Int64}(Dict(:x => 6), 40), IOExample{Int64, Int64}(Dict(:x => 7), 53), IOExample{Int64, Int64}(Dict(:x => 8), 68), IOExample{Int64, Int64}(Dict(:x => 9), 85), IOExample{Int64, Int64}(Dict(:x => 10), 104), IOExample{Int64, Int64}(Dict(:x => 11), 125), IOExample{Int64, Int64}(Dict(:x => 12), 148), IOExample{Int64, Int64}(Dict(:x => 13), 173), IOExample{Int64, Int64}(Dict(:x => 14), 200), IOExample{Int64, Int64}(Dict(:x => 15), 229), IOExample{Int64, Int64}(Dict(:x => 16), 260), IOExample{Int64, Int64}(Dict(:x => 17), 293), IOExample{Int64, Int64}(Dict(:x => 18), 328), IOExample{Int64, Int64}(Dict(:x => 19), 365), IOExample{Int64, Int64}(Dict(:x => 20), 404)], mean_squared_error, 2, 0.99, execute_on_input)
program_sa2 = @timed synth(problem_sa, iterator_sa2)
(value = (7{6{9,9},7{1,3}}, optimal_program), time = 0.011435244, bytes = 5187672, gctime = 0.0, gcstats = Base.GC_Diff(5187672, 1, 0, 85769, 0, 0, 0, 0, 0), lock_conflicts = 0, compile_time = 0.0, recompile_time = 0.0)
program_sa2[1]
(7{6{9,9},7{1,3}}, optimal_program)
program_sa2[2]
0.011435244

We can see that a higher tempture 1 solves this problem quicker than tempeture 2.

Genetic search is a type of evolutionary algorithm, which simulates the process of natural selection. It evolves a population of candidate programs through operations like mutation, crossover (recombination), and selection. Then, the fitness of each program is assessed (i.e., how well it satisfies the given specifications). Only the 'fittest' programs are selected for the next generation, thus gradually refining the population of candidate programs.

For more information, see here.

We show the example of finding a lambda function. Try varying the parameters of the genetic search to see what happens.

e_gs = x -> 3 * x * x + (x + 2)
#23 (generic function with 1 method)
problem_gs, examples_gs = create_problem(e_gs)
(Problem{Vector{IOExample{Int64, Int64}}}("", IOExample{Int64, Int64}[IOExample{Int64, Int64}(Dict(:x => 1), 6), IOExample{Int64, Int64}(Dict(:x => 2), 16), IOExample{Int64, Int64}(Dict(:x => 3), 32), IOExample{Int64, Int64}(Dict(:x => 4), 54), IOExample{Int64, Int64}(Dict(:x => 5), 82), IOExample{Int64, Int64}(Dict(:x => 6), 116), IOExample{Int64, Int64}(Dict(:x => 7), 156), IOExample{Int64, Int64}(Dict(:x => 8), 202), IOExample{Int64, Int64}(Dict(:x => 9), 254), IOExample{Int64, Int64}(Dict(:x => 10), 312), IOExample{Int64, Int64}(Dict(:x => 11), 376), IOExample{Int64, Int64}(Dict(:x => 12), 446), IOExample{Int64, Int64}(Dict(:x => 13), 522), IOExample{Int64, Int64}(Dict(:x => 14), 604), IOExample{Int64, Int64}(Dict(:x => 15), 692), IOExample{Int64, Int64}(Dict(:x => 16), 786), IOExample{Int64, Int64}(Dict(:x => 17), 886), IOExample{Int64, Int64}(Dict(:x => 18), 992), IOExample{Int64, Int64}(Dict(:x => 19), 1104), IOExample{Int64, Int64}(Dict(:x => 20), 1222)]), IOExample{Int64, Int64}[IOExample{Int64, Int64}(Dict(:x => 1), 6), IOExample{Int64, Int64}(Dict(:x => 2), 16), IOExample{Int64, Int64}(Dict(:x => 3), 32), IOExample{Int64, Int64}(Dict(:x => 4), 54), IOExample{Int64, Int64}(Dict(:x => 5), 82), IOExample{Int64, Int64}(Dict(:x => 6), 116), IOExample{Int64, Int64}(Dict(:x => 7), 156), IOExample{Int64, Int64}(Dict(:x => 8), 202), IOExample{Int64, Int64}(Dict(:x => 9), 254), IOExample{Int64, Int64}(Dict(:x => 10), 312), IOExample{Int64, Int64}(Dict(:x => 11), 376), IOExample{Int64, Int64}(Dict(:x => 12), 446), IOExample{Int64, Int64}(Dict(:x => 13), 522), IOExample{Int64, Int64}(Dict(:x => 14), 604), IOExample{Int64, Int64}(Dict(:x => 15), 692), IOExample{Int64, Int64}(Dict(:x => 16), 786), IOExample{Int64, Int64}(Dict(:x => 17), 886), IOExample{Int64, Int64}(Dict(:x => 18), 992), IOExample{Int64, Int64}(Dict(:x => 19), 1104), IOExample{Int64, Int64}(Dict(:x => 20), 1222)])
iterator_gs = GeneticSearchIterator(g_4, :X, examples_gs, population_size = 10, mutation_probability = 0.8, maximum_initial_population_depth = 3) 
GeneticSearchIterator(GenericSolver(1: X = 1
2: X = 2
3: X = 3
4: X = 4
5: X = 5
6: X = X * X
7: X = X + X
8: X = X - X
9: X = x
, SolverState(Hole[Bool[1, 1, 1, 1, 1, 1, 1, 1, 1]], Set{AbstractLocalConstraint}(), true), DataStructures.PriorityQueue{AbstractLocalConstraint, Int64, Base.Order.ForwardOrdering}(), nothing, false, 9223372036854775807, 9223372036854775807), IOExample{Int64, Int64}[IOExample{Int64, Int64}(Dict(:x => 1), 6), IOExample{Int64, Int64}(Dict(:x => 2), 16), IOExample{Int64, Int64}(Dict(:x => 3), 32), IOExample{Int64, Int64}(Dict(:x => 4), 54), IOExample{Int64, Int64}(Dict(:x => 5), 82), IOExample{Int64, Int64}(Dict(:x => 6), 116), IOExample{Int64, Int64}(Dict(:x => 7), 156), IOExample{Int64, Int64}(Dict(:x => 8), 202), IOExample{Int64, Int64}(Dict(:x => 9), 254), IOExample{Int64, Int64}(Dict(:x => 10), 312), IOExample{Int64, Int64}(Dict(:x => 11), 376), IOExample{Int64, Int64}(Dict(:x => 12), 446), IOExample{Int64, Int64}(Dict(:x => 13), 522), IOExample{Int64, Int64}(Dict(:x => 14), 604), IOExample{Int64, Int64}(Dict(:x => 15), 692), IOExample{Int64, Int64}(Dict(:x => 16), 786), IOExample{Int64, Int64}(Dict(:x => 17), 886), IOExample{Int64, Int64}(Dict(:x => 18), 992), IOExample{Int64, Int64}(Dict(:x => 19), 1104), IOExample{Int64, Int64}(Dict(:x => 20), 1222)], execute_on_input, 10, 0.8, 3)
begin
    program_gs, error_gs = synth(problem_gs, iterator_gs)
    rulenode2expr(program_gs, g_4)
end
:(((1 + x * (x * 3)) + ((3 + 5) - 3)) - (4 - x))