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,328 @@
1
+ """Training data: random strain paths and the responses of a behaviour along them.
2
+
3
+ A path starts from the natural state and joins ``segments`` random strains linearly, each
4
+ segment in ``increments`` steps: a random walk (each strain the previous one plus a
5
+ random step, held within the amplitude) or independent strains (each component uniform
6
+ within the amplitude). The volumetric part of the strains is scaled by ``volumetric``:
7
+ the volumetric strains of metals are elastic and small, those of porous media are not.
8
+ The responses come from a material point (:func:`~morphogen.homogenization.nonlinear.
9
+ simulate_point`) or from any solver of the paths of a microstructure (the homogenized
10
+ response of :class:`~morphogen.homogenization.fft_nonlinear.NonlinearFFTProblem` or of
11
+ :class:`~morphogen.homogenization.nonlinear.NonlinearFEProblem`), at the planned steps
12
+ of each path (the steps that a solver divides are dropped).
13
+
14
+ In small strains the data are the strain (engineering shears) and the stress; in finite
15
+ strains the Green-Lagrange strain ``E = (F^T F - I) / 2`` (engineering shears) and the
16
+ second Piola-Kirchhoff stress ``S = J F^-1 sigma F^-T``, objective measures conjugate to
17
+ each other, whatever the rotation of the gradient (the upper triangular gradients of the
18
+ paths, their Cauchy stresses).
19
+ """
20
+
21
+ from __future__ import annotations
22
+
23
+ import json
24
+ from collections.abc import Callable
25
+ from dataclasses import dataclass, field
26
+ from pathlib import Path
27
+
28
+ import numpy as np
29
+
30
+ from morphogen.homogenization.paths import LoadingPath, PathResult, _index
31
+
32
+ #: The kinds of random paths
33
+ KINDS = ("walk", "linear")
34
+ #: The measures of the data: small strains (the strain, the stress) or finite strains (the
35
+ #: Green-Lagrange strain, the second Piola-Kirchhoff stress)
36
+ MEASURES = ("small", "green-lagrange")
37
+ #: The Voigt pairs (11, 22, 33, 23, 31, 12)
38
+ PAIRS = ((0, 0), (1, 1), (2, 2), (1, 2), (2, 0), (0, 1))
39
+ _TRACE = np.array([1.0, 1.0, 1.0, 0.0, 0.0, 0.0])
40
+ _ENGINEERING = np.array([1.0, 1.0, 1.0, 2.0, 2.0, 2.0])
41
+
42
+
43
+ def random_paths(
44
+ n: int,
45
+ *,
46
+ segments: int = 4,
47
+ increments: int = 10,
48
+ amplitude: float = 0.01,
49
+ volumetric: float = 0.2,
50
+ kind: str = "walk",
51
+ components=None,
52
+ free=False,
53
+ rate: float | None = None,
54
+ seed: int = 0,
55
+ ) -> list[LoadingPath]:
56
+ """``n`` random strain paths of ``segments`` linear segments of ``increments`` steps.
57
+
58
+ The strains at the ends of the segments: with ``kind="walk"`` a random walk (steps of
59
+ tensor components uniform, of standard deviation ``amplitude / sqrt(segments)``, the
60
+ components held within ``amplitude``), with ``kind="linear"`` independent strains
61
+ (tensor components uniform within ``amplitude``); their volumetric part scaled by
62
+ ``volumetric``. ``components``: the components driven (names ``"11"`` ... or Voigt
63
+ indices; by default all six), the others held at zero strain but those of ``free``
64
+ (components, or True for all of them), left free (zero stress): a tension-torsion
65
+ test drives 11 and 12 and frees 22 and 33. A model learns the responses to the
66
+ components of its data only: the paths it runs must hold the others likewise.
67
+ ``rate``: the largest strain rate of a component on each segment (the segments then
68
+ last the time of their strain), by default a unit time each."""
69
+ if kind not in KINDS:
70
+ raise ValueError(f"kind: one of {KINDS}, got {kind!r}")
71
+ if int(n) < 1 or int(segments) < 1 or int(increments) < 1:
72
+ raise ValueError("paths, segments and increments: at least one")
73
+ if not (amplitude > 0 and volumetric >= 0):
74
+ raise ValueError("amplitude: positive; volumetric: non-negative")
75
+ if rate is not None and not rate > 0:
76
+ raise ValueError("rate: positive")
77
+ driven = list(range(6)) if components is None else sorted({_component(c) for c in components})
78
+ mask = np.zeros(6, dtype=bool)
79
+ mask[driven] = True
80
+ released = np.zeros(6, dtype=bool)
81
+ if free is True:
82
+ released = ~mask
83
+ elif free:
84
+ released[[_component(c) for c in free]] = True
85
+ if np.any(released & mask):
86
+ raise ValueError("free: components not driven")
87
+ rng = np.random.default_rng(seed)
88
+ step = amplitude / np.sqrt(segments) * np.sqrt(3.0) # uniform of that deviation
89
+ out = []
90
+ for _ in range(int(n)):
91
+ tensor = np.zeros(6) # tensor components (half the engineering shears)
92
+ ends = [np.zeros(6)]
93
+ for _ in range(int(segments)):
94
+ if kind == "walk":
95
+ tensor = np.clip(tensor + rng.uniform(-step, step, 6), -amplitude, amplitude)
96
+ else:
97
+ tensor = rng.uniform(-amplitude, amplitude, 6)
98
+ strain = np.where(mask, tensor, 0.0)
99
+ mean = strain[:3].mean() if mask[:3].all() else 0.0
100
+ strain = strain - (1.0 - volumetric) * mean * _TRACE
101
+ ends.append(strain * _ENGINEERING)
102
+ values = np.array(ends)
103
+ if rate is None:
104
+ times = np.arange(len(ends), dtype=float)
105
+ else:
106
+ span = np.abs(np.diff(values, axis=0)).max(axis=1)
107
+ times = np.concatenate([[0.0], np.cumsum(np.maximum(span, 1e-3 * amplitude) / rate)])
108
+ controls = ~released
109
+ out.append(LoadingPath(times, np.where(controls, values, 0.0), controls,
110
+ increments=(int(increments),))) # fmt: skip
111
+ return out
112
+
113
+
114
+ def _component(c) -> int:
115
+ if isinstance(c, (int, np.integer)):
116
+ if not 0 <= int(c) < 6:
117
+ raise ValueError(f"component index {c}: from 0 to 5")
118
+ return int(c)
119
+ return _index(str(c))
120
+
121
+
122
+ def _tensor(v, engineering: bool) -> np.ndarray:
123
+ """Symmetric tensors (n, 3, 3) of Voigt components (n, 6)."""
124
+ v = np.asarray(v, dtype=float)
125
+ t = np.empty((*v.shape[:-1], 3, 3))
126
+ for k, (i, j) in enumerate(PAIRS):
127
+ x = v[..., k] * (0.5 if engineering and i != j else 1.0)
128
+ t[..., i, j] = x
129
+ t[..., j, i] = x
130
+ return t
131
+
132
+
133
+ def _voigt(t, engineering: bool) -> np.ndarray:
134
+ """Voigt components (n, 6) of symmetric tensors (n, 3, 3)."""
135
+ out = np.stack([t[..., i, j] for i, j in PAIRS], axis=-1)
136
+ if engineering:
137
+ out[..., 3:] *= 2.0
138
+ return out
139
+
140
+
141
+ def gradient_tensor(h) -> np.ndarray:
142
+ """The deformation gradients ``F`` (n, 3, 3) of the components 11, 22, 33, 23, 13, 12 of
143
+ the upper triangular displacement gradients of the paths in finite strains (n, 6)."""
144
+ h = np.asarray(h, dtype=float)
145
+ f = np.zeros((*h.shape[:-1], 3, 3))
146
+ f[..., [0, 1, 2], [0, 1, 2]] = 1.0 + h[..., :3]
147
+ f[..., 1, 2], f[..., 0, 2], f[..., 0, 1] = h[..., 3], h[..., 4], h[..., 5]
148
+ return f
149
+
150
+
151
+ def green_lagrange(f) -> np.ndarray:
152
+ """The Green-Lagrange strains (n, 6; engineering shears) of gradients ``F`` (n, 3, 3)."""
153
+ c = np.einsum("...ki,...kj->...ij", f, f)
154
+ return _voigt(0.5 * (c - np.eye(3)), engineering=True)
155
+
156
+
157
+ def second_piola(f, cauchy) -> np.ndarray:
158
+ """The second Piola-Kirchhoff stresses (n, 6) of the gradients ``F`` (n, 3, 3) and the
159
+ Cauchy stresses (n, 6)."""
160
+ inv = np.linalg.inv(f)
161
+ s = np.linalg.det(f)[..., None, None] * inv @ _tensor(cauchy, False) @ np.swapaxes(inv, -1, -2)
162
+ return _voigt(s, engineering=False)
163
+
164
+
165
+ @dataclass
166
+ class Dataset:
167
+ """Responses along paths: the ``times`` (paths x points), the ``strain`` and the
168
+ ``stress`` (paths x points x 6, Voigt; engineering shears), the first point of each
169
+ path the natural state, in small strains or (``measure="green-lagrange"``) the
170
+ Green-Lagrange strain and the second Piola-Kirchhoff stress; ``info``: how they were
171
+ made (the behaviour, the paths)."""
172
+
173
+ times: np.ndarray
174
+ strain: np.ndarray
175
+ stress: np.ndarray
176
+ measure: str = "small"
177
+ info: dict = field(default_factory=dict)
178
+
179
+ def __post_init__(self) -> None:
180
+ self.times = np.atleast_2d(np.asarray(self.times, dtype=float))
181
+ self.strain = np.asarray(self.strain, dtype=float)
182
+ self.stress = np.asarray(self.stress, dtype=float)
183
+ n, m = self.times.shape
184
+ if self.strain.shape != (n, m, 6) or self.stress.shape != (n, m, 6) or m < 2:
185
+ raise ValueError("data: times (paths x points), strains and stresses (x 6)")
186
+ if self.measure not in MEASURES:
187
+ raise ValueError(f"measure: one of {MEASURES}, got {self.measure!r}")
188
+ if not (np.all(np.isfinite(self.strain)) and np.all(np.isfinite(self.stress))):
189
+ raise ValueError("data: finite strains and stresses")
190
+
191
+ @property
192
+ def n_paths(self) -> int:
193
+ return self.times.shape[0]
194
+
195
+ @property
196
+ def n_points(self) -> int:
197
+ return self.times.shape[1]
198
+
199
+ def subset(self, index) -> Dataset:
200
+ """The paths of ``index``."""
201
+ index = np.asarray(index)
202
+ return Dataset(self.times[index], self.strain[index], self.stress[index], self.measure,
203
+ dict(self.info)) # fmt: skip
204
+
205
+ def split(self, validation: float = 0.2, *, seed: int = 0) -> tuple[Dataset, Dataset]:
206
+ """The paths shuffled (``seed``) into a training set and a validation set of the
207
+ fraction ``validation`` of them (at least one path each)."""
208
+ if not 0.0 < validation < 1.0 or self.n_paths < 2:
209
+ raise ValueError("split: a fraction between 0 and 1 of at least two paths")
210
+ order = np.random.default_rng(seed).permutation(self.n_paths)
211
+ k = min(max(round(validation * self.n_paths), 1), self.n_paths - 1)
212
+ return self.subset(np.sort(order[k:])), self.subset(np.sort(order[:k]))
213
+
214
+ def save(self, path) -> Path:
215
+ """The data in an ``.npz`` file (their ``info`` as JSON)."""
216
+ path = Path(path)
217
+ np.savez_compressed(path, times=self.times, strain=self.strain, stress=self.stress,
218
+ measure=np.array(self.measure),
219
+ info=np.array(json.dumps(self.info))) # fmt: skip
220
+ return path if path.suffix == ".npz" else path.with_name(path.name + ".npz")
221
+
222
+ @classmethod
223
+ def load(cls, path) -> Dataset:
224
+ with np.load(path, allow_pickle=False) as f:
225
+ return cls(f["times"], f["strain"], f["stress"], str(f["measure"]),
226
+ json.loads(str(f["info"]))) # fmt: skip
227
+
228
+
229
+ def _planned(result: PathResult, path: LoadingPath) -> np.ndarray:
230
+ """The rows of a response at the start and at the planned steps of its path."""
231
+ planned = np.concatenate([[path.times[0]], path.schedule()])
232
+ times = np.asarray(result.times)
233
+ k = np.clip(np.searchsorted(times, planned - 1e-9 * max(1.0, abs(planned[-1]))), 0,
234
+ len(times) - 1) # fmt: skip
235
+ if not np.allclose(times[k], planned, rtol=1e-9, atol=1e-12):
236
+ raise ValueError(f"path {result.name!r}: the response misses planned steps")
237
+ return k
238
+
239
+
240
+ def measures(result: PathResult, rows=None) -> tuple[np.ndarray, np.ndarray, str]:
241
+ """The strain and the stress of a response (its ``rows``) in the measure of its
242
+ kinematics: small strains, or the Green-Lagrange strain and the second
243
+ Piola-Kirchhoff stress (finite strains)."""
244
+ rows = slice(None) if rows is None else rows
245
+ if not result.finite:
246
+ return np.asarray(result.strain)[rows], np.asarray(result.stress)[rows], "small"
247
+ f = gradient_tensor(np.asarray(result.strain)[rows])
248
+ return green_lagrange(f), second_piola(f, np.asarray(result.cauchy)[rows]), "green-lagrange"
249
+
250
+
251
+ def responder(
252
+ source, kinematics: str = "small", orientation=None
253
+ ) -> Callable[[LoadingPath], PathResult]:
254
+ """The response to a path of ``source``: a material (a
255
+ :class:`~morphogen.homogenization.materials.Material` or its configuration) at a
256
+ material point (turned by the Bunge angles ``orientation`` of a crystal), or a callable
257
+ ``path -> PathResult`` (a microstructure)."""
258
+ if callable(source) and not isinstance(source, dict):
259
+ return source
260
+ from morphogen.homogenization.materials import Material
261
+ from morphogen.homogenization.nonlinear import simulate_point
262
+
263
+ material = Material.from_config(source)
264
+ return lambda path: simulate_point(material, path, kinematics=kinematics,
265
+ orientation=orientation) # fmt: skip
266
+
267
+
268
+ def generate(
269
+ source,
270
+ paths,
271
+ *,
272
+ kinematics: str = "small",
273
+ info: dict | None = None,
274
+ callback: Callable[[int, int], None] | None = None,
275
+ ) -> Dataset:
276
+ """The responses of ``source`` (see :func:`responder`: a material at a material point,
277
+ or a callable ``path -> PathResult`` of a microstructure) along ``paths`` (loading
278
+ paths or their specifications, all of the same numbers of steps), at their planned
279
+ steps. ``callback(done, total)`` after each path (it may raise
280
+ :class:`~morphogen.stopping.Stopped`)."""
281
+ respond = responder(source, kinematics)
282
+ paths = [LoadingPath.from_spec(p) for p in paths]
283
+ if not paths:
284
+ raise ValueError("generate: at least one path")
285
+ times, strains, stresses, measure = [], [], [], "small"
286
+ for k, path in enumerate(paths):
287
+ result = respond(path)
288
+ rows = _planned(result, path)
289
+ e, s, measure = measures(result, rows)
290
+ times.append(np.asarray(result.times)[rows])
291
+ strains.append(e)
292
+ stresses.append(s)
293
+ if callback is not None:
294
+ callback(k + 1, len(paths))
295
+ if len({len(t) for t in times}) != 1:
296
+ raise ValueError("generate: paths of the same numbers of steps")
297
+ return Dataset(np.array(times), np.array(strains), np.array(stresses), measure,
298
+ dict(info or {})) # fmt: skip
299
+
300
+
301
+ @dataclass(frozen=True)
302
+ class Scales:
303
+ """The normalization of the data: the root mean squares of the strain, of the stress,
304
+ of the strain increments and the mean time step of a training set. The networks see
305
+ the strains and the increments divided by theirs and give stresses divided by
306
+ theirs: scalars, which keep the isotropy of the data and the potential of the
307
+ stresses (:class:`~morphogen.learning.networks.Potential`)."""
308
+
309
+ strain: float
310
+ stress: float
311
+ increment: float
312
+ time: float
313
+
314
+ @classmethod
315
+ def of(cls, data: Dataset) -> Scales:
316
+ def rms(a) -> float:
317
+ return float(np.sqrt(np.mean(np.square(a))))
318
+
319
+ strain, stress = rms(data.strain), rms(data.stress)
320
+ if not (strain > 0 and stress > 0):
321
+ raise ValueError("data: some strains and stresses")
322
+ increment = rms(np.diff(data.strain, axis=1)) or strain
323
+ dt = float(np.mean(np.diff(data.times, axis=1)))
324
+ return cls(strain, stress, increment, dt if dt > 0 else 1.0)
325
+
326
+ def to_dict(self) -> dict:
327
+ return {"strain": self.strain, "stress": self.stress, "increment": self.increment,
328
+ "time": self.time} # fmt: skip