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,212 @@
1
+ """Learning from a configuration (``morphogen learn``): the data of a behaviour at a
2
+ material point or of a microstructure along random paths, the training of a model, its
3
+ errors on the validation paths and on named paths that the learned law runs at a
4
+ material point against the reference, the files of the model and of the data.
5
+
6
+ A configuration (a mapping, or its ``learning`` mapping)::
7
+
8
+ material: {young: 200000, poisson: 0.3, plasticity: {yield: 200, hardening: 10000}}
9
+ # or a microstructure: sample: image.npy, materials: {0: ..., 1: ...}, bc: periodic
10
+ kinematics: small
11
+ data: {paths: 128, segments: 4, increments: 8, amplitude: 0.01, volumetric: 0.2,
12
+ kind: walk, components: null, free: false, rate: null, seed: 0,
13
+ validation: 0.25}
14
+ model: {kind: recurrent, hidden: 32, rate: false, seed: 0} # or kind: standard, internal: 8
15
+ # (and strain: logarithmic or green-lagrange, the strain a model sees in finite strains)
16
+ training: {epochs: 300, batch: 16, learning_rate: 0.01, final: 0.1, patience: null,
17
+ clip: 1.0, rotate: false, seed: 0}
18
+ paths: {cycle: "t=0,1,3 n=8,16 E11=0,0.01,-0.01"}
19
+ output: model.npz
20
+ save_data: data.npz
21
+
22
+ ``data`` are the options of :func:`~morphogen.learning.data.random_paths` and the fraction
23
+ of validation paths, ``model`` those of :func:`~morphogen.learning.networks.make_model`
24
+ (``hidden`` by default 32, or two layers of 32; ``internal``, the internal variables of a
25
+ ``standard`` model, by default 8; ``strain``, the strain that a model of any kind sees in
26
+ finite strains: ``logarithmic``, the default, ``1/2 ln C`` and its conjugate stress, or
27
+ ``green-lagrange``, ``E`` and ``S``), ``training`` those of
28
+ :func:`~morphogen.learning.training.train` (``rotate``: true for isotropic behaviours,
29
+ ``cubic`` for a cubic crystal in its axes). The learned law of a crystal runs in the axes
30
+ of its material, turned by the orientation of each grain (``learned: {model: ...,
31
+ oriented: true}``, the default); the elastic constants and the thermal expansion of a
32
+ reference material go to its learned material.
33
+ """
34
+
35
+ from __future__ import annotations
36
+
37
+ import math
38
+ from collections.abc import Callable
39
+ from pathlib import Path
40
+
41
+ import numpy as np
42
+
43
+ from morphogen.homogenization.paths import LoadingPath
44
+ from morphogen.learning.behaviour import learned_material
45
+ from morphogen.learning.data import generate, random_paths, responder
46
+ from morphogen.learning.networks import Model, make_model
47
+ from morphogen.learning.training import errors, train
48
+
49
+ #: The keys of a configuration, and the defaults of its sections
50
+ KEYS = ("material", "sample", "materials", "bc", "kinematics", "data", "model", "training",
51
+ "paths", "output", "save_data") # fmt: skip
52
+ DATA = {"paths": 128, "segments": 4, "increments": 8, "amplitude": 0.01, "volumetric": 0.2,
53
+ "kind": "walk", "components": None, "free": False, "rate": None, "seed": 0,
54
+ "validation": 0.25} # fmt: skip
55
+ MODEL = {"kind": "recurrent", "hidden": None, "rate": False, "internal": None, "strain": None,
56
+ "seed": 0} # fmt: skip
57
+ TRAINING = {"epochs": 300, "batch": 16, "learning_rate": 0.01, "final": 0.1, "patience": None,
58
+ "clip": 1.0, "rotate": False, "seed": 0} # fmt: skip
59
+
60
+
61
+ def _section(cfg: dict, name: str, defaults: dict) -> dict:
62
+ given = cfg.get(name) or {}
63
+ if not isinstance(given, dict):
64
+ raise ValueError(f"learning.{name}: a mapping")
65
+ unknown = sorted(set(given) - set(defaults))
66
+ if unknown:
67
+ raise ValueError(f"learning.{name}: unknown keys {unknown}; allowed {sorted(defaults)}")
68
+ return {**defaults, **given}
69
+
70
+
71
+ def source_of(cfg: dict, base=None, kinematics: str = "small") -> Callable:
72
+ """The response to a path of the ``material`` (a material point) or of the ``sample``
73
+ (a voxel image, relative to ``base``) of ``materials`` (the FFT solver of the paths,
74
+ under the boundary condition ``bc``) of a configuration."""
75
+ if ("material" in cfg) == ("sample" in cfg):
76
+ raise ValueError("learning: give a material (a material point) or a sample (an image)")
77
+ if "material" in cfg:
78
+ return responder(cfg["material"], kinematics)
79
+ from morphogen import io
80
+ from morphogen.homogenization import materials_from_config
81
+ from morphogen.homogenization.fft_nonlinear import NonlinearFFTProblem
82
+
83
+ if "materials" not in cfg:
84
+ raise ValueError("learning.sample: give the materials of its phases")
85
+ sample = Path(cfg["sample"])
86
+ image = io.load_image(sample if base is None or sample.is_absolute() else Path(base) / sample)
87
+ problem = NonlinearFFTProblem(image, materials_from_config(cfg["materials"]),
88
+ cfg.get("bc", "periodic"), kinematics=kinematics) # fmt: skip
89
+ return problem.run
90
+
91
+
92
+ def _at(result, key: str, times) -> np.ndarray:
93
+ """The strains or stresses (``key``) of a response at ``times`` (times x 6)."""
94
+ values = np.asarray(getattr(result, key))
95
+ return np.array([np.interp(times, result.times, values[:, c]) for c in range(6)]).T
96
+
97
+
98
+ def reference_elasticity(source) -> dict:
99
+ """The elastic constants of a reference material (young, poisson), for the linear
100
+ problems and the reference media of its learned law, and its thermal expansion; none
101
+ of a microstructure, nor the constants of a crystal (the learned law then takes those
102
+ of its initial tangent)."""
103
+ from morphogen.homogenization.materials import Material
104
+
105
+ if callable(source) and not isinstance(source, (dict, Material)):
106
+ return {}
107
+ reference = Material.from_config(source)
108
+ out = {}
109
+ if reference.young is not None:
110
+ out = {"young": reference.young, "poisson": reference.poisson}
111
+ if reference.expands:
112
+ out["expansion"] = reference.expansion
113
+ return out
114
+
115
+
116
+ def compare_path(material, respond, path, kinematics: str = "small", orientation=None) -> tuple:
117
+ """The response of the reference ``respond`` along ``path`` (a
118
+ :class:`~morphogen.homogenization.paths.LoadingPath`), that of the learned ``material``
119
+ at a material point (turned by ``orientation``, Bunge angles; None where it fails) and
120
+ their gaps, a row of :func:`path_errors`."""
121
+ from morphogen.homogenization.nonlinear import simulate_point
122
+
123
+ ref = respond(path)
124
+ try: # a learned law may have no solution for the stresses prescribed
125
+ got = simulate_point(material, path, kinematics=kinematics, orientation=orientation,
126
+ max_cuts=4) # fmt: skip
127
+ except RuntimeError as exc:
128
+ return ref, None, {"stress": math.inf, "strain": math.inf, "failed": str(exc)}
129
+ times = np.concatenate([[path.times[0]], path.schedule()])
130
+ row = {}
131
+ for key in ("stress", "strain"):
132
+ a, b = _at(got, key, times), _at(ref, key, times)
133
+ row[key] = float(np.sqrt(np.sum((a - b) ** 2) / max(np.sum(b**2), 1e-300)))
134
+ row["final_stress"] = np.asarray(got.stress)[-1].tolist()
135
+ row["reference_stress"] = np.asarray(ref.stress)[-1].tolist()
136
+ return ref, got, row
137
+
138
+
139
+ def path_errors(model, source, paths, kinematics: str = "small", orientation=None) -> dict:
140
+ """The gaps of the learned law of ``model`` at a material point to the responses of
141
+ ``source`` (:func:`~morphogen.learning.data.responder`) along named ``paths`` (name ->
142
+ path, its specification or its text): the root mean square of the gaps of the stresses
143
+ (of the strains) relative to that of the stresses (of the strains) of the reference
144
+ at the planned steps, and the final stresses of both; infinite gaps and the message
145
+ where the learned law fails (no solution for the stresses prescribed, after four
146
+ divisions of a step). The learned material takes the elastic constants of a
147
+ reference material (else those of its initial tangent); ``orientation`` (Bunge
148
+ angles) turns both, a crystal and its law learned in its axes."""
149
+ respond = responder(source, kinematics, orientation)
150
+ material = learned_material(model, **reference_elasticity(source))
151
+ out = {}
152
+ for name, spec in dict(paths).items():
153
+ path = LoadingPath.parse(spec) if isinstance(spec, str) else LoadingPath.from_spec(spec)
154
+ out[str(name)] = compare_path(material, respond, path, kinematics, orientation)[2]
155
+ return out
156
+
157
+
158
+ def learn(
159
+ config: dict, base=None, *, callback=None, model: Model | None = None
160
+ ) -> tuple[Model, dict]:
161
+ """Learn the behaviour of a configuration (see the module): the trained model (or
162
+ ``model``, trained further) and the summary of the data, of the training, of its
163
+ errors and of the files written (relative to ``base``). ``callback``: that of
164
+ :func:`~morphogen.learning.training.train`."""
165
+ cfg = config.get("learning", config) if isinstance(config, dict) else None
166
+ if not isinstance(cfg, dict):
167
+ raise ValueError("learning: a mapping")
168
+ unknown = sorted(set(cfg) - set(KEYS))
169
+ if unknown:
170
+ raise ValueError(f"learning: unknown keys {unknown}; allowed {sorted(KEYS)}")
171
+ kinematics = cfg.get("kinematics", "small")
172
+ base = None if base is None else Path(base)
173
+ data_opts = _section(cfg, "data", DATA)
174
+ model_opts = _section(cfg, "model", MODEL)
175
+ training = _section(cfg, "training", TRAINING)
176
+ source = source_of(cfg, base, kinematics)
177
+ validation = float(data_opts.pop("validation"))
178
+ count = int(data_opts.pop("paths"))
179
+ paths = random_paths(count, **data_opts)
180
+ info = {"source": cfg.get("material") or {"sample": str(cfg["sample"])},
181
+ "kinematics": kinematics, "paths": {"count": count, **data_opts}} # fmt: skip
182
+ data = generate(source, paths, kinematics=kinematics, info=info)
183
+ train_set, valid = data.split(validation, seed=int(data_opts["seed"]))
184
+ if model is None:
185
+ kind = model_opts.pop("kind")
186
+ hidden = model_opts.pop("hidden")
187
+ if kind not in ("recurrent", "standard"):
188
+ model_opts.pop("rate")
189
+ if hidden is not None:
190
+ model_opts["hidden"] = hidden
191
+ for key in ("internal", "strain"):
192
+ value = model_opts.pop(key)
193
+ if value is not None:
194
+ if key == "internal" and kind != "standard":
195
+ raise ValueError("learning.model.internal: the internal variables of a "
196
+ "standard model only") # fmt: skip
197
+ model_opts[key] = value
198
+ model = make_model(kind, **model_opts)
199
+ model.metadata["data"] = info
200
+ fit = train(model, train_set, valid, callback=callback, **training)
201
+ out = {"model": model.kind, "options": model.options, "paths": data.n_paths,
202
+ "points": data.n_points, "training": fit.summary()} # fmt: skip
203
+ out["validation"] = {k: v for k, v in errors(model, valid).items() if k != "paths"}
204
+ model.metadata["validation"] = out["validation"]
205
+ if cfg.get("paths"):
206
+ out["tests"] = path_errors(model, source, cfg["paths"], kinematics)
207
+ for key, write in (("output", model.save), ("save_data", data.save)):
208
+ if cfg.get(key):
209
+ target = Path(cfg[key])
210
+ target = target if base is None or target.is_absolute() else base / target
211
+ out[key] = str(write(target))
212
+ return model, out