@reicek/neataptic-ts 0.1.21 → 0.1.22

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (223) hide show
  1. package/.github/agents/boundary-mapper.agent.md +29 -0
  2. package/.github/agents/docs-scout.agent.md +29 -0
  3. package/.github/agents/plan-scout.agent.md +29 -0
  4. package/.github/agents/solid-split.agent.md +138 -0
  5. package/.github/copilot-instructions.md +103 -0
  6. package/package.json +6 -3
  7. package/plans/ES2023 migration +13 -8
  8. package/plans/Evolution_Training_Interoperability_Contracts.md +1 -1
  9. package/plans/Interactive_Examples_and_Learning_Path.md +10 -2
  10. package/plans/Memory_Optimization.md +3 -3
  11. package/plans/README.md +63 -0
  12. package/plans/Roadmap.md +15 -3
  13. package/plans/asciiMaze_SOLID_split.done.md +130 -0
  14. package/plans/flappy_bird_SOLID_split.done.md +67 -0
  15. package/scripts/assets/theme.css +221 -34
  16. package/scripts/copy-examples.mjs +9 -5
  17. package/scripts/export-onnx.mjs +3 -3
  18. package/scripts/generate-bench-tables.mjs +10 -10
  19. package/scripts/generate-bench-tables.ts +10 -10
  20. package/scripts/generate-docs.ts +1415 -449
  21. package/scripts/render-docs-html.ts +15 -8
  22. package/src/README.md +101 -223
  23. package/src/architecture/README.md +57 -185
  24. package/src/architecture/layer/README.md +38 -38
  25. package/src/architecture/network/README.md +33 -31
  26. package/src/architecture/network/activate/README.md +77 -77
  27. package/src/architecture/network/connect/README.md +15 -13
  28. package/src/architecture/network/deterministic/README.md +7 -7
  29. package/src/architecture/network/evolve/README.md +44 -44
  30. package/src/architecture/network/gating/README.md +20 -20
  31. package/src/architecture/network/genetic/README.md +51 -51
  32. package/src/architecture/network/mutate/README.md +97 -97
  33. package/src/architecture/network/onnx/README.md +264 -264
  34. package/src/architecture/network/prune/README.md +39 -39
  35. package/src/architecture/network/remove/README.md +26 -26
  36. package/src/architecture/network/serialize/README.md +56 -56
  37. package/src/architecture/network/slab/README.md +61 -61
  38. package/src/architecture/network/standalone/README.md +24 -24
  39. package/src/architecture/network/stats/README.md +9 -9
  40. package/src/architecture/network/topology/README.md +46 -46
  41. package/src/architecture/network/training/README.md +21 -21
  42. package/src/methods/README.md +9 -87
  43. package/src/multithreading/README.md +8 -77
  44. package/src/multithreading/workers/README.md +2 -2
  45. package/src/multithreading/workers/browser/README.md +0 -6
  46. package/src/multithreading/workers/node/README.md +0 -3
  47. package/src/neat/README.md +562 -568
  48. package/src/utils/README.md +18 -18
  49. package/test/examples/asciiMaze/README.md +59 -59
  50. package/test/examples/asciiMaze/asciiMaze.e2e.test.ts +14 -9
  51. package/test/examples/asciiMaze/browser-entry/README.md +196 -0
  52. package/test/examples/asciiMaze/browser-entry/browser-entry.abort.services.ts +95 -0
  53. package/test/examples/asciiMaze/browser-entry/browser-entry.constants.ts +23 -0
  54. package/test/examples/asciiMaze/browser-entry/browser-entry.curriculum.services.ts +115 -0
  55. package/test/examples/asciiMaze/browser-entry/browser-entry.globals.services.ts +106 -0
  56. package/test/examples/asciiMaze/browser-entry/browser-entry.host.services.ts +157 -0
  57. package/test/examples/asciiMaze/browser-entry/browser-entry.services.ts +14 -0
  58. package/test/examples/asciiMaze/browser-entry/browser-entry.ts +129 -0
  59. package/test/examples/asciiMaze/browser-entry/browser-entry.types.ts +120 -0
  60. package/test/examples/asciiMaze/browser-entry/browser-entry.utils.ts +98 -0
  61. package/test/examples/asciiMaze/browser-entry.ts +10 -576
  62. package/test/examples/asciiMaze/dashboardManager/README.md +276 -0
  63. package/test/examples/asciiMaze/dashboardManager/archive/README.md +16 -0
  64. package/test/examples/asciiMaze/dashboardManager/archive/dashboardManager.archive.services.ts +267 -0
  65. package/test/examples/asciiMaze/dashboardManager/dashboardManager.constants.ts +35 -0
  66. package/test/examples/asciiMaze/dashboardManager/dashboardManager.services.ts +103 -0
  67. package/test/examples/asciiMaze/dashboardManager/dashboardManager.ts +181 -0
  68. package/test/examples/asciiMaze/dashboardManager/dashboardManager.types.ts +267 -0
  69. package/test/examples/asciiMaze/dashboardManager/dashboardManager.utils.ts +254 -0
  70. package/test/examples/asciiMaze/dashboardManager/live/README.md +14 -0
  71. package/test/examples/asciiMaze/dashboardManager/live/dashboardManager.live.services.ts +264 -0
  72. package/test/examples/asciiMaze/dashboardManager/telemetry/README.md +47 -0
  73. package/test/examples/asciiMaze/dashboardManager/telemetry/dashboardManager.telemetry.services.ts +513 -0
  74. package/test/examples/asciiMaze/dashboardManager.ts +13 -2335
  75. package/test/examples/asciiMaze/evolutionEngine/README.md +1058 -0
  76. package/test/examples/asciiMaze/evolutionEngine/curriculumPhase.ts +90 -0
  77. package/test/examples/asciiMaze/evolutionEngine/engineState.constants.ts +36 -0
  78. package/test/examples/asciiMaze/evolutionEngine/engineState.ts +58 -513
  79. package/test/examples/asciiMaze/evolutionEngine/engineState.types.ts +212 -0
  80. package/test/examples/asciiMaze/evolutionEngine/engineState.utils.ts +301 -0
  81. package/test/examples/asciiMaze/evolutionEngine/evolutionEngine.types.ts +445 -0
  82. package/test/examples/asciiMaze/evolutionEngine/evolutionLoop.ts +81 -50
  83. package/test/examples/asciiMaze/evolutionEngine/optionsAndSetup.ts +2 -4
  84. package/test/examples/asciiMaze/evolutionEngine/populationDynamics.ts +17 -33
  85. package/test/examples/asciiMaze/evolutionEngine/populationPruning.ts +1 -1
  86. package/test/examples/asciiMaze/evolutionEngine/rngAndTiming.ts +1 -2
  87. package/test/examples/asciiMaze/evolutionEngine/sampling.ts +1 -1
  88. package/test/examples/asciiMaze/evolutionEngine/scratchPools.ts +2 -5
  89. package/test/examples/asciiMaze/evolutionEngine/setupHelpers.ts +30 -37
  90. package/test/examples/asciiMaze/evolutionEngine/telemetryMetrics.ts +16 -58
  91. package/test/examples/asciiMaze/evolutionEngine/trainingWarmStart.ts +2 -2
  92. package/test/examples/asciiMaze/evolutionEngine.ts +55 -55
  93. package/test/examples/asciiMaze/fitness.ts +2 -2
  94. package/test/examples/asciiMaze/fitness.types.ts +65 -0
  95. package/test/examples/asciiMaze/interfaces.ts +64 -1352
  96. package/test/examples/asciiMaze/mazeMovement/README.md +356 -0
  97. package/test/examples/asciiMaze/mazeMovement/finalization/README.md +49 -0
  98. package/test/examples/asciiMaze/mazeMovement/finalization/mazeMovement.finalization.ts +138 -0
  99. package/test/examples/asciiMaze/mazeMovement/mazeMovement.constants.ts +101 -0
  100. package/test/examples/asciiMaze/mazeMovement/mazeMovement.services.ts +230 -0
  101. package/test/examples/asciiMaze/mazeMovement/mazeMovement.ts +299 -0
  102. package/test/examples/asciiMaze/mazeMovement/mazeMovement.types.ts +185 -0
  103. package/test/examples/asciiMaze/mazeMovement/mazeMovement.utils.ts +153 -0
  104. package/test/examples/asciiMaze/mazeMovement/policy/README.md +91 -0
  105. package/test/examples/asciiMaze/mazeMovement/policy/mazeMovement.policy.ts +467 -0
  106. package/test/examples/asciiMaze/mazeMovement/runtime/README.md +95 -0
  107. package/test/examples/asciiMaze/mazeMovement/runtime/mazeMovement.runtime.ts +354 -0
  108. package/test/examples/asciiMaze/mazeMovement/shaping/README.md +124 -0
  109. package/test/examples/asciiMaze/mazeMovement/shaping/mazeMovement.shaping.ts +459 -0
  110. package/test/examples/asciiMaze/mazeMovement.ts +12 -2978
  111. package/test/examples/flappy_bird/Trace-20260309T191949.json +24124 -0
  112. package/test/examples/flappy_bird/browser-entry/README.md +1129 -0
  113. package/test/examples/flappy_bird/browser-entry/browser-entry.host.utils.ts +4 -324
  114. package/test/examples/flappy_bird/browser-entry/browser-entry.network-view.utils.ts +6 -399
  115. package/test/examples/flappy_bird/browser-entry/browser-entry.playback.utils.ts +1 -717
  116. package/test/examples/flappy_bird/browser-entry/browser-entry.spawn.utils.ts +11 -31
  117. package/test/examples/flappy_bird/browser-entry/browser-entry.visualization.utils.ts +15 -893
  118. package/test/examples/flappy_bird/browser-entry/host/README.md +307 -0
  119. package/test/examples/flappy_bird/browser-entry/host/host.resize.service.ts +1 -295
  120. package/test/examples/flappy_bird/browser-entry/host/host.ts +562 -6
  121. package/test/examples/flappy_bird/browser-entry/host/resize/README.md +274 -0
  122. package/test/examples/flappy_bird/browser-entry/host/resize/host.resize.service.constants.ts +31 -0
  123. package/test/examples/flappy_bird/browser-entry/host/resize/host.resize.service.services.ts +360 -0
  124. package/test/examples/flappy_bird/browser-entry/host/resize/host.resize.service.ts +117 -0
  125. package/test/examples/flappy_bird/browser-entry/host/resize/host.resize.service.types.ts +63 -0
  126. package/test/examples/flappy_bird/browser-entry/host/resize/host.resize.service.utils.ts +250 -0
  127. package/test/examples/flappy_bird/browser-entry/network-view/README.md +399 -0
  128. package/test/examples/flappy_bird/browser-entry/network-view/network-view.topology.utils.ts +255 -0
  129. package/test/examples/flappy_bird/browser-entry/network-view/network-view.ts +802 -7
  130. package/test/examples/flappy_bird/browser-entry/playback/README.md +684 -0
  131. package/test/examples/flappy_bird/browser-entry/playback/background/README.md +277 -0
  132. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/README.md +770 -0
  133. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.cache.services.ts +178 -0
  134. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.constants.ts +107 -0
  135. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.geometry.utils.ts +518 -0
  136. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.math.utils.ts +117 -0
  137. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.pulse.utils.ts +233 -0
  138. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.services.ts +211 -0
  139. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.ts +48 -0
  140. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.types.ts +212 -0
  141. package/test/examples/flappy_bird/browser-entry/playback/background/ground-grid/playback.background.ground-grid.utils.ts +81 -0
  142. package/test/examples/flappy_bird/browser-entry/playback/background/playback.background.cache.services.ts +96 -0
  143. package/test/examples/flappy_bird/browser-entry/playback/background/playback.background.constants.ts +62 -0
  144. package/test/examples/flappy_bird/browser-entry/playback/background/playback.background.services.ts +244 -0
  145. package/test/examples/flappy_bird/browser-entry/playback/background/playback.background.ts +53 -0
  146. package/test/examples/flappy_bird/browser-entry/playback/background/playback.background.types.ts +68 -0
  147. package/test/examples/flappy_bird/browser-entry/playback/background/playback.background.utils.ts +100 -0
  148. package/test/examples/flappy_bird/browser-entry/playback/frame-render/README.md +310 -0
  149. package/test/examples/flappy_bird/browser-entry/playback/frame-render/playback.frame-render.service.ts +92 -0
  150. package/test/examples/flappy_bird/browser-entry/playback/frame-render/playback.frame-render.services.ts +272 -0
  151. package/test/examples/flappy_bird/browser-entry/playback/frame-render/playback.frame-render.types.ts +39 -0
  152. package/test/examples/flappy_bird/browser-entry/playback/frame-render/playback.frame-render.utils.ts +493 -0
  153. package/test/examples/flappy_bird/browser-entry/playback/playback.constants.ts +1 -1
  154. package/test/examples/flappy_bird/browser-entry/playback/playback.frame-render.service.ts +4 -0
  155. package/test/examples/flappy_bird/browser-entry/playback/playback.snapshot.utils.ts +44 -0
  156. package/test/examples/flappy_bird/browser-entry/playback/playback.starfield.service.ts +39 -122
  157. package/test/examples/flappy_bird/browser-entry/playback/playback.starfield.services.ts +272 -0
  158. package/test/examples/flappy_bird/browser-entry/playback/playback.starfield.types.ts +62 -0
  159. package/test/examples/flappy_bird/browser-entry/playback/playback.starfield.utils.ts +11 -4
  160. package/test/examples/flappy_bird/browser-entry/playback/playback.ts +409 -8
  161. package/test/examples/flappy_bird/browser-entry/playback/playback.types.ts +4 -12
  162. package/test/examples/flappy_bird/browser-entry/runtime/README.md +235 -0
  163. package/test/examples/flappy_bird/browser-entry/runtime/runtime.evolution-launch.service.ts +45 -0
  164. package/test/examples/flappy_bird/browser-entry/runtime/runtime.lifecycle.service.ts +81 -0
  165. package/test/examples/flappy_bird/browser-entry/runtime/runtime.startup.service.ts +74 -0
  166. package/test/examples/flappy_bird/browser-entry/runtime/runtime.ts +31 -121
  167. package/test/examples/flappy_bird/browser-entry/runtime/runtime.types.ts +36 -0
  168. package/test/examples/flappy_bird/browser-entry/visualization/README.md +557 -0
  169. package/test/examples/flappy_bird/browser-entry/visualization/visualization.constants.ts +110 -0
  170. package/test/examples/flappy_bird/browser-entry/visualization/visualization.draw.service.ts +957 -19
  171. package/test/examples/flappy_bird/browser-entry/visualization/visualization.legend.utils.ts +138 -3
  172. package/test/examples/flappy_bird/browser-entry/visualization/visualization.topology.utils.ts +3 -27
  173. package/test/examples/flappy_bird/browser-entry/visualization/visualization.ts +1 -23
  174. package/test/examples/flappy_bird/browser-entry/worker-channel/README.md +156 -0
  175. package/test/examples/flappy_bird/constants/README.md +1179 -0
  176. package/test/examples/flappy_bird/constants/constants.network-view.ts +24 -0
  177. package/test/examples/flappy_bird/constants/constants.palette.ts +7 -0
  178. package/test/examples/flappy_bird/constants/constants.starfield.ts +78 -3
  179. package/test/examples/flappy_bird/environment/README.md +143 -0
  180. package/test/examples/flappy_bird/environment/environment.observation.utils.ts +1 -19
  181. package/test/examples/flappy_bird/environment/environment.step.service.ts +3 -66
  182. package/test/examples/flappy_bird/evaluation/README.md +130 -0
  183. package/test/examples/flappy_bird/evaluation/evaluation.fitness.utils.ts +1 -1
  184. package/test/examples/flappy_bird/evaluation/evaluation.rollout.service.ts +5 -375
  185. package/test/examples/flappy_bird/evaluation/rollout/README.md +291 -0
  186. package/test/examples/flappy_bird/evaluation/rollout/evaluation.rollout.constants.ts +30 -0
  187. package/test/examples/flappy_bird/evaluation/rollout/evaluation.rollout.service.ts +58 -0
  188. package/test/examples/flappy_bird/evaluation/rollout/evaluation.rollout.services.ts +310 -0
  189. package/test/examples/flappy_bird/evaluation/rollout/evaluation.rollout.types.ts +56 -0
  190. package/test/examples/flappy_bird/evaluation/rollout/evaluation.rollout.utils.ts +368 -0
  191. package/test/examples/flappy_bird/flappy-evolution-worker/README.md +618 -0
  192. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.playback.service.ts +7 -7
  193. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.simulation.frame.service.ts +364 -0
  194. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.simulation.types.ts +14 -0
  195. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.simulation.utils.ts +4 -201
  196. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.ts +184 -345
  197. package/test/examples/flappy_bird/flappy-evolution-worker/flappy-evolution-worker.warm-start.service.ts +291 -0
  198. package/test/examples/flappy_bird/flappy.simulation.shared.utils.ts +5 -0
  199. package/test/examples/flappy_bird/simulation-shared/README.md +417 -0
  200. package/test/examples/flappy_bird/simulation-shared/observation/README.md +183 -0
  201. package/test/examples/flappy_bird/simulation-shared/observation/observation.features.utils.ts +301 -0
  202. package/test/examples/flappy_bird/simulation-shared/observation/observation.ts +9 -0
  203. package/test/examples/flappy_bird/simulation-shared/observation/observation.vector.utils.ts +59 -0
  204. package/test/examples/flappy_bird/simulation-shared/simulation-shared.observation.utils.ts +5 -403
  205. package/test/examples/flappy_bird/simulation-shared/simulation-shared.spawn.utils.ts +20 -6
  206. package/test/examples/flappy_bird/{evaluation/evaluation.statistics.utils.ts → simulation-shared/simulation-shared.statistics.utils.ts} +23 -8
  207. package/test/examples/flappy_bird/trainer/README.md +563 -0
  208. package/test/examples/flappy_bird/trainer/evaluation/README.md +199 -0
  209. package/test/examples/flappy_bird/trainer/evaluation/trainer.evaluation.service.constants.ts +9 -0
  210. package/test/examples/flappy_bird/trainer/evaluation/trainer.evaluation.service.services.ts +73 -0
  211. package/test/examples/flappy_bird/trainer/evaluation/trainer.evaluation.service.ts +165 -0
  212. package/test/examples/flappy_bird/trainer/evaluation/trainer.evaluation.service.types.ts +25 -0
  213. package/test/examples/flappy_bird/trainer/evaluation/trainer.evaluation.service.utils.ts +161 -0
  214. package/test/examples/flappy_bird/trainer/trainer.evaluation.service.ts +13 -0
  215. package/test/examples/flappy_bird/trainer/trainer.report.service.services.ts +181 -0
  216. package/test/examples/flappy_bird/trainer/trainer.report.service.ts +126 -0
  217. package/test/examples/flappy_bird/trainer/trainer.selection.utils.ts +89 -0
  218. package/test/examples/flappy_bird/trainer/trainer.ts +11 -553
  219. package/test/examples/flappy_bird/browser-entry/browser-entry.utils.ts +0 -12
  220. package/test/examples/flappy_bird/environment/environment.ts +0 -7
  221. package/test/examples/flappy_bird/evaluation/evaluation.ts +0 -7
  222. package/test/examples/flappy_bird/simulation-shared/simulation-shared.ts +0 -15
  223. package/test/examples/flappy_bird/trainer/trainer.statistics.utils.ts +0 -78
