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,290 @@
1
+ """Post-processing of apparent properties: compliance, engineering constants and
2
+ anisotropy of stiffness tensors, macroscopic values of porous media, normalized and
3
+ specific values.
4
+
5
+ Stiffness and compliance. Every output of an elastic stiffness ``C`` gives its compliance
6
+ ``S = C^-1`` beside it, in the same notation (:data:`NOTATION`): morphoGen's Voigt order
7
+ ``11, 22, 33, 23, 31, 12`` with engineering shears (``11, 22, 12`` for plane problems,
8
+ :data:`PLANE_NOTATION`), so that ``S_11 = 1/E_1``, ``S_12 = -nu_12/E_1 = -nu_21/E_2`` and
9
+ ``S_44 = 1/G_23``, ``S_55 = 1/G_31``, ``S_66 = 1/G_12`` for an orthotropic material in its
10
+ axes (:func:`engineering_constants`). TFEL (MFront) and Abaqus order their shears ``12,
11
+ 13, 23``: a component ``C_44`` of morphoGen is their ``C_66``. The Mandel form of a
12
+ stiffness is ``W C W``, ``W = diag(1, 1, 1, √2, √2, √2)``, and of a compliance ``W^-1 S
13
+ W^-1``.
14
+
15
+ Macroscopic values of porous media. Meshes (or images) without their pores give the
16
+ macroscopic stress as the average over the whole volume element, the pores carrying
17
+ none: ``Sigma = phi <sigma>_s``, the average over the solid times the solid fraction
18
+ ``phi`` (as in the homogenization notice of Z-set). The macroscopic strain is not the
19
+ average over the solid: it is the prescribed strain, or the macroscopic unknowns solved
20
+ for under stress or mixed loadings (:func:`morphogen.homogenization.core.superpose`), as
21
+ the degrees of freedom of a periodic element. Solutions hold both (``Solution.strain``,
22
+ ``Solution.stress``) and the averages over each phase (``Solution.phases``).
23
+
24
+ Normalized values. For a property ``P`` (bulk, shear or Young's modulus, conductivity)
25
+ of a microstructure of solid fraction ``phi``, whose solid phases have the properties
26
+ ``P_i`` and the fractions ``f_i``:
27
+
28
+ * relative: ``P / P_s``, with ``P_s = sum f_i P_i / phi`` the property of the solid (of
29
+ its single phase for a porous medium);
30
+ * normalized: ``P / (phi P_s) = P / sum f_i P_i``, the property per unit of solid
31
+ fraction, relative to the Voigt bound (rule of mixtures), which bounds it by 1;
32
+ * specific: ``P / rho`` with the effective density ``rho = sum f_i rho_i``.
33
+
34
+ Relative properties against the relative density ``phi`` are the coordinates of the
35
+ normalized Ashby charts (:mod:`morphogen.results`); Gibson & Ashby (1997) scalings read
36
+ ``E / E_s ~ phi^n`` (``n = 1`` stretching-dominated, 2 bending-dominated foams).
37
+ """
38
+
39
+ from __future__ import annotations
40
+
41
+ import numpy as np
42
+
43
+ from morphogen.homogenization.materials import TRANSPORT, Material
44
+
45
+ #: Mandel weights of the Voigt order (sqrt(2) on the shears)
46
+ _W = np.array([1.0, 1.0, 1.0, np.sqrt(2.0), np.sqrt(2.0), np.sqrt(2.0)])
47
+
48
+ #: morphoGen's Voigt order of the rows and columns of stiffnesses and compliances, in space
49
+ #: and in the plane
50
+ VOIGT_ORDER = ("11", "22", "33", "23", "31", "12")
51
+ PLANE_ORDER = ("11", "22", "12")
52
+ #: The notation of a stiffness and of its compliance, stated by the outputs that give them
53
+ NOTATION = (
54
+ "Voigt, order 11 22 33 23 31 12 (TFEL and Abaqus: 11 22 33 12 13 23), engineering "
55
+ "shears; S = C^-1 in the same notation"
56
+ )
57
+ PLANE_NOTATION = "Voigt, order 11 22 12, engineering shear; S = C^-1 in the same notation"
58
+
59
+
60
+ #: The smallest eigenvalue of a stiffness, relative to its largest, at or below which the
61
+ #: stiffness is singular to round-off (a direction without stiffness, as across layers of
62
+ #: void, at 1e-17 of the rest), or not positive definite: it has no compliance
63
+ _ROUND_OFF = 10.0 * np.finfo(float).eps
64
+
65
+
66
+ def compliance(stiffness) -> np.ndarray:
67
+ """The compliance ``S = C^-1`` of a Voigt stiffness (6 x 6, order 11 22 33 23 31 12; 3
68
+ x 3, order 11 22 12, for plane problems; engineering shears), in the same notation:
69
+ ``S_11 = 1/E_1``, ``S_12 = -nu_12/E_1``, ``S_44 = 1/G_23`` (see the module). A
70
+ stiffness singular to round-off (its smallest eigenvalue within 10 machine epsilons of
71
+ its largest, or negative: a direction without stiffness, as across layers of void) has
72
+ none: NaN, not the inverse of its round-off; an exactly singular one raises
73
+ :class:`numpy.linalg.LinAlgError`; one only badly scaled keeps its inverse (a design
74
+ stiff along its fibres, 3, whose plane is as stiff as its void, 1e-12: 1e-14)."""
75
+ c = np.asarray(stiffness, dtype=float)
76
+ if c.shape not in ((6, 6), (3, 3)):
77
+ raise ValueError(f"stiffness: a 6 x 6 matrix (3 x 3 in the plane), got shape {c.shape}")
78
+ s = np.linalg.inv(c)
79
+ if np.all(np.isfinite(c)):
80
+ w = np.linalg.eigvalsh(0.5 * (c + c.T))
81
+ if not w[0] > _ROUND_OFF * w[-1]:
82
+ return np.full_like(c, np.nan)
83
+ return s
84
+
85
+
86
+ def notation(stiffness) -> str:
87
+ """The notation of a stiffness and of its compliance (:data:`NOTATION`;
88
+ :data:`PLANE_NOTATION` for a 3 x 3 one)."""
89
+ return PLANE_NOTATION if np.shape(stiffness) == (3, 3) else NOTATION
90
+
91
+
92
+ def matrix_entries(matrix, prefix: str) -> dict[str, float]:
93
+ """The entries of the upper triangle of a symmetric matrix as ``<prefix><i><j>``, the
94
+ indices from 1 in the Voigt order (``C11`` ... ``C66``, ``S11`` ... ``S66``): the
95
+ columns of the tables of results."""
96
+ m = np.asarray(matrix, dtype=float)
97
+ n = len(m)
98
+ return {f"{prefix}{i + 1}{j + 1}": float(m[i, j]) for i in range(n) for j in range(i, n)}
99
+
100
+
101
+ def engineering_constants(stiffness) -> dict[str, float]:
102
+ """Young's moduli ``E1, E2, E3``, Poisson's ratios ``nu_ij`` (contraction along
103
+ ``j`` under a stress along ``i``: ``-S_ij / S_ii``) and shear moduli ``G23, G31,
104
+ G12`` of a Voigt stiffness (order 11 22 33 23 31 12, engineering shears)."""
105
+ s = np.linalg.inv(np.asarray(stiffness, dtype=float))
106
+ out = {f"E{i + 1}": float(1.0 / s[i, i]) for i in range(3)}
107
+ for i in range(3):
108
+ for j in range(3):
109
+ if i != j:
110
+ out[f"nu{i + 1}{j + 1}"] = float(-s[i, j] / s[i, i])
111
+ for k, name in zip((3, 4, 5), ("G23", "G31", "G12"), strict=True):
112
+ out[name] = float(1.0 / s[k, k])
113
+ return out
114
+
115
+
116
+ #: The Voigt index of the shear of each plane of the axes
117
+ _SHEAR = {(0, 1): 5, (1, 2): 3, (0, 2): 4}
118
+
119
+
120
+ def directional_modulus(stiffness, angles, *, plane=(0, 1), plane_strain: bool = True):
121
+ """The Young's modulus ``1 / (n n : S : n n)`` along the directions ``n = cos(theta)
122
+ e_a + sin(theta) e_b`` of ``angles`` (radians) in the plane of the axes ``(a, b)`` of a
123
+ Voigt stiffness (6 x 6), under a uniaxial stress along ``n``: in plane strain (``S``
124
+ the inverse of the in-plane block ``a, b, ab`` of the stiffness: prisms across the
125
+ plane, as planar images one voxel thick) or in plane stress (``S`` the in-plane block
126
+ of the compliance, the other stresses free). A plane stiffness (3 x 3, Voigt 11, 22,
127
+ 12) is taken in plane strain as it is. The ratio of its least to its largest value
128
+ over the angles is the elastic anisotropy ``eta_E = E_min / E_max`` of Both et al.
129
+ (2026)."""
130
+ c = np.asarray(stiffness, dtype=float)
131
+ a, b = sorted(int(v) for v in plane)
132
+ if c.shape == (3, 3):
133
+ s = np.linalg.inv(c)
134
+ elif c.shape == (6, 6):
135
+ if (a, b) not in _SHEAR:
136
+ raise ValueError("plane: two distinct axes among 0, 1 and 2")
137
+ k = [a, b, _SHEAR[(a, b)]]
138
+ s = np.linalg.inv(c[np.ix_(k, k)]) if plane_strain else np.linalg.inv(c)[np.ix_(k, k)]
139
+ else:
140
+ raise ValueError("stiffness: a Voigt matrix of 6 x 6, or 3 x 3 in the plane")
141
+ if tuple(int(v) for v in plane) == (b, a): # the angles from the second axis given
142
+ s = s[np.ix_([1, 0, 2], [1, 0, 2])]
143
+ t = np.asarray(angles, dtype=float)
144
+ v = np.stack([np.cos(t) ** 2, np.sin(t) ** 2, np.cos(t) * np.sin(t)], axis=-1)
145
+ return 1.0 / np.einsum("...i,ij,...j->...", v, s, v)
146
+
147
+
148
+ def sphere_directions(count: int = 2000) -> np.ndarray:
149
+ """``count`` unit vectors spread evenly over the half-sphere ``z > 0`` (a Fibonacci
150
+ lattice): the directions of space up to their sign, as axes of moduli."""
151
+ k = np.arange(int(count)) + 0.5
152
+ z = k / int(count)
153
+ phi = np.pi * (1.0 + np.sqrt(5.0)) * k
154
+ r = np.sqrt(1.0 - z * z)
155
+ return np.column_stack([r * np.cos(phi), r * np.sin(phi), z])
156
+
157
+
158
+ def spatial_modulus(stiffness, directions) -> np.ndarray:
159
+ """The Young's modulus ``1 / (n n : S : n n)`` along unit vectors ``n`` of space
160
+ (``(m, 3)``, normalized here) of a Voigt stiffness (6 x 6, engineering shears), under a
161
+ uniaxial stress along ``n``: the plane-stress :func:`directional_modulus` in every
162
+ plane. Its least and largest values over :func:`sphere_directions` give the elastic
163
+ anisotropy ``eta_E = E_min / E_max`` of a 3D sample (Both et al. 2026)."""
164
+ c = np.asarray(stiffness, dtype=float)
165
+ if c.shape != (6, 6):
166
+ raise ValueError("stiffness: a Voigt matrix of 6 x 6")
167
+ s = np.linalg.inv(c)
168
+ n = np.asarray(directions, dtype=float).reshape(-1, 3)
169
+ n = n / np.linalg.norm(n, axis=1, keepdims=True)
170
+ v = np.column_stack([n[:, 0] ** 2, n[:, 1] ** 2, n[:, 2] ** 2,
171
+ n[:, 1] * n[:, 2], n[:, 2] * n[:, 0], n[:, 0] * n[:, 1]]) # fmt: skip
172
+ return 1.0 / np.einsum("mi,ij,mj->m", v, s, v)
173
+
174
+
175
+ def anisotropy(stiffness) -> dict[str, float]:
176
+ """Voigt and Reuss bulk and shear moduli of a Voigt stiffness, the universal
177
+ anisotropy index ``A_U = 5 G_V / G_R + K_V / K_R - 6`` (Ranganathan & Ostoja-
178
+ Starzewski 2008, zero for isotropy), the Zener ratio ``2 C44 / (C11 - C12)`` of its
179
+ mean cubic part (1 for isotropy) and the relative distance to the nearest isotropic
180
+ stiffness (its Voigt average, in the Mandel norm)."""
181
+ c = np.asarray(stiffness, dtype=float)
182
+ s = np.linalg.inv(c)
183
+ a, b, d = np.trace(c[:3, :3]), c[0, 1] + c[0, 2] + c[1, 2], np.trace(c[3:, 3:])
184
+ kv, gv = (a + 2.0 * b) / 9.0, (a - b + 3.0 * d) / 15.0
185
+ a, b, d = np.trace(s[:3, :3]), s[0, 1] + s[0, 2] + s[1, 2], np.trace(s[3:, 3:])
186
+ kr, gr = 1.0 / (a + 2.0 * b), 15.0 / (4.0 * a - 4.0 * b + 3.0 * d)
187
+ c11 = np.trace(c[:3, :3]) / 3.0
188
+ c12 = (c[0, 1] + c[0, 2] + c[1, 2]) / 3.0
189
+ c44 = np.trace(c[3:, 3:]) / 3.0
190
+ iso = np.zeros((6, 6))
191
+ iso[:3, :3] = kv - 2.0 * gv / 3.0
192
+ iso[[0, 1, 2], [0, 1, 2]] += 2.0 * gv
193
+ iso[[3, 4, 5], [3, 4, 5]] = gv
194
+ mandel = _W[:, None] * _W[None, :]
195
+ return {
196
+ "bulk_voigt": float(kv),
197
+ "bulk_reuss": float(kr),
198
+ "shear_voigt": float(gv),
199
+ "shear_reuss": float(gr),
200
+ "universal_anisotropy": float(5.0 * gv / gr + kv / kr - 6.0),
201
+ "zener_ratio": float(2.0 * c44 / (c11 - c12)) if c11 != c12 else float("nan"),
202
+ "isotropy_distance": float(np.linalg.norm((c - iso) * mandel) / np.linalg.norm(c * mandel)),
203
+ }
204
+
205
+
206
+ def solid_fraction(fractions: dict[int, float], materials: dict[int, Material]) -> float:
207
+ """Volume fraction of the phases that are not voids."""
208
+ return float(sum(f for p, f in fractions.items() if not materials[p].void))
209
+
210
+
211
+ def effective_density(fractions: dict[int, float], materials: dict[int, Material]):
212
+ """``sum f_i rho_i`` (exact), or None when a solid phase has no density."""
213
+ solid = [p for p in fractions if not materials[p].void]
214
+ if not solid or any(materials[p].density is None for p in solid):
215
+ return None
216
+ return float(sum(fractions[p] * materials[p].density for p in solid))
217
+
218
+
219
+ def _property(material: Material, name: str) -> float | None:
220
+ """Property of a phase: exact for isotropic materials, the Hill average of a crystal
221
+ (uniform orientations)."""
222
+ if name in _TRANSPORT: # the coefficient of a transport phenomenon
223
+ physics = _TRANSPORT[name]
224
+ if not material.has(physics):
225
+ return None
226
+ voigt = material.mean_conductivity("voigt", physics)
227
+ if voigt == 0.0: # an insulator
228
+ return 0.0
229
+ return 0.5 * (voigt + material.mean_conductivity("reuss", physics))
230
+ if not material.elastic:
231
+ return None
232
+ k, g = material.moduli("hill")
233
+ return {"bulk_modulus": k, "shear_modulus": g, "young": 9.0 * k * g / (3.0 * k + g)}[name]
234
+
235
+
236
+ #: the physics of the scalar property of each transport phenomenon
237
+ _TRANSPORT = {name: physics for physics, name in TRANSPORT.items()}
238
+ #: base property of the scalar results: apparent properties, and entries of tensors
239
+ _BASE = {
240
+ "bulk_modulus": "bulk_modulus",
241
+ "shear_modulus": "shear_modulus",
242
+ "conductivity": "conductivity",
243
+ "E1": "young",
244
+ "E2": "young",
245
+ "E3": "young",
246
+ "G23": "shear_modulus",
247
+ "G31": "shear_modulus",
248
+ "G12": "shear_modulus",
249
+ "mean": "conductivity",
250
+ }
251
+
252
+
253
+ def _base(key: str) -> str | None:
254
+ parts = key.split(".")
255
+ if parts[0] in ("bulk_modulus", "shear_modulus", *_TRANSPORT) and len(parts) == 2:
256
+ return parts[0]
257
+ if parts[0] == "stiffness" and len(parts) == 3 and parts[2] != "mean":
258
+ return _BASE.get(parts[2])
259
+ scalar = parts[0].removesuffix("_tensor") # the mean of the tensor of a transport
260
+ if scalar != parts[0] and scalar in _TRANSPORT and len(parts) == 3 and parts[2] == "mean":
261
+ return scalar
262
+ return None
263
+
264
+
265
+ def normalized_values(
266
+ values: dict, fractions: dict[int, float], materials: dict[int, Material]
267
+ ) -> dict[str, float]:
268
+ """Solid fraction, effective density, and the relative, normalized and specific
269
+ values (see the module) of the apparent properties in ``values`` (keys
270
+ ``<property>.<bc>``, and ``stiffness.<bc>.E1``... for the entries of tensors)."""
271
+ phi = solid_fraction(fractions, materials)
272
+ rho = effective_density(fractions, materials)
273
+ out: dict[str, float] = {"solid_fraction": phi}
274
+ if rho is not None:
275
+ out["density"] = rho
276
+ solid = [p for p in fractions if not materials[p].void and fractions[p] > 0]
277
+ for key, value in values.items():
278
+ base = _base(key)
279
+ if base is None or not isinstance(value, float):
280
+ continue
281
+ props = [_property(materials[p], base) for p in solid]
282
+ if not props or any(v is None for v in props):
283
+ continue
284
+ voigt = sum(fractions[p] * v for p, v in zip(solid, props, strict=True))
285
+ if voigt > 0 and phi > 0:
286
+ out[f"{key}.relative"] = value * phi / voigt
287
+ out[f"{key}.normalized"] = value / voigt
288
+ if rho:
289
+ out[f"{key}.specific"] = value / rho
290
+ return out