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,219 @@
1
+ """Periodic homogenization of NURBS cells: effective stiffness and conductivity.
2
+
3
+ A cell is an assembly whose outer boundary is a rectangle (a box) with matching control
4
+ points on opposite sides (:func:`morphogen.iga.shapes.cell_with_hole`): the trace of a
5
+ field on a side of a patch depends on the control points of that side only, so that
6
+ equal unknowns on matching control points make the field periodic exactly. Its holes
7
+ are free of tractions; several materials are the phases of its patches.
8
+
9
+ The cell need not be a box. With the periods of the medium (``lattice``: one vector per
10
+ row; the :attr:`~morphogen.iga.geometry.Multipatch.lattice` of the assembly by default)
11
+ it is any set of patches that tiles the plane (the space) by these translations — a
12
+ parallelogram (the rhombus of a hexagonal array), or whole grains of the pattern cut
13
+ nowhere (:func:`morphogen.iga.shapes.alternating_holes`): the control points of its
14
+ boundary that are a period apart are then one, and ``|Y|`` is the area (volume) of the
15
+ lattice, ``|det(lattice)|``.
16
+
17
+ For each unit macroscopic strain ``E_I`` (gradient, for conduction) the fluctuation
18
+ ``chi_I`` — periodic, fixed at one control point — solves ``K chi_I = -L_I``, with ``L_I =
19
+ int B^T D E_I`` the forces of the uniform strain, and the effective tensor is the mean
20
+ energy of the pair of total strains::
21
+
22
+ C_IJ = (1 / |Y|) int (E_I + eps(chi_I)) : D : (E_J + eps(chi_J)) dY
23
+ = (1 / |Y|) (int D_IJ dY + L_I . chi_J),
24
+
25
+ ``|Y|`` the area (volume) of the box, holes included: the stiffness in Voigt's notation
26
+ with engineering shears (``(11, 22, 12)`` in the plane), or the conductivity tensor.
27
+
28
+ In the plane, ``plane="strain"`` gives the plane block of the stiffness of the cell
29
+ extruded along the third axis (what a solver of the solid gives with ``eps_33 = 0``);
30
+ ``plane="stress"`` that of a thin sheet.
31
+ """
32
+
33
+ from __future__ import annotations
34
+
35
+ import itertools
36
+ from dataclasses import dataclass, field
37
+
38
+ import numpy as np
39
+ import scipy.sparse as sp
40
+ import scipy.sparse.linalg as spla
41
+ from scipy.sparse.csgraph import connected_components
42
+ from scipy.spatial import cKDTree
43
+
44
+ from morphogen.iga.analysis import Analysis
45
+ from morphogen.iga.geometry import Multipatch, Patch
46
+
47
+
48
+ def _periods(lattice: np.ndarray) -> np.ndarray:
49
+ """The translations that can bring a side of a cell onto another: the combinations
50
+ of its periods with the coefficients -1, 0 and 1, one of each pair of opposites."""
51
+ dim = len(lattice)
52
+ combos = [c for c in itertools.product((-1, 0, 1), repeat=dim) if any(c)]
53
+ kept = [c for c in combos if next(v for v in c if v) > 0]
54
+ return np.array(kept, dtype=float) @ lattice
55
+
56
+
57
+ def _lattice_classes(model: Multipatch, lattice: np.ndarray, tolerance: float) -> np.ndarray:
58
+ """The classes of the control points of a cell of given periods: those of its
59
+ boundary that are a period apart share one."""
60
+ boundary = model.boundary_nodes()
61
+ points = model.nodes[boundary]
62
+ tol = tolerance * float(np.abs(lattice).max())
63
+ tree = cKDTree(points)
64
+ rows, cols = [], []
65
+ for shift in _periods(lattice):
66
+ distance, match = tree.query(points + shift)
67
+ found = distance <= tol
68
+ rows.append(boundary[found])
69
+ cols.append(boundary[match[found]])
70
+ rows, cols = np.concatenate(rows), np.concatenate(cols)
71
+ if not len(rows):
72
+ raise ValueError(
73
+ "not a periodic cell: no control points of its boundary are a period apart"
74
+ )
75
+ if np.abs(model.weights[rows] - model.weights[cols]).max() > 1e-9:
76
+ raise ValueError("not a periodic cell: different weights a period apart")
77
+ graph = sp.coo_matrix((np.ones(len(rows)), (rows, cols)), shape=(model.n_nodes,) * 2)
78
+ _, labels = connected_components(graph, directed=False)
79
+ return labels
80
+
81
+
82
+ def periodic_classes(model: Multipatch, tolerance: float = 1e-8, lattice=None) -> np.ndarray:
83
+ """The class of each control point of a cell: the control points of opposite sides
84
+ of its box that match (the same position along the side, the same weight) share
85
+ one; an error if a side has control points without a match. With the periods of the
86
+ cell (``lattice``, or those of the assembly), the control points of its boundary
87
+ that are a period apart share one."""
88
+ lattice = model.lattice if lattice is None else np.asarray(lattice, dtype=float)
89
+ if lattice is not None:
90
+ return _lattice_classes(model, lattice, tolerance)
91
+ lower, upper = model.lower, model.upper
92
+ size = float((upper - lower).max())
93
+ tol = tolerance * size
94
+ rows, cols = [], []
95
+ for axis in range(model.dim):
96
+ low = np.flatnonzero(np.abs(model.nodes[:, axis] - lower[axis]) <= tol)
97
+ high = np.flatnonzero(np.abs(model.nodes[:, axis] - upper[axis]) <= tol)
98
+ others = [d for d in range(model.dim) if d != axis]
99
+ if len(low) != len(high) or not len(low):
100
+ raise ValueError(
101
+ f"not a periodic cell: {len(low)} and {len(high)} control points on the "
102
+ f"sides across axis {axis}"
103
+ )
104
+ distance, match = cKDTree(model.nodes[high][:, others]).query(model.nodes[low][:, others])
105
+ if distance.max() > tol or len(np.unique(match)) != len(low):
106
+ raise ValueError(
107
+ f"not a periodic cell: the control points of the sides across axis {axis} "
108
+ "do not match"
109
+ )
110
+ if np.abs(model.weights[low] - model.weights[high[match]]).max() > 1e-9:
111
+ raise ValueError(f"not a periodic cell: different weights across axis {axis}")
112
+ rows.append(low)
113
+ cols.append(high[match])
114
+ rows, cols = np.concatenate(rows), np.concatenate(cols)
115
+ graph = sp.coo_matrix((np.ones(len(rows)), (rows, cols)), shape=(model.n_nodes,) * 2)
116
+ _, labels = connected_components(graph, directed=False)
117
+ return labels
118
+
119
+
120
+ @dataclass
121
+ class CellSolution:
122
+ """The effective ``tensor`` of a cell, the area (volume) ``measure`` of its box, the
123
+ share ``fraction`` of it that the patches fill, the fluctuations of the unit
124
+ macroscopic strains (``fluctuations``: unknowns x components) and the analysis."""
125
+
126
+ tensor: np.ndarray
127
+ measure: float
128
+ fraction: float
129
+ fluctuations: np.ndarray
130
+ analysis: Analysis = field(repr=False)
131
+
132
+ def constants(self) -> dict[str, float]:
133
+ """The engineering constants of the tensor (:func:`plane_constants` in the
134
+ plane; the mean conductivity for conduction)."""
135
+ if self.analysis.physics == "conduction":
136
+ return {"conductivity": float(np.trace(self.tensor) / len(self.tensor))}
137
+ if self.tensor.shape == (3, 3):
138
+ return plane_constants(self.tensor)
139
+ from morphogen.optimization.topology import tensor_properties
140
+
141
+ return tensor_properties(self.tensor)
142
+
143
+
144
+ def plane_constants(tensor) -> dict[str, float]:
145
+ """The engineering constants of a plane stiffness (3 x 3; Voigt 11, 22, 12 with
146
+ engineering shears): Young's moduli and Poisson's ratios of its plane law, ``young_1 =
147
+ 1 / S_11``, ``poisson_12 = -S_12 / S_11`` (the contraction along 2 under a tension
148
+ along 1), the shear modulus ``C_66`` and the bulk modulus of the plane, ``(C_11 +
149
+ C_22 + 2 C_12) / 4``."""
150
+ c = np.asarray(tensor, dtype=float)
151
+ s = np.linalg.inv(c)
152
+ return {
153
+ "young_1": float(1.0 / s[0, 0]),
154
+ "young_2": float(1.0 / s[1, 1]),
155
+ "poisson_12": float(-s[0, 1] / s[0, 0]),
156
+ "poisson_21": float(-s[0, 1] / s[1, 1]),
157
+ "shear_modulus": float(c[2, 2]),
158
+ "bulk_modulus": float((c[0, 0] + c[1, 1] + 2.0 * c[0, 1]) / 4.0),
159
+ }
160
+
161
+
162
+ class Cell:
163
+ """A periodic cell (see the module): the assembly ``model``, the ``materials`` of
164
+ its phases, the physics (``"elastic"``, with ``plane`` for surfaces, or
165
+ ``"conduction"``) and, for a cell that is not a box, the periods ``lattice`` (those
166
+ of the assembly by default). :meth:`solve` gives its effective tensor."""
167
+
168
+ def __init__(self, model, materials, *, physics: str = "elastic", plane: str = "strain",
169
+ extra: int = 0, tolerance: float = 1e-8, lattice=None): # fmt: skip
170
+ if isinstance(model, Patch):
171
+ model = Multipatch(model)
172
+ self.analysis = Analysis(model, materials, physics=physics, plane=plane, extra=extra)
173
+ self.model = model
174
+ lattice = model.lattice if lattice is None else np.asarray(lattice, dtype=float)
175
+ self.lattice = lattice
176
+ self.classes = periodic_classes(model, tolerance, lattice)
177
+ if lattice is None:
178
+ self.measure = float(np.prod(model.upper - model.lower))
179
+ else:
180
+ self.measure = float(abs(np.linalg.det(lattice)))
181
+ if self.analysis.measure() > (1.0 + 1e-6) * self.measure:
182
+ raise ValueError(
183
+ "not a periodic cell: its patches fill more than a period of the lattice"
184
+ )
185
+ nd = self.analysis.nd
186
+ # the unknowns of a class of control points are one; the first class is fixed
187
+ kept = np.flatnonzero(self.classes != self.classes[0])
188
+ _, reduced = np.unique(self.classes[kept], return_inverse=True)
189
+ n_free = (reduced.max() + 1) * nd if kept.size else 0
190
+ rows = (nd * kept[:, None] + np.arange(nd)).ravel()
191
+ cols = (nd * reduced[:, None] + np.arange(nd)).ravel()
192
+ self.reduction = sp.coo_matrix(
193
+ (np.ones(len(rows)), (rows, cols)), shape=(self.analysis.n_dofs, n_free)
194
+ ).tocsr()
195
+
196
+ def solve(self) -> CellSolution:
197
+ """The effective tensor of the cell and the fluctuations of its unit loadings."""
198
+ analysis = self.analysis
199
+ k = analysis.matrix()
200
+ loads, total = analysis.uniform_loads()
201
+ t = self.reduction
202
+ kqq = (t.T @ k @ t).tocsc()
203
+ solve = spla.factorized(kqq)
204
+ chi = np.zeros_like(loads)
205
+ for j in range(loads.shape[1]):
206
+ chi[:, j] = t @ solve(-(t.T @ loads[:, j]))
207
+ tensor = (total + loads.T @ chi) / self.measure
208
+ tensor = 0.5 * (tensor + tensor.T)
209
+ return CellSolution(tensor, self.measure, analysis.measure() / self.measure, chi, analysis)
210
+
211
+
212
+ def homogenize(model, materials, *, physics: str = "elastic", plane: str = "strain",
213
+ extra: int = 0, lattice=None) -> CellSolution: # fmt: skip
214
+ """The effective tensor of a periodic NURBS cell (:class:`Cell`)."""
215
+ cell = Cell(model, materials, physics=physics, plane=plane, extra=extra, lattice=lattice)
216
+ return cell.solve()
217
+
218
+
219
+ __all__ = ["Cell", "CellSolution", "homogenize", "periodic_classes", "plane_constants"]