Merge the "solver-experiments" branch that I have been working on for

a few weeks. This include mainly three things:

1. Various tweaks for a total performance gain of around 30%.
2. Take into account symmetries and avoid repeated work. This
   required a re-work of the splitting into tasks before the solve.
3. Add a second fallback table (eoesep). This gives huge performance
   gains for particular scrambles (e.g. superflip).

After merging this commit, remove and re-generate all pruning tables.

Squashed commit of the following:

commit 60f0705d2d69050e6a30581a2810f686d6f69b80
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Sat Dec 7 16:06:48 2024 +0100

    Fix indentation

commit cc5d489a251812b6188c0ba264ac6cb2236f1afe
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Sat Dec 7 15:56:19 2024 +0100

    Updated documentation

commit a3f605dd628546e52564f82b139feb473b0725f3
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Sat Dec 7 14:01:11 2024 +0100

    use eoesep table as second fallback

commit c75e43c9116c64f97e92b0fe038be8a032925a72
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Fri Dec 6 16:13:23 2024 +0100

    First commit for gendata_eoesep

commit fea7688ab8bdc5ae0c3480622e2510a3bcd39248
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Tue Dec 3 17:31:00 2024 +0100

    Add scramble to tool

commit 66866cb71dea4ca8278ecb9e90ff4295771feb42
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Tue Dec 3 17:22:59 2024 +0100

    Added tool to check multiple solutions

commit ef65611c772c3996bddca8d181da3538e0af1674
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Tue Dec 3 17:16:20 2024 +0100

    Write all solutions for symmetric positions

commit e3ded26db7d7d4ae7c0e2488151ed14f581f7b8e
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Tue Nov 26 09:14:54 2024 +0100

    Added symmetry filter (TODO: print excluded solutions)

commit 864c437a9751c58d58562650ca9eba4a9e6ad3eb
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Mon Nov 25 14:51:13 2024 +0100

    Improved task split

commit b88926d36d7ab0c64c5fe3bb954fd15d41267fba
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Fri Nov 22 19:06:41 2024 +0100

    Reworked tasks for multi-threading in view of symmetry filter

commit 26fa653f97df8cd601aecb80eaf89f0a00e9ba9f
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Thu Oct 31 15:37:43 2024 +0100

    Added transform move

commit 19f655ef94d658eaa2fefb5cea3c167a3ec58db6
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Thu Oct 31 09:29:15 2024 +0100

    Clarified doc

commit 3b0fe1e5ef8b628854e30f0f0067300e2763c954
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Thu Oct 31 08:36:58 2024 +0100

    Handle solved cube correctly

commit 57705cbc4982e3abe97a36ed64871738d4f721c0
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Thu Oct 31 08:24:30 2024 +0100

    Close file

commit fc7d462b58bcf3d3a3fbf26c1f3bd04c640a4898
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Tue Oct 29 15:05:48 2024 +0100

    Removed stats tool

commit 359bf7cb49ef405ee76ed662207d47cb2abcc5a9
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Tue Oct 29 15:01:51 2024 +0100

    Updated theory doc

commit 39c315af562bc4ce896f41004388a4c34d475d37
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Tue Oct 29 14:51:40 2024 +0100

    Remove unused constants

commit 57a5d24538aa59a4df9221dad2f99e9f0286bd9d
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Tue Oct 29 10:20:38 2024 +0100

    Add tool to solve scrambles from file

commit 07e2918c216636891b1fa6adecc9756086a901e9
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Mon Oct 28 17:00:00 2024 +0100

    Add make table to tool

commit f5e5266c654eb027a5a35c57cc618555246f5e5e
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Mon Oct 28 09:35:49 2024 +0100

    Remove old solver, other small things

commit a1ec78025b7959dbb845213f7f4e6851ecebc204
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Sun Oct 27 02:00:29 2024 +0200

    Improvements

commit 8eea23dbe888d923e662e24ae969130e2c67b999
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Sat Oct 26 12:24:19 2024 +0200

    Makefile fix

commit 3fc3927beacc78971cefeb42da8d71fe6c015fc1
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Fri Oct 25 18:25:09 2024 +0200

    More performance gains

commit 7b4efa1f9af9722de1ab9ccfc27899825a0d12c4
Author: Sebastiano Tronto <sebastiano@tronto.net>
Date:   Fri Oct 25 15:53:20 2024 +0200

    Alternative solver implementation, small performance gain

1 files changed, 71 insertions, 0 deletions

diff --git a/tools/301_solve_file/solve_file.c b/tools/301_solve_file/solve_file.c
new file mode 100644
index 0000000..aa45df0
--- /dev/null
+++ b/tools/301_solve_file/solve_file.c
@@ -0,0 +1,71 @@
+#include "../tool.h"
+
+#define SOL_BUFFER_LEN   1000
+#define MAX_SCR          10000
+#define MAX_SCR_LEN      250
+
+char *solver;
+int64_t size = 0, N = 0;
+char *buf;
+char scrambles[MAX_SCR][MAX_SCR_LEN];
+
+void run(void) {
+        int64_t i, nsols;
+        long long stats[NISSY_SIZE_SOLVE_STATS];
+        char sol[SOL_BUFFER_LEN], cube[22];
+
+        printf("Solved the following scrambles:\n\n");
+        for (i = 0; i < N; i++) {
+                printf("%" PRId64 ". %s\n", i+1, scrambles[i]);
+                printf("Solving scramble %s\n", scrambles[i]);
+                if (nissy_applymoves(NISSY_SOLVED_CUBE, scrambles[i], cube)
+                     == -1) {
+                        printf("Invalid scramble\n");
+                        continue;
+                }
+                nsols = nissy_solve(cube, solver, NISSY_NISSFLAG_NORMAL,
+                    0, 20, 1, -1, size, buf, SOL_BUFFER_LEN, sol, stats);
+                if (nsols == 0)
+                        printf("No solution found\n");
+                else
+                        printf("Solutions:\n%s\n", sol);
+        }
+}
+
+int main(int argc, char **argv) {
+        char filename[255], *scrfilename;
+        FILE *scrfile;
+
+        if (argc < 3) {
+                printf("Error: not enough arguments. "
+                    "A solver and a scramble file must be given.\n");
+                return 1;
+        }
+
+        solver = argv[1];
+        scrfilename = argv[2];
+
+        srand(time(NULL));
+        nissy_setlogger(log_stderr);
+
+        sprintf(filename, "tables/%s", solver);
+        if (getdata(solver, &buf, filename) != 0)
+                return 1;
+
+        size = nissy_datasize(solver);
+
+        if ((scrfile = fopen(scrfilename, "r")) == NULL) {
+                printf("Error: could not read given file '%s'.\n",
+                    scrfilename);
+                return 1;
+        }
+
+        printf("Reading scrambles from file '%s'.\n", scrfilename);
+        for (N = 0; fgets(scrambles[N], MAX_SCR_LEN, scrfile) != NULL; N++) ;
+        fclose(scrfile);
+
+        timerun(run);
+
+        free(buf);
+        return 0;
+}