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,81 @@
1
+ """Behaviours learned from data: networks trained on the responses of morphoGen's
2
+ behaviours (or of a microstructure) along random loading paths, then integrated in place
3
+ of a behaviour.
4
+
5
+ * Data (:mod:`.data`): random strain paths, the responses of a material point
6
+ (:func:`~morphogen.homogenization.nonlinear.simulate_point`) or of the path solvers of a
7
+ microstructure along them, splits and normalization.
8
+ * Models (:mod:`.networks`), their gradients written out: a perceptron of the stress
9
+ (:class:`FeedForward`), the stress derived from a learned convex potential
10
+ (:class:`Potential`: hyperelastic, a symmetric positive tangent) and a recurrent network
11
+ over the strain increments with learned internal variables (:class:`Recurrent`:
12
+ path-dependent responses, plasticity) and a learned generalized standard material
13
+ (:class:`Standard`, :mod:`.standard`: a convex free energy and a convex dissipation
14
+ potential of learned internal variables, the state of a step the minimizer of the
15
+ incremental potential: a nonnegative dissipation and a symmetric tangent by
16
+ construction). In finite strains every model is of the logarithmic strain ``1/2 ln C``
17
+ (by default; its stress ``T`` conjugate to it, ``S = J^T T``, :mod:`.logarithmic`) or of
18
+ the Green-Lagrange strain, objective.
19
+ * Training (:mod:`.training`): Adam on mini-batches, early stopping on a validation
20
+ set, the paths turned by the symmetries of the behaviour (uniform rotations, those of
21
+ the cube), seeded; the files of the models (``.npz`` with JSON metadata).
22
+ * Learned laws (:mod:`.behaviour`): ``learned`` in the configuration of a material
23
+ integrates its points by a model, at a material point, by finite elements and on voxels,
24
+ in the axes of its material (turned by the orientation of each grain, as crystals), the
25
+ stress-free thermal strain of its expansion taken out.
26
+ * :func:`learn`: data, training, evaluation and file of a configuration (``morphogen
27
+ learn``).
28
+ * MFront sources (:mod:`.mfront`): a learned law as an MFront behaviour (its trained
29
+ parameters as constants, morphoGen's C++ port of the model, ``learned.cpp``), for
30
+ AMITEX_FFTP, Cast3M, Abaqus and Code_Aster (:func:`morphogen.io.mfront.mfront_source`,
31
+ ``morphogen mfront``, the AMITEX and Abaqus exports).
32
+ """
33
+
34
+ from morphogen.learning.behaviour import (
35
+ LearnedBehaviour,
36
+ LearnedLaw,
37
+ LearnedPoints,
38
+ isotropic_constants,
39
+ learned_law,
40
+ learned_material,
41
+ )
42
+ from morphogen.learning.data import Dataset, Scales, generate, random_paths, responder
43
+ from morphogen.learning.networks import (
44
+ KINDS,
45
+ FeedForward,
46
+ Model,
47
+ Potential,
48
+ Recurrent,
49
+ load_model,
50
+ make_model,
51
+ )
52
+ from morphogen.learning.run import learn, path_errors
53
+ from morphogen.learning.standard import Standard
54
+ from morphogen.learning.training import Training, errors, train
55
+
56
+ __all__ = [
57
+ "KINDS",
58
+ "Dataset",
59
+ "FeedForward",
60
+ "LearnedBehaviour",
61
+ "LearnedLaw",
62
+ "LearnedPoints",
63
+ "Model",
64
+ "Potential",
65
+ "Recurrent",
66
+ "Scales",
67
+ "Standard",
68
+ "Training",
69
+ "errors",
70
+ "generate",
71
+ "isotropic_constants",
72
+ "learn",
73
+ "learned_law",
74
+ "learned_material",
75
+ "load_model",
76
+ "make_model",
77
+ "path_errors",
78
+ "random_paths",
79
+ "responder",
80
+ "train",
81
+ ]
@@ -0,0 +1,398 @@
1
+ """Learned laws in the solvers of morphoGen: a material whose ``learned`` names a model
2
+ (:class:`LearnedBehaviour`) has its points integrated by the model, along the seam of the
3
+ MFront behaviours (points of the kind ``MFRONT``, which the kernels skip; their
4
+ integration after them): at a material point, by finite elements and on voxels. The
5
+ rest of the solvers is unchanged (the periodic element, Newton's method, the outputs);
6
+ the elastic constants of the material remain those of the linear problems and of the
7
+ reference medium of the FFT solver (:func:`learned_material` takes those of the initial
8
+ tangent of the model).
9
+
10
+ A step of a point gives the model the strain at its end, the strain and the state of the
11
+ model at its start (the internal variables of the point) and the time step: the stress
12
+ and the consistent tangent, and the state at its end. The tangent is exact at a material
13
+ point; in volume elements it is symmetrized for the conjugate gradients when the laws of
14
+ all the phases have symmetric tangents (those of the potential and of the standard model
15
+ are), and kept whole for GMRES otherwise (the perceptron, the recurrent network:
16
+ :attr:`LearnedLaw.symmetric`). In finite strains, the model of the Green-Lagrange strain
17
+ ``E`` and the second Piola-Kirchhoff stress ``S`` gives the first Piola-Kirchhoff stress
18
+ ``P = F S`` and its tangent ``dP/dF = I (x) S + F . dS/dE . dE/dF``.
19
+
20
+ A learned law depends on the temperature through the thermal expansion of its material
21
+ only, as morphoGen's own behaviours do: the model sees the mechanical strain, the strain
22
+ less the stress-free thermal strain ``alpha dT`` (``dT`` from the stress-free state, the
23
+ expansion tensor in the axes of the material). In finite strains the split is that of
24
+ morphoGen's Hencky points (:mod:`morphogen.homogenization.finite`): the mechanical
25
+ logarithmic strain ``H_m = 1/2 ln C - alpha dT``, the stress ``T`` conjugate to ``H = 1/2
26
+ ln C`` and the free energy per unit reference volume (no factor ``J_th``). The model sees
27
+ the Green-Lagrange strain of ``H_m``, ``E_m = (exp(2 H_m) - I)/2`` (a law of ``ln C``
28
+ sees ``H_m`` itself), its stress gives ``T = J_m^-T S_m`` and ``K = dT/dH = J_m^-T
29
+ (dS_m/dE_m - T : d2H/dE2 (E_m)) J_m^-1`` (``J = dH/dE``, ``J_m`` at ``E_m``), and ``S =
30
+ J^T T``, ``dS/dE = J^T K J + T : d2H/dE2`` (:mod:`morphogen.learning.logarithmic`): a law
31
+ of ``E`` that is Hencky's elasticity gives the stresses of the Hencky points. For an
32
+ isotropic expansion ``E_m = A (E + I/2) A - I/2`` and ``S = A S_m A`` (``A = exp(-alpha
33
+ dT)``: the multiplicative split ``F = F_m F_th``, ``F_th = exp(alpha dT)``); for an
34
+ anisotropic one that split is not the Hencky points' (the logarithms add only where ``C``
35
+ and ``alpha`` commute). Without an expansion, a change of temperature leaves the law
36
+ unchanged.
37
+
38
+ A learned law runs in the axes of its material, which the orientation of its point turns
39
+ as it turns crystals (``crystal = g sample``: Bunge angles at a material point, those of
40
+ the grain of each point in polycrystals): the model sees the strain ``g eps g^T`` (``g E
41
+ g^T`` in finite strains) and its stress and tangent are turned back, ``sigma = g^T
42
+ sigma_g g`` and ``C = T^T C_g T`` (``T``: the 6 x 6 matrix of ``g`` on the strains); a law
43
+ learned once in the axes of a crystal serves every grain. Without an orientation, or with
44
+ ``oriented: false``, it runs in the axes of the sample. Order of the components at every
45
+ interface: morphoGen's Voigt order 11, 22, 33, 23, 31, 12 (engineering shears of the
46
+ strains) in the data, the models, the arrays of the points and the 6 x 6 rotations; the
47
+ learned points never pass TFEL's order 12, 13, 23 of the MFront points beside them.
48
+
49
+ Slots of the internal variables of a point: the plastic strain and the cumulated plastic
50
+ strain of the outputs (zero: the model has no plastic strain), the strain (or ``E``) of
51
+ the model at the end of the step (in the axes of its material), then the state of the
52
+ model.
53
+ """
54
+
55
+ from __future__ import annotations
56
+
57
+ import math
58
+ from dataclasses import dataclass
59
+ from pathlib import Path
60
+
61
+ import numpy as np
62
+
63
+ from morphogen.homogenization.behaviours import MFRONT, STATE_P
64
+ from morphogen.learning.data import PAIRS, _tensor, _voigt
65
+ from morphogen.learning.logarithmic import _measures, _pullback
66
+ from morphogen.learning.networks import Model, load_model
67
+
68
+ _STRAIN = STATE_P + 1
69
+ _STATE = _STRAIN + 6
70
+ #: The models loaded from their files (path -> (modification time, model))
71
+ _LOADED: dict[str, tuple[float, Model]] = {}
72
+
73
+
74
+ @dataclass(frozen=True)
75
+ class LearnedBehaviour:
76
+ """A learned law of a material: ``model``, the file of a model of
77
+ :mod:`morphogen.learning` (``.npz``, :meth:`~morphogen.learning.networks.Model.save`)
78
+ or the model itself; ``oriented``: the law in the axes of its material, turned by the
79
+ orientation of its point (that of its grain in a polycrystal) as a crystal is, or
80
+ (false) in the axes of the sample everywhere."""
81
+
82
+ model: object
83
+ oriented: bool = True
84
+
85
+ def __post_init__(self) -> None:
86
+ object.__setattr__(self, "oriented", bool(self.oriented))
87
+ if isinstance(self.model, (str, Path)):
88
+ object.__setattr__(self, "model", str(self.model))
89
+ elif not isinstance(self.model, Model):
90
+ raise ValueError("learned: the file of a model of morphogen.learning, or the model")
91
+ elif not self.model.ready:
92
+ raise ValueError("learned: the model is not trained")
93
+
94
+ @classmethod
95
+ def from_config(cls, spec) -> LearnedBehaviour:
96
+ """The file of a model, or a mapping ``model: <file>`` (and ``oriented``)."""
97
+ if isinstance(spec, LearnedBehaviour):
98
+ return spec
99
+ if isinstance(spec, dict):
100
+ unknown = sorted(set(spec) - {"model", "oriented"})
101
+ if unknown or "model" not in spec:
102
+ raise ValueError(f"learned: a mapping of model (and oriented), got {sorted(spec)}")
103
+ return cls(spec["model"], spec.get("oriented", True))
104
+ return cls(spec)
105
+
106
+ def to_config(self) -> dict:
107
+ model = self.model
108
+ path = model.path if isinstance(model, Model) else model
109
+ out = {"model": None if path is None else str(path)}
110
+ if not self.oriented:
111
+ out["oriented"] = False
112
+ return out
113
+
114
+ def load(self) -> Model:
115
+ """The model (loaded once from its file while the file does not change)."""
116
+ if isinstance(self.model, Model):
117
+ return self.model
118
+ path = Path(self.model)
119
+ if not path.is_file():
120
+ raise FileNotFoundError(f"learned: no model {path}")
121
+ key, stamp = str(path.resolve()), path.stat().st_mtime
122
+ cached = _LOADED.get(key)
123
+ if cached is None or cached[0] != stamp:
124
+ cached = (stamp, load_model(path))
125
+ _LOADED[key] = cached
126
+ return cached[1]
127
+
128
+
129
+ @dataclass
130
+ class LearnedLaw:
131
+ """A learned law loaded for the points of a material: its model and kinematics, and
132
+ the thermal expansion of its material (3 x 3, per unit change of temperature, in the
133
+ axes of the material; None without one)."""
134
+
135
+ spec: LearnedBehaviour
136
+ model: Model
137
+ finite: bool
138
+ expansion: np.ndarray | None = None
139
+
140
+ @property
141
+ def width(self) -> int:
142
+ """Internal variables of a point in morphoGen's arrays."""
143
+ return _STATE + self.model.n_state
144
+
145
+ @property
146
+ def symmetric(self) -> bool:
147
+ """Whether the consistent tangent of the law is symmetric: that of a potential (the
148
+ Hessian of its free energy) and of a standard model (of its two convex
149
+ potentials), not those of the perceptron and of the recurrent network; a law that
150
+ says so itself (``model.symmetric``: those of
151
+ :mod:`morphogen.homogenization.laws`)."""
152
+ own = getattr(self.model, "symmetric", None)
153
+ return self.model.kind in ("potential", "standard") if own is None else bool(own)
154
+
155
+
156
+ def learned_law(spec, *, finite: bool, expansion=None) -> LearnedLaw:
157
+ """The learned law of ``spec`` for the points of a solver, its model checked against
158
+ the kinematics (small strains, or the Green-Lagrange measures in finite strains);
159
+ ``expansion``: the thermal expansion tensor of its material (in its axes)."""
160
+ spec = LearnedBehaviour.from_config(spec)
161
+ model = spec.load()
162
+ wanted = "green-lagrange" if finite else "small"
163
+ if model.measure != wanted:
164
+ kind = "finite" if finite else "small"
165
+ raise ValueError(f"learned: a model of {model.measure} data; the paths in {kind} "
166
+ f"strains need one of {wanted} data") # fmt: skip
167
+ if expansion is not None:
168
+ expansion = np.asarray(expansion, dtype=float).reshape(3, 3)
169
+ expansion = 0.5 * (expansion + expansion.T) if np.any(expansion) else None
170
+ return LearnedLaw(spec, model, bool(finite), expansion)
171
+
172
+
173
+ def finite_stress(f, s6, c6) -> tuple[np.ndarray, np.ndarray]:
174
+ """The first Piola-Kirchhoff stresses (n, 9) and their tangents ``dP/dF`` (n, 9, 9;
175
+ tensors row by row) of the gradients ``f`` (n, 3, 3), of the second Piola-Kirchhoff
176
+ stresses ``s6`` (n, 6) and of their tangents with respect to the Green-Lagrange
177
+ strain ``c6`` (n, 6, 6; engineering shears)."""
178
+ n = f.shape[0]
179
+ s = _tensor(s6, engineering=False)
180
+ # dE_a/dF_kL: E_AA = (F_mA F_mA - 1) / 2, 2 E_AB = F_mA F_mB
181
+ de = np.zeros((n, 6, 3, 3))
182
+ for a, (i, j) in enumerate(PAIRS):
183
+ de[:, a, :, i] += f[:, :, j]
184
+ if i != j:
185
+ de[:, a, :, j] += f[:, :, i]
186
+ ds6 = np.einsum("nba,nakl->nbkl", c6, de)
187
+ ds = np.empty((n, 3, 3, 3, 3))
188
+ for b, (i, j) in enumerate(PAIRS):
189
+ ds[:, i, j] = ds6[:, b]
190
+ ds[:, j, i] = ds6[:, b]
191
+ tangent = np.einsum("ik,nlj->nijkl", np.eye(3), s) + np.einsum("nim,nmjkl->nijkl", f, ds)
192
+ return (f @ s).reshape(n, 9), tangent.reshape(n, 9, 9)
193
+
194
+
195
+ def turned(t, s, c) -> tuple[np.ndarray, np.ndarray]:
196
+ """The stresses (n, 6) and tangents (n, 6, 6) of a law in the axes of its material
197
+ (``s``, ``c``) turned back to the axes of the sample by the 6 x 6 matrices ``t`` (n, 6,
198
+ 6) of its orientations on the strains (engineering shears): ``T^T s`` and ``T^T c T``,
199
+ the work and the energy unchanged."""
200
+ return np.einsum("nji,nj->ni", t, s), np.einsum("nki,nkl,nlj->nij", t, c, t)
201
+
202
+
203
+ def thermal_split(e, heat, dtemp) -> np.ndarray:
204
+ """The mechanical Green-Lagrange strains (n, 6; engineering shears) of Green-Lagrange
205
+ strains ``e`` (n, 6) heated by ``dtemp`` with the expansions ``heat`` (n, 3, 3), by the
206
+ split of the Hencky points: the Green-Lagrange strain ``E_m = (exp(2 H_m) - I)/2`` of
207
+ the mechanical logarithmic strain ``H_m = 1/2 ln C - dtemp alpha`` (``C = I + 2 E``;
208
+ ``expm1`` of the eigenvalues of ``2 H_m``, exact to round-off near zero); NaN where
209
+ ``C`` is not positive definite."""
210
+ h = _measures(np.ascontiguousarray(e, dtype=float), 1.0)[0]
211
+ h = h - float(dtemp) * _voigt(heat, engineering=True)
212
+ out = np.full_like(h, np.nan)
213
+ ok = np.all(np.isfinite(h), axis=1)
214
+ if ok.any():
215
+ w, v = np.linalg.eigh(_tensor(h[ok], engineering=True))
216
+ out[ok] = _voigt(np.einsum("nij,nj,nkj->nik", v, 0.5 * np.expm1(2.0 * w), v),
217
+ engineering=True) # fmt: skip
218
+ return out
219
+
220
+
221
+ def thermal_conjugate(e, em, s, c) -> tuple[np.ndarray, np.ndarray]:
222
+ """The stresses (n, 6) conjugate to the Green-Lagrange strains ``e`` (n, 6) and their
223
+ tangents (n, 6, 6) of a law heated as the Hencky points are, of its stresses ``s`` and
224
+ tangents ``c`` at the mechanical strains ``em`` of :func:`thermal_split`: the stress
225
+ ``T = J_m^-T S_m`` conjugate to the logarithmic strain and its tangent ``K = dT/dH =
226
+ J_m^-T (dS_m/dE_m - T : d2H/dE2 (E_m)) J_m^-1`` (``J = dH/dE``, ``J_m`` at ``em``),
227
+ then ``S = J^T T`` and ``dS/dE = J^T K J + T : d2H/dE2`` at ``e`` (``S : dE = T : dH =
228
+ S_m : dE_m``: the free energy of the law per unit reference volume); the tangent
229
+ symmetrized if that of the law is symmetric to the bit (a potential, a standard
230
+ model)."""
231
+ e, em = (np.ascontiguousarray(a, dtype=float) for a in (e, em))
232
+ s, c = np.asarray(s, dtype=float), np.asarray(c, dtype=float)
233
+ n = e.shape[0]
234
+ jm = _measures(em, 1.0)[1]
235
+ # J_m^-T where C is positive definite (NaN elsewhere, as the stresses: a failed point)
236
+ inverse = np.full((n, 6, 6), np.nan)
237
+ ok = np.all(np.isfinite(jm), axis=(1, 2))
238
+ if ok.any():
239
+ inverse[ok] = np.linalg.inv(np.swapaxes(jm[ok], 1, 2))
240
+ t = np.ascontiguousarray(np.einsum("nij,nj->ni", inverse, s))
241
+ geometric = _pullback(em, t, np.zeros((n, 6, 6)), 1.0, False)[1]
242
+ k = np.ascontiguousarray(inverse @ (c - geometric) @ np.swapaxes(inverse, 1, 2))
243
+ return _pullback(e, t, k, 1.0, bool(np.array_equal(c, np.swapaxes(c, 1, 2))))
244
+
245
+
246
+ def _model_step(model, e, e_old, h_old, dt, dtemp=0.0):
247
+ """The step of ``model`` at the points of finite strains ``e`` (n, 6); NaN at the others,
248
+ where the model is not called: failed points (heated where ``C`` is not positive
249
+ definite, as a Hencky point fails, or of a gradient that is not finite). A model whose
250
+ law depends on the temperature (``model.thermal``: the shifted times of a
251
+ viscoelastic law) also gets the change of temperature ``dtemp``."""
252
+ extra = (dtemp,) if getattr(model, "thermal", False) else ()
253
+ ok = np.all(np.isfinite(e), axis=1)
254
+ if ok.all():
255
+ return model.step(e, e_old, h_old, dt, *extra)
256
+ n = e.shape[0]
257
+ s, c = np.full((n, 6), np.nan), np.full((n, 6, 6), np.nan)
258
+ h = np.full((n, model.n_state), np.nan)
259
+ if ok.any():
260
+ s[ok], c[ok], h[ok] = model.step(e[ok], e_old[ok], h_old[ok], dt, *extra)
261
+ return s, c, h
262
+
263
+
264
+ class LearnedPoints:
265
+ """The integration points of the materials with a learned law (those of kind
266
+ ``MFRONT`` among ``kind``, of the laws ``pmat``), integrated by their models in the
267
+ axes of their materials (``rotations``: the orientation of each row ``point_mat`` of
268
+ the materials, ``crystal = g sample``; the laws not oriented in the axes of the
269
+ sample); the interface of :class:`~morphogen.homogenization.mfront.MFrontPoints`."""
270
+
271
+ def __init__(self, laws, kind, pmat, point_mat, rotations, finite: bool, threads=None,
272
+ symmetric: bool = True): # fmt: skip
273
+ from morphogen.learning.training import voigt_rotations
274
+
275
+ self.finite = bool(finite)
276
+ self.symmetric = bool(symmetric)
277
+ self.points = np.flatnonzero(np.asarray(kind) == MFRONT)
278
+ pmat = np.asarray(pmat)[self.points]
279
+ point_mat = np.asarray(point_mat)[self.points]
280
+ self.groups = []
281
+ for c, law in enumerate(laws):
282
+ if law.finite != self.finite:
283
+ raise ValueError("learned: the law and the solver have other kinematics")
284
+ local = np.flatnonzero(pmat == c)
285
+ if not local.size:
286
+ continue
287
+ # the 6 x 6 matrices of the orientations of the points on the strains, if any
288
+ t = None
289
+ g = np.repeat(np.eye(3)[None], local.size, axis=0)
290
+ if rotations is not None and len(rotations):
291
+ g = np.asarray(rotations, dtype=float)[point_mat[local]]
292
+ turn = law.spec.oriented and not np.allclose(g, np.eye(3), rtol=0.0, atol=1e-14)
293
+ if turn:
294
+ t = voigt_rotations(g)[0]
295
+ # the expansions in the axes of the model: its material's, or (a law in the axes
296
+ # of the sample) turned by the orientation of the point as the kernels turn it
297
+ heat = None
298
+ if law.expansion is not None:
299
+ heat = np.repeat(law.expansion[None], local.size, axis=0)
300
+ if not law.spec.oriented:
301
+ heat = np.einsum("npi,pq,nqj->nij", g, law.expansion, g)
302
+ self.groups.append((law, local, t, heat))
303
+
304
+ def integrate(self, grads, dtemp, dt, old, new, stress, tangent) -> int:
305
+ """Integration of the points of learned laws among the arrays of all the points;
306
+ returns the number of points whose stress is not finite."""
307
+ idx = self.points
308
+ out = [new[idx], stress[idx], tangent[idx]]
309
+ failed = self.integrate_compact(grads[idx], dtemp, dt, old[idx], *out)
310
+ new[idx], stress[idx], tangent[idx] = out
311
+ return failed
312
+
313
+ def integrate_compact(self, grads, dtemp, dt, old, new, stress, tangent) -> int:
314
+ """The same for the arrays of these points only (in the order of :attr:`points`)."""
315
+ failed = 0
316
+ dtemp = float(dtemp)
317
+ for law, local, t, heat in self.groups:
318
+ o = old[local]
319
+ n_state = law.model.n_state
320
+ if self.finite: # E = (H + H^T + H^T H) / 2: no cancellation of 1
321
+ hg = np.asarray(grads[local]).reshape(-1, 3, 3)
322
+ f = np.eye(3) + hg
323
+ gl = hg + np.swapaxes(hg, 1, 2) + np.einsum("nki,nkj->nij", hg, hg)
324
+ e = _voigt(0.5 * gl, engineering=True)
325
+ else:
326
+ e = np.asarray(grads[local])
327
+ if t is not None: # in the axes of the material: g eps g^T (g E g^T)
328
+ e = np.einsum("nij,nj->ni", t, e)
329
+ total = None
330
+ if heat is not None and dtemp != 0.0: # the mechanical strain
331
+ if self.finite: # of the Hencky points: 1/2 ln C - alpha dT
332
+ total, e = e, thermal_split(e, heat, dtemp)
333
+ else:
334
+ e = e - dtemp * _voigt(heat, engineering=True)
335
+ s, c, h = _model_step(law.model, e, o[:, _STRAIN:_STATE],
336
+ o[:, _STATE : _STATE + n_state], dt, dtemp) # fmt: skip
337
+ if total is not None: # S = J^T T, T = J_m^-T S_m: conjugate to E
338
+ s, c = thermal_conjugate(total, e, s, c)
339
+ if t is not None:
340
+ s, c = turned(t, s, c)
341
+ if self.finite:
342
+ s, c = finite_stress(f, s, c)
343
+ if self.symmetric:
344
+ c = 0.5 * (c + np.swapaxes(c, 1, 2))
345
+ bad = ~(np.all(np.isfinite(s), axis=1) & np.all(np.isfinite(c), axis=(1, 2)))
346
+ failed += int(bad.sum())
347
+ stress[local] = s
348
+ tangent[local] = c
349
+ state = np.zeros((local.size, new.shape[1]))
350
+ state[:, _STRAIN:_STATE] = e
351
+ state[:, _STATE : _STATE + n_state] = h
352
+ if hasattr(law.model, "scalar"): # the variable p of the outputs (a damage)
353
+ state[:, STATE_P] = law.model.scalar(h)
354
+ new[local] = state
355
+ return failed
356
+
357
+
358
+ def isotropic_constants(stiffness) -> tuple[float, float]:
359
+ """Young's modulus and Poisson's ratio of the isotropic projection (Voigt's means of
360
+ the bulk and shear moduli) of a 6 x 6 stiffness (engineering shears)."""
361
+ c = np.asarray(stiffness, dtype=float)
362
+ normal = np.trace(c[:3, :3])
363
+ off = c[0, 1] + c[0, 2] + c[1, 2]
364
+ bulk = (normal + 2.0 * off) / 9.0
365
+ shear = (normal - off + 3.0 * np.trace(c[3:, 3:])) / 15.0
366
+ if not (bulk > 0 and shear > 0):
367
+ raise ValueError("the stiffness has no positive isotropic part")
368
+ young = 9.0 * bulk * shear / (3.0 * bulk + shear)
369
+ poisson = (3.0 * bulk - 2.0 * shear) / (2.0 * (3.0 * bulk + shear))
370
+ return float(young), float(min(max(poisson, -0.99), 0.49))
371
+
372
+
373
+ def initial_tangent(model: Model) -> np.ndarray:
374
+ """The tangent of a model at the natural state (of its first step from it)."""
375
+ zero = np.zeros((1, 6))
376
+ return model.step(zero, zero, np.zeros((1, model.n_state)), 1.0)[1][0]
377
+
378
+
379
+ def learned_material(
380
+ model, *, young: float | None = None, poisson: float | None = None, expansion=None
381
+ ):
382
+ """A :class:`~morphogen.homogenization.materials.Material` of the learned law of
383
+ ``model`` (a model, its file, or a :class:`LearnedBehaviour`), its elastic constants
384
+ (the linear problems and the reference media) those given or of the isotropic
385
+ projection of its initial tangent; ``expansion``: its thermal expansion (one
386
+ coefficient, principal values or a tensor in the axes of the material), the
387
+ stress-free thermal strain taken out of the strain the model sees."""
388
+ from morphogen.homogenization.materials import Material
389
+
390
+ spec = LearnedBehaviour.from_config(model)
391
+ if young is None or poisson is None:
392
+ e, nu = isotropic_constants(initial_tangent(spec.load()))
393
+ young = e if young is None else young
394
+ poisson = nu if poisson is None else poisson
395
+ if not (math.isfinite(young) and young > 0):
396
+ raise ValueError(f"young: positive, got {young}")
397
+ return Material(young=float(young), poisson=float(poisson), expansion=expansion,
398
+ learned=spec) # fmt: skip