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,488 @@
1
+ """Figures and videos of the realizations of a run (the ``visualization`` section of the
2
+ configurations): the chain from the morphological model to its voxel image, its
3
+ conforming mesh and the fields of its homogenization.
4
+
5
+ A view shows one object of each realization (``of``):
6
+
7
+ * ``image``: the voxel image; figures: its three middle sections (``kind: sections``) or
8
+ the surface of a ``phase`` (``surface``, VTK); videos: the three sections moving
9
+ together (``orthoslices``, the default, as in Avizo), a section sweeping along ``axis``
10
+ (``sections``) or the surface of a phase turning (``surface``);
11
+ * ``labels``: the cell labels of tessellations and grain structures (sections,
12
+ orthoslices);
13
+ * ``mesh``: the conforming mesh coloured by phase (``color: none``: uniform); figures: a
14
+ view; videos: a turntable (``turntable``) or a cross-section sweeping along ``axis``
15
+ (``sweep``);
16
+ * a result of the homogenization, ``<property>.<bc>`` (bulk_modulus, shear_modulus,
17
+ conductivity), ``<loading>.<bc>`` or ``<path>.<bc>``: the field ``color`` (by default the
18
+ von Mises stress, or the norm of the heat flux) on the mesh deformed by its displacement
19
+ magnified ``magnification`` times (by default the largest displacement drawn as a tenth
20
+ of the mesh, and the true deformation along loading paths in finite strains; ``part:
21
+ fluctuation`` removes the macroscopic part ``E x``), cut by the plane ``section: (axis,
22
+ fraction)``; on the voxels of the FFT solver, the sections of the field. Videos of
23
+ properties and loadings grow the load (``wave: ramp``) or make it oscillate (``wave:
24
+ sine``); those of loading paths follow their steps from the natural state (``frames``:
25
+ interpolated between the steps). Figures of loading paths draw their curves (``kind:
26
+ curves``, the default) or their field at the end (``kind: field``).
27
+
28
+ The fields are named as in the files of the fields: ``von_mises``, ``energy_density``,
29
+ ``stress_11`` ... ``stress_12`` and ``strain_11`` ... (Voigt order 11, 22, 33, 23, 31, 12),
30
+ ``displacement`` (its norm); ``flux``, ``gradient`` (norms), ``flux_1`` ...,
31
+ ``dissipation``, ``temperature``; along paths ``p`` (cumulated plastic strain) and
32
+ ``plastic_strain_11`` ...
33
+
34
+ Files: ``<stem>_<name>.<format>``, with the name given (``name``) or made of the object,
35
+ the kind and the field: ``spheres_0000_image_orthoslices.mp4``,
36
+ ``spheres_0000_shear_modulus_periodic_von_mises.png``.
37
+ """
38
+
39
+ from __future__ import annotations
40
+
41
+ import importlib.util
42
+ import logging
43
+ from pathlib import Path
44
+
45
+ import numpy as np
46
+
47
+ log = logging.getLogger("morphogen")
48
+
49
+ COMPONENTS = ("11", "22", "33", "23", "31", "12")
50
+ _TENSORS = tuple(f"{n}_{c}" for n in ("stress", "strain") for c in COMPONENTS)
51
+ #: The fields colouring the views of the results, by kind of result
52
+ FIELDS = {
53
+ "elastic": ("von_mises", "energy_density", "displacement", *_TENSORS),
54
+ "thermal": (
55
+ "flux",
56
+ "gradient",
57
+ "dissipation",
58
+ "temperature",
59
+ *(f"flux_{d}" for d in "123"),
60
+ *(f"gradient_{d}" for d in "123"),
61
+ ),
62
+ "path": (
63
+ "von_mises",
64
+ "p",
65
+ "displacement",
66
+ *_TENSORS,
67
+ *(f"plastic_strain_{c}" for c in COMPONENTS),
68
+ # of the crystals that twin or cleave
69
+ "twin_fraction",
70
+ "twin_reoriented",
71
+ "twin_misorientation",
72
+ "cleavage_opening",
73
+ "cleavage_damage",
74
+ "cleavage_microdamage",
75
+ # of the cells whose interfaces debond, and of the fatigue of a cycle
76
+ "interface_damage",
77
+ "interface_opening",
78
+ "fatigue_utilization",
79
+ "fatigue_equivalent",
80
+ "fatigue_amplitude",
81
+ "fatigue_hydrostatic_max",
82
+ # of the criterion of cleavage of Beremin
83
+ "beremin_stress",
84
+ ),
85
+ }
86
+ DEFAULT_FIELD = {"elastic": "von_mises", "thermal": "flux", "path": "von_mises"}
87
+ #: The fields of the nodes of finite element meshes (the displacement of the loading
88
+ #: paths of the FFT solver is at the centres of the voxels)
89
+ NODAL = ("displacement", "temperature")
90
+ #: The kinds of the figures and of the videos of each object, the first ones the defaults
91
+ KINDS = {
92
+ "image": (("sections", "surface"), ("orthoslices", "sections", "surface")),
93
+ "labels": (("sections",), ("orthoslices", "sections")),
94
+ "mesh": (("view",), ("turntable", "sweep")),
95
+ "result": (("field",), ("field",)),
96
+ "path": (("curves", "field"), ("field",)),
97
+ }
98
+ _VECTORS = ("displacement", "flux", "gradient")
99
+
100
+
101
+ def von_mises(stress) -> np.ndarray:
102
+ """Von Mises stress of stresses in the Voigt order (last axis; tensor shears)."""
103
+ s = np.asarray(stress, dtype=float)
104
+ mean = s[..., :3].sum(axis=-1) / 3.0
105
+ dev2 = np.sum((s[..., :3] - mean[..., None]) ** 2, axis=-1)
106
+ dev2 += 2.0 * np.sum(s[..., 3:] ** 2, axis=-1)
107
+ return np.sqrt(1.5 * dev2)
108
+
109
+
110
+ def element_arrays(fields: dict, physics: str) -> dict[str, np.ndarray]:
111
+ """The element fields of a solution (``Solution.fields``) by name: energy density, von
112
+ Mises stress, stress and strain components; or dissipation, flux and gradient
113
+ components."""
114
+ out: dict[str, np.ndarray] = {}
115
+ if physics == "elastic":
116
+ eps, sig = fields["strain"], fields["stress"]
117
+ out["energy_density"] = fields["energy"]
118
+ out["von_mises"] = von_mises(sig)
119
+ for i, name in enumerate(COMPONENTS):
120
+ out[f"stress_{name}"] = sig[..., i]
121
+ for i, name in enumerate(COMPONENTS):
122
+ out[f"strain_{name}"] = eps[..., i]
123
+ else:
124
+ grad, flux = fields["gradient"], fields["flux"]
125
+ out["dissipation"] = fields["dissipation"]
126
+ for d in range(3):
127
+ out[f"flux_{d + 1}"] = flux[..., d]
128
+ for d in range(3):
129
+ out[f"gradient_{d + 1}"] = grad[..., d]
130
+ return out
131
+
132
+
133
+ def solution_fields(solution) -> dict[str, np.ndarray]:
134
+ """All the named fields of a solution kept with ``fields=True``: those of
135
+ :func:`element_arrays`, the nodal displacement or temperature of finite elements, and
136
+ the flux and gradient vectors."""
137
+ fields = solution.fields
138
+ out = element_arrays(fields, solution.physics)
139
+ if solution.physics == "elastic":
140
+ if "displacement" in fields:
141
+ out["displacement"] = np.asarray(fields["displacement"])
142
+ else:
143
+ out["flux"] = np.asarray(fields["flux"])
144
+ out["gradient"] = np.asarray(fields["gradient"])
145
+ if "temperature" in fields:
146
+ out["temperature"] = np.asarray(fields["temperature"])
147
+ return out
148
+
149
+
150
+ def path_fields(arrays: dict) -> dict[str, np.ndarray]:
151
+ """The named fields of a loading path at one time (``PathResult.fields[t]``)."""
152
+ out = {"von_mises": np.asarray(arrays["mises"]), "p": np.asarray(arrays["p"])}
153
+ for name in ("stress", "strain", "plastic_strain"):
154
+ values = np.asarray(arrays[name])
155
+ for i, c in enumerate(COMPONENTS):
156
+ out[f"{name}_{c}"] = values[..., i]
157
+ if "displacement" in arrays:
158
+ out["displacement"] = np.asarray(arrays["displacement"])
159
+ for name in FIELDS["path"]: # the other scalar fields that a solver or a study adds
160
+ if name in arrays and name not in out:
161
+ out[name] = np.asarray(arrays[name])
162
+ return out
163
+
164
+
165
+ def field_values(named: dict, name: str) -> np.ndarray:
166
+ """The values of the field ``name`` among the named fields (vectors by their norm)."""
167
+ if name not in named:
168
+ raise ValueError(f"visualization: no field {name!r} here (fields: {', '.join(named)})")
169
+ values = np.asarray(named[name], dtype=float)
170
+ if name in _VECTORS and values.shape[-1] == 3:
171
+ values = np.linalg.norm(values, axis=-1)
172
+ return values
173
+
174
+
175
+ def requirements(spec) -> set[str]:
176
+ """What the views of a :class:`~morphogen.config.VisualizationSpec` need: ``"vtk"``
177
+ (3D views), ``"ffmpeg"`` (.mp4), ``"matplotlib"`` (figures)."""
178
+ out = {"matplotlib"} if spec.views else set() # the colormaps
179
+ if any(view.vtk for view in spec.views):
180
+ out.add("vtk")
181
+ if any("mp4" in v.formats for v in spec.videos):
182
+ out.add("ffmpeg")
183
+ return out
184
+
185
+
186
+ def check(spec) -> None:
187
+ """Raise an error naming what the views need and is missing (before a run)."""
188
+ from morphogen.viz.video import ffmpeg_path, vtk_can_render
189
+
190
+ missing = []
191
+ for need in sorted(requirements(spec)):
192
+ if need == "ffmpeg":
193
+ if ffmpeg_path() is None:
194
+ missing.append(
195
+ "ffmpeg for .mp4 videos (on the PATH, MORPHOGEN_FFMPEG, or pip install "
196
+ "imageio-ffmpeg; or the format gif)"
197
+ )
198
+ elif importlib.util.find_spec(need) is None:
199
+ missing.append(
200
+ "VTK for the 3D views (pip install 'morphogen[video]')"
201
+ if need == "vtk"
202
+ else "matplotlib for the figures (pip install 'morphogen[plot]')"
203
+ )
204
+ elif need == "vtk" and not vtk_can_render():
205
+ missing.append(
206
+ "a display for the 3D views of VTK (X, EGL or OSMesa; on a headless machine, "
207
+ "run under xvfb-run)"
208
+ )
209
+ if missing:
210
+ raise RuntimeError("visualization: missing " + "; ".join(missing))
211
+
212
+
213
+ # -- views -------------------------------------------------------------------------------
214
+
215
+
216
+ def _camera(spec) -> dict:
217
+ """The camera of the 3D views of a visualization section."""
218
+ return {"elevation": spec.elevation, "azimuth": spec.azimuth}
219
+
220
+
221
+ def _save_rgb(rgb: np.ndarray, path: Path) -> Path:
222
+ from PIL import Image
223
+
224
+ path.parent.mkdir(parents=True, exist_ok=True)
225
+ options = {"compression": "tiff_lzw"} if path.suffix.lower() in (".tif", ".tiff") else {}
226
+ Image.fromarray(np.ascontiguousarray(rgb[..., :3])).save(path, **options)
227
+ return path
228
+
229
+
230
+ def _source(view, image, labels):
231
+ source = labels if view.of == "labels" else image
232
+ if source is None:
233
+ what = "cell labels (tessellations, grain structures)" if view.of == "labels" else "image"
234
+ raise ValueError(f"visualization: this realization has no {what}")
235
+ return source
236
+
237
+
238
+ def _result(results, key: str):
239
+ if not results or key not in results:
240
+ raise ValueError(
241
+ f"visualization: no result {key!r} (results: {', '.join(sorted(results or {}))})"
242
+ )
243
+ return results[key]
244
+
245
+
246
+ def _points(support) -> np.ndarray:
247
+ """The nodes of a mesh, or the centres of the voxels of an image (nx, ny, nz, 3)."""
248
+ from morphogen.mesh.tetra import TetMesh
249
+
250
+ if isinstance(support, TetMesh):
251
+ return support.nodes
252
+ axes = [
253
+ support.origin[d] + (np.arange(n) + 0.5) * support.spacing[d]
254
+ for d, n in enumerate(support.data.shape)
255
+ ]
256
+ return np.stack(np.meshgrid(*axes, indexing="ij"), axis=-1)
257
+
258
+
259
+ def _macro(res, time) -> np.ndarray:
260
+ """The macroscopic strain (displacement gradient in finite strains) of a result."""
261
+ from morphogen.homogenization.paths import PathResult
262
+
263
+ if not isinstance(res, PathResult):
264
+ return np.asarray(res.solution.strain, dtype=float)
265
+ k = int(np.argmin(np.abs(np.asarray(res.times) - time)))
266
+ if res.finite:
267
+ from morphogen.homogenization.finite import gradient_of
268
+
269
+ return np.asarray(gradient_of(res.strain[k]), dtype=float).reshape(3, 3)
270
+ from morphogen.homogenization.elements import voigt_to_tensor
271
+
272
+ return voigt_to_tensor(res.strain[k], strain=True)
273
+
274
+
275
+ def _snapshot(res, view, time=None):
276
+ """The support, the named fields and the displacement (``None`` without one) of a
277
+ result (of a loading path: at ``time``)."""
278
+ from morphogen.homogenization.paths import PathResult
279
+
280
+ if isinstance(res, PathResult):
281
+ if time not in res.fields:
282
+ raise ValueError(f"visualization: {view.of} kept no fields at time {time}")
283
+ support, named = res.support, path_fields(res.fields[time])
284
+ else:
285
+ sol = res.solution
286
+ if sol.fields is None:
287
+ raise ValueError(f"visualization: {view.of} kept no fields")
288
+ support, named = sol.support, solution_fields(sol)
289
+ u = named.get("displacement")
290
+ if u is not None and view.part == "fluctuation":
291
+ u = u - _points(support) @ _macro(res, time).T
292
+ return support, named, u
293
+
294
+
295
+ def _magnification(view, res):
296
+ from morphogen.homogenization.paths import PathResult
297
+
298
+ if view.magnification is None and isinstance(res, PathResult) and res.finite:
299
+ return 1.0 if view.part == "total" else None # the true deformation
300
+ return view.magnification
301
+
302
+
303
+ def _figure(spec, view, path: Path, image, labels, mesh, results) -> Path:
304
+ from morphogen.homogenization.paths import PathResult
305
+ from morphogen.mesh.tetra import TetMesh
306
+ from morphogen.viz import video as vv
307
+ from morphogen.viz.export import save_figure
308
+ from morphogen.viz.figures import field_figure, path_figure, slices_figure
309
+
310
+ cmap = view.cmap or spec.cmap
311
+ if view.of in ("image", "labels"):
312
+ source = _source(view, image, labels)
313
+ if view.kind == "surface":
314
+ frame = vv.turntable_frames(
315
+ source, phase=view.phase, frames=1, size=spec.size, **_camera(spec)
316
+ )[0]
317
+ return _save_rgb(frame, path)
318
+ return save_figure(slices_figure(source, labels=view.of == "labels"), path, dpi=spec.dpi)
319
+ if view.of == "mesh":
320
+ if mesh is None:
321
+ raise ValueError("visualization: this realization has no conforming mesh")
322
+ field = None if view.color == "none" else "phase"
323
+ return _save_rgb(vv.deformed_view(mesh, None, field, size=spec.size, **_camera(spec)), path)
324
+ res = _result(results, view.of)
325
+ title = f"{view.of}: {view.color}" if view.kind == "field" else view.of
326
+ if isinstance(res, PathResult) and view.kind == "curves":
327
+ return save_figure(path_figure(res, title=title), path, dpi=spec.dpi)
328
+ time = max(res.fields) if isinstance(res, PathResult) and res.fields else None
329
+ support, named, u = _snapshot(res, view, time)
330
+ values = field_values(named, view.color)
331
+ if isinstance(support, TetMesh):
332
+ rgb = vv.deformed_view(
333
+ support,
334
+ u,
335
+ values,
336
+ magnification=_magnification(view, res),
337
+ section=view.section,
338
+ size=spec.size,
339
+ **_camera(spec),
340
+ cmap=cmap,
341
+ clim=view.clim,
342
+ title=view.color,
343
+ )
344
+ return _save_rgb(rgb, path)
345
+ fig = field_figure(values, cmap=cmap, clim=view.clim, title=title, label=view.color)
346
+ return save_figure(fig, path, dpi=spec.dpi)
347
+
348
+
349
+ def _natural(values: np.ndarray) -> np.ndarray:
350
+ """The natural state of a field: zero, NaN kept (the pores of images)."""
351
+ return np.where(np.isnan(values), np.nan, 0.0)
352
+
353
+
354
+ def _frames(spec, view, image, labels, mesh, results) -> list[np.ndarray]:
355
+ from morphogen.homogenization.paths import PathResult
356
+ from morphogen.mesh.tetra import TetMesh
357
+ from morphogen.viz import video as vv
358
+
359
+ cmap = view.cmap or spec.cmap
360
+ if view.of in ("image", "labels"):
361
+ source = _source(view, image, labels)
362
+ flags = {"labels": True} if view.of == "labels" else {}
363
+ if view.kind == "orthoslices":
364
+ size = max(spec.size) // 2
365
+ return vv.orthoslice_frames(
366
+ source, frames=view.frames or 48, size=size, cmap=cmap, **flags
367
+ )
368
+ if view.kind == "sections":
369
+ return vv.section_frames(source, view.axis, size=max(spec.size), cmap=cmap, **flags)
370
+ return vv.turntable_frames(
371
+ source, phase=view.phase, frames=view.frames or 72, size=spec.size, **_camera(spec)
372
+ )
373
+ if view.of == "mesh":
374
+ if mesh is None:
375
+ raise ValueError("visualization: this realization has no conforming mesh")
376
+ field = None if view.color == "none" else "phase"
377
+ if view.kind == "turntable":
378
+ return vv.turntable_frames(
379
+ mesh, field=field, frames=view.frames or 72, size=spec.size, **_camera(spec)
380
+ )
381
+ return vv.section_sweep_frames(
382
+ mesh, field, axis=view.axis, frames=view.frames or 48, size=spec.size, **_camera(spec)
383
+ )
384
+ res = _result(results, view.of)
385
+ clim = view.clim
386
+ if isinstance(res, PathResult):
387
+ times = sorted(res.fields)
388
+ if not times:
389
+ raise ValueError(f"visualization: {view.of} kept no fields")
390
+ snaps = [_snapshot(res, view, t) for t in times]
391
+ support = snaps[0][0]
392
+ values = [field_values(named, view.color) for _, named, _ in snaps]
393
+ values.insert(0, _natural(values[0]))
394
+ captions = [f"t = {t:g}" for t in (float(res.times[0]), *times)]
395
+ if isinstance(support, TetMesh):
396
+ us = [np.zeros_like(support.nodes) if u is None else u for _, _, u in snaps]
397
+ us.insert(0, np.zeros_like(support.nodes))
398
+ return vv.history_frames(
399
+ support,
400
+ us,
401
+ values,
402
+ frames=view.frames,
403
+ magnification=_magnification(view, res),
404
+ section=view.section,
405
+ size=spec.size,
406
+ **_camera(spec),
407
+ cmap=cmap,
408
+ clim=clim,
409
+ title=view.color,
410
+ captions=captions,
411
+ )
412
+ lo, hi = clim or (None, None)
413
+ return vv.time_section_frames(
414
+ values,
415
+ view.axis,
416
+ size=max(spec.size),
417
+ cmap=cmap,
418
+ vmin=lo,
419
+ vmax=hi,
420
+ captions=captions,
421
+ label=view.color,
422
+ )
423
+ support, named, u = _snapshot(res, view)
424
+ values = field_values(named, view.color)
425
+ if isinstance(support, TetMesh):
426
+ if u is None: # conduction: no deformation, a cross-section sweeping through
427
+ return vv.section_sweep_frames(
428
+ support,
429
+ values,
430
+ axis=view.axis,
431
+ frames=view.frames or 48,
432
+ size=spec.size,
433
+ **_camera(spec),
434
+ cmap=cmap,
435
+ clim=clim,
436
+ title=view.color,
437
+ )
438
+ return vv.field_frames(
439
+ support,
440
+ u,
441
+ values,
442
+ magnification=view.magnification,
443
+ frames=view.frames or 48,
444
+ wave=view.wave,
445
+ section=view.section,
446
+ size=spec.size,
447
+ **_camera(spec),
448
+ cmap=cmap,
449
+ clim=clim,
450
+ title=view.color,
451
+ scaling=vv.field_scaling(view.color),
452
+ )
453
+ lo, hi = clim or (None, None)
454
+ return vv.section_frames(
455
+ values,
456
+ view.axis,
457
+ size=max(spec.size),
458
+ cmap=cmap,
459
+ vmin=lo,
460
+ vmax=hi,
461
+ labels=False,
462
+ bar=True,
463
+ label=view.color,
464
+ )
465
+
466
+
467
+ def visualize(spec, stem: str, outdir, *, image=None, labels=None, mesh=None, results=None):
468
+ """Write the figures and videos of ``spec`` (a
469
+ :class:`~morphogen.config.VisualizationSpec`) for one realization: its voxel ``image``,
470
+ cell ``labels``, conforming ``mesh`` and the ``results`` of its homogenization (kept
471
+ with their fields); returns the paths written."""
472
+ from morphogen.viz.video import write_video
473
+
474
+ outdir = Path(outdir)
475
+ written = []
476
+ for view in spec.figures:
477
+ for fmt in view.formats:
478
+ path = outdir / f"{stem}_{view.label}.{fmt}"
479
+ written.append(_figure(spec, view, path, image, labels, mesh, results))
480
+ log.info("figure %s", path.name)
481
+ for view in spec.videos:
482
+ frames = _frames(spec, view, image, labels, mesh, results)
483
+ for fmt in view.formats:
484
+ path = outdir / (f"{stem}_{view.label}" + ("_frames" if fmt == "frames" else f".{fmt}"))
485
+ fps = view.fps or spec.fps
486
+ written.append(write_video(frames, path, fps=fps, mode=view.mode, repeat=view.repeat))
487
+ log.info("video %s (%d frames)", path.name, len(frames))
488
+ return written