@@ -28,10 +28,6 @@ rounded network outputs (thresholded at 0.5) against the target labels.
28
28
  It assumes target values are 0 or 1, and outputs are probabilities between 0 and 1.
29
29
  Note: This is equivalent to `1 - accuracy` for binary classification.
30
30
 
31
- Parameters:
32
- - `` - - An array of target values, expected to be 0 or 1.
33
- - `` - - An array of output values from the network, typically probabilities between 0 and 1.
34
-
35
31
  Returns: The proportion of misclassified samples (error rate, between 0 and 1).
36
32
 
37
33
  #### crossEntropy
@@ -47,10 +43,6 @@ predicted probability diverges from the actual label.
47
43
  It uses a small epsilon (PROB_EPSILON = 1e-15) to prevent `log(0)` which would result in `NaN`.
48
44
  Output values are clamped to the range `[epsilon, 1 - epsilon]` for numerical stability.
49
45
 
50
- Parameters:
51
- - `` - - An array of target values, typically 0 or 1 for binary classification, or probabilities for soft labels.
52
- - `` - - An array of output values from the network, representing probabilities (expected to be between 0 and 1).
53
-
54
46
  Returns: The mean cross-entropy error over all samples.
55
47
 
56
48
  #### focalLoss
@@ -60,12 +52,6 @@ Returns: The mean cross-entropy error over all samples.
60
52
  Calculates the Focal Loss, which is useful for addressing class imbalance in classification tasks.
