morphogen 1.0.0__py3-none-any.whl

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 (381) hide show
  1. morphogen/__init__.py +60 -0
  2. morphogen/__main__.py +7 -0
  3. morphogen/_platform.py +55 -0
  4. morphogen/_public.py +153 -0
  5. morphogen/_utils.py +80 -0
  6. morphogen/_version.py +1 -0
  7. morphogen/analysis/__init__.py +174 -0
  8. morphogen/analysis/anisotropy.py +135 -0
  9. morphogen/analysis/basic.py +38 -0
  10. morphogen/analysis/cells.py +54 -0
  11. morphogen/analysis/connectivity.py +156 -0
  12. morphogen/analysis/correlation.py +195 -0
  13. morphogen/analysis/covariance.py +80 -0
  14. morphogen/analysis/fractal.py +54 -0
  15. morphogen/analysis/measures.py +188 -0
  16. morphogen/analysis/morphology.py +265 -0
  17. morphogen/analysis/particles.py +160 -0
  18. morphogen/analysis/percolation.py +2034 -0
  19. morphogen/analysis/power_laws.py +143 -0
  20. morphogen/analysis/random_sets.py +351 -0
  21. morphogen/analysis/stereology.py +289 -0
  22. morphogen/analysis/surface.py +107 -0
  23. morphogen/analysis/topology.py +92 -0
  24. morphogen/automata/__init__.py +74 -0
  25. morphogen/automata/engine.py +211 -0
  26. morphogen/automata/growth.py +686 -0
  27. morphogen/automata/lattice.py +143 -0
  28. morphogen/automata/reaction.py +255 -0
  29. morphogen/automata/rules.py +353 -0
  30. morphogen/automata/tilings.py +1715 -0
  31. morphogen/cli.py +3526 -0
  32. morphogen/config.py +2167 -0
  33. morphogen/contact/__init__.py +113 -0
  34. morphogen/contact/experiments.py +368 -0
  35. morphogen/contact/hertz.py +104 -0
  36. morphogen/contact/kernels.py +827 -0
  37. morphogen/contact/periodic.py +278 -0
  38. morphogen/contact/problem.py +578 -0
  39. morphogen/contact/surfaces.py +310 -0
  40. morphogen/coupling/__init__.py +43 -0
  41. morphogen/coupling/ageing.py +143 -0
  42. morphogen/coupling/diffusion.py +226 -0
  43. morphogen/coupling/fenicsx.py +484 -0
  44. morphogen/coupling/oxidation.py +447 -0
  45. morphogen/coupling/plates.py +247 -0
  46. morphogen/design/__init__.py +51 -0
  47. morphogen/design/csp.py +616 -0
  48. morphogen/design/frames.py +277 -0
  49. morphogen/design/search.py +287 -0
  50. morphogen/design/tiles.py +336 -0
  51. morphogen/distributions.py +312 -0
  52. morphogen/domain.py +203 -0
  53. morphogen/dynamics/__init__.py +179 -0
  54. morphogen/dynamics/model.py +638 -0
  55. morphogen/dynamics/openradioss.py +643 -0
  56. morphogen/dynamics/results.py +515 -0
  57. morphogen/fracture/__init__.py +170 -0
  58. morphogen/fracture/bulk.py +349 -0
  59. morphogen/fracture/cohesive.py +1614 -0
  60. morphogen/fracture/ductile.py +557 -0
  61. morphogen/fracture/lefm.py +1168 -0
  62. morphogen/fracture/mixed.py +1178 -0
  63. morphogen/fracture/periodic.py +733 -0
  64. morphogen/fracture/phasefield.py +714 -0
  65. morphogen/fracture/phasefield_finite.py +368 -0
  66. morphogen/fracture/surface.py +572 -0
  67. morphogen/fracture/toughness.py +566 -0
  68. morphogen/gpu.py +108 -0
  69. morphogen/gui/__init__.py +8 -0
  70. morphogen/gui/api.py +1927 -0
  71. morphogen/gui/desktop.py +387 -0
  72. morphogen/gui/icon.png +0 -0
  73. morphogen/gui/index.html +1909 -0
  74. morphogen/gui/server.py +229 -0
  75. morphogen/gui/tools/__init__.py +629 -0
  76. morphogen/gui/tools/compare.py +149 -0
  77. morphogen/gui/tools/contact.py +391 -0
  78. morphogen/gui/tools/couplings.py +1085 -0
  79. morphogen/gui/tools/crackfront.py +245 -0
  80. morphogen/gui/tools/design.py +224 -0
  81. morphogen/gui/tools/dynamics.py +824 -0
  82. morphogen/gui/tools/fracture.py +2586 -0
  83. morphogen/gui/tools/interop.py +1654 -0
  84. morphogen/gui/tools/learning.py +595 -0
  85. morphogen/gui/tools/mechanics.py +3881 -0
  86. morphogen/gui/tools/nonlocal_damage.py +1321 -0
  87. morphogen/gui/tools/phasefield.py +215 -0
  88. morphogen/gui/tools/physics.py +597 -0
  89. morphogen/gui/tools/stability.py +1756 -0
  90. morphogen/gui/tools/statistics.py +1408 -0
  91. morphogen/gui/viewer.js +1100 -0
  92. morphogen/homogenization/__init__.py +210 -0
  93. morphogen/homogenization/acoustics.py +566 -0
  94. morphogen/homogenization/amg.py +1005 -0
  95. morphogen/homogenization/apparent.py +1046 -0
  96. morphogen/homogenization/behaviours.cu +2285 -0
  97. morphogen/homogenization/behaviours.py +944 -0
  98. morphogen/homogenization/beremin.py +263 -0
  99. morphogen/homogenization/bifurcation.py +1085 -0
  100. morphogen/homogenization/bloch.py +507 -0
  101. morphogen/homogenization/bounds.py +226 -0
  102. morphogen/homogenization/core.py +458 -0
  103. morphogen/homogenization/coupled.py +1135 -0
  104. morphogen/homogenization/crystal.py +2967 -0
  105. morphogen/homogenization/dilatation.py +454 -0
  106. morphogen/homogenization/elements.py +157 -0
  107. morphogen/homogenization/fatigue.py +768 -0
  108. morphogen/homogenization/fe.py +1739 -0
  109. morphogen/homogenization/fenicsx.py +307 -0
  110. morphogen/homogenization/fft.py +499 -0
  111. morphogen/homogenization/fft_nonlinear.py +391 -0
  112. morphogen/homogenization/finite.py +613 -0
  113. morphogen/homogenization/flow.py +361 -0
  114. morphogen/homogenization/frames.py +1125 -0
  115. morphogen/homogenization/gpu.py +1241 -0
  116. morphogen/homogenization/harmonic.py +427 -0
  117. morphogen/homogenization/identification.py +579 -0
  118. morphogen/homogenization/kernels.py +760 -0
  119. morphogen/homogenization/laws.py +2061 -0
  120. morphogen/homogenization/materials.py +1080 -0
  121. morphogen/homogenization/mfront.py +589 -0
  122. morphogen/homogenization/networks.py +880 -0
  123. morphogen/homogenization/nonlinear.py +2612 -0
  124. morphogen/homogenization/ntfa.py +577 -0
  125. morphogen/homogenization/paths.py +476 -0
  126. morphogen/homogenization/photonic.py +467 -0
  127. morphogen/homogenization/poroelastic.py +212 -0
  128. morphogen/homogenization/porous.py +1120 -0
  129. morphogen/homogenization/postprocess.py +290 -0
  130. morphogen/homogenization/solvers.py +1140 -0
  131. morphogen/homogenization/tensors.py +240 -0
  132. morphogen/homogenization/voxel_fe.py +457 -0
  133. morphogen/homogenization/xfem.py +1016 -0
  134. morphogen/homogenization/zmat.py +1258 -0
  135. morphogen/iga/__init__.py +48 -0
  136. morphogen/iga/analysis.py +508 -0
  137. morphogen/iga/basis.py +214 -0
  138. morphogen/iga/geometry.py +501 -0
  139. morphogen/iga/homogenization.py +219 -0
  140. morphogen/iga/optimization.py +700 -0
  141. morphogen/iga/shapes.py +331 -0
  142. morphogen/image.py +128 -0
  143. morphogen/io/__init__.py +246 -0
  144. morphogen/io/amitex.py +741 -0
  145. morphogen/io/ebsd.py +881 -0
  146. morphogen/io/export.py +196 -0
  147. morphogen/io/geometry.py +158 -0
  148. morphogen/io/medit.py +147 -0
  149. morphogen/io/meshes.py +844 -0
  150. morphogen/io/metaimage.py +97 -0
  151. morphogen/io/mfront.py +1104 -0
  152. morphogen/io/native.py +57 -0
  153. morphogen/io/radioss.py +764 -0
  154. morphogen/io/solvers.py +371 -0
  155. morphogen/io/tables.py +278 -0
  156. morphogen/io/tiff.py +66 -0
  157. morphogen/io/vtk.py +701 -0
  158. morphogen/io/xdmf.py +200 -0
  159. morphogen/kernels/__init__.py +5 -0
  160. morphogen/kernels/annealing.py +192 -0
  161. morphogen/kernels/cells.py +69 -0
  162. morphogen/kernels/collective.py +87 -0
  163. morphogen/kernels/force_biased.py +595 -0
  164. morphogen/kernels/implicit.py +145 -0
  165. morphogen/kernels/leaves.py +132 -0
  166. morphogen/kernels/packing.py +304 -0
  167. morphogen/kernels/raster.py +279 -0
  168. morphogen/kernels/rsa.py +371 -0
  169. morphogen/kernels/union.py +135 -0
  170. morphogen/kernels/watershed.py +190 -0
  171. morphogen/laser/__init__.py +234 -0
  172. morphogen/laser/architectures.py +375 -0
  173. morphogen/laser/bending.py +216 -0
  174. morphogen/laser/cells.py +1694 -0
  175. morphogen/laser/design.py +940 -0
  176. morphogen/laser/figures.py +227 -0
  177. morphogen/laser/heat.py +804 -0
  178. morphogen/laser/materials.py +691 -0
  179. morphogen/laser/mechanics.py +1670 -0
  180. morphogen/laser/metallurgy.py +615 -0
  181. morphogen/laser/patterns.py +828 -0
  182. morphogen/laser/periodic.py +392 -0
  183. morphogen/laser/process.py +362 -0
  184. morphogen/laser/run.py +534 -0
  185. morphogen/laser/solid.py +216 -0
  186. morphogen/laser/specimen.py +200 -0
  187. morphogen/laser/structures.py +708 -0
  188. morphogen/learning/__init__.py +81 -0
  189. morphogen/learning/behaviour.py +398 -0
  190. morphogen/learning/data.py +328 -0
  191. morphogen/learning/learned.cpp +668 -0
  192. morphogen/learning/logarithmic.py +202 -0
  193. morphogen/learning/mfront.py +409 -0
  194. morphogen/learning/networks.py +767 -0
  195. morphogen/learning/run.py +212 -0
  196. morphogen/learning/standard.py +814 -0
  197. morphogen/learning/training.py +235 -0
  198. morphogen/mesh/__init__.py +29 -0
  199. morphogen/mesh/conforming.py +1423 -0
  200. morphogen/mesh/curved.py +600 -0
  201. morphogen/mesh/exact.py +1717 -0
  202. morphogen/mesh/octree.py +350 -0
  203. morphogen/mesh/polycrystal.py +1041 -0
  204. morphogen/mesh/polyhedra.py +677 -0
  205. morphogen/mesh/regularize.py +570 -0
  206. morphogen/mesh/surface.py +97 -0
  207. morphogen/mesh/tetra.py +512 -0
  208. morphogen/mesh/voxel.py +124 -0
  209. morphogen/micromorphic/__init__.py +31 -0
  210. morphogen/micromorphic/damage.py +359 -0
  211. morphogen/micromorphic/ductile.py +534 -0
  212. morphogen/micromorphic/finite.py +220 -0
  213. morphogen/micromorphic/microfoam.py +787 -0
  214. morphogen/micromorphic/space.py +341 -0
  215. morphogen/models/__init__.py +195 -0
  216. morphogen/models/affine.py +384 -0
  217. morphogen/models/automata.py +592 -0
  218. morphogen/models/base.py +500 -0
  219. morphogen/models/boolean.py +310 -0
  220. morphogen/models/bouligand.py +331 -0
  221. morphogen/models/branching.py +241 -0
  222. morphogen/models/combination.py +430 -0
  223. morphogen/models/deadleaves.py +766 -0
  224. morphogen/models/design.py +289 -0
  225. morphogen/models/ebsd.py +206 -0
  226. morphogen/models/fibers.py +1476 -0
  227. morphogen/models/foam.py +594 -0
  228. morphogen/models/gaussian.py +314 -0
  229. morphogen/models/growth.py +459 -0
  230. morphogen/models/hardcore.py +317 -0
  231. morphogen/models/hierarchical.py +269 -0
  232. morphogen/models/honeycomb.py +749 -0
  233. morphogen/models/implicit.py +177 -0
  234. morphogen/models/laminate.py +470 -0
  235. morphogen/models/lattice.py +351 -0
  236. morphogen/models/lattice_field.py +345 -0
  237. morphogen/models/levelset_foam.py +563 -0
  238. morphogen/models/nacre.py +411 -0
  239. morphogen/models/nested.py +924 -0
  240. morphogen/models/osteons.py +374 -0
  241. morphogen/models/pieces.py +167 -0
  242. morphogen/models/planar.py +126 -0
  243. morphogen/models/reconstruction.py +203 -0
  244. morphogen/models/scale_rich.py +1409 -0
  245. morphogen/models/scale_rich_3d.py +1616 -0
  246. morphogen/models/tessellation.py +735 -0
  247. morphogen/models/tiling_field.py +302 -0
  248. morphogen/models/tpms.py +197 -0
  249. morphogen/models/transparent.py +406 -0
  250. morphogen/models/union.py +141 -0
  251. morphogen/optimization/__init__.py +43 -0
  252. morphogen/optimization/cell.py +295 -0
  253. morphogen/optimization/filters.py +115 -0
  254. morphogen/optimization/mma.py +226 -0
  255. morphogen/optimization/run.py +219 -0
  256. morphogen/optimization/topology.py +632 -0
  257. morphogen/orientations.py +568 -0
  258. morphogen/parallel.py +599 -0
  259. morphogen/pipeline.py +978 -0
  260. morphogen/primitives.py +188 -0
  261. morphogen/results.py +564 -0
  262. morphogen/rve/__init__.py +73 -0
  263. morphogen/rve/report.py +627 -0
  264. morphogen/rve/scaling.py +363 -0
  265. morphogen/rve/study.py +1054 -0
  266. morphogen/rve/windows.py +345 -0
  267. morphogen/seeding.py +51 -0
  268. morphogen/settings.py +118 -0
  269. morphogen/stopping.py +48 -0
  270. morphogen/symmetry.py +384 -0
  271. morphogen/templates/activator_inhibitor.yaml +22 -0
  272. morphogen/templates/aggregation.yaml +23 -0
  273. morphogen/templates/boolean_cylinders.yaml +20 -0
  274. morphogen/templates/boolean_spheres.yaml +22 -0
  275. morphogen/templates/bouligand.yaml +28 -0
  276. morphogen/templates/cellular_automaton.yaml +25 -0
  277. morphogen/templates/coated_spheres.yaml +26 -0
  278. morphogen/templates/contact_fibers.yaml +27 -0
  279. morphogen/templates/cox_nanocomposite.yaml +22 -0
  280. morphogen/templates/cross_linked_fibers.yaml +26 -0
  281. morphogen/templates/curved_arcs.yaml +28 -0
  282. morphogen/templates/curved_fibers.yaml +24 -0
  283. morphogen/templates/dead_leaves.yaml +22 -0
  284. morphogen/templates/delaunay_network.yaml +22 -0
  285. morphogen/templates/dense_packing.yaml +22 -0
  286. morphogen/templates/diffusion.yaml +33 -0
  287. morphogen/templates/ebsd.yaml +34 -0
  288. morphogen/templates/ebsd_map.ctf +3087 -0
  289. morphogen/templates/fracture_composite.yaml +42 -0
  290. morphogen/templates/fracture_rubber.yaml +47 -0
  291. morphogen/templates/gaussian_excursion.yaml +17 -0
  292. morphogen/templates/graded_lattice.yaml +24 -0
  293. morphogen/templates/hardcore_fibers.yaml +22 -0
  294. morphogen/templates/hardcore_spheres.yaml +22 -0
  295. morphogen/templates/hierarchical_lattice.yaml +22 -0
  296. morphogen/templates/homogenization_acoustic_foam.yaml +36 -0
  297. morphogen/templates/homogenization_beremin.yaml +50 -0
  298. morphogen/templates/homogenization_cleavage.yaml +51 -0
  299. morphogen/templates/homogenization_cleavage_band.yaml +55 -0
  300. morphogen/templates/homogenization_contact.yaml +43 -0
  301. morphogen/templates/homogenization_crack_closure.yaml +49 -0
  302. morphogen/templates/homogenization_crystal_plasticity.yaml +50 -0
  303. morphogen/templates/homogenization_crystal_plasticity_fft.yaml +52 -0
  304. morphogen/templates/homogenization_crystallization.yaml +30 -0
  305. morphogen/templates/homogenization_debonding.yaml +43 -0
  306. morphogen/templates/homogenization_detwinning.yaml +58 -0
  307. morphogen/templates/homogenization_ductile_damage.yaml +47 -0
  308. morphogen/templates/homogenization_fatigue.yaml +40 -0
  309. morphogen/templates/homogenization_grain_fracture.yaml +56 -0
  310. morphogen/templates/homogenization_gyroid.yaml +30 -0
  311. morphogen/templates/homogenization_intergranular.yaml +43 -0
  312. morphogen/templates/homogenization_interphase.yaml +42 -0
  313. morphogen/templates/homogenization_mixed_loading.yaml +33 -0
  314. morphogen/templates/homogenization_ntfa.yaml +56 -0
  315. morphogen/templates/homogenization_piezoelectric.yaml +27 -0
  316. morphogen/templates/homogenization_polycrystal.yaml +30 -0
  317. morphogen/templates/homogenization_polycrystal_inclusions.yaml +30 -0
  318. morphogen/templates/homogenization_poroelastic.yaml +26 -0
  319. morphogen/templates/homogenization_rubber.yaml +40 -0
  320. morphogen/templates/homogenization_slip_cleavage.yaml +50 -0
  321. morphogen/templates/homogenization_spheres.yaml +31 -0
  322. morphogen/templates/homogenization_transport.yaml +29 -0
  323. morphogen/templates/homogenization_twinning.yaml +54 -0
  324. morphogen/templates/homogenization_viscoelastic.yaml +34 -0
  325. morphogen/templates/homogenization_viscoplastic.yaml +42 -0
  326. morphogen/templates/homogenization_voronoi.yaml +26 -0
  327. morphogen/templates/homogenization_xfem.yaml +23 -0
  328. morphogen/templates/hyperuniform_cells.yaml +24 -0
  329. morphogen/templates/laguerre.yaml +18 -0
  330. morphogen/templates/laser_bending.yaml +35 -0
  331. morphogen/templates/laser_cells.yaml +38 -0
  332. morphogen/templates/laser_corrugated.yaml +36 -0
  333. morphogen/templates/level_set_foam.yaml +29 -0
  334. morphogen/templates/menger_sponge.yaml +17 -0
  335. morphogen/templates/nacre.yaml +25 -0
  336. morphogen/templates/nucleation_growth.yaml +25 -0
  337. morphogen/templates/optimize_auxetic.yaml +29 -0
  338. morphogen/templates/optimize_auxetic_3d.yaml +27 -0
  339. morphogen/templates/optimize_bulk.yaml +23 -0
  340. morphogen/templates/optimize_conductivity.yaml +20 -0
  341. morphogen/templates/osteons.yaml +28 -0
  342. morphogen/templates/penetrable_spheres.yaml +21 -0
  343. morphogen/templates/poisson_fibers.yaml +21 -0
  344. morphogen/templates/random_laminate.yaml +26 -0
  345. morphogen/templates/random_lattice.yaml +27 -0
  346. morphogen/templates/random_walk_fibers.yaml +26 -0
  347. morphogen/templates/reaction_diffusion.yaml +22 -0
  348. morphogen/templates/reconstruction.yaml +22 -0
  349. morphogen/templates/rve_cellular_automaton.yaml +23 -0
  350. morphogen/templates/rve_crystal_plasticity_fft.yaml +51 -0
  351. morphogen/templates/rve_multiphysics.yaml +43 -0
  352. morphogen/templates/rve_poisson_fibers.yaml +22 -0
  353. morphogen/templates/rve_poisson_fibers_fe.yaml +33 -0
  354. morphogen/templates/rve_voronoi_windows.yaml +20 -0
  355. morphogen/templates/scale_rich_network.yaml +29 -0
  356. morphogen/templates/scale_rich_plates.yaml +30 -0
  357. morphogen/templates/sequential_dead_leaves.yaml +25 -0
  358. morphogen/templates/strut_lattice.yaml +21 -0
  359. morphogen/templates/tile_assembly.yaml +28 -0
  360. morphogen/templates/tpms.yaml +19 -0
  361. morphogen/templates/trabecular_bone.yaml +29 -0
  362. morphogen/templates/transparent_dead_leaves.yaml +23 -0
  363. morphogen/templates/vascular_tree.yaml +23 -0
  364. morphogen/templates/voronoi.yaml +20 -0
  365. morphogen/templates/wood.yaml +34 -0
  366. morphogen/templates/workflow.yaml +56 -0
  367. morphogen/texture.py +665 -0
  368. morphogen/theory.py +162 -0
  369. morphogen/viz/__init__.py +12 -0
  370. morphogen/viz/export.py +244 -0
  371. morphogen/viz/figures.py +707 -0
  372. morphogen/viz/png.py +148 -0
  373. morphogen/viz/sections.py +696 -0
  374. morphogen/viz/surfaces.py +1352 -0
  375. morphogen/viz/video.py +904 -0
  376. morphogen/viz/workflow.py +488 -0
  377. morphogen-1.0.0.dist-info/METADATA +2316 -0
  378. morphogen-1.0.0.dist-info/RECORD +381 -0
  379. morphogen-1.0.0.dist-info/WHEEL +4 -0
  380. morphogen-1.0.0.dist-info/entry_points.txt +5 -0
  381. morphogen-1.0.0.dist-info/licenses/LICENSE +674 -0
