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,362 @@
1
+ """The laser treatment of a sheet: the hardness that a path leaves at given points.
2
+
3
+ :class:`LaserTreatment` holds the sheet (material, thickness, layers through the
4
+ thickness), the treatment (``hardening``, or a thermochemical one with its
5
+ :class:`~morphogen.laser.metallurgy.Alloying`) and the laser configuration (``single``:
6
+ the upper face; ``symmetric``: the same beam on both faces, or the beam of each track's
7
+ ``bottom``). :meth:`LaserTreatment.apply` runs a
8
+ :class:`~morphogen.laser.patterns.LaserPath` track after track at the points of the sheet
9
+ (the Gauss points of a mesh, the pixels of a map), each point split into ``layers``
10
+ through the thickness:
11
+
12
+ 1. the distance of each point to the track gives its thermal cycle at each depth, from
13
+ the quasi-steady cycles of a long straight track
14
+ (:class:`~morphogen.laser.heat.TrackKernel`, tabulated once per pair of beams): the
15
+ moving beam heats the band around its axis
16
+ as if the track were straight and long (curved tracks: their radius of curvature
17
+ should exceed the heated width; their ends overhang the specimen);
18
+ 2. a thermochemical treatment mixes the coating (or nitrogen) into the points that the
19
+ track melts (:meth:`~morphogen.laser.metallurgy.Alloying.mix`), the coating of the faces melted
20
+ being consumed;
21
+ 3. the metallurgical model integrates each cycle (:mod:`morphogen.laser.metallurgy`): the
22
+ points never touched before take the response of the first track tabulated once per
23
+ kernel; the
24
+ others (the tracks that overlap, temper or re-harden earlier ones) integrate their
25
+ cycle step by step.
26
+
27
+ The tracks are separated by pauses long enough for the sheet to cool (30 s in Wang's
28
+ experiments): each cycle starts from ambient. :meth:`LaserTreatment.transient` runs the
29
+ same path through the finite-volume solver of the whole blank instead (the heat that the
30
+ previous tracks leave, the edges), for checks.
31
+ """
32
+
33
+ from __future__ import annotations
34
+
35
+ from dataclasses import dataclass, field
36
+
37
+ import numpy as np
38
+
39
+ from morphogen.laser.heat import CONFIGURATIONS, Beam, TrackKernel, TransientHeat, track_kernel
40
+ from morphogen.laser.materials import SheetMaterial
41
+ from morphogen.laser.metallurgy import TREATMENTS, Alloying, PeakHardening
42
+ from morphogen.laser.patterns import LaserPath, distance_to_polyline
43
+
44
+ #: Distances of the response of an untouched sheet to a track (its shortcut).
45
+ RESPONSE_POINTS = 512
46
+ #: State variables that define the material of a point (the others are bookkeeping).
47
+ _MATERIAL_KEYS = (
48
+ "martensite",
49
+ "bainite",
50
+ "hm0",
51
+ "ptemper",
52
+ "retained",
53
+ "gain",
54
+ "carbon",
55
+ "nitrogen",
56
+ )
57
+
58
+
59
+ @dataclass
60
+ class TreatmentResult:
61
+ """The treated sheet at its points: ``hardness``, ``peak`` temperature (°C),
62
+ ``treated`` share (of the transformed phases, or of the full gain), ``melted``,
63
+ ``carbon`` and ``nitrogen`` (wt%), all ``(points, layers)``; ``weights``: the area
64
+ (mm²) of each point; the path and its measures."""
65
+
66
+ points: np.ndarray
67
+ weights: np.ndarray
68
+ layers: int
69
+ hardness: np.ndarray
70
+ peak: np.ndarray
71
+ treated: np.ndarray
72
+ melted: np.ndarray
73
+ carbon: np.ndarray
74
+ nitrogen: np.ndarray
75
+ material: SheetMaterial
76
+ path: LaserPath | None = None
77
+ state: dict = field(default_factory=dict, repr=False)
78
+
79
+ @property
80
+ def mean_hardness(self) -> np.ndarray:
81
+ """Hardness averaged through the thickness (``points``)."""
82
+ return self.hardness.mean(axis=1)
83
+
84
+ def area_fraction(self, threshold: float = 0.5) -> float:
85
+ """Fraction of the area whose treated share (through the thickness) exceeds
86
+ ``threshold``."""
87
+ share = self.treated.mean(axis=1)
88
+ return float(np.sum(self.weights * (share >= threshold)) / np.sum(self.weights))
89
+
90
+ def volume_fraction(self) -> float:
91
+ """Mean treated share over the sheet: the reinforced volume fraction."""
92
+ return float(
93
+ np.sum(self.weights[:, None] * self.treated) / (self.layers * np.sum(self.weights))
94
+ )
95
+
96
+ def flow(self) -> tuple:
97
+ """Flow laws of the points ``(kind, σ0, a, b)``, each ``(points, layers)``."""
98
+ kind, s0, a, b = self.material.strength.flow(
99
+ self.hardness.ravel(), young=self.material.young
100
+ )
101
+ shape = self.hardness.shape
102
+ return kind.reshape(shape), s0.reshape(shape), a.reshape(shape), b.reshape(shape)
103
+
104
+
105
+ class LaserTreatment:
106
+ """A treatment of a sheet (see the module): ``material`` (a :class:`SheetMaterial`
107
+ or a preset name), ``thickness`` (mm; the material's by default), ``configuration``,
108
+ ``layers`` through the thickness, ``treatment`` (``hardening``, ``carburizing``,
109
+ ``nitriding``, ``alloying``) and its ``alloying`` parameters, ``ambient`` (°C)."""
110
+
111
+ def __init__(
112
+ self,
113
+ material,
114
+ *,
115
+ thickness: float | None = None,
116
+ configuration: str = "symmetric",
117
+ layers: int = 4,
118
+ treatment: str = "hardening",
119
+ alloying=None,
120
+ ambient: float = 20.0,
121
+ distances: int = 48,
122
+ times: int = 240,
123
+ ):
124
+ self.material = SheetMaterial.from_config(material)
125
+ self.thickness = float(thickness if thickness is not None else self.material.thickness)
126
+ if configuration not in CONFIGURATIONS:
127
+ raise ValueError(f"configuration: one of {CONFIGURATIONS}")
128
+ self.configuration = configuration
129
+ self.layers = int(layers)
130
+ if self.layers < 1:
131
+ raise ValueError("layers: at least one")
132
+ if treatment not in TREATMENTS:
133
+ raise ValueError(f"treatment: one of {TREATMENTS}")
134
+ self.treatment = treatment
135
+ if treatment == "hardening":
136
+ self.alloying = None
137
+ else:
138
+ spec = (
139
+ {"kind": treatment, **dict(alloying or {})}
140
+ if not isinstance(alloying, Alloying)
141
+ else alloying
142
+ )
143
+ self.alloying = Alloying.from_config(spec)
144
+ self.ambient = float(ambient)
145
+ self._kernel_options = {"distances": int(distances), "times": int(times)}
146
+ self._kernels: dict = {}
147
+ self._responses: dict = {}
148
+
149
+ @property
150
+ def model(self):
151
+ return self.material.metallurgy
152
+
153
+ def beams(self, beam: Beam, bottom: Beam | None) -> tuple[Beam, Beam | None]:
154
+ """The beams of a track: its ``bottom`` beam, or the same beam on the lower
155
+ face in the ``symmetric`` configuration, none in the ``single`` one."""
156
+ if self.configuration == "single":
157
+ return beam, None
158
+ return beam, bottom if bottom is not None else beam
159
+
160
+ def kernel(self, beam: Beam, bottom: Beam | None = None) -> TrackKernel:
161
+ """The tabulated cycles of a track of these beams (cached)."""
162
+ top, low = self.beams(beam, bottom)
163
+ key = (top, low)
164
+ if key not in self._kernels:
165
+ self._kernels[key] = track_kernel(
166
+ top,
167
+ self.thickness,
168
+ self.material.thermal,
169
+ bottom=low,
170
+ layers=self.layers,
171
+ ambient=self.ambient,
172
+ cutoff=self._cutoff(),
173
+ **self._kernel_options,
174
+ )
175
+ return self._kernels[key]
176
+
177
+ def _cutoff(self) -> float:
178
+ """The lowest peak temperature that changes a point: the onset of tempering when
179
+ the sheet holds martensite, else of the transformations."""
180
+ m = self.model
181
+ low = m.tempering.t_min + 100.0
182
+ if isinstance(m, PeakHardening) or getattr(m, "martensite", 0.0) > 0:
183
+ return max(low, self.ambient + 50.0)
184
+ return max(min(m.onset - 100.0, low + 300.0), self.ambient + 50.0)
185
+
186
+ def _response(self, kern: TrackKernel) -> tuple[np.ndarray, dict]:
187
+ """The state that the cycles of a kernel leave in an untouched sheet, on a fine
188
+ grid of distances (:data:`RESPONSE_POINTS`) x layers: the thresholds of the
189
+ transformations stay sharp."""
190
+ key = id(kern)
191
+ if key not in self._responses:
192
+ dist = np.linspace(0.0, kern.reach, RESPONSE_POINTS)
193
+ n = len(dist) * kern.layers
194
+ state = self.model.initial_state(n)
195
+ cyc = kern.cycles(dist) # distances x times x layers
196
+ temps = np.transpose(cyc, (1, 0, 2)).reshape(len(kern.times), n)
197
+ self._integrate(state, temps, kern.times)
198
+ self._responses[key] = (dist, state)
199
+ return self._responses[key]
200
+
201
+ def _integrate(self, state, temps, times) -> None:
202
+ """Integrate cycles ``temps`` (times x points) from ambient, then cool."""
203
+ m = self.model
204
+ prev = np.full(temps.shape[1], self.ambient)
205
+ t_prev = None
206
+ for j, tj in enumerate(times):
207
+ dt = float(tj - t_prev) if t_prev is not None else 0.0
208
+ if dt > 0:
209
+ m.step(state, prev, temps[j], dt)
210
+ prev = temps[j]
211
+ t_prev = tj
212
+ m.step(state, prev, np.full_like(prev, self.ambient), max(1.0, float(times[-1] - times[0])))
213
+ m.finish(state)
214
+
215
+ def apply(self, path: LaserPath, points, weights=None) -> TreatmentResult:
216
+ """Run the path at the points (n x 2, mm) of areas ``weights`` (mm²; equal by
217
+ default): see the module."""
218
+ pts = np.ascontiguousarray(np.asarray(points, dtype=float).reshape(-1, 2))
219
+ n, nl = len(pts), self.layers
220
+ w = np.ones(n) if weights is None else np.asarray(weights, dtype=float).reshape(n)
221
+ m = self.model
222
+ state = m.initial_state(n * nl)
223
+ init = m.initial_state(1)
224
+ keys = [k for k in _MATERIAL_KEYS if k in state]
225
+ coated = {"top": np.ones(n, bool), "bottom": np.ones(n, bool)}
226
+ if self.alloying is not None:
227
+ if self.alloying.faces == "top":
228
+ coated["bottom"][:] = False
229
+ elif self.alloying.faces == "bottom":
230
+ coated["top"][:] = False
231
+ dz = self.thickness / nl
232
+ for track in path:
233
+ kern = self.kernel(track.beam, track.bottom)
234
+ d = distance_to_polyline(pts, track.points)
235
+ near = np.flatnonzero(d < kern.reach)
236
+ if not near.size:
237
+ continue
238
+ dn = d[near]
239
+ rows = (near[:, None] * nl + np.arange(nl)[None, :]).ravel() # point-layers
240
+ # 1. composition of the melt
241
+ changed = np.zeros(rows.size, dtype=bool)
242
+ if self.alloying is not None:
243
+ peaks = kern.peak_at(dn) # near x layers
244
+ melted = peaks >= m.solidus
245
+ if melted.any():
246
+ surface = {}
247
+ for face, layer in (("top", 0), ("bottom", nl - 1)):
248
+ hit = melted[:, layer] & coated[face][near]
249
+ surface[face] = float(w[near][hit].sum())
250
+ coated[face][near[hit]] = False
251
+ mask = np.zeros(n * nl, dtype=bool)
252
+ mask[rows[melted.ravel()]] = True
253
+ self.alloying.mix(
254
+ state,
255
+ mask,
256
+ np.repeat(w, nl) * dz,
257
+ surface,
258
+ density=self.material.density,
259
+ melt_temperature=float(peaks.max()),
260
+ chromium=m.composition.get("Cr", 0.0),
261
+ )
262
+ changed = melted.ravel()
263
+ # 2. metallurgy: untouched points take the tabulated response
264
+ pristine = np.ones(rows.size, dtype=bool)
265
+ for k in keys:
266
+ pristine &= state[k][rows] == init[k][0]
267
+ pristine &= ~changed
268
+ if pristine.any():
269
+ self._take_response(
270
+ state,
271
+ rows[pristine],
272
+ kern,
273
+ np.repeat(dn, nl)[pristine],
274
+ np.tile(np.arange(nl), dn.size)[pristine],
275
+ )
276
+ sel = ~pristine
277
+ todo = rows[sel]
278
+ if todo.size:
279
+ sub = {k: v[todo] for k, v in state.items() if k != "clock"}
280
+ sub["clock"] = state["clock"].copy()
281
+ cyc = kern.cycles(dn) # near x times x layers
282
+ temps = np.transpose(cyc, (1, 0, 2)).reshape(len(kern.times), -1)
283
+ self._integrate(sub, temps[:, sel], kern.times)
284
+ for k, v in sub.items():
285
+ if k != "clock":
286
+ state[k][todo] = v
287
+ hard = m.hardness(state).reshape(n, nl)
288
+ treated = m.treated(state).reshape(n, nl)
289
+ return TreatmentResult(
290
+ points=pts,
291
+ weights=w,
292
+ layers=nl,
293
+ hardness=hard,
294
+ peak=state["tmax"].reshape(n, nl).copy(),
295
+ treated=treated,
296
+ melted=state["melted"].reshape(n, nl).copy(),
297
+ carbon=state["carbon"].reshape(n, nl).copy(),
298
+ nitrogen=state["nitrogen"].reshape(n, nl).copy(),
299
+ material=self.material,
300
+ path=path,
301
+ state=state,
302
+ )
303
+
304
+ def _take_response(self, state, rows, kern: TrackKernel, dist, layer) -> None:
305
+ """The tabulated response of an untouched sheet at distances ``dist`` and
306
+ ``layer`` s: linear interpolation of the continuous variables in the distance,
307
+ the nearest distance for the others."""
308
+ grid, resp = self._response(kern)
309
+ nd, nl = len(grid), kern.layers
310
+ x = np.clip(dist, 0.0, grid[-1])
311
+ i = np.clip(np.searchsorted(grid, x, side="right") - 1, 0, nd - 2)
312
+ f = (x - grid[i]) / (grid[i + 1] - grid[i])
313
+ r0, r1 = i * nl + layer, (i + 1) * nl + layer
314
+ nearest = np.where(f < 0.5, r0, r1)
315
+ for k, table in resp.items():
316
+ if k == "clock":
317
+ continue
318
+ if table.dtype == bool or k in ("t8",):
319
+ state[k][rows] = table[nearest]
320
+ else:
321
+ a, b = table[r0], table[r1]
322
+ ok = np.isfinite(a) & np.isfinite(b)
323
+ state[k][rows] = np.where(ok, (1.0 - f) * a + f * b, table[nearest])
324
+
325
+ def transient(
326
+ self,
327
+ path: LaserPath,
328
+ size,
329
+ *,
330
+ origin=(0.0, 0.0),
331
+ cell: float = 0.1,
332
+ cooling: float | None = None,
333
+ ) -> tuple:
334
+ """The path run by the finite-volume solver on the blank ``size`` (mm) at
335
+ ``origin``, cells of ``cell`` mm, the layers of the treatment through the
336
+ thickness: ``(TransientHeat, TransientResult)`` with the metallurgical state of
337
+ the cells (hardening only)."""
338
+ if self.alloying is not None:
339
+ raise ValueError(
340
+ "transient runs: hardening only (the melt pools of the "
341
+ "thermochemical treatments come from the kernels)"
342
+ )
343
+ solver = TransientHeat(
344
+ size,
345
+ self.thickness,
346
+ self.material.thermal,
347
+ cell=cell,
348
+ layers=self.layers,
349
+ origin=origin,
350
+ ambient=self.ambient,
351
+ )
352
+ segs = []
353
+ for t in path:
354
+ top, low = self.beams(t.beam, t.bottom)
355
+ segs.append((t.points, top, low, t.pause))
356
+ res = solver.run(
357
+ segs,
358
+ configuration="single",
359
+ model=self.model,
360
+ cooling=cooling if cooling is not None else self.ambient + 30.0,
361
+ )
362
+ return solver, res