61
53
  Focal loss down-weights easy examples and focuses training on hard negatives.
62
54
 
63
- Parameters:
64
- - `` - - Array of target values (0 or 1 for binary, or probabilities for soft labels).
65
- - `` - - Array of predicted probabilities (between 0 and 1).
66
- - `` - - Focusing parameter (default 2).
67
- - `` - - Balancing parameter (default 0.25).
68
-
69
55
  Returns: The mean focal loss.
70
56
 
71
57
  #### hinge
@@ -79,10 +65,6 @@ Hinge loss is used for training classifiers. It penalizes predictions that are
79
65
  not only incorrect but also those that are correct but not confident (i.e., close to the decision boundary).
80
66
  Assumes target values are encoded as -1 or 1.
81
67
 
82
- Parameters:
83
- - `` - - An array of target values, expected to be -1 or 1.
84
- - `` - - An array of output values from the network (raw scores, not necessarily probabilities).
85
-
86
68
  Returns: The mean hinge loss.
87
69
 
88
70
  #### labelSmoothing
@@ -92,11 +74,6 @@ Returns: The mean hinge loss.
92
74
  Calculates the Cross Entropy with Label Smoothing.
93
75
  Label smoothing prevents the model from becoming overconfident by softening the targets.
94
76
 
95
- Parameters:
96
- - `` - - Array of target values (0 or 1 for binary, or probabilities for soft labels).
97
- - `` - - Array of predicted probabilities (between 0 and 1).
98
- - `` - - Smoothing factor (between 0 and 1, e.g., 0.1).
99
-
100
77
  Returns: The mean cross-entropy loss with label smoothing.
