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,392 @@
1
+ """The periodic cell of a laser-architectured sheet and its homogenized tensile tests.
2
+
3
+ A pattern repeated over a whole sheet — a family of straight tracks at its spacing,
4
+ crossed families, corrugations, a honeycomb — is periodic: its *lattice*
5
+ (:func:`lattice`) is spanned by two vectors ``a1``, ``a2`` (mm; reduced to the most
6
+ compact pair, :func:`reduce_basis`). The *cell* (:class:`PeriodicCell`) is the
7
+ parallelogram they span, meshed by quadrilaterals whose nodes match on opposite edges.
8
+ Its displacements are periodic up to the macroscopic displacement gradient ``H``: a
9
+ node of the right (top) edge moves as its image on the left (bottom) edge plus ``H a1``
10
+ (``H a2``); one node is held (no translation), ``H`` is symmetric (no rotation): the
11
+ computational homogenization of periodic media (Michel, Moulinec & Suquet 1999). The
12
+ unknowns are the displacements of the independent nodes and ``H`` (:meth:`PeriodicCell.map`).
13
+
14
+ **Tensile test of the sheet** (:func:`cell_test`) in the direction ``n`` at ``angle``
15
+ degrees from ``x`` (the rolling direction), ``t`` across: ``H = a n⊗n + b t⊗t + c (n⊗t
16
+ + t⊗n)``, ``a`` prescribed, ``b`` and ``c`` free — their conjugate forces, the volume of
17
+ the cell times the mean nominal stresses ``P_tt`` and ``P_nt + P_tn``, vanish: a
18
+ uniaxial stress. The mean nominal stress ``P_nn`` against the engineering strain ``|(I
19
+ + H) n| − 1`` gives the yield and tensile strengths and the uniform elongation (the
20
+ maximum of the nominal stress: Considère's, the sheet's own, no specimen necking); the
21
+ width strain (the distance between two lines of the sheet along ``n``, the edges of a
22
+ strip: ``ln (det(I + H) / |(I + H) n|)``) over the thickness strain (the mean of ``ln
23
+ λ3`` over the cell) gives Lankford's coefficient — those of the sheet, free of the edges
24
+ of a specimen and of where its tracks fall in its gauge (Hill 1963: the representative
25
+ volume).
26
+
27
+ **Biaxial stretching** (``ratio``): ``b`` prescribed with ``a`` so that the true
28
+ strains across and along ``n`` keep the ratio, ``ln(1 + b) = ratio ln(1 + a)``, ``c``
29
+ free: the linear strain paths of sheet forming, from uniaxial tension (−½) through plane
30
+ strain (0) to equibiaxial stretching (1); the result's stress is then the mean nominal
31
+ stress ``P_nn`` (its maximum: the diffuse necking along ``n``), ``fields["nominal"]``
32
+ holds ``P_nn``, ``P_tt`` and ``P_nt`` (:func:`mean_nominal`).
33
+
34
+ **The shear** (``free_shear``): free by default, its conjugate stress vanishing, so that
35
+ a sheet whose tracks are oblique to ``n`` shears as it is stretched; held at zero, the
36
+ principal axes of the mean stretch stay along ``n`` and ``t``, the mean shear stress
37
+ then free: the path of the strains is prescribed in full, as by the tools of a forming
38
+ operation and in the analysis of Marciniak and Kuczyński.
39
+ """
40
+
41
+ from __future__ import annotations
42
+
43
+ import math
44
+ from dataclasses import dataclass, replace
45
+
46
+ import numpy as np
47
+ from scipy import sparse
48
+
49
+ from morphogen.laser.mechanics import Membrane, TensileResult, curve_measures
50
+ from morphogen.laser.specimen import QuadMesh
51
+ from morphogen.laser.structures import load_test
52
+
53
+ __all__ = ["PeriodicCell", "cell_test", "lattice", "mean_nominal", "reduce_basis"]
54
+
55
+
56
+ def reduce_basis(a1, a2) -> tuple[np.ndarray, np.ndarray]:
57
+ """The Lagrange–Gauss reduction of a basis of a plane lattice: the shortest pair of
58
+ vectors spanning it (at 60° to 120° from each other), counter-clockwise."""
59
+ a1, a2 = np.asarray(a1, dtype=float), np.asarray(a2, dtype=float)
60
+ if abs(a1[0] * a2[1] - a1[1] * a2[0]) < 1e-12 * max(a1 @ a1, a2 @ a2, 1e-300):
61
+ raise ValueError("lattice: the vectors are parallel")
62
+ for _ in range(64):
63
+ if a1 @ a1 > a2 @ a2:
64
+ a1, a2 = a2, a1
65
+ mu = round(float(a1 @ a2) / float(a1 @ a1))
66
+ if mu == 0:
67
+ break
68
+ a2 = a2 - mu * a1
69
+ if a1[0] * a2[1] - a1[1] * a2[0] < 0:
70
+ a2 = -a2
71
+ return a1, a2
72
+
73
+
74
+ def _turn(v, degrees: float) -> np.ndarray:
75
+ th = math.radians(degrees)
76
+ c, s = math.cos(th), math.sin(th)
77
+ return np.array([c * v[0] - s * v[1], s * v[0] + c * v[1]])
78
+
79
+
80
+ def lattice(pattern: dict, along: float | None = None) -> tuple[np.ndarray, np.ndarray]:
81
+ """The lattice vectors (mm, reduced) of a pattern repeated over the sheet (see the
82
+ module): ``straight`` (``spacing`` across the tracks, ``along`` them: by default the
83
+ spacing, 2 mm at most, the treatment being the same all along a track),
84
+ ``corrugated`` and ``fourier`` (``period`` along, ``spacing`` across, shifted by the
85
+ ``phase`` between neighbours), ``crossed`` (along each family, from a track of the
86
+ other family to the next: ``spacing2 / sin 2θ`` along the first, ``spacing / sin
87
+ 2θ`` along the second), ``honeycomb`` (the centres of the hexagons), ``none`` (a
88
+ square of 2 mm); all turned by the pattern's ``rotation``."""
89
+ p = dict(pattern)
90
+ kind = p.get("kind")
91
+ if kind == "none":
92
+ a1, a2 = np.array([2.0, 0.0]), np.array([0.0, 2.0])
93
+ elif kind == "straight":
94
+ s = p.get("spacing")
95
+ if not s:
96
+ raise ValueError("the cell of a straight family: give its spacing")
97
+ th = float(p.get("angle", 0.0))
98
+ along = min(float(s), 2.0) if along is None else float(along)
99
+ a1, a2 = _turn([along, 0.0], th), _turn([0.0, float(s)], th)
100
+ elif kind in ("corrugated", "fourier"):
101
+ s = p.get("spacing")
102
+ if not s:
103
+ raise ValueError(f"the cell of {kind} tracks: give their spacing")
104
+ period = float(p.get("period", 10.0))
105
+ a1 = np.array([period, 0.0])
106
+ a2 = np.array([-float(p.get("phase", 0.0)) / 360.0 * period, float(s)])
107
+ elif kind == "crossed":
108
+ th = math.radians(float(p.get("angle", 45.0)))
109
+ s1 = float(p.get("spacing", 3.0))
110
+ s2 = float(p.get("spacing2") or s1)
111
+ sin2 = abs(math.sin(2.0 * th))
112
+ if sin2 < 1e-6:
113
+ raise ValueError("crossed: the families are parallel")
114
+ a1 = s2 / sin2 * np.array([math.cos(th), math.sin(th)])
115
+ a2 = s1 / sin2 * np.array([math.cos(th), -math.sin(th)])
116
+ elif kind == "honeycomb":
117
+ c = float(p.get("cell", 3.0))
118
+ th = float(p.get("angle", 0.0))
119
+ a1 = _turn([1.5 * c, 0.5 * math.sqrt(3.0) * c], th)
120
+ a2 = _turn([0.0, math.sqrt(3.0) * c], th)
121
+ else:
122
+ raise ValueError(f"no lattice for the pattern {kind!r}: give the cell's vectors")
123
+ rot = float(p.get("rotation", 0.0))
124
+ return reduce_basis(_turn(a1, rot), _turn(a2, rot))
125
+
126
+
127
+ @dataclass
128
+ class PeriodicCell:
129
+ """The parallelogram spanned by ``a1`` and ``a2`` from ``origin`` (mm), meshed by
130
+ ``n1 x n2`` quadrilaterals (``mesh``); ``master``: the independent node each node
131
+ moves with (itself for the independent ones, ``i < n1`` and ``j < n2``); ``shift``:
132
+ the multiples ``(k1, k2)`` of ``a1`` and ``a2`` between them."""
133
+
134
+ a1: np.ndarray
135
+ a2: np.ndarray
136
+ origin: np.ndarray
137
+ mesh: QuadMesh
138
+ master: np.ndarray
139
+ shift: np.ndarray
140
+
141
+ @classmethod
142
+ def build(cls, a1, a2, *, element: float = 0.25, centre=(0.0, 0.0), shape=None) -> PeriodicCell:
143
+ """The cell of a lattice centred at ``centre``, its elements about ``element``
144
+ mm, or ``shape = (n1, n2)`` elements along ``a1`` and ``a2``."""
145
+ a1, a2 = np.asarray(a1, dtype=float), np.asarray(a2, dtype=float)
146
+ if a1[0] * a2[1] - a1[1] * a2[0] <= 0:
147
+ raise ValueError("cell: a1, a2 counter-clockwise (reduce_basis)")
148
+ if shape is None:
149
+ n1 = max(2, math.ceil(np.linalg.norm(a1) / element - 1e-9))
150
+ n2 = max(2, math.ceil(np.linalg.norm(a2) / element - 1e-9))
151
+ else:
152
+ n1, n2 = (int(v) for v in shape)
153
+ if min(n1, n2) < 2:
154
+ raise ValueError("cell: two elements at least along each vector")
155
+ origin = np.asarray(centre, dtype=float) - 0.5 * (a1 + a2)
156
+ i, j = np.meshgrid(np.arange(n1 + 1), np.arange(n2 + 1), indexing="ij")
157
+ i, j = i.ravel(), j.ravel()
158
+ nodes = origin + (i / n1)[:, None] * a1 + (j / n2)[:, None] * a2
159
+
160
+ def ids(ii, jj):
161
+ return ii * (n2 + 1) + jj
162
+
163
+ qi, qj = np.meshgrid(np.arange(n1), np.arange(n2), indexing="ij")
164
+ qi, qj = qi.ravel(), qj.ravel()
165
+ quads = np.stack(
166
+ [ids(qi, qj), ids(qi + 1, qj), ids(qi + 1, qj + 1), ids(qi, qj + 1)], axis=1
167
+ )
168
+ master = ids(i % n1, j % n2)
169
+ shift = np.stack([i // n1, j // n2], axis=1)
170
+ mesh = QuadMesh(
171
+ nodes,
172
+ quads.astype(np.int64),
173
+ np.flatnonzero(i == 0),
174
+ np.flatnonzero(i == n1),
175
+ np.flatnonzero(j == 0),
176
+ np.flatnonzero(j == n2),
177
+ (n1, n2),
178
+ )
179
+ return cls(a1, a2, origin, mesh, master.astype(np.int64), shift)
180
+
181
+ @property
182
+ def area(self) -> float:
183
+ """The area of the cell (mm²)."""
184
+ return float(abs(self.a1[0] * self.a2[1] - self.a1[1] * self.a2[0]))
185
+
186
+ @property
187
+ def independent(self) -> np.ndarray:
188
+ """The independent nodes (``i < n1``, ``j < n2``), in the order of the unknowns."""
189
+ return np.flatnonzero(self.master == np.arange(len(self.master)))
190
+
191
+ def box(self, margin: float = 0.0) -> tuple[float, float, float, float]:
192
+ """The box ``(x0, x1, y0, y1)`` around the cell, widened by ``margin``."""
193
+ lo = self.mesh.nodes.min(axis=0) - margin
194
+ hi = self.mesh.nodes.max(axis=0) + margin
195
+ return (float(lo[0]), float(hi[0]), float(lo[1]), float(hi[1]))
196
+
197
+ def map(self, angle: float = 0.0) -> sparse.csr_matrix:
198
+ """The map ``T`` of the unknowns ``q`` (the displacements of the independent
199
+ nodes, then ``a``, ``b``, ``c`` of ``H``, see the module, for the direction at
200
+ ``angle`` degrees) to the nodal displacements ``u = T q``."""
201
+ th = math.radians(angle)
202
+ c, s = math.cos(th), math.sin(th)
203
+ bases = (
204
+ np.array([[c * c, c * s], [c * s, s * s]]), # n ⊗ n
205
+ np.array([[s * s, -c * s], [-c * s, c * c]]), # t ⊗ t
206
+ np.array([[-2 * c * s, c * c - s * s], [c * c - s * s, 2 * c * s]]), # n⊗t + t⊗n
207
+ )
208
+ ind = self.independent
209
+ col = np.full(len(self.master), -1, dtype=np.int64)
210
+ col[ind] = np.arange(len(ind))
211
+ m = col[self.master]
212
+ nn = len(self.master)
213
+ rows = [np.arange(2 * nn)]
214
+ cols = [np.stack([2 * m, 2 * m + 1], axis=1).ravel()]
215
+ vals = [np.ones(2 * nn)]
216
+ d = self.shift[:, :1] * self.a1 + self.shift[:, 1:] * self.a2 # nodes x 2
217
+ dep = np.flatnonzero(np.any(self.shift != 0, axis=1))
218
+ for k, B in enumerate(bases):
219
+ v = d[dep] @ B.T # B d for each dependent node
220
+ rows.append(np.stack([2 * dep, 2 * dep + 1], axis=1).ravel())
221
+ cols.append(np.full(2 * len(dep), 2 * len(ind) + k))
222
+ vals.append(v.ravel())
223
+ return sparse.csr_matrix(
224
+ (np.concatenate(vals), (np.concatenate(rows), np.concatenate(cols))),
225
+ shape=(2 * nn, 2 * len(ind) + 3),
226
+ )
227
+
228
+
229
+ def mean_nominal(membrane: Membrane) -> np.ndarray:
230
+ """The mean nominal stress of a membrane in its current state (2 x 2, MPa): ``J σ
231
+ F⁻ᵀ`` (``J`` the change of volume, ``det F λ3``) averaged over its layers and its
232
+ area; over a periodic cell, the macroscopic nominal stress (Hill–Mandel)."""
233
+ F = membrane.Fn
234
+ sig = membrane.sig_n # (elements, 4, layers, 3): xx, yy, xy
235
+ S = np.empty((*sig.shape[:-1], 2, 2))
236
+ S[..., 0, 0], S[..., 1, 1] = sig[..., 0], sig[..., 1]
237
+ S[..., 0, 1] = S[..., 1, 0] = sig[..., 2]
238
+ inv_t = np.linalg.inv(F).swapaxes(-1, -2)[:, :, None]
239
+ J = np.linalg.det(F)[..., None] * membrane.lam_n
240
+ P = (J[..., None, None] * (S @ inv_t)).mean(axis=2)
241
+ w = membrane.w0
242
+ return np.einsum("eg,egij->ij", w, P) / float(w.sum())
243
+
244
+
245
+ class _Reduced:
246
+ """A membrane seen through the periodic map ``u = T q`` (forces ``Tᵀ f``, tangent
247
+ ``Tᵀ K T``); its other attributes are those of the membrane."""
248
+
249
+ def __init__(self, membrane: Membrane, T):
250
+ self.inner = membrane
251
+ self.T = T.tocsr()
252
+ self.Tt = self.T.T.tocsr()
253
+ self.ndof = self.T.shape[1]
254
+ self.u = np.zeros(self.ndof)
255
+
256
+ def __getattr__(self, name):
257
+ return getattr(self.inner, name)
258
+
259
+ def full(self, q) -> np.ndarray:
260
+ return self.T @ q
261
+
262
+ def reset(self) -> None:
263
+ self.inner.reset()
264
+ self.u = np.zeros(self.ndof)
265
+
266
+ def evaluate(self, q):
267
+ f, K, state, bad = self.inner.evaluate(self.T @ q)
268
+ return self.Tt @ f, (self.Tt @ K @ self.T).tocsr(), state, bad
269
+
270
+ def commit(self, q, state) -> None:
271
+ self.inner.commit(self.T @ q, state)
272
+ self.u = np.asarray(q, dtype=float).copy()
273
+
274
+
275
+ def cell_test(
276
+ membrane: Membrane,
277
+ cell: PeriodicCell,
278
+ angle: float = 0.0,
279
+ *,
280
+ max_strain: float = 0.25,
281
+ step: float = 0.004,
282
+ max_step: float = 0.02,
283
+ drop: float = 0.05,
284
+ tol: float = 1e-5,
285
+ max_iterations: int = 20,
286
+ max_steps: int = 400,
287
+ failure_margin: float | None = None,
288
+ record_history: bool = False,
289
+ keep_fields: bool = False,
290
+ monitors: dict | None = None,
291
+ ratio: float | None = None,
292
+ until=None,
293
+ free_shear: bool = True,
294
+ ) -> TensileResult:
295
+ """The tensile test of the sheet in the direction at ``angle`` degrees from x (see
296
+ the module) on the membrane of the cell: the engineering strain along it up to
297
+ ``max_strain`` (the steps and stops of
298
+ :func:`~morphogen.laser.structures.load_test`); the result's stress is the mean
299
+ nominal stress along the direction, its width and thickness strains give
300
+ Lankford's coefficient (:meth:`~morphogen.laser.mechanics.TensileResult.r_value`).
301
+ ``monitors``: more functions of the unknowns recorded at each step, after the
302
+ membrane has taken its new state (``fields["monitors"]``). ``ratio``: biaxial
303
+ stretching, the true strain across the direction prescribed at ``ratio`` times the
304
+ true strain along it (see the module); ``until``: the test stops when this function
305
+ of the unknowns returns true (after the monitors of the step); ``free_shear``: false
306
+ holds the shear ``c`` at zero (see the module)."""
307
+ T = cell.map(angle)
308
+ red = _Reduced(membrane, T)
309
+ na = T.shape[1] - 3 # the unknown a, then b and c
310
+ w = membrane.w0
311
+ wsum = float(w.sum())
312
+ th = math.radians(angle)
313
+ n, t = np.array([math.cos(th), math.sin(th)]), np.array([-math.sin(th), math.cos(th)])
314
+
315
+ def thickness(_q):
316
+ return float((np.log(membrane.lam_n).mean(axis=2) * w).sum() / wsum)
317
+
318
+ def nominal(u, v):
319
+ return lambda _q: float(u @ mean_nominal(membrane) @ v)
320
+
321
+ monitors = {
322
+ **(monitors or {}),
323
+ "c": lambda q: float(q[na + 2]),
324
+ "b": lambda q: float(q[na + 1]),
325
+ "thickness_strain": thickness,
326
+ }
327
+ if ratio is not None:
328
+ monitors.update({"P_nn": nominal(n, n), "P_tt": nominal(t, t), "P_nt": nominal(n, t)})
329
+ moved, direction = [na], [1.0]
330
+ if ratio is not None: # a linear path of the true strains: ln(1 + b) = ratio ln(1 + a)
331
+ rho = float(ratio)
332
+ moved = [na, na + 1]
333
+
334
+ def direction(d):
335
+ return (
336
+ np.array([d, (1.0 + d) ** rho - 1.0]),
337
+ np.array([1.0, rho * (1.0 + d) ** (rho - 1.0)]),
338
+ )
339
+
340
+ # the first independent node, the origin of the cell, and with fixed axes the shear
341
+ fixed = [0, 1] if free_shear else [0, 1, na + 2]
342
+ res = load_test(
343
+ red,
344
+ fixed,
345
+ moved,
346
+ direction,
347
+ length=1.0,
348
+ section=cell.area * membrane.thickness,
349
+ max_disp=max_strain,
350
+ step=step,
351
+ max_step=max_step,
352
+ drop=drop,
353
+ tol=tol,
354
+ max_iterations=max_iterations,
355
+ max_steps=max_steps,
356
+ failure_margin=failure_margin,
357
+ record_history=record_history,
358
+ monitors=monitors,
359
+ keep_fields=keep_fields,
360
+ until=until,
361
+ )
362
+ mon = res.fields["monitors"]
363
+ a, b, c = res.displacement, mon["b"], mon["c"]
364
+ strain = np.sqrt((1.0 + a) ** 2 + c**2) - 1.0
365
+ stress = res.stress if ratio is None else np.asarray(mon["P_nn"])
366
+ # the proof stress on the elastic slope: the phases of a treated steel share it
367
+ ys, uts, eu, energy, necked = curve_measures(strain, stress, young=membrane.young)
368
+ failure = res.failure_strain
369
+ if math.isfinite(failure): # from a (the controlled unknown) to the strain along n
370
+ failure = float(np.interp(failure, a, strain))
371
+ fields = dict(res.fields)
372
+ fields["cell"] = (cell.a1.copy(), cell.a2.copy())
373
+ fields["macroscopic"] = {"a": a.copy(), "b": np.asarray(b), "c": np.asarray(c)}
374
+ if ratio is not None:
375
+ fields["nominal"] = {k: np.asarray(mon[f"P_{k}"]) for k in ("nn", "tt", "nt")}
376
+ return replace(
377
+ res,
378
+ strain=strain,
379
+ stress=stress,
380
+ yield_strength=ys,
381
+ tensile_strength=uts,
382
+ uniform_elongation=eu,
383
+ energy=energy,
384
+ necked=necked,
385
+ failure_strain=failure,
386
+ # the distance between the edges of a strip along n: det(I + H) / |(I + H) n|
387
+ width_strain=np.log(
388
+ ((1.0 + a) * (1.0 + np.asarray(b)) - np.asarray(c) ** 2) / (1.0 + strain)
389
+ ),
390
+ thickness_strain=np.asarray(mon["thickness_strain"]),
391
+ fields=fields,
392
+ )