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,216 @@
1
+ """A treated sheet in its volume: voxels of graded elastoplastic phases for the solvers of
2
+ three-dimensional fields.
3
+
4
+ The finite elements of the sheets (:mod:`morphogen.laser.mechanics`) are those of a
5
+ membrane in plane stress whose layers share the strain of the plane: no stress across the
6
+ thickness, no layer that holds its neighbours back. Here the periodic cell of the sheet
7
+ treated all over is drawn in its volume: an image of voxels ``(n1, n2, layers)`` along
8
+ the two vectors of its lattice and its thickness, whose phases are classes of hardness,
9
+ each with the flow law of its hardness, and whose two faces are free: a gap of void
10
+ voxels between the sheet and its periodic image across the thickness (the first layer
11
+ at ``z = 0``: the face of the beam of a laser treatment). The solvers of
12
+ :mod:`morphogen.homogenization` then take it as any microstructure: loading paths by FFT
13
+ (:func:`volume_tension`: a tensile test along an axis of the cell, the other stresses
14
+ free), its phases, fields and statistics, a conforming mesh, the other physics.
15
+
16
+ The flow laws of the sheets (:class:`~morphogen.laser.materials.FlowLaw`) become the
17
+ isotropic hardening of von Mises plasticity
18
+ (:class:`~morphogen.homogenization.behaviours.Plasticity`: ``R0 + H p + Σ Q_i (1 -
19
+ exp(-b_i p))``): Voce's law is one of its terms; Ludwik's and Swift's power laws are
20
+ fitted over a range of plastic strain by a linear term and three exponentials (their
21
+ amplitudes by non-negative least squares, their rates the best of a few: within one or
22
+ two percent).
23
+ """
24
+
25
+ from __future__ import annotations
26
+
27
+ import numpy as np
28
+
29
+ from morphogen.homogenization.behaviours import Plasticity
30
+ from morphogen.homogenization.materials import Material
31
+ from morphogen.image import VoxelImage
32
+ from morphogen.laser.materials import LAWS, FlowLaw
33
+
34
+ #: The rates of the three exponentials fitted to a power law, over the range of plastic
35
+ #: strain: the fastest, the middle and the slowest are chosen among these
36
+ RATES = ((3000.0, 1000.0, 300.0), (150.0, 60.0, 25.0), (10.0, 5.0, 2.0))
37
+
38
+
39
+ def flow_plasticity(kind, sigma0: float, a: float, b: float, *, strain: float = 0.3) -> Plasticity:
40
+ """The von Mises plasticity of a flow law of the sheets (``kind``: its name, or its
41
+ index in :data:`~morphogen.laser.materials.LAWS`; ``sigma0``, ``a``, ``b``: its
42
+ parameters): exact for Voce's law, fitted over the plastic strains up to ``strain``
43
+ for the power laws (see the module; the rates of the exponentials: those of
44
+ :data:`RATES` that leave the least error)."""
45
+ from itertools import product
46
+
47
+ from scipy.optimize import nnls
48
+
49
+ name = kind if isinstance(kind, str) else LAWS[int(kind)]
50
+ law = FlowLaw(name, float(sigma0), float(a), float(b))
51
+ if name == "voce":
52
+ return Plasticity(yield_stress=law.sigma0, isotropic=((law.a, law.b),))
53
+ if not strain > 0:
54
+ raise ValueError("strain: the range of plastic strain of the fit, positive")
55
+ p = strain * np.linspace(0.0, 1.0, 400) ** 2 # denser at the start, where the law bends
56
+ first = float(law.stress(0.0))
57
+ target = law.stress(p)
58
+ best = None
59
+ for rates in product(*RATES):
60
+ rates = np.asarray(rates) / strain
61
+ basis = np.column_stack([p, *(1.0 - np.exp(-rate * p) for rate in rates)])
62
+ amplitudes, _ = nnls(basis, target - first)
63
+ error = float(np.abs((first + basis @ amplitudes) / target - 1.0).max())
64
+ if best is None or error < best[0]:
65
+ best = (error, amplitudes, rates)
66
+ _, amplitudes, rates = best
67
+ terms = tuple((float(q), float(r)) for q, r in zip(amplitudes[1:], rates, strict=True) if q > 0)
68
+ return Plasticity(yield_stress=first, hardening=float(amplitudes[0]), isotropic=terms)
69
+
70
+
71
+ def hardening_stress(plasticity: Plasticity, p) -> np.ndarray:
72
+ """The yield stress ``R0 + H p + Σ Q_i (1 - exp(-b_i p))`` of a plasticity at the
73
+ cumulated plastic strains ``p``."""
74
+ p = np.asarray(p, dtype=float)
75
+ out = plasticity.yield_stress + plasticity.hardening * p
76
+ for q, rate in plasticity.isotropic:
77
+ out = out + q * (1.0 - np.exp(-rate * p))
78
+ return out
79
+
80
+
81
+ def sheet_volume(
82
+ hardness,
83
+ material,
84
+ spacing,
85
+ thickness: float,
86
+ *,
87
+ classes: int = 8,
88
+ gap: int = 2,
89
+ depth: int | None = None,
90
+ strain: float = 0.3,
91
+ ) -> tuple[VoxelImage, dict[int, Material]]:
92
+ """The volume of a treated sheet (see the module): ``hardness`` (HV; ``(n1, n2,
93
+ layers)``, on a grid of the periodic cell of steps ``spacing`` (mm) along its two
94
+ axes, its layers through the ``thickness`` (mm)) of a sheet of ``material`` (a
95
+ :class:`~morphogen.laser.materials.SheetMaterial`). Returns the image of its phases
96
+ and their materials: phase 0, the void of the ``gap`` voxels above the sheet (its
97
+ free faces); phases 1, 2, ...: the classes of hardness present among ``classes`` of
98
+ equal width, in increasing hardness, each with the elastic constants of the sheet and
99
+ the plasticity of the flow law of the mean hardness of its voxels (``strain``: the
100
+ range of the fit of power laws). ``depth``: voxels through each layer (by default as
101
+ many as make the voxels nearest cubes); the first layer is at ``z = 0``. The hardness
102
+ of each phase is in the metadata of the image (``"hardness"``), with the number of
103
+ voxels through the sheet (``"solid_voxels"``)."""
104
+ hv = np.asarray(hardness, dtype=float)
105
+ if hv.ndim == 2:
106
+ hv = hv[:, :, None]
107
+ if hv.ndim != 3 or not np.all(np.isfinite(hv)) or hv.min() <= 0:
108
+ raise ValueError("hardness: positive values (n1, n2, layers)")
109
+ dx, dy = (float(v) for v in spacing)
110
+ if not (dx > 0 and dy > 0 and thickness > 0):
111
+ raise ValueError("spacing and thickness: positive (mm)")
112
+ if not 1 <= int(classes) <= 254 or int(gap) < 1:
113
+ raise ValueError(
114
+ "classes: from 1 to 254; gap: at least 1 (it frees the faces of the sheet)"
115
+ )
116
+ layer = float(thickness) / hv.shape[2]
117
+ depth = max(1, round(layer / min(dx, dy))) if depth is None else int(depth)
118
+ if depth < 1:
119
+ raise ValueError("depth: at least one voxel through each layer")
120
+ low, high = float(hv.min()), float(hv.max())
121
+ count = 1 if high - low <= 1e-9 * high else int(classes)
122
+ index = np.minimum((count * (hv - low) / max(high - low, 1e-300)).astype(np.int64), count - 1)
123
+ present = np.unique(index)
124
+ phase = np.searchsorted(present, index) + 1
125
+ # the hardness of a class: the mean of its voxels (a sheet of two hardnesses keeps both)
126
+ means = np.bincount(phase.ravel(), weights=hv.ravel())[1:] / np.bincount(phase.ravel())[1:]
127
+ kind, sigma0, a, b = material.strength.flow(means, young=material.young)
128
+ materials: dict[int, Material] = {0: Material(void=True)}
129
+ for k in range(len(present)):
130
+ law = flow_plasticity(int(kind[k]), sigma0[k], a[k], b[k], strain=strain)
131
+ materials[k + 1] = Material(young=material.young, poisson=material.poisson, plasticity=law)
132
+ data = np.zeros((hv.shape[0], hv.shape[1], hv.shape[2] * depth + int(gap)), dtype=np.uint8)
133
+ data[:, :, : hv.shape[2] * depth] = np.repeat(phase, depth, axis=2)
134
+ metadata = {
135
+ "hardness": {k + 1: float(mean) for k, mean in enumerate(means)},
136
+ "thickness": float(thickness),
137
+ "solid_voxels": int(hv.shape[2] * depth),
138
+ }
139
+ image = VoxelImage(data, (dx, dy, layer / depth), periodic=True, metadata=metadata)
140
+ return image, materials
141
+
142
+
143
+ def case_volume(case, resolution: float | None = None, **options):
144
+ """The volume of the periodic cell of a sheet treated all over by the pattern of a
145
+ :class:`~morphogen.laser.design.SheetCase` (its lattice, or the ``vectors`` of its
146
+ loading: two vectors at right angles, the axes of the image): the hardness that its
147
+ laser path leaves on a grid of ``resolution`` mm (by default the element of the
148
+ case) in each of its layers (the first under the beam, the last on the face of the
149
+ beam ``bottom``), then :func:`sheet_volume` with its ``options``. A lattice that is not
150
+ rectangular (honeycombs, tracks shifted from one to the next) has a rectangular cell
151
+ of several of its cells: give its two vectors to the loading."""
152
+ from morphogen.laser.design import CELL_REACH
153
+ from morphogen.laser.patterns import LaserPath, make_pattern
154
+
155
+ cell = case.cell()
156
+ a1, a2 = np.asarray(cell.a1, dtype=float), np.asarray(cell.a2, dtype=float)
157
+ l1, l2 = float(np.linalg.norm(a1)), float(np.linalg.norm(a2))
158
+ if abs(a1 @ a2) > 1e-9 * l1 * l2:
159
+ raise ValueError(
160
+ "the cell of this pattern is not rectangular: give two vectors at right angles "
161
+ "(of a cell of several of its cells) to the loading (vectors)"
162
+ )
163
+ step = float(case.element if resolution is None else resolution)
164
+ n1, n2 = max(2, round(l1 / step)), max(2, round(l2 / step))
165
+ u, v = (np.arange(n1) + 0.5) / n1, (np.arange(n2) + 0.5) / n2
166
+ points = cell.origin + u[:, None, None] * a1 + v[None, :, None] * a2
167
+ params = dict(case.pattern)
168
+ kind = params.pop("kind")
169
+ path = (
170
+ LaserPath([])
171
+ if kind == "none"
172
+ else make_pattern(kind, cell.box(CELL_REACH), beam=case.beam, bottom=case.bottom,
173
+ pause=case.pause, cover=True, **params)
174
+ ) # fmt: skip
175
+ treated = case.laser_treatment().apply(path, points.reshape(-1, 2))
176
+ hardness = treated.hardness.reshape(n1, n2, -1)
177
+ return sheet_volume(hardness, case.material, (l1 / n1, l2 / n2), case.specimen.thickness,
178
+ **options) # fmt: skip
179
+
180
+
181
+ def volume_tension(image: VoxelImage, materials: dict, *, axis: int = 0, strain: float = 0.05,
182
+ increments: int = 20, kinematics: str = "small", **options) -> dict: # fmt: skip
183
+ """The tensile test of the volume of a sheet along the axis ``axis`` of its cell (0 or
184
+ 1), up to the macroscopic ``strain`` in ``increments`` steps, the other stresses of
185
+ its plane free (:func:`~morphogen.homogenization.apparent.homogenize`, with its
186
+ ``options``): the ``strain`` along the axis, the ``stress`` of the sheet (the mean
187
+ stress of the cell over the fraction of its height that the sheet fills), the strain
188
+ of its ``width`` and the path ``result`` (fields, phases). The strains of the cell
189
+ across the sheet are those of its gap, which nothing holds (left free, they make the
190
+ problem singular): they are prescribed, and the faces of the sheet stay free, its
191
+ thickness changing in the gap. ``kinematics="finite"``: finite strains (the flow laws
192
+ in the logarithmic strains); the strain is then the elongation over the initial
193
+ length and the stress the force over the initial section, those of a tensile test
194
+ and of the membrane of the sheets."""
195
+ from morphogen.homogenization.apparent import homogenize
196
+
197
+ if axis not in (0, 1):
198
+ raise ValueError("axis: 0 or 1, in the plane of the sheet")
199
+ solid = image.metadata.get("solid_voxels")
200
+ if not solid:
201
+ solid = int(np.any(np.asarray(image.data) > 0, axis=(0, 1)).sum())
202
+ component = ("11", "22")[axis]
203
+ still = [0.0, 0.0]
204
+ path = {"times": [0.0, 1.0], "increments": int(increments),
205
+ "strain": {component: [0.0, float(strain)], "33": still, "23": still,
206
+ "13": still}} # fmt: skip
207
+ nonlinear = {**(options.pop("nonlinear", None) or {}), "kinematics": kinematics}
208
+ result = homogenize(image, materials, properties=[], paths={"tension": path},
209
+ nonlinear=nonlinear, **options) # fmt: skip
210
+ result = result["tension.periodic"]
211
+ return {
212
+ "strain": result.strain[:, axis],
213
+ "stress": result.stress[:, axis] * image.shape[2] / solid,
214
+ "width": result.strain[:, 1 - axis],
215
+ "result": result,
216
+ }
@@ -0,0 +1,200 @@
1
+ """Specimens of laser-architectured sheets and their meshes.
2
+
3
+ The sheet's coordinates: ``x`` along the tensile axis, ``y`` across; the parallel
4
+ (gauge) part of a specimen occupies ``[0, length] x [0, width]``, the band where the
5
+ patterns are drawn (:meth:`Specimen.band`). Kinds:
6
+
7
+ ``dogbone``
8
+ a flat tensile specimen: the parallel part, circular fillets of radius ``radius``
9
+ to grips of width ``grip_width`` and length ``grip_length`` (the part between the
10
+ fillet and the jaws), the strain read by a virtual extensometer of length
11
+ ``extensometer`` centred on the parallel part (DIC);
12
+ ``strip``
13
+ the parallel part alone, its ends held by the grips (``clamped``: no lateral
14
+ contraction there) or free to contract;
15
+ ``cell``
16
+ a periodic cell of the sheet, ``length`` x ``width`` (a period of the pattern along
17
+ x, the spacing of its tracks along y): an infinite architectured sheet.
18
+
19
+ Meshes are structured quadrilaterals mapped on the outline, about ``element`` mm.
20
+ Defaults: the specimens of Wang (2022, thesis ch. 5): a parallel part 30 mm long and
21
+ 5 mm wide, 1 mm thick.
22
+ """
23
+
24
+ from __future__ import annotations
25
+
26
+ import math
27
+ from dataclasses import dataclass
28
+
29
+ import numpy as np
30
+
31
+ KINDS = ("dogbone", "strip", "cell")
32
+ #: Gauss points of the 2 x 2 rule on [-1, 1]².
33
+ _GP = np.array([[-1, -1], [1, -1], [1, 1], [-1, 1]], dtype=float) / math.sqrt(3.0)
34
+
35
+
36
+ @dataclass
37
+ class QuadMesh:
38
+ """Quadrilaterals: ``nodes`` (n x 2), ``quads`` (e x 4, counter-clockwise), and the
39
+ node sets of the outline (``left``, ``right``, ``bottom``, ``top`` edges of the
40
+ mapped grid)."""
41
+
42
+ nodes: np.ndarray
43
+ quads: np.ndarray
44
+ left: np.ndarray
45
+ right: np.ndarray
46
+ bottom: np.ndarray
47
+ top: np.ndarray
48
+ shape: tuple
49
+
50
+ def gauss(self):
51
+ """The Gauss points ``(e x 4 x 2)`` coordinates, the derivatives of the shape
52
+ functions in the reference configuration ``(e x 4 x 4 x 2)`` and the weights
53
+ ``(e x 4)`` (areas)."""
54
+ xe = self.nodes[self.quads] # e x 4 x 2
55
+ pts = np.empty((len(self.quads), 4, 2))
56
+ dndx = np.empty((len(self.quads), 4, 4, 2))
57
+ wts = np.empty((len(self.quads), 4))
58
+ for g, (r, s) in enumerate(_GP):
59
+ n = 0.25 * np.array(
60
+ [(1 - r) * (1 - s), (1 + r) * (1 - s), (1 + r) * (1 + s), (1 - r) * (1 + s)]
61
+ )
62
+ dr = 0.25 * np.array([-(1 - s), (1 - s), (1 + s), -(1 + s)])
63
+ ds = 0.25 * np.array([-(1 - r), -(1 + r), (1 + r), (1 - r)])
64
+ pts[:, g] = np.einsum("a,eai->ei", n, xe)
65
+ jac = np.stack([np.einsum("a,eai->ei", dr, xe), np.einsum("a,eai->ei", ds, xe)], axis=1)
66
+ det = jac[:, 0, 0] * jac[:, 1, 1] - jac[:, 0, 1] * jac[:, 1, 0]
67
+ if np.any(det <= 0):
68
+ raise ValueError("mesh: an inverted element")
69
+ inv = (
70
+ np.stack(
71
+ [
72
+ np.stack([jac[:, 1, 1], -jac[:, 0, 1]], -1),
73
+ np.stack([-jac[:, 1, 0], jac[:, 0, 0]], -1),
74
+ ],
75
+ axis=1,
76
+ )
77
+ / det[:, None, None]
78
+ )
79
+ dnat = np.stack([dr, ds], axis=1) # 4 x 2
80
+ # ∂N/∂x_i = Σ_k (J⁻¹)_ik ∂N/∂ξ_k, J_ki = ∂x_i/∂ξ_k
81
+ dndx[:, g] = np.einsum("ak,eik->eai", dnat, inv)
82
+ wts[:, g] = det
83
+ return pts, dndx, wts
84
+
85
+ @property
86
+ def area(self) -> float:
87
+ return float(self.gauss()[2].sum())
88
+
89
+
90
+ @dataclass
91
+ class Specimen:
92
+ """A specimen (see the module); lengths in mm."""
93
+
94
+ kind: str = "dogbone"
95
+ length: float = 30.0
96
+ width: float = 5.0
97
+ thickness: float = 1.0
98
+ radius: float = 6.0
99
+ grip_width: float = 10.0
100
+ grip_length: float = 10.0
101
+ extensometer: float | None = None
102
+ clamped: bool = True
103
+ element: float = 0.25
104
+
105
+ def __post_init__(self):
106
+ if self.kind not in KINDS:
107
+ raise ValueError(f"specimen kind: one of {KINDS}")
108
+ for name in ("length", "width", "thickness", "element"):
109
+ if not getattr(self, name) > 0:
110
+ raise ValueError(f"specimen: {name} must be positive")
111
+ if self.kind == "dogbone":
112
+ if not self.grip_width > self.width:
113
+ raise ValueError("specimen: grip_width > width")
114
+ if not self.radius > 0:
115
+ raise ValueError("specimen: radius must be positive")
116
+ if self.extensometer is None: # away from the fillets or the clamped ends
117
+ if self.kind == "dogbone":
118
+ self.extensometer = max(self.length - self.width, 0.5 * self.length)
119
+ elif self.kind == "strip" and self.clamped:
120
+ self.extensometer = max(self.length - 2.0 * self.width, 0.5 * self.length)
121
+ else:
122
+ self.extensometer = self.length
123
+ if not 0 < self.extensometer <= self.length + 1e-12:
124
+ raise ValueError("specimen: 0 < extensometer <= length")
125
+
126
+ @classmethod
127
+ def from_config(cls, data) -> Specimen:
128
+ if isinstance(data, Specimen):
129
+ return data
130
+ return cls(**dict(data or {}))
131
+
132
+ def band(self) -> tuple[float, float, float, float]:
133
+ """The parallel part ``(x0, x1, y0, y1)`` where patterns are drawn."""
134
+ return (0.0, self.length, 0.0, self.width)
135
+
136
+ @property
137
+ def fillet(self) -> float:
138
+ """Length along x of each fillet."""
139
+ if self.kind != "dogbone":
140
+ return 0.0
141
+ dw = 0.5 * (self.grip_width - self.width)
142
+ r = self.radius
143
+ return math.sqrt(max(r * r - (r - min(dw, r)) ** 2, 0.0)) + max(dw - r, 0.0)
144
+
145
+ def _width_at(self, x):
146
+ """Width of the outline at abscissae ``x``."""
147
+ x = np.asarray(x, dtype=float)
148
+ if self.kind != "dogbone":
149
+ return np.full_like(x, self.width)
150
+ r, dw, lf = self.radius, 0.5 * (self.grip_width - self.width), self.fillet
151
+ d = np.maximum(np.maximum(-x, x - self.length), 0.0) # distance beyond the parallel part
152
+ if dw <= r: # a circular arc tangent to the parallel part
153
+ u = np.minimum(d, lf)
154
+ rise = r - np.sqrt(np.maximum(r * r - u * u, 0.0))
155
+ else: # an arc of a quarter circle then a straight shoulder
156
+ rise = np.where(
157
+ d <= r, r - np.sqrt(np.maximum(r * r - np.minimum(d, r) ** 2, 0.0)), r + (d - r)
158
+ )
159
+ return self.width + 2.0 * np.minimum(rise, dw)
160
+
161
+ def extent(self) -> tuple[float, float]:
162
+ """Abscissae of the ends of the specimen."""
163
+ if self.kind != "dogbone":
164
+ return 0.0, self.length
165
+ e = self.fillet + self.grip_length
166
+ return -e, self.length + e
167
+
168
+ def mesh(self, element: float | None = None) -> QuadMesh:
169
+ """A structured mesh of the specimen (elements of about ``element`` mm)."""
170
+ h = float(element or self.element)
171
+ x0, x1 = self.extent()
172
+ ny = max(2, math.ceil(self.width / h))
173
+ if self.kind == "dogbone":
174
+ # the parallel part at h, the fillets and grips coarser
175
+ nx_g = max(4, math.ceil(self.length / h))
176
+ xs_g = np.linspace(0.0, self.length, nx_g + 1)
177
+ lf = self.fillet + self.grip_length
178
+ nf = max(3, math.ceil(lf / (1.5 * h)))
179
+ t = np.linspace(0.0, 1.0, nf + 1)[1:] ** 1.4
180
+ xs = np.concatenate([-lf * t[::-1], xs_g, self.length + lf * t])
181
+ else:
182
+ nx = max(2, math.ceil(self.length / h))
183
+ xs = np.linspace(x0, x1, nx + 1)
184
+ w = self._width_at(xs)
185
+ yc = 0.5 * self.width
186
+ frac = np.linspace(-0.5, 0.5, ny + 1)
187
+ X = np.repeat(xs[:, None], ny + 1, axis=1)
188
+ Y = yc + w[:, None] * frac[None, :]
189
+ nodes = np.column_stack([X.ravel(), Y.ravel()])
190
+ nxe, nye = len(xs) - 1, ny
191
+ idx = np.arange(len(xs) * (ny + 1)).reshape(len(xs), ny + 1)
192
+ quads = np.column_stack(
193
+ [idx[:-1, :-1].ravel(), idx[1:, :-1].ravel(), idx[1:, 1:].ravel(), idx[:-1, 1:].ravel()]
194
+ )
195
+ return QuadMesh(nodes, quads, idx[0], idx[-1], idx[:, 0], idx[:, -1], (nxe, nye))
196
+
197
+ def extensometer_ends(self) -> tuple[float, float]:
198
+ """Abscissae of the ends of the extensometer."""
199
+ c = 0.5 * self.length
200
+ return c - 0.5 * self.extensometer, c + 0.5 * self.extensometer