101
78
 
102
79
  #### mae
@@ -108,10 +85,6 @@ Calculates the Mean Absolute Error (MAE), another common loss function for regre
108
85
  MAE measures the average of the absolute differences between predictions and actual values.
109
86
  Compared to MSE, it is less sensitive to outliers because errors are not squared.
110
87
 
111
- Parameters:
112
- - `` - - An array of target numerical values.
113
- - `` - - An array of output values from the network.
114
-
115
88
  Returns: The mean absolute error.
116
89
 
117
90
  #### mape
@@ -125,10 +98,6 @@ for understanding the error relative to the magnitude of the target values.
125
98
  However, it has limitations: it's undefined when the target value is zero and
126
99
  can be skewed by target values close to zero.
127
100
 
128
- Parameters:
129
- - `` - - An array of target numerical values. Should not contain zeros for standard MAPE.
130
- - `` - - An array of output values from the network.
131
-
132
101
  Returns: The mean absolute percentage error, expressed as a proportion (e.g., 0.1 for 10%).
133
102
 
134
103
  #### mse
@@ -141,10 +110,6 @@ MSE measures the average of the squares of the errors—that is, the average
141
110
  squared difference between the estimated values and the actual value.
142
111
  It is sensitive to outliers due to the squaring of the error terms.
