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,391 @@
1
+ """Nonlinear homogenization of periodic voxel images along loading paths: the periodic
2
+ element of :mod:`morphogen.homogenization.nonlinear` on the voxels of the FFT solver.
3
+
4
+ Each voxel is the trilinear hexahedron of :mod:`morphogen.homogenization.fft`, its 2 x 2
5
+ x 2 Gauss points the integration points of the behaviours. Fully integrated, these
6
+ elements lock under isochoric plastic flow (the macroscopic flow stress of a composite
7
+ with a plastic matrix converges from far above as the voxels are refined): by default the
8
+ volumetric part of the measures is averaged over each voxel, the B-bar method in small
9
+ strains (Hughes 1980) and the F-bar method in finite strains (de Souza Neto, Perić,
10
+ Dutko & Owen 1996), in their variational form (the forces derive from the energy of
11
+ these measures), so that the tangent stays symmetric. The unknowns of a step are the
12
+ periodic nodal fluctuation ``w`` and the components of the macroscopic strain prescribed
13
+ as stresses (the macroscopic degrees of freedom of the periodic element), solved by the
14
+ Newton iterations of :class:`~morphogen.homogenization.nonlinear._PathSolver`: the
15
+ macroscopic block is condensed, the corrections are inexact, the steps are divided when
16
+ they do not converge.
17
+
18
+ Each linearized equilibrium ``K_t dw = -R_w`` is solved by conjugate gradients
19
+ preconditioned by the inverse of the stiffness of a homogeneous elastic reference medium,
20
+ applied in Fourier space (:class:`~morphogen.homogenization.fft.FourierPreconditioner`): a
21
+ Newton-Krylov scheme (Gélébart & Mondon-Cancel 2013; Kabel, Böhlke & Schneider 2014) on
22
+ the discretization of Schneider, Merkert & Kabel (2017). The tangent operator is applied
23
+ matrix-free from the consistent tangents of the points: stress increments ``C_t : B v`` at
24
+ the points, then nodal forces gathered node by node; nothing is assembled. The tangents
25
+ are symmetrized, so that conjugate gradients apply, when the laws of all the phases have
26
+ symmetric ones; otherwise (crystal and porous plasticity, the Armstrong-Frederick
27
+ hardening, learned laws that are not potentials, MFront behaviours without a symmetric
28
+ tangent) they are kept full, symmetrized again at the linearizations where their measured
29
+ asymmetry is small (:data:`~morphogen.homogenization.nonlinear.ASYMMETRY`), and GMRES
30
+ with deflated restarts and the same preconditioner solves the corrections of the others
31
+ (:func:`~morphogen.homogenization.solvers.gmres`; ``tangent`` chooses), recycling from a
32
+ solve to the next of the path the space of the first one that restarts (GCRO-DR,
33
+ :class:`~morphogen.homogenization.solvers.Recycling`) and stopping a solve that stagnates
34
+ (an inexact correction). Pores
35
+ have no integration points and, as in the linear solver, need no ersatz material.
36
+
37
+ The behaviours are those of the finite elements: von Mises elasto-(visco)plasticity, and
38
+ crystal plasticity with the slip systems of each grain turned by its orientation, in
39
+ small or finite strains (total Lagrangian, upper triangular macroscopic gradient).
40
+
41
+ Memory: per integration point, the measure of strain, the stress, the tangent (36 or 81
42
+ values) and the internal variables twice (a crystal with 12 slip systems: about 1 kB in
43
+ small strains, 1.7 kB in finite strains), with 8 points per voxel: about 2 GB for a 64³
44
+ polycrystal in small strains.
45
+ """
46
+
47
+ from __future__ import annotations
48
+
49
+ import dataclasses
50
+ import logging
51
+ import time
52
+ from functools import partial
53
+
54
+ import numpy as np
55
+
56
+ from morphogen.homogenization import finite as fin
57
+ from morphogen.homogenization import kernels
58
+ from morphogen.homogenization.elements import voigt_to_tensor
59
+ from morphogen.homogenization.fft import FFTElasticProblem, FourierPreconditioner
60
+ from morphogen.homogenization.materials import Material
61
+ from morphogen.homogenization.nonlinear import _PathSolver, _PointArrays, behaviour_table
62
+ from morphogen.homogenization.solvers import (
63
+ GMRES_STAGNATION,
64
+ NEGLIGIBLE,
65
+ Recycling,
66
+ SolveInfo,
67
+ conjugate_gradient,
68
+ gmres,
69
+ norm,
70
+ )
71
+ from morphogen.image import VoxelImage
72
+
73
+ log = logging.getLogger("morphogen")
74
+
75
+ #: Integration of the voxels: B-bar (F-bar in finite strains), or full
76
+ INTEGRATIONS = ("bbar", "full")
77
+
78
+
79
+ class _KrylovSolver:
80
+ """Conjugate gradients on a tangent operator applied matrix-free (``apply``),
81
+ preconditioned in Fourier space (``precondition``), from a starting point when one is
82
+ given (the solver of :meth:`_VoxelPaths.linearize`); GMRES on an operator that is not
83
+ ``symmetric``, recycling the space of ``recycle`` (shared by the solves of a path: the
84
+ operator is a new one for it) and stopped where it stagnates
85
+ (:data:`~morphogen.homogenization.solvers.GMRES_STAGNATION`)."""
86
+
87
+ method = "fft"
88
+
89
+ def __init__(self, apply, precondition, tol: float, maxiter: int, symmetric: bool = True,
90
+ recycle: Recycling | None = None): # fmt: skip
91
+ self.apply = apply
92
+ self.precondition = precondition
93
+ self.tol = float(tol)
94
+ self.maxiter = int(maxiter)
95
+ self.krylov = conjugate_gradient
96
+ if not symmetric:
97
+ self.krylov = partial(gmres, recycle=recycle, stagnation=GMRES_STAGNATION)
98
+ if recycle is not None:
99
+ recycle.renew()
100
+
101
+ def solve(self, rhs, x0=None, tol=None) -> tuple[np.ndarray, SolveInfo]:
102
+ """Solution of ``K x = rhs`` to the relative residual ``tol`` (default: that of
103
+ the solver), from ``x0`` if given. The nodal forces of a periodic grid sum to
104
+ zero (the translations are the kernel of ``K``): the mean of ``rhs``, round-off,
105
+ is removed."""
106
+ b = np.asarray(rhs, dtype=float).reshape(-1, 3)
107
+ b = (b - b.mean(axis=0)).ravel()
108
+ n = b.size
109
+ t0 = time.perf_counter()
110
+ tol = self.tol if tol is None else float(tol)
111
+ norm_b = norm(b)
112
+ if norm_b == 0.0:
113
+ return np.zeros(n), SolveInfo(self.method, n, 0, 0.0, 0.0, 0.0)
114
+ start = None if x0 is None or not np.any(x0) else np.asarray(x0, dtype=float)
115
+ r = b if start is None else b - self.apply(start)
116
+ norm_r = norm(r)
117
+ iterations, residual = 0, norm_r / norm_b
118
+ if norm_r <= tol * norm_b:
119
+ x = np.zeros(n) if start is None else start.copy()
120
+ else:
121
+ x, iterations, rel = self.krylov(
122
+ self.apply, self.precondition, r, tol * norm_b / norm_r, self.maxiter
123
+ )
124
+ residual = rel * norm_r / norm_b
125
+ if start is not None:
126
+ x += start
127
+ if residual > 10 * tol:
128
+ log.warning(
129
+ "FFT solver stopped at relative residual %.2e (tolerance %.1e)", residual, tol
130
+ )
131
+ info = SolveInfo(self.method, n, iterations, residual, 0.0, time.perf_counter() - t0)
132
+ return x, info
133
+
134
+
135
+ class _VoxelPaths(_PointArrays):
136
+ """Discretization of the loading paths on the voxels (see
137
+ :class:`~morphogen.homogenization.nonlinear._PathSolver`): the periodic nodal
138
+ fluctuation (3 unknowns per voxel), the integration points of the voxels that carry
139
+ material, the tangent applied matrix-free and solved by FFT-preconditioned conjugate
140
+ gradients (GMRES for full tangents); on the CPU (on the GPU:
141
+ :class:`morphogen.homogenization.gpu.VoxelPaths`)."""
142
+
143
+ def __init__(self, problem: NonlinearFFTProblem):
144
+ self.problem = problem
145
+ self.shape = problem.shape
146
+ self.finite = problem.finite
147
+ self.elem = problem.elem
148
+ self.slot = problem.slot
149
+ el = problem.element
150
+ self.g_gauss = np.array(el.g_gauss)
151
+ self.weight = float(el.weight)
152
+ self.n_q = 3 * int(np.prod(self.shape))
153
+ self.reference = problem._reference_element()
154
+ self.bbar = problem.integration == "bbar"
155
+ self.tol = problem.tol
156
+ self.maxiter = problem.maxiter or 20 * int(max(self.shape)) + 1000
157
+ #: The space that the GMRES solves of the path recycle (empty until one restarts)
158
+ self.recycling = Recycling()
159
+ self._buffers(problem.kind.size, 9 if self.finite else 6)
160
+
161
+ def _buffers(self, n_pts: int, nc: int) -> None:
162
+ """The preconditioner and the work arrays of ``n_pts`` points (``nc`` components)."""
163
+ self.precondition = FourierPreconditioner.from_element(self.shape, self.reference, 3)
164
+ self.work = np.zeros((n_pts, nc))
165
+ # F-bar: the gradients of the points and the stresses of their behaviours
166
+ keep = self.finite and self.bbar
167
+ self.base = np.zeros((n_pts if keep else 1, 9))
168
+ self.stress = np.zeros((n_pts if keep else 1, nc))
169
+ self.zero = np.zeros(9)
170
+
171
+ def _nodal(self, s) -> tuple[np.ndarray, float]:
172
+ """Nodal forces of the point stresses ``s`` and their norm before they cancel;
173
+ forces below ``NEGLIGIBLE`` times that norm are round-off (uniform stresses, as
174
+ in a homogeneous medium), set to zero."""
175
+ nx, ny, nz = self.shape
176
+ out = np.empty(self.n_q)
177
+ scale = kernels.voxel_forces(
178
+ nx, ny, nz, self.slot, s, self.weight, self.g_gauss, self.finite, out
179
+ )
180
+ if norm(out) <= NEGLIGIBLE * scale:
181
+ out[:] = 0.0
182
+ return out, scale
183
+
184
+ def _macro(self, e) -> np.ndarray:
185
+ """Macroscopic gradient (9, row by row) of the macroscopic components ``e``:
186
+ upper triangular in finite strains, symmetric in small strains."""
187
+ if self.finite:
188
+ return fin.gradient_of(e)
189
+ return voigt_to_tensor(e, strain=True).ravel()
190
+
191
+ def measures(self, q, e, grads, wts) -> None:
192
+ nx, ny, nz = self.shape
193
+ kernels.voxel_measures(nx, ny, nz, self.elem, q, self._macro(e), self.g_gauss,
194
+ self.finite, self.bbar, grads, self.base) # fmt: skip
195
+ wts.fill(self.weight)
196
+
197
+ def forces(self, sigma, wts):
198
+ """With B-bar (F-bar), the stresses of the points are first replaced by their
199
+ conjugates: the outputs report them."""
200
+ if self.bbar:
201
+ if self.finite:
202
+ np.copyto(self.stress, sigma)
203
+ kernels.voxel_effective(self.elem.size, self.finite, sigma, self.base)
204
+ out, scale = self._nodal(sigma)
205
+ return out, self.weight * sigma.sum(axis=0), scale
206
+
207
+ def _increments(self, v, direction, tangent) -> np.ndarray:
208
+ """Stress increments (conjugate ones with B-bar) of the points for the nodal
209
+ displacements ``v`` and the uniform gradient ``direction``."""
210
+ nx, ny, nz = self.shape
211
+ kernels.voxel_tangent_stress(nx, ny, nz, self.elem, v, direction, tangent, self.stress,
212
+ self.base, self.g_gauss, self.finite, self.bbar,
213
+ self.work) # fmt: skip
214
+ return self.work
215
+
216
+ #: The linear solver is a Krylov method (see :attr:`_PathSolver.measured`)
217
+ iterative = True
218
+
219
+ def linearize(self, tangent, wts, first: bool, symmetric: bool | None = None):
220
+ def apply(v):
221
+ return self._nodal(self._increments(v, self.zero, tangent))[0]
222
+
223
+ symmetric = self.problem.symmetrize if symmetric is None else symmetric
224
+ return _KrylovSolver(apply, self.precondition, self.tol, self.maxiter, symmetric,
225
+ self.recycling) # fmt: skip
226
+
227
+ def macro_response(self, tangent, wts, v) -> np.ndarray:
228
+ """``K_Ew v``: the integral of the stress increments (conjugate ones with B-bar and
229
+ F-bar) of the points for the nodal fluctuation ``v``."""
230
+ total = self.weight * self._increments(v, self.zero, tangent).sum(axis=0)
231
+ return fin.macro_part(total) if self.finite else total
232
+
233
+ def coupling(self, tangent, wts, unknown):
234
+ g = np.empty((self.n_q, unknown.size))
235
+ kee = np.zeros((6, 6))
236
+ still = np.zeros(self.n_q)
237
+ for k, j in enumerate(unknown):
238
+ unit = np.zeros(6)
239
+ unit[j] = 1.0
240
+ ds = self._increments(still, self._macro(unit), tangent)
241
+ g[:, k] = self._nodal(ds)[0]
242
+ total = self.weight * ds.sum(axis=0)
243
+ kee[:, j] = fin.macro_part(total) if self.finite else total
244
+ return g, kee
245
+
246
+ def displacement(self, q, e) -> np.ndarray:
247
+ """Displacement at the centres of all the voxels (voxels x 3)."""
248
+ image = self.problem.image
249
+ nx, ny, nz = self.shape
250
+ if self.finite:
251
+ macro = fin.gradient_of(e).reshape(3, 3)
252
+ else:
253
+ macro = voigt_to_tensor(e, strain=True)
254
+ axes = [
255
+ image.origin[d] + (np.arange(n) + 0.5) * image.spacing[d]
256
+ for d, n in enumerate(self.shape)
257
+ ]
258
+ x = np.stack(np.meshgrid(*axes, indexing="ij"), axis=-1).reshape(-1, 3)
259
+ mean = np.empty((nx * ny * nz, 3))
260
+ kernels.voxel_centres(nx, ny, nz, q, mean)
261
+ return x @ macro.T + mean
262
+
263
+
264
+ class NonlinearFFTProblem(_PathSolver, FFTElasticProblem):
265
+ """Nonlinear behaviours of the phases (von Mises elasto-(visco)plasticity, crystal
266
+ plasticity) on a periodic voxel image, loaded along paths: the periodic element on
267
+ trilinear voxels, whose macroscopic strain components are degrees of freedom, each
268
+ Newton correction solved by FFT-preconditioned conjugate gradients (GMRES with full
269
+ tangents), in small or finite strains (``kinematics``). Crystals are turned by the
270
+ orientations of their grains (``grains``: image or array of grain labels;
271
+ ``orientations``: Bunge angles of each grain).
272
+
273
+ ``integration``: ``"bbar"`` (default) averages the volumetric part of the measures
274
+ over each voxel (B-bar in small strains, F-bar in finite strains), so that the
275
+ trilinear voxels do not lock under isochoric plastic flow; ``"full"`` integrates every
276
+ component at the 8 Gauss points (the discretization of the linear FFT solver).
277
+ ``device``: ``"gpu"`` runs the iterations on the GPU, where the arrays of the points
278
+ stay (the measures, the integration of the behaviours, the nodal forces and the
279
+ conjugate gradients; see :mod:`morphogen.homogenization.gpu`), ``"auto"`` when there
280
+ is one. ``tangent``: the consistent tangents of the points symmetrized and solved by
281
+ conjugate gradients (``"symmetric"``), full and solved by GMRES (``"full"``), or by
282
+ default (``"auto"``) symmetrized when the laws of all the phases have symmetric
283
+ tangents (:func:`~morphogen.homogenization.nonlinear.behaviour_table`:
284
+ :attr:`symmetrize` tells which), and otherwise at each linearization where their
285
+ asymmetry is below :data:`~morphogen.homogenization.nonlinear.ASYMMETRY`
286
+ (:attr:`measured`; the outputs report the largest asymmetry and the linearizations
287
+ solved with the full tangents).
288
+ ``tol``: relative residual of the conjugate gradients (the Newton corrections are
289
+ solved inexactly above it); ``maxiter``: their iterations; ``reference``: Lamé
290
+ coefficients of the reference medium of the preconditioner (default: the means of the
291
+ extreme elastic moduli of the phases); ``newton_tol``, ``max_newton`` and
292
+ ``max_cuts``: as for :class:`~morphogen.homogenization.nonlinear.NonlinearFEProblem`.
293
+ """
294
+
295
+ def __init__(
296
+ self,
297
+ image: VoxelImage,
298
+ materials: dict[int, Material],
299
+ bc: str = "periodic",
300
+ *,
301
+ tol: float = 1e-8,
302
+ maxiter: int | None = None,
303
+ reference: tuple[float, float] | None = None,
304
+ grains=None,
305
+ orientations=None,
306
+ newton_tol: float = 1e-6,
307
+ max_newton: int = 25,
308
+ max_cuts: int = 10,
309
+ kinematics: str = "small",
310
+ integration: str = "bbar",
311
+ device: str = "cpu",
312
+ tangent: str = "auto",
313
+ ):
314
+ if integration not in INTEGRATIONS:
315
+ raise ValueError(f"integration: one of {INTEGRATIONS}, got {integration!r}")
316
+ self.integration = integration
317
+ super().__init__(
318
+ image,
319
+ materials,
320
+ bc,
321
+ tol=tol,
322
+ maxiter=maxiter,
323
+ reference=reference,
324
+ grains=grains,
325
+ orientations=orientations,
326
+ device=device,
327
+ )
328
+ self._path_options(newton_tol, max_newton, max_cuts, kinematics, tangent)
329
+ self.materials = materials
330
+ self._smoothing: dict = {} # the Fourier symbols of the equation of the microdamage
331
+ self.groups: tuple[int, ...] = ()
332
+ if not self.empty:
333
+ # the voxels that carry material, and the phases they belong to
334
+ self.elem = np.flatnonzero(self.active)
335
+ self.slot = np.full(self.mat.size, -1, dtype=np.int64)
336
+ self.slot[self.elem] = np.arange(self.elem.size)
337
+ present = np.unique(self.stat[self.elem])
338
+ self.groups = tuple(self.table.phases[g] for g in present)
339
+ group = np.searchsorted(present, self.stat[self.elem])
340
+ table = dataclasses.replace(self.table, mat=self.mat[self.elem], stat=group)
341
+ phase = np.asarray(image.data).ravel()[self.elem]
342
+ beh = behaviour_table(phase, materials, table, finite=self.finite)
343
+ self._point_behaviours(beh, self.mat[self.elem], group, 8)
344
+
345
+ def _discretization(self) -> _VoxelPaths:
346
+ if self.device == "gpu":
347
+ from morphogen.homogenization import gpu
348
+
349
+ return gpu.VoxelPaths(self)
350
+ return _VoxelPaths(self)
351
+
352
+ def _support(self) -> VoxelImage:
353
+ return self.image
354
+
355
+ def _smooth(self, elements, values, length) -> np.ndarray:
356
+ """The equation of the microdamage on the grid of the voxels, ``chi - length^2
357
+ lap chi = values`` with the ``values`` of the voxels ``elements`` (among those
358
+ that carry material; nothing elsewhere) and the seven-point Laplacian, solved in
359
+ Fourier space: the inverse of a positive operator, so that the microdamage of a
360
+ damage is positive, and spreads through the voxels of the other phases."""
361
+ voxels = self.elem[elements]
362
+ grid = np.zeros(self.mat.size)
363
+ grid[voxels] = values
364
+ symbol = self._smoothing.get(float(length))
365
+ if symbol is None:
366
+ symbol = np.ones(1)
367
+ for axis, (n, h) in enumerate(zip(self.shape, self.image.spacing, strict=True)):
368
+ last = axis == len(self.shape) - 1
369
+ k = np.arange(n // 2 + 1) if last else np.arange(n)
370
+ term = (length / h) ** 2 * (2.0 - 2.0 * np.cos(2.0 * np.pi * k / n))
371
+ shape = [1] * len(self.shape)
372
+ shape[axis] = term.size
373
+ symbol = symbol + term.reshape(shape)
374
+ self._smoothing[float(length)] = symbol
375
+ axes = tuple(range(len(self.shape)))
376
+ spectrum = np.fft.rfftn(grid.reshape(self.shape), axes=axes) / symbol
377
+ smooth = np.fft.irfftn(spectrum, s=self.shape, axes=axes)
378
+ return smooth.ravel()[voxels]
379
+
380
+ def _fields(self, sigma, grads, state, u) -> dict[str, np.ndarray]:
381
+ """The fields of the finite elements on the grid of the image (voxels x
382
+ components; NaN in the pores), the displacement at the centres of the voxels."""
383
+ out = {}
384
+ for name, values in super()._fields(sigma, grads, state, u).items():
385
+ if name == "displacement":
386
+ out[name] = values.reshape(*self.shape, 3)
387
+ continue
388
+ full = np.full((self.mat.size, *values.shape[1:]), np.nan)
389
+ full[self.elem] = values
390
+ out[name] = full.reshape(*self.shape, *values.shape[1:])
391
+ return out