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,307 @@
1
+ """The FEniCSx solver: morphoGen's finite element problems assembled and solved by
2
+ dolfinx (``solver="fenicsx"``).
3
+
4
+ ``make_problem(mesh, materials, physics, bc, solver="fenicsx")`` (configurations:
5
+ ``homogenization: solver: fenicsx``; the command line: ``--solver fenicsx``) returns
6
+ problems whose fields come from FEniCSx: the weak forms of linear (thermo-)elasticity
7
+ and conduction written in UFL on the same tetrahedra, with Lagrange elements of the
8
+ order of the mesh and the materials of the elements (oriented crystals included) as
9
+ cellwise constant tensors; the periodic fluctuations by the multi-point constraints of
10
+ dolfinx_mpc (the upper faces of the box slaved to the lower ones, a node held against
11
+ translations); the kinematic, static and mixed conditions on the very degrees of
12
+ freedom that morphoGen's own solver constrains; PETSc's sparse direct solver (MUMPS) or,
13
+ beyond ``DIRECT_LIMIT`` unknowns, conjugate gradients preconditioned by algebraic
14
+ multigrid (GAMG, with the rigid-body modes). The averages, energies and statistics of
15
+ the phases are then evaluated from the fields as for morphoGen's solver, so that the
16
+ two are interchangeable (``homogenize``, RVE studies, configurations, the command line)
17
+ and check each other.
18
+
19
+ FEniCSx runs on Linux (or WSL): ``conda install -c conda-forge fenics-dolfinx
20
+ dolfinx_mpc``; dolfinx 0.11 and dolfinx_mpc 0.11 were used.
21
+ """
22
+
23
+ from __future__ import annotations
24
+
25
+ import time
26
+
27
+ import numpy as np
28
+ from scipy.spatial import cKDTree
29
+
30
+ from morphogen.homogenization.elements import voigt_to_tensor
31
+ from morphogen.homogenization.fe import FEElasticProblem, FEThermalProblem
32
+ from morphogen.homogenization.solvers import SolveInfo
33
+
34
+ #: Unknowns up to which PETSc's direct solver (MUMPS) is used.
35
+ DIRECT_LIMIT = 300_000
36
+
37
+
38
+ def available() -> bool:
39
+ """Whether dolfinx, dolfinx_mpc and petsc4py can be imported."""
40
+ try:
41
+ _modules()
42
+ except ImportError:
43
+ return False
44
+ return True
45
+
46
+
47
+ def _modules():
48
+ try:
49
+ import basix.ufl
50
+ import dolfinx
51
+ import dolfinx.fem.petsc
52
+ import dolfinx_mpc
53
+ import ufl
54
+ from mpi4py import MPI
55
+ from petsc4py import PETSc
56
+ except ImportError as exc: # pragma: no cover - depends on the platform
57
+ raise ImportError(
58
+ "solver 'fenicsx' needs FEniCSx: dolfinx, dolfinx_mpc and petsc4py "
59
+ "(conda install -c conda-forge fenics-dolfinx dolfinx_mpc; Linux or WSL)"
60
+ ) from exc
61
+ return basix, dolfinx, dolfinx_mpc, ufl, MPI, PETSc
62
+
63
+
64
+ class _Fenicsx:
65
+ """dolfinx mesh, spaces, materials and linear systems of a finite element problem
66
+ (mixed into :class:`FEElasticProblem` and :class:`FEThermalProblem`)."""
67
+
68
+ _fx = None
69
+
70
+ def _fx_setup(self):
71
+ if self._fx is not None:
72
+ return self._fx
73
+ basix, dolfinx, dolfinx_mpc, ufl, MPI, PETSc = _modules()
74
+ m = self.mesh
75
+ t0 = time.perf_counter()
76
+ corners = m.elements[:, :4]
77
+ used = np.unique(corners)
78
+ index = np.full(m.n_nodes, -1, dtype=np.int64)
79
+ index[used] = np.arange(len(used))
80
+ coord = basix.ufl.element("Lagrange", "tetrahedron", 1, shape=(3,))
81
+ msh = dolfinx.mesh.create_mesh(
82
+ MPI.COMM_SELF, index[corners].astype(np.int64), ufl.Mesh(coord), m.nodes[used]
83
+ )
84
+ original = msh.topology.original_cell_index
85
+ if isinstance(original, list): # one array per cell type
86
+ original = original[0]
87
+ original = np.asarray(original)
88
+ mat = self.mat[original]
89
+ shape = (3,) if self.physics == "elastic" else ()
90
+ space = dolfinx.fem.functionspace(msh, ("Lagrange", m.order, shape))
91
+ # morphoGen's nodes -> degrees of freedom (block indices) of dolfinx
92
+ dof_xyz = space.tabulate_dof_coordinates()
93
+ dist, block = cKDTree(dof_xyz).query(m.nodes)
94
+ size = float(np.max(m.upper - m.lower))
95
+ if dist.max() > 1e-9 * size or len(np.unique(block)) != m.n_nodes:
96
+ raise ValueError(
97
+ "solver 'fenicsx': the nodes of the mesh are not those of dolfinx's elements"
98
+ )
99
+ d = 6 if self.physics == "elastic" else 3
100
+ tensors = dolfinx.fem.functionspace(msh, ("DG", 0, (d, d)))
101
+ stiff = dolfinx.fem.Function(tensors)
102
+ cells = tensors.dofmap.list[:, 0]
103
+ stiff.x.array.reshape(-1, d * d)[cells] = self.table.matrices[mat].reshape(-1, d * d)
104
+ u, v = ufl.TrialFunction(space), ufl.TestFunction(space)
105
+ dx = ufl.Measure("dx", domain=msh, metadata={"quadrature_degree": 2 * (m.order - 1)})
106
+ ds = ufl.Measure("ds", domain=msh)
107
+ n = ufl.FacetNormal(msh)
108
+ if self.physics == "elastic":
109
+
110
+ def voigt(w):
111
+ e = ufl.sym(ufl.grad(w))
112
+ return ufl.as_vector(
113
+ [e[0, 0], e[1, 1], e[2, 2], 2 * e[1, 2], 2 * e[2, 0], 2 * e[0, 1]]
114
+ )
115
+
116
+ eig = dolfinx.fem.Function(dolfinx.fem.functionspace(msh, ("DG", 0, (6,))))
117
+ eig.x.array.reshape(-1, 6)[eig.function_space.dofmap.list[:, 0]] = self.table.eigen[mat]
118
+ load = dolfinx.fem.Constant(msh, np.zeros(6)) # macroscopic strain (Voigt)
119
+ dtemp = dolfinx.fem.Constant(msh, 0.0)
120
+ traction = dolfinx.fem.Constant(msh, np.zeros((3, 3))) # macroscopic stress
121
+ a = ufl.inner(ufl.dot(stiff, voigt(u)), voigt(v)) * dx
122
+ rhs = -ufl.inner(ufl.dot(stiff, load - dtemp * eig), voigt(v)) * dx
123
+ rhs += ufl.inner(ufl.dot(traction, n), v) * ds
124
+ constants = {"load": load, "dt": dtemp, "boundary": traction}
125
+ else:
126
+ load = dolfinx.fem.Constant(msh, np.zeros(3)) # macroscopic gradient
127
+ flux = dolfinx.fem.Constant(msh, np.zeros(3)) # macroscopic flux
128
+ a = ufl.inner(ufl.dot(stiff, ufl.grad(u)), ufl.grad(v)) * dx
129
+ rhs = -ufl.inner(ufl.dot(stiff, load), ufl.grad(v)) * dx - ufl.inner(flux, n) * v * ds
130
+ constants = {"load": load, "boundary": flux}
131
+ self._fx = {
132
+ "modules": (dolfinx, dolfinx_mpc, PETSc),
133
+ "mesh": msh,
134
+ "space": space,
135
+ "block": block,
136
+ "a": a,
137
+ "rhs": rhs,
138
+ "constants": constants,
139
+ "systems": {},
140
+ "setup_s": time.perf_counter() - t0,
141
+ }
142
+ return self._fx
143
+
144
+ def _fx_bcs(self, key):
145
+ """Homogeneous Dirichlet conditions on the degrees of freedom that morphoGen's
146
+ solver constrains (``_constraints``), or the node held in periodic problems."""
147
+ fx = self._fx
148
+ dolfinx = fx["modules"][0]
149
+ space, block = fx["space"], fx["block"]
150
+ nd = 3 if self.physics == "elastic" else 1
151
+ if key[0] == "periodic":
152
+ # a node inside the box: holding a master of the periodic constraints breaks
153
+ # their condensation (dolfinx_mpc 0.11)
154
+ inside = np.ones(self.mesh.n_nodes, dtype=bool)
155
+ inside[self.mesh.boundary_nodes()] = False
156
+ if not inside.any():
157
+ raise ValueError("solver 'fenicsx': periodic meshes need a node inside the box")
158
+ centre = 0.5 * (self.mesh.lower + self.mesh.upper)
159
+ dist = np.linalg.norm(self.mesh.nodes - centre, axis=1)
160
+ con = np.zeros((self.mesh.n_nodes, nd), dtype=bool)
161
+ con[int(np.argmin(np.where(inside, dist, np.inf)))] = True
162
+ else:
163
+ con = np.asarray(self._constraints(key)).reshape(self.mesh.n_nodes, nd)
164
+ if nd == 1:
165
+ dofs = np.sort(block[con[:, 0]]).astype(np.int32)
166
+ return [dolfinx.fem.dirichletbc(dolfinx.fem.Function(space), dofs)]
167
+ bcs = []
168
+ for c in range(3):
169
+ if not con[:, c].any():
170
+ continue
171
+ sub, parent = space.sub(c).collapse()
172
+ inverse = np.full(3 * len(block), -1, dtype=np.int64)
173
+ inverse[np.asarray(parent)] = np.arange(len(parent))
174
+ p = 3 * block[con[:, c]] + c
175
+ order = np.argsort(p)
176
+ dofs = [p[order].astype(np.int32), inverse[p[order]].astype(np.int32)]
177
+ bcs.append(dolfinx.fem.dirichletbc(dolfinx.fem.Function(sub), dofs, space.sub(c)))
178
+ return bcs
179
+
180
+ def _fx_system(self, key):
181
+ fx = self._fx_setup()
182
+ if key in fx["systems"]:
183
+ return fx["systems"][key]
184
+ dolfinx, dolfinx_mpc, PETSc = fx["modules"]
185
+ t0 = time.perf_counter()
186
+ space = fx["space"]
187
+ bcs = self._fx_bcs(key)
188
+ a_form = dolfinx.fem.form(fx["a"])
189
+ l_form = dolfinx.fem.form(fx["rhs"])
190
+ mpc = None
191
+ if key[0] == "periodic":
192
+ lo, hi = self.mesh.lower, self.mesh.upper
193
+ tol = 1e-8 * float(np.max(hi - lo))
194
+
195
+ def upper(x):
196
+ return np.logical_or.reduce([np.isclose(x[k], hi[k], atol=tol) for k in range(3)])
197
+
198
+ def relation(x):
199
+ out = x.copy()
200
+ for k in range(3):
201
+ top = np.isclose(x[k], hi[k], atol=tol)
202
+ out[k, top] = x[k, top] - (hi[k] - lo[k])
203
+ return out
204
+
205
+ mpc = dolfinx_mpc.MultiPointConstraint(space)
206
+ mpc.create_periodic_constraint_geometrical(space, upper, relation, bcs, tol=tol)
207
+ mpc.finalize()
208
+ matrix = dolfinx_mpc.assemble_matrix(a_form, mpc, bcs=bcs)
209
+ else:
210
+ matrix = dolfinx.fem.petsc.assemble_matrix(a_form, bcs=bcs)
211
+ matrix.assemble()
212
+ n = matrix.getSize()[0]
213
+ ksp = PETSc.KSP().create(fx["mesh"].comm)
214
+ ksp.setOperators(matrix)
215
+ if n <= DIRECT_LIMIT:
216
+ ksp.setType("preonly")
217
+ ksp.getPC().setType("lu")
218
+ ksp.getPC().setFactorSolverType("mumps")
219
+ method = "fenicsx-mumps"
220
+ else: # pragma: no cover - large problems
221
+ ksp.setType("cg")
222
+ ksp.getPC().setType("gamg")
223
+ ksp.setTolerances(rtol=self.tol, max_it=self.maxiter or 10_000)
224
+ method = "fenicsx-cg-gamg"
225
+ ksp.setFromOptions()
226
+ system = (a_form, l_form, bcs, mpc, matrix, ksp, method, n, time.perf_counter() - t0)
227
+ fx["systems"][key] = system
228
+ return system
229
+
230
+ def _fx_solve(self, key) -> tuple[np.ndarray, SolveInfo]:
231
+ """Fluctuation (zero where constrained) in morphoGen's node order."""
232
+ a_form, l_form, bcs, mpc, _, ksp, method, n, setup = self._fx_system(key)
233
+ fx = self._fx
234
+ dolfinx, dolfinx_mpc, PETSc = fx["modules"]
235
+ t0 = time.perf_counter()
236
+ if mpc is None:
237
+ b = dolfinx.fem.petsc.assemble_vector(l_form)
238
+ dolfinx.fem.petsc.apply_lifting(b, [a_form], bcs=[bcs])
239
+ b.ghostUpdate(addv=PETSc.InsertMode.ADD, mode=PETSc.ScatterMode.REVERSE)
240
+ dolfinx.fem.petsc.set_bc(b, bcs)
241
+ w = dolfinx.fem.Function(fx["space"])
242
+ else:
243
+ b = dolfinx_mpc.assemble_vector(l_form, mpc)
244
+ dolfinx_mpc.apply_lifting(b, [a_form], [bcs], mpc)
245
+ b.ghostUpdate(addv=PETSc.InsertMode.ADD, mode=PETSc.ScatterMode.REVERSE)
246
+ dolfinx.fem.petsc.set_bc(b, bcs)
247
+ w = dolfinx.fem.Function(mpc.function_space)
248
+ ksp.solve(b, w.x.petsc_vec)
249
+ if ksp.getConvergedReason() < 0:
250
+ raise RuntimeError(
251
+ f"solver 'fenicsx': PETSc did not converge (reason {ksp.getConvergedReason()})"
252
+ )
253
+ w.x.scatter_forward()
254
+ if mpc is not None:
255
+ mpc.backsubstitution(w)
256
+ values = np.asarray(w.x.array)
257
+ if self.physics == "elastic":
258
+ field = values.reshape(-1, 3)[fx["block"]].ravel()
259
+ else:
260
+ field = values[fx["block"]]
261
+ residual = float(ksp.getResidualNorm())
262
+ b.destroy()
263
+ info = SolveInfo(
264
+ method, int(n), int(ksp.getIterationNumber()), residual, fx["setup_s"] + setup, 0.0
265
+ )
266
+ info.solve_s = time.perf_counter() - t0
267
+ return field, info
268
+
269
+
270
+ class FenicsxElasticProblem(_Fenicsx, FEElasticProblem):
271
+ """Linear (thermo-)elasticity of a tetrahedral mesh solved by FEniCSx."""
272
+
273
+ def _field(self, x: np.ndarray, dt: float):
274
+ fx = self._fx_setup()
275
+ c = fx["constants"]
276
+ m = self.mesh
277
+ if self.native == "strain":
278
+ e = voigt_to_tensor(x, strain=True)
279
+ u_aff = (m.nodes @ e.T).ravel()
280
+ c["load"].value[:] = x
281
+ c["boundary"].value[:] = 0.0
282
+ else:
283
+ u_aff = np.zeros(3 * m.n_nodes)
284
+ c["load"].value[:] = 0.0
285
+ c["boundary"].value[:] = voigt_to_tensor(x, strain=False)
286
+ c["dt"].value = float(dt)
287
+ w, info = self._fx_solve(self._key(x))
288
+ return u_aff + w, info
289
+
290
+
291
+ class FenicsxThermalProblem(_Fenicsx, FEThermalProblem):
292
+ """Steady linear conduction of a tetrahedral mesh solved by FEniCSx."""
293
+
294
+ def _field(self, x: np.ndarray, dt: float = 0.0):
295
+ fx = self._fx_setup()
296
+ c = fx["constants"]
297
+ m = self.mesh
298
+ if self.native == "gradient":
299
+ t_aff = m.nodes @ x
300
+ c["load"].value[:] = x
301
+ c["boundary"].value[:] = 0.0
302
+ else:
303
+ t_aff = np.zeros(m.n_nodes)
304
+ c["load"].value[:] = 0.0
305
+ c["boundary"].value[:] = x
306
+ w, info = self._fx_solve(self._key(x))
307
+ return t_aff + w, info