143
112
 
144
- Parameters:
145
- - `` - - An array of target numerical values.
146
- - `` - - An array of output values from the network.
147
-
148
113
  Returns: The mean squared error.
149
114
 
150
115
  #### msle
@@ -159,10 +124,6 @@ It measures the squared difference between the logarithms of the predicted and a
159
124
  Uses `log(1 + x)` instead of `log(x)` for numerical stability and to handle inputs of 0.
160
125
  Assumes both targets and outputs are non-negative.
161
126
 
162
- Parameters:
163
- - `` - - An array of target numerical values (assumed >= 0).
164
- - `` - - An array of output values from the network (assumed >= 0).
165
-
166
127
  Returns: The mean squared logarithmic error.
167
128
 
168
129
  #### softmaxCrossEntropy
@@ -382,10 +343,6 @@ rounded network outputs (thresholded at 0.5) against the target labels.
382
343
  It assumes target values are 0 or 1, and outputs are probabilities between 0 and 1.
383
344
  Note: This is equivalent to `1 - accuracy` for binary classification.
384
345
 
385
- Parameters:
386
- - `` - - An array of target values, expected to be 0 or 1.
387
- - `` - - An array of output values from the network, typically probabilities between 0 and 1.
388
-
389
346
  Returns: The proportion of misclassified samples (error rate, between 0 and 1).
390
347
 
391
348
  #### cosineAnnealing
@@ -434,10 +391,6 @@ predicted probability diverges from the actual label.
434
391
  It uses a small epsilon (PROB_EPSILON = 1e-15) to prevent `log(0)` which would result in `NaN`.
435
392
  Output values are clamped to the range `[epsilon, 1 - epsilon]` for numerical stability.
436
393
 
437
- Parameters:
438
- - `` - - An array of target values, typically 0 or 1 for binary classification, or probabilities for soft labels.
439
- - `` - - An array of output values from the network, representing probabilities (expected to be between 0 and 1).
440
-
441
394
  Returns: The mean cross-entropy error over all samples.
442
395
 
443
396
  #### exp
@@ -482,12 +435,6 @@ Returns: A function that takes the base learning rate and the current iteration
482
435
  Calculates the Focal Loss, which is useful for addressing class imbalance in classification tasks.
483
436
  Focal loss down-weights easy examples and focuses training on hard negatives.
484
437
 
485
- Parameters:
486
- - `` - - Array of target values (0 or 1 for binary, or probabilities for soft labels).
487
- - `` - - Array of predicted probabilities (between 0 and 1).
488
- - `` - - Focusing parameter (default 2).
489
- - `` - - Balancing parameter (default 0.25).
490
-
491
438
  Returns: The mean focal loss.
492
439
 
493
440
  #### hinge
@@ -501,10 +448,6 @@ Hinge loss is used for training classifiers. It penalizes predictions that are
501
448
  not only incorrect but also those that are correct but not confident (i.e., close to the decision boundary).
502
449
  Assumes target values are encoded as -1 or 1.
503
450
 
504
- Parameters:
505
- - `` - - An array of target values, expected to be -1 or 1.
506
- - `` - - An array of output values from the network (raw scores, not necessarily probabilities).
507
-
508
451
  Returns: The mean hinge loss.
509
452
 
510
453
  #### inv
@@ -534,11 +477,6 @@ Returns: A function that calculates the inversely decayed learning rate for a gi
534
477
  Calculates the Cross Entropy with Label Smoothing.
535
478
  Label smoothing prevents the model from becoming overconfident by softening the targets.
536
479
 
537
- Parameters:
538
- - `` - - Array of target values (0 or 1 for binary, or probabilities for soft labels).
539
- - `` - - Array of predicted probabilities (between 0 and 1).
540
- - `` - - Smoothing factor (between 0 and 1, e.g., 0.1).
541
-
542
480
  Returns: The mean cross-entropy loss with label smoothing.
543
481
 
544
482
  #### linearWarmupDecay
@@ -563,10 +501,6 @@ Calculates the Mean Absolute Error (MAE), another common loss function for regre
563
501
  MAE measures the average of the absolute differences between predictions and actual values.
564
502
  Compared to MSE, it is less sensitive to outliers because errors are not squared.
565
503
 
566
- Parameters:
567
- - `` - - An array of target numerical values.
568
- - `` - - An array of output values from the network.
569
-
570
504
  Returns: The mean absolute error.
571
505
 
572
506
  #### mape
@@ -580,10 +514,6 @@ for understanding the error relative to the magnitude of the target values.
580
514
  However, it has limitations: it's undefined when the target value is zero and
581
515
  can be skewed by target values close to zero.
582
516
 
583
- Parameters:
584
- - `` - - An array of target numerical values. Should not contain zeros for standard MAPE.
585
- - `` - - An array of output values from the network.
586
-
587
517
  Returns: The mean absolute percentage error, expressed as a proportion (e.g., 0.1 for 10%).
588
518
 
589
519
  #### mse
@@ -596,10 +526,6 @@ MSE measures the average of the squares of the errors—that is, the average
596
526
  squared difference between the estimated values and the actual value.
597
527
  It is sensitive to outliers due to the squaring of the error terms.
598
528
 
599
- Parameters:
600
- - `` - - An array of target numerical values.
601
- - `` - - An array of output values from the network.
602
-
603
529
  Returns: The mean squared error.