@@ -0,0 +1,235 @@
1
+ """Training of the models: Adam on mini-batches, early stopping on a validation set.
2
+
3
+ The parameters follow Adam (Kingma & Ba 2015) on the gradients of mini-batches of the
4
+ training set (points, or whole paths for a recurrent model), shuffled at each epoch;
5
+ the global norm of a gradient is clipped to ``clip``, the learning rate falls
6
+ geometrically from ``learning_rate`` to ``final`` times it over the epochs. The
7
+ parameters kept are those of the least loss of the validation set (of the training set
8
+ without one); the training stops after ``patience`` epochs without a better one. The
9
+ seeds of the initial parameters (the model's) and of the shuffles (the training's)
10
+ make it reproducible. The mini-batches may be turned at each epoch by the symmetries of
11
+ the behaviour: uniform rotations (isotropic behaviours) or the 24 rotations of the cube (a
12
+ cubic crystal in its axes), data that the behaviour gives without more responses.
13
+ """
14
+
15
+ from __future__ import annotations
16
+
17
+ import copy
18
+ import itertools
19
+ import time
20
+ from collections.abc import Callable
21
+ from dataclasses import dataclass, field
22
+
23
+ import numpy as np
24
+
25
+ from morphogen.learning.data import Dataset, _tensor, _voigt
26
+ from morphogen.learning.networks import Model
27
+
28
+
29
+ @dataclass
30
+ class Training:
31
+ """A training: the model (its parameters those of the best epoch), the losses of the
32
+ training and validation sets at each epoch (mean squares of the gaps of the
33
+ normalized stresses), the best epoch, whether it stopped early, its time."""
34
+
35
+ model: Model
36
+ train_loss: list[float] = field(default_factory=list)
37
+ validation_loss: list[float] = field(default_factory=list)
38
+ best_epoch: int = -1
39
+ stopped: bool = False
40
+ time_s: float = 0.0
41
+
42
+ @property
43
+ def epochs(self) -> int:
44
+ return len(self.train_loss)
45
+
46
+ @property
47
+ def best_loss(self) -> float:
48
+ return float(self.validation_loss[self.best_epoch])
49
+
50
+ def summary(self) -> dict:
51
+ return {"epochs": self.epochs, "best_epoch": self.best_epoch,
52
+ "train_loss": float(self.train_loss[self.best_epoch]),
53
+ "validation_loss": self.best_loss, "stopped": self.stopped,
54
+ "time_s": round(self.time_s, 3)} # fmt: skip
55
+
56
+
57
+ def rotations(n: int, rng) -> np.ndarray:
58
+ """``n`` rotation matrices drawn uniformly (n, 3, 3): the QR decompositions of Gaussian
59
+ matrices, the signs of the diagonals of R taken out, the determinants made positive."""
60
+ q, r = np.linalg.qr(rng.normal(size=(n, 3, 3)))
61
+ q = q * np.sign(np.diagonal(r, axis1=1, axis2=2))[:, None, :]
62
+ q[:, :, 0] *= np.sign(np.linalg.det(q))[:, None]
63
+ return q
64
+
65
+
66
+ def cubic_rotations() -> np.ndarray:
67
+ """The 24 rotations of the cube (24, 3, 3): the signed permutation matrices of
68
+ determinant 1, the proper symmetries of a cubic crystal in its axes."""
69
+ out = []
70
+ for perm in itertools.permutations(range(3)):
71
+ for signs in itertools.product((1.0, -1.0), repeat=3):
72
+ m = np.zeros((3, 3))
73
+ m[range(3), perm] = signs
74
+ if np.linalg.det(m) > 0:
75
+ out.append(m)
76
+ return np.array(out)
77
+
78
+
79
+ #: The symmetries the mini-batches may be turned by (``rotate`` of :func:`train`)
80
+ SYMMETRIES = ("isotropic", "cubic")
81
+
82
+
83
+ def _symmetry(rotate):
84
+ """The rotations of ``rotate``: None (none), "isotropic" (uniform: True) or the group
85
+ of the cube (``"cubic"``)."""
86
+ if rotate in (False, None, "none"):
87
+ return None
88
+ if rotate is True or rotate == "isotropic":
89
+ return "isotropic"
90
+ if rotate == "cubic":
91
+ return cubic_rotations()
92
+ raise ValueError(f"rotate: false, true or one of {', '.join(SYMMETRIES)}, got {rotate!r}")
93
+
94
+
95
+ def voigt_rotations(rot) -> tuple[np.ndarray, np.ndarray]:
96
+ """The 6 x 6 matrices (n, 6, 6) that turn the Voigt components of strains (engineering
97
+ shears) and of stresses by rotations ``rot`` (n, 3, 3): ``R t R^T``."""
98
+ eye = np.eye(6)
99
+ out = []
100
+ for engineering in (True, False):
101
+ basis = _tensor(eye, engineering) # (6, 3, 3): the tensors of the components
102
+ turned = np.einsum("nij,kjl,nml->nkim", rot, basis, rot)
103
+ out.append(np.swapaxes(_voigt(turned, engineering), 1, 2))
104
+ return out[0], out[1]
105
+
106
+
107
+ def rotated(data: Dataset, rng, points: bool = False) -> Dataset:
108
+ """The paths of ``data`` each turned by a random rotation (each point, with
109
+ ``points``): the responses of an isotropic behaviour along the turned paths."""
110
+ n = data.n_paths * (data.n_points if points else 1)
111
+ te, ts = voigt_rotations(rotations(n, rng))
112
+ shape = (data.n_paths, data.n_points if points else 1, 6, 6)
113
+ te, ts = te.reshape(shape), ts.reshape(shape)
114
+ strain = np.einsum("ptij,ptj->pti", te, data.strain)
115
+ stress = np.einsum("ptij,ptj->pti", ts, data.stress)
116
+ return Dataset(data.times, strain, stress, data.measure, data.info)
117
+
118
+
119
+ def _turned(model: Model, arrays, rng, group="isotropic") -> tuple:
120
+ """A mini-batch of normalized arrays (:meth:`~morphogen.learning.networks.Model.
121
+ prepare`) turned by a random rotation per sample (a point, or a path): uniform, or of
122
+ the rotations ``group`` (n, 3, 3); the scales are scalars, the rotations act on the
123
+ normalized strains, increments and stresses."""
124
+ n = arrays[0].shape[0]
125
+ rot = rotations(n, rng) if isinstance(group, str) else group[rng.integers(len(group), size=n)]
126
+ te, ts = voigt_rotations(rot)
127
+ if not model.recurrent:
128
+ x, y = arrays
129
+ return np.einsum("nij,nj->ni", te, x), np.einsum("nij,nj->ni", ts, y)
130
+ if model.kind == "standard": # the strains, the time steps, the stresses
131
+ x, dt, y = arrays
132
+ return np.einsum("nij,ntj->nti", te, x), dt, np.einsum("nij,ntj->nti", ts, y)
133
+ u, x, y = arrays
134
+ u = u.copy()
135
+ u[..., :6] = np.einsum("nij,ntj->nti", te, u[..., :6])
136
+ u[..., 6:12] = np.einsum("nij,ntj->nti", te, u[..., 6:12])
137
+ return u, np.einsum("nij,ntj->nti", te, x), np.einsum("nij,ntj->nti", ts, y)
138
+
139
+
140
+ def train(
141
+ model: Model,
142
+ data: Dataset,
143
+ validation: Dataset | None = None,
144
+ *,
145
+ epochs: int = 200,
146
+ batch: int = 32,
147
+ learning_rate: float = 0.01,
148
+ final: float = 0.1,
149
+ patience: int | None = None,
150
+ clip: float = 1.0,
151
+ rotate: bool | str = False,
152
+ seed: int = 0,
153
+ callback: Callable[[int, float, float], None] | None = None,
154
+ ) -> Training:
155
+ """Train ``model`` on ``data`` (see the module), set up on them first when it has no
156
+ parameters; ``validation``: the paths of the early stopping. With ``rotate`` (true or
157
+ ``"isotropic"``: an isotropic behaviour), each mini-batch of paths is turned by random
158
+ rotations at each epoch (:func:`rotated`): the data of every direction, without more
159
+ responses; with ``"cubic"`` (a cubic crystal, its data in its axes), by random
160
+ rotations of the cube (:func:`cubic_rotations`). ``callback(epoch, train_loss,
161
+ validation_loss)`` after each epoch (it may raise :class:`~morphogen.stopping.
162
+ Stopped`)."""
163
+ if int(epochs) < 1 or int(batch) < 1 or not learning_rate > 0 or not 0 < final <= 1:
164
+ raise ValueError("epochs, batch: at least one; learning_rate positive; final in (0, 1]")
165
+ group = _symmetry(rotate)
166
+ if data.measure != model.measure and model.ready:
167
+ raise ValueError(f"data in {data.measure} strains, the model in {model.measure}")
168
+ t0 = time.perf_counter()
169
+ if not model.ready:
170
+ model.setup(data)
171
+ arrays = model.prepare(data)
172
+ checks = model.prepare(validation) if validation is not None else None
173
+ n = arrays[0].shape[0]
174
+ rng = np.random.default_rng(seed)
175
+ first = {k: np.zeros_like(v) for k, v in model.params.items()}
176
+ second = {k: np.zeros_like(v) for k, v in model.params.items()}
177
+ beta1, beta2, eps = 0.9, 0.999, 1e-8
178
+ out = Training(model)
179
+ best, kept, wait, count = np.inf, copy.deepcopy(model.params), 0, 0
180
+ for epoch in range(int(epochs)):
181
+ rate = learning_rate * final ** (epoch / max(int(epochs) - 1, 1))
182
+ order = rng.permutation(n)
183
+ total = 0.0
184
+ for start in range(0, n, int(batch)):
185
+ idx = order[start : start + int(batch)]
186
+ sub = tuple(a[idx] for a in arrays)
187
+ if group is not None:
188
+ sub = _turned(model, sub, rng, group)
189
+ loss, grads = model.objective(sub)
190
+ total += loss * idx.size
191
+ norm = np.sqrt(sum(float(np.sum(g * g)) for g in grads.values()))
192
+ factor = min(1.0, clip / norm) if clip and norm > 0 else 1.0
193
+ count += 1
194
+ c1, c2 = 1.0 - beta1**count, 1.0 - beta2**count
195
+ for k, g in grads.items():
196
+ g = g * factor
197
+ first[k] = beta1 * first[k] + (1.0 - beta1) * g
198
+ second[k] = beta2 * second[k] + (1.0 - beta2) * g * g
199
+ model.params[k] = model.params[k] - rate * (first[k] / c1) / (
200
+ np.sqrt(second[k] / c2) + eps
201
+ )
202
+ out.train_loss.append(total / n)
203
+ check = model.objective(checks, grad=False)[0] if checks is not None else total / n
204
+ out.validation_loss.append(float(check))
205
+ if callback is not None:
206
+ callback(epoch, out.train_loss[-1], float(check))
207
+ if check < best:
208
+ best, kept, wait, out.best_epoch = check, copy.deepcopy(model.params), 0, epoch
209
+ else:
210
+ wait += 1
211
+ if patience is not None and wait >= int(patience):
212
+ out.stopped = True
213
+ break
214
+ model.params = kept
215
+ out.time_s = time.perf_counter() - t0
216
+ model.metadata["training"] = out.summary()
217
+ return out
218
+
219
+
220
+ def errors(model: Model, data: Dataset) -> dict:
221
+ """The gaps of the stresses of ``model`` to those of ``data``: relative to the root
222
+ mean square of the stresses of each path (``paths``: one per path; their ``mean`` and
223
+ ``max``) and of all (``relative``), and the root mean square of the gaps (``rmse``,
224
+ in the units of the stresses). A recurrent model runs each path from its natural
225
+ state."""
226
+ if model.recurrent:
227
+ predicted = model.predict(data.strain, data.times)
228
+ else:
229
+ predicted = model.predict(data.strain)
230
+ gap = np.sum((predicted - data.stress) ** 2, axis=-1)
231
+ norm = np.sum(data.stress**2, axis=-1)
232
+ paths = np.sqrt(gap.sum(axis=1) / np.maximum(norm.sum(axis=1), 1e-300))
233
+ return {"relative": float(np.sqrt(gap.sum() / max(norm.sum(), 1e-300))),
234
+ "mean": float(paths.mean()), "max": float(paths.max()),
235
+ "rmse": float(np.sqrt(gap.mean() / 6.0)), "paths": paths.tolist()} # fmt: skip
@@ -0,0 +1,29 @@
1
+ """Meshes: conforming tetrahedral meshes of implicit morphologies (MMG), with 4-node or
2
+ 10-node elements whose curved edges follow the interfaces, exact meshes without a
3
+ background grid, voxel hexahedra and surface meshes (marching cubes)."""
4
+
5
+ from morphogen.mesh.conforming import ImplicitBody, conforming_mesh, mirrored_mesh, mmg_executable
6
+ from morphogen.mesh.curved import curved_mesh
7
+ from morphogen.mesh.exact import adaptive_mesh, exact_mesh, exact_route, polyhedral_mesh
8
+ from morphogen.mesh.surface import SurfaceMesh, surface_mesh
9
+ from morphogen.mesh.tetra import TetMesh
10
+ from morphogen.mesh.voxel import HEX_CORNERS, HEX_FACES, VoxelMesh, voxel_mesh
11
+
12
+ __all__ = [
13
+ "HEX_CORNERS",
14
+ "HEX_FACES",
15
+ "ImplicitBody",
16
+ "SurfaceMesh",
17
+ "TetMesh",
18
+ "VoxelMesh",
19
+ "adaptive_mesh",
20
+ "conforming_mesh",
21
+ "curved_mesh",
22
+ "exact_mesh",
23
+ "exact_route",
24
+ "mirrored_mesh",
25
+ "mmg_executable",
26
+ "polyhedral_mesh",
27
+ "surface_mesh",
28
+ "voxel_mesh",
29
+ ]