604
530
 
605
531
  #### msle
@@ -614,10 +540,6 @@ It measures the squared difference between the logarithms of the predicted and a
614
540
  Uses `log(1 + x)` instead of `log(x)` for numerical stability and to handle inputs of 0.
615
541
  Assumes both targets and outputs are non-negative.
616
542
 
617
- Parameters:
618
- - `` - - An array of target numerical values (assumed >= 0).
619
- - `` - - An array of output values from the network (assumed >= 0).
620
-
621
543
  Returns: The mean squared logarithmic error.
622
544
 
623
545
  #### reduceOnPlateau
@@ -703,7 +625,7 @@ but can slow down the search process.
703
625
 
704
626
  ### registerCustomActivation
705
627
 
706
- `(activationName: string, activationFunction: import("C:/NeatapticTS/src/methods/activation.utils").ActivationFunction) => void`
628
+ `(activationName: string, activationFunction: import("src/methods/activation.utils").ActivationFunction) => void`
707
629
 
708
630
  ## methods/connection.ts
709
631
 
@@ -935,7 +857,7 @@ Useful for any stateless schedule strategy.
935
857
 
936
858
  ### createCosineAnnealingRateSchedule
937
859
 
938
- `(period: number, minimumRate: number) => import("C:/NeatapticTS/src/methods/rate.utils").RateSchedule`
860
+ `(period: number, minimumRate: number) => import("src/methods/rate.utils").RateSchedule`
939
861
 
940
862
  Returns a cosine annealing learning rate schedule.
941
863
 
@@ -947,7 +869,7 @@ Returns: A learning rate schedule implementing cosine annealing.
947
869
 
948
870
  ### createCosineAnnealingWarmRestartsSchedule
949
871
 
950
- `(initialPeriod: number, minimumRate: number, periodGrowthMultiplier: number) => import("C:/NeatapticTS/src/methods/rate.utils").RateSchedule`
872
+ `(initialPeriod: number, minimumRate: number, periodGrowthMultiplier: number) => import("src/methods/rate.utils").RateSchedule`
951
873
 
952
874
  Returns a cosine annealing schedule with warm restarts and growing cycles.
953
875
 
@@ -960,7 +882,7 @@ Returns: A learning rate schedule implementing SGDR-style warm restarts.
960
882
 
961
883
  ### createExponentialRateSchedule
962
884
 
963
- `(decayFactor: number) => import("C:/NeatapticTS/src/methods/rate.utils").RateSchedule`
885
+ `(decayFactor: number) => import("src/methods/rate.utils").RateSchedule`
964
886
 
965
887
  Returns an exponential decay learning rate schedule.
966
888
 
@@ -971,7 +893,7 @@ Returns: A learning rate schedule implementing exponential decay.
971
893
 
972
894
  ### createFixedRateSchedule
973
895
 
974
- `() => import("C:/NeatapticTS/src/methods/rate.utils").RateSchedule`
896
+ `() => import("src/methods/rate.utils").RateSchedule`
975
897
 
976
898
  Returns a schedule that always yields the base learning rate.
977
899
 
@@ -979,7 +901,7 @@ Returns: A learning rate schedule that ignores iteration and returns baseRate.
979
901
 
980
902
  ### createInverseRateSchedule
981
903
 
982
- `(decayFactor: number, decayPower: number) => import("C:/NeatapticTS/src/methods/rate.utils").RateSchedule`
904
+ `(decayFactor: number, decayPower: number) => import("src/methods/rate.utils").RateSchedule`
983
905
 
984
906
  Returns an inverse decay learning rate schedule.
985
907
 
@@ -991,7 +913,7 @@ Returns: A learning rate schedule implementing inverse decay.
991
913
 
992
914
  ### createLinearWarmupDecaySchedule
993
915
 
994
- `(totalStepCount: number, warmupStepCount: number | undefined, endRate: number) => import("C:/NeatapticTS/src/methods/rate.utils").RateSchedule`
916
+ `(totalStepCount: number, warmupStepCount: number | undefined, endRate: number) => import("src/methods/rate.utils").RateSchedule`
995
917
 
996
918
  Returns a linear warmup followed by linear decay schedule.
997
919
 
@@ -1004,7 +926,7 @@ Returns: A learning rate schedule implementing warmup then decay.
1004
926
 
1005
927
  ### createReduceOnPlateauSchedule
1006
928
 
1007
- `(options: { factor?: number | undefined; patience?: number | undefined; minDelta?: number | undefined; cooldown?: number | undefined; minRate?: number | undefined; verbose?: boolean | undefined; } | undefined) => import("C:/NeatapticTS/src/methods/rate.utils").ReduceOnPlateauSchedule`
929
+ `(options: { factor?: number | undefined; patience?: number | undefined; minDelta?: number | undefined; cooldown?: number | undefined; minRate?: number | undefined; verbose?: boolean | undefined; } | undefined) => import("src/methods/rate.utils").ReduceOnPlateauSchedule`
1008
930
 
1009
931
  Returns a ReduceLROnPlateau-style schedule that lowers the rate when no improvement is seen.
1010
932
 
@@ -1015,7 +937,7 @@ Returns: A stateful schedule that reacts to lack of improvement.
1015
937
 
1016
938
  ### createStepRateSchedule
1017
939
 
1018
- `(decayFactor: number, decayStepSize: number) => import("C:/NeatapticTS/src/methods/rate.utils").RateSchedule`
940
+ `(decayFactor: number, decayStepSize: number) => import("src/methods/rate.utils").RateSchedule`
1019
941
 
1020
942
  Returns a step decay learning rate schedule.
1021
943
 
@@ -26,24 +26,14 @@ emphasis on efficient evaluation and mutation of neural networks in parallel env
26
26
 
27
27
  Absolute activation function.
28
28
 
29
- Parameters:
30
- - `` - - The input value.
31
-
32
29
  Returns: The activated value.
33
30
 
34
31
  #### activateSerializedNetwork
35
32
 
36
- `(inputValues: number[], activationValues: number[], stateValues: number[], serializedNetwork: number[], activationFunctions: import("C:/NeatapticTS/src/multithreading/types").ActivationFn[]) => number[]`
33
+ `(inputValues: number[], activationValues: number[], stateValues: number[], serializedNetwork: number[], activationFunctions: import("src/multithreading/types").ActivationFn[]) => number[]`
37
34
 
38
35
  Activates a serialized network.
39
36
 
40
- Parameters:
41
- - `` - - The input values.
42
- - `` - - The activations array.
43
- - `` - - The states array.
44
- - `` - - The serialized network data.
45
- - `` - - The activation functions.
46
-
47
37
  Returns: The output values.
48
38
 
49
39
  #### activations
@@ -56,9 +46,6 @@ A list of compiled activation functions in a specific order.
56
46
 
57
47
  Bent Identity activation function.
58
48
 
59
- Parameters:
60
- - `` - - The input value.
61
-
62
49
  Returns: The activated value.
63
50
 
64
51
  #### bipolar
@@ -67,9 +54,6 @@ Returns: The activated value.
67
54
 
68
55
  Bipolar activation function.
69
56
 
70
- Parameters:
71
- - `` - - The input value.
72
-
73
57
  Returns: The activated value.
74
58
 
75
59
  #### bipolarSigmoid
@@ -78,20 +62,14 @@ Returns: The activated value.
78
62
 
79
63
  Bipolar Sigmoid activation function.
80
64
 
81
- Parameters:
82
- - `` - - The input value.
83
-
84
65
  Returns: The activated value.
85
66
 
86
67
  #### deserializeDataSet
87
68
 
88
- `(serializedSet: number[]) => import("C:/NeatapticTS/src/multithreading/types").SerializedSample[]`
69
+ `(serializedSet: number[]) => import("src/multithreading/types").SerializedSample[]`
89
70
 
90
71
  Deserializes a dataset from a flat array.
91
72
 
92
- Parameters:
93
- - `` - - The serialized dataset.
94
-
95
73
  Returns: The deserialized dataset as an array of input-output pairs.
96
74
 
97
75
  #### gaussian
@@ -100,14 +78,11 @@ Returns: The deserialized dataset as an array of input-output pairs.
100
78
 
101
79
  Gaussian activation function.
102
80
 
103
- Parameters:
104
- - `` - - The input value.
105
-
106
81
  Returns: The activated value.
107
82
 
108
83
  #### getBrowserTestWorker
109
84
 
110
- `() => Promise<import("C:/NeatapticTS/src/multithreading/types").TestWorkerConstructor>`
85
+ `() => Promise<import("src/multithreading/types").TestWorkerConstructor>`
111
86
 
112
87
  Gets the browser test worker.
113
88
 
@@ -115,7 +90,7 @@ Returns: The browser test worker.
115
90
 
116
91
  #### getNodeTestWorker
117
92
 
118
- `() => Promise<import("C:/NeatapticTS/src/multithreading/types").TestWorkerConstructor>`
93
+ `() => Promise<import("src/multithreading/types").TestWorkerConstructor>`
119
94
 
120
95
  Gets the node test worker.
121
96
 
@@ -127,9 +102,6 @@ Returns: The node test worker.
127
102
 
128
103
  Hard Tanh activation function.
129
104
 
130
- Parameters:
131
- - `` - - The input value.
132
-
133
105
  Returns: The activated value.
134
106
 
135
107
  #### identity
@@ -138,9 +110,6 @@ Returns: The activated value.
138
110
 
139
111
  Identity activation function.
140
112
 
141
- Parameters:
142
- - `` - - The input value.
143
-
144
113
  Returns: The activated value.
145
114
 
146
115
  #### inverse
@@ -149,9 +118,6 @@ Returns: The activated value.
149
118
 
150
119
  Inverse activation function.
151
120
 
152
- Parameters:
153
- - `` - - The input value.
154
-
155
121
  Returns: The activated value.
156
122
 
157
123
  #### logistic
@@ -160,9 +126,6 @@ Returns: The activated value.
160
126
 
161
127
  Logistic activation function.
162
128
 
163
- Parameters:
164
- - `` - - The input value.
165
-
166
129
  Returns: The activated value.
167
130
 
168
131
  #### relu
@@ -171,9 +134,6 @@ Returns: The activated value.
171
134
 
172
135
  Rectified Linear Unit (ReLU) activation function.
173
136
 
174
- Parameters:
175
- - `` - - The input value.
176
-
177
137
  Returns: The activated value.
178
138
 
179
139
  #### selu
@@ -182,9 +142,6 @@ Returns: The activated value.
182
142
 
183
143
  Scaled Exponential Linear Unit (SELU) activation function.
184
144
 
185
- Parameters:
186
- - `` - - The input value.
187
-
188
145
  Returns: The activated value.
189
146
 
190
147
  #### serializeDataSet
@@ -193,9 +150,6 @@ Returns: The activated value.
193
150
 
194
151
  Serializes a dataset into a flat array.
195
152
 
196
- Parameters:
197
- - `` - - The dataset to serialize.
198
-
199
153
  Returns: The serialized dataset.
200
154
 
201
155
  #### sinusoid
@@ -204,9 +158,6 @@ Returns: The serialized dataset.
204
158
 
205
159
  Sinusoid activation function.
206
160
 
207
- Parameters:
208
- - `` - - The input value.
209
-
210
161
  Returns: The activated value.
211
162
 
212
163
  #### softplus
@@ -215,9 +166,6 @@ Returns: The activated value.
215
166
 
216
167
  Softplus activation function. - Added
217
168
 
218
- Parameters:
219
- - `` - - The input value.
220
-
221
169
  Returns: The activated value.
222
170
 
223
171
  #### softsign
@@ -226,9 +174,6 @@ Returns: The activated value.
226
174
 
227
175
  Softsign activation function.
228
176
 
229
- Parameters:
230
- - `` - - The input value.
231
-
232
177
  Returns: The activated value.
233
178
 
234
179
  #### step
@@ -237,9 +182,6 @@ Returns: The activated value.
237
182
 
238
183
  Step activation function.
239
184
 
240
- Parameters:
241
- - `` - - The input value.
242
-
243
185
  Returns: The activated value.
244
186
 
245
187
  #### tanh
@@ -248,25 +190,14 @@ Returns: The activated value.
248
190
 
249
191
  Hyperbolic tangent activation function.
250
192
 
251
- Parameters:
252
- - `` - - The input value.
253
-
254
193
  Returns: The activated value.
255
194
 
256
195
  #### testSerializedSet
257
196
 
258
- `(serializedSampleSet: import("C:/NeatapticTS/src/multithreading/types").SerializedSample[], cost: (expected: number[], actual: number[]) => number, activationValues: number[], stateValues: number[], serializedNetwork: number[], activationFunctions: import("C:/NeatapticTS/src/multithreading/types").ActivationFn[]) => number`
197
+ `(serializedSampleSet: import("src/multithreading/types").SerializedSample[], cost: (expected: number[], actual: number[]) => number, activationValues: number[], stateValues: number[], serializedNetwork: number[], activationFunctions: import("src/multithreading/types").ActivationFn[]) => number`
259
198
 
260
199
  Tests a serialized dataset using a cost function.
261
200
 
262
- Parameters:
263
- - `` - - The serialized dataset as an array of input-output pairs.
264
- - `` - - The cost function.
265
- - `` - - The activations array.
266
- - `` - - The states array.
267
- - `` - - The serialized network data.
268
- - `` - - The activation functions.
269
-
270
201
  Returns: The average error.
271
202
 
272
203
  #### workers
@@ -306,7 +237,7 @@ Returns: Absolute activation.
306
237
 
307
238
  ### activateSerializedNetwork
308
239
 
309
- `(inputValues: number[], activationValues: number[], stateValues: number[], serializedNetwork: number[], activationFunctions: import("C:/NeatapticTS/src/multithreading/types").ActivationFn[]) => number[]`
240
+ `(inputValues: number[], activationValues: number[], stateValues: number[], serializedNetwork: number[], activationFunctions: import("src/multithreading/types").ActivationFn[]) => number[]`
310
241
 
311
242
  Activates a serialized network and produces outputs.
312
243
 
@@ -350,7 +281,7 @@ Returns: Bipolar sigmoid activation.
350
281
 
351
282
  ### deserializeDataSet
352
283
 
353
- `(serializedSet: number[]) => import("C:/NeatapticTS/src/multithreading/types").SerializedSample[]`
284
+ `(serializedSet: number[]) => import("src/multithreading/types").SerializedSample[]`
354
285
 
355
286
  Deserializes a dataset from its flat representation.
356
287
 
@@ -480,7 +411,7 @@ Returns: Hyperbolic tangent activation.
480
411
 
481
412
  ### testSerializedSet
482
413
 
483
- `(serializedSampleSet: import("C:/NeatapticTS/src/multithreading/types").SerializedSample[], costFunction: (expected: number[], actual: number[]) => number, activationValues: number[], stateValues: number[], serializedNetwork: number[], activationFunctions: import("C:/NeatapticTS/src/multithreading/types").ActivationFn[]) => number`
414
+ `(serializedSampleSet: import("src/multithreading/types").SerializedSample[], costFunction: (expected: number[], actual: number[]) => number, activationValues: number[], stateValues: number[], serializedNetwork: number[], activationFunctions: import("src/multithreading/types").ActivationFn[]) => number`
484
415
 
485
416
  Tests a serialized dataset using a cost function.
486
417
 
@@ -12,7 +12,7 @@ Utility class for managing workers in both Node.js and browser environments.
12
12
 
13
13
  #### getBrowserTestWorker
14
14
 
15
- `() => Promise<typeof import("C:/NeatapticTS/src/multithreading/workers/browser/testworker").TestWorker>`
15
+ `() => Promise<typeof import("src/multithreading/workers/browser/testworker").TestWorker>`
16
16
 
17
17
  Loads the browser test worker dynamically.
18
18
 
@@ -20,7 +20,7 @@ Returns: A promise that resolves to the browser TestWorker class.
20
20
 
21
21
  #### getNodeTestWorker
22
22
 
23
- `() => Promise<typeof import("C:/NeatapticTS/src/multithreading/workers/node/testworker").TestWorker>`
23
+ `() => Promise<typeof import("src/multithreading/workers/node/testworker").TestWorker>`
24
24
 
25
25
  Loads the Node.js test worker dynamically.
26
26
 
@@ -24,9 +24,6 @@ computationally expensive tasks, such as network evaluation, to separate threads
24
24
 
25
25
  Creates a string representation of the worker's blob.
26
26
 
27
- Parameters:
28
- - `` - - The cost function to be used by the worker.
29
-
30
27
  Returns: The blob string.
31
28
 
32
29
  #### evaluate
@@ -35,9 +32,6 @@ Returns: The blob string.
35
32
 
36
33
  Evaluates a network using the worker process.
37
34
 
38
- Parameters:
39
- - `` - - The network to evaluate.
40
-
41
35
  Returns: A promise that resolves to the evaluation result.
42
36
 
43
37
  #### terminate
@@ -45,9 +45,6 @@ Evaluates a neural network using the worker process.
45
45
  The network is serialized and sent to the worker for evaluation. The worker
46
46
  sends back the evaluation result, which is returned as a promise.
47
47
 
48
- Parameters:
49
- - `` - - The neural network to evaluate. It must implement a `serialize` method.
50
-
51
48
  Returns: A promise that resolves to the evaluation result.
52
49
 
53
50
  #### terminate