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,615 @@
1
+ """Thermo-metallurgical response of a steel sheet to the thermal cycles of laser tracks:
2
+ the phases and the hardness that each point keeps.
3
+
4
+ Two models share one interface: :meth:`initial_state` (arrays of the points),
5
+ :meth:`step` (one time step of their temperatures, vectorized), :meth:`finish` (the
6
+ transformations completed on the final cooling to ambient) and :meth:`hardness`.
7
+ Temperatures in °C, times in s, compositions in wt%.
8
+
9
+ :class:`TransformationHardening` (C–Mn and low-alloy steels). A cycle that exceeds
10
+ ``Ac1`` forms austenite at its peak ``T_p`` by the lever rule of a hypo-eutectoid steel,
11
+ the carbon of the austenite following the ``A3`` line from the eutectoid ``0.77`` at
12
+ ``Ac1`` to the steel's at ``Ac3``: ``f_γ = (C − C_α)/(C_γ(T_p) − C_α)`` (the pearlite at
13
+ once, the ferrite gradually); laser heating at 10³–10⁴ K/s shifts both temperatures up
14
+ by ``superheat``. On cooling the austenite turns into martensite when it cools fast
15
+ enough (the cooling time ``t8/5`` against a critical one, the rest into bainite or
16
+ ferrite–pearlite), at ambient by Koistinen and Marburger's law
17
+ ``1 − exp(−0.011 (Ms − T))``, ``Ms`` of the austenite's carbon by Andrews's (1965)
18
+ linear formula (the rest retained). The hardnesses of martensite, bainite and
19
+ ferrite–pearlite are Maynier et al.'s (1978) functions of the composition and of the
20
+ cooling rate. Martensite below ``Ac1`` tempers: the Hollomon–Jaffe parameter
21
+ ``P = T (C + log10 t)`` (K, hours) accumulated by additivity (the time that gives the
22
+ current ``P`` at the current temperature, extended by the step), its hardness falling
23
+ linearly from ``P0`` to ``P1`` (Grange et al. 1977). An annealed ferrite–pearlite sheet
24
+ thus gets tracks of martensite with tempered rings where later tracks pass (the
25
+ annealed MS1500 of Wang 2022); a martensitic or dual-phase sheet (DP1180, MS1500:
26
+ ``martensite`` initial fraction) softens in rings that stay below ``Ac1`` and hardens
27
+ again where it is austenitized (Lapouge et al. 2019).
28
+
29
+ :class:`PeakHardening` (phenomenological). The hardness gained by a cycle is a
30
+ function of its peak temperature (a table), lost by Hollomon–Jaffe tempering; a new
31
+ cycle above the onset of the table re-transforms a share of the point that grows with
32
+ its peak, the rest keeping its tempered gain (the larger of the fresh gain and of this
33
+ mixture). For AISI 430, whose hardening by
34
+ grain-boundary martensite and chromium carbides near the melting point (Wang et al.
35
+ 2022) has no simple phase model.
36
+
37
+ **Composition** (:class:`Alloying`). Laser carburizing from a graphite coating,
38
+ nitriding under nitrogen and alloying from a pre-placed coating happen in the melt
39
+ pool, stirred by Marangoni flows: the coating that a track melts (its areal mass on the
40
+ faces melted, times an efficiency) mixes with the melted metal (mass balance),
41
+ nitrogen dissolves up to Sieverts's solubility ``log[%N] = −188/T − 1.25 −
42
+ e_N^Cr [%Cr]`` (iron, ``e_N^Cr = −0.047``, at a partial pressure ``p``: times ``√p``)
43
+ times an efficiency. The solid-state diffusion of the same cycles reaches micrometres
44
+ (``√(∫D dt)``, :meth:`~morphogen.laser.heat.TrackKernel.kinetic_integral`) and is neglected.
45
+ """
46
+
47
+ from __future__ import annotations
48
+
49
+ import math
50
+ from dataclasses import dataclass, field
51
+
52
+ import numpy as np
53
+
54
+ #: Elements of the compositions (wt%).
55
+ ELEMENTS = ("C", "N", "Si", "Mn", "Ni", "Cr", "Mo", "V")
56
+ #: Carbon of ferrite and of the eutectoid (wt%).
57
+ C_FERRITE, C_EUTECTOID = 0.02, 0.77
58
+
59
+
60
+ def _composition(data) -> dict[str, float]:
61
+ comp = dict.fromkeys(ELEMENTS, 0.0)
62
+ for k, v in dict(data or {}).items():
63
+ if k not in ELEMENTS:
64
+ raise ValueError(f"composition: unknown element {k!r} (one of {ELEMENTS})")
65
+ comp[k] = float(v)
66
+ return comp
67
+
68
+
69
+ def andrews_ac(comp) -> tuple[float, float]:
70
+ """``Ac1`` and ``Ac3`` (°C) by Andrews's (1965) formulas."""
71
+ c = _composition(comp)
72
+ ac1 = 723.0 - 10.7 * c["Mn"] - 16.9 * c["Ni"] + 29.1 * c["Si"] + 16.9 * c["Cr"]
73
+ ac3 = (
74
+ 910.0
75
+ - 203.0 * math.sqrt(max(c["C"], 0.0))
76
+ - 15.2 * c["Ni"]
77
+ + 44.7 * c["Si"]
78
+ + 104.0 * c["V"]
79
+ + 31.5 * c["Mo"]
80
+ )
81
+ return ac1, ac3
82
+
83
+
84
+ def andrews_ms(carbon, comp, nitrogen=0.0):
85
+ """``Ms`` (°C) by Andrews's (1965) linear formula, nitrogen counted as carbon."""
86
+ c = _composition(comp)
87
+ cn = np.asarray(carbon, dtype=float) + np.asarray(nitrogen, dtype=float)
88
+ return 539.0 - 423.0 * cn - 30.4 * c["Mn"] - 17.7 * c["Ni"] - 12.1 * c["Cr"] - 7.5 * c["Mo"]
89
+
90
+
91
+ def maynier_hardness(carbon, comp, rate, *, nitrogen=0.0) -> tuple:
92
+ """Hardnesses (HV) of martensite, bainite and ferrite–pearlite formed at the cooling
93
+ rate ``rate`` (K/s at about 700 °C) by Maynier, Jungmann & Dollet (1978), the carbon
94
+ of the transforming austenite given (nitrogen counted as carbon)."""
95
+ c = _composition(comp)
96
+ cc = np.asarray(carbon, dtype=float) + np.asarray(nitrogen, dtype=float)
97
+ lv = np.log10(np.maximum(np.asarray(rate, dtype=float), 1e-3) * 3600.0) # °C/h
98
+ si, mn, ni, cr, mo, v = (c[k] for k in ("Si", "Mn", "Ni", "Cr", "Mo", "V"))
99
+ hm = 127.0 + 949.0 * cc + 27.0 * si + 11.0 * mn + 8.0 * ni + 16.0 * cr + 21.0 * lv
100
+ hb = (
101
+ -323.0
102
+ + 185.0 * cc
103
+ + 330.0 * si
104
+ + 153.0 * mn
105
+ + 65.0 * ni
106
+ + 144.0 * cr
107
+ + 191.0 * mo
108
+ + lv * (89.0 + 53.0 * cc - 55.0 * si - 22.0 * mn - 10.0 * ni - 20.0 * cr - 33.0 * mo)
109
+ )
110
+ hf = (
111
+ 42.0
112
+ + 223.0 * cc
113
+ + 53.0 * si
114
+ + 30.0 * mn
115
+ + 12.6 * ni
116
+ + 7.0 * cr
117
+ + 19.0 * mo
118
+ + lv * (10.0 - 19.0 * si + 4.0 * ni + 8.0 * cr + 130.0 * v)
119
+ )
120
+ return hm, hb, hf
121
+
122
+
123
+ def sieverts_nitrogen(temperature: float, chromium: float = 0.0, pressure: float = 1.0) -> float:
124
+ """Solubility of nitrogen (wt%) in liquid iron at ``temperature`` (°C) under a
125
+ partial pressure ``pressure`` (atm): ``log[%N] = −188/T − 1.25`` (Sieverts's law),
126
+ raised by chromium through ``log f_N = e_N^Cr [%Cr]``, ``e_N^Cr = −0.047``."""
127
+ t = temperature + 273.15
128
+ return 10.0 ** (-188.0 / t - 1.25 + 0.047 * chromium) * math.sqrt(max(pressure, 0.0))
129
+
130
+
131
+ def _tempering_step(p, t_new, dt, c_hj: float, t_min: float):
132
+ """Hollomon–Jaffe parameter after ``dt`` seconds at ``t_new`` (°C), by additivity:
133
+ the time that gives ``p`` at this temperature, plus ``dt``."""
134
+ hot = t_new > t_min
135
+ if not hot.any():
136
+ return p
137
+ tk = t_new[hot] + 273.15
138
+ t_eq = 10.0 ** (np.minimum(p[hot] / tk - c_hj, 30.0)) # hours
139
+ out = p.copy()
140
+ out[hot] = np.maximum(p[hot], tk * (c_hj + np.log10(t_eq + dt / 3600.0)))
141
+ return out
142
+
143
+
144
+ @dataclass
145
+ class Tempering:
146
+ """Linear softening with the Hollomon–Jaffe parameter: hardness ``H0`` up to ``P0``,
147
+ falling to ``floor`` (a fraction of ``H0``, or an absolute ``minimum`` HV, the larger)
148
+ at ``P1``; ``constant`` C (hours); no tempering below ``t_min`` °C."""
149
+
150
+ constant: float = 20.0
151
+ start: float = 9000.0
152
+ end: float = 20000.0
153
+ floor: float = 0.4
154
+ minimum: float = 0.0
155
+ t_min: float = 150.0
156
+
157
+ def factor(self, p, h0):
158
+ """Hardness of a phase of as-quenched hardness ``h0`` at the parameter ``p``."""
159
+ s = np.clip((np.asarray(p) - self.start) / (self.end - self.start), 0.0, 1.0)
160
+ low = np.maximum(self.floor * np.asarray(h0), self.minimum)
161
+ return h0 - s * np.maximum(h0 - low, 0.0)
162
+
163
+ @classmethod
164
+ def from_config(cls, data) -> Tempering:
165
+ return data if isinstance(data, Tempering) else cls(**dict(data or {}))
166
+
167
+
168
+ class _Model:
169
+ """Shared bookkeeping of the thermal excursions of the points."""
170
+
171
+ ambient: float = 20.0
172
+ #: An excursion starts above this temperature and ends below ``finish_below``.
173
+ onset: float = 700.0
174
+ finish_below: float = 300.0
175
+
176
+ def _base_state(self, n: int) -> dict:
177
+ return {
178
+ "clock": np.zeros(1),
179
+ "tmax": np.full(n, -273.15),
180
+ "peak": np.full(n, -273.15),
181
+ "excursion": np.zeros(n, dtype=bool),
182
+ "t8": np.full(n, np.nan),
183
+ "t85": np.full(n, np.nan),
184
+ "melted": np.zeros(n, dtype=bool),
185
+ "molten": np.zeros(n, dtype=bool),
186
+ }
187
+
188
+ def _track(self, state, t_old, t_new, dt):
189
+ """Peaks, excursions and cooling times; returns the points whose excursion ended."""
190
+ state["clock"] += dt
191
+ clock = float(state["clock"][0])
192
+ np.maximum(state["tmax"], t_new, out=state["tmax"])
193
+ start = (~state["excursion"]) & (t_new >= self.onset)
194
+ if start.any():
195
+ state["excursion"][start] = True
196
+ state["peak"][start] = t_new[start]
197
+ state["t8"][start] = np.nan
198
+ state["molten"][start] = False
199
+ exc = state["excursion"]
200
+ np.maximum(state["peak"], np.where(exc, t_new, -273.15), out=state["peak"])
201
+ # cooling times 800 -> 500 °C (linear interpolation of the crossing within the step)
202
+ for level, key in ((800.0, "t8"), (500.0, "t5")):
203
+ cross = exc & (t_old >= level) & (t_new < level)
204
+ if cross.any():
205
+ f = (t_old[cross] - level) / np.maximum(t_old[cross] - t_new[cross], 1e-12)
206
+ when = clock - dt + f * dt
207
+ if key == "t8":
208
+ state["t8"][cross] = when
209
+ else:
210
+ t8 = state["t8"][cross]
211
+ state["t85"][cross] = np.where(np.isfinite(t8), when - t8, state["t85"][cross])
212
+ hot = t_new >= self.solidus
213
+ state["melted"] |= hot
214
+ state["molten"] |= exc & hot
215
+ done = exc & (t_new < self.finish_below)
216
+ return done
217
+
218
+ def finish(self, state) -> None:
219
+ """Complete the excursions still open (the final cooling to ambient)."""
220
+ done = state["excursion"].copy()
221
+ if done.any():
222
+ self._complete(state, done)
223
+
224
+ def peak_temperature(self, state) -> np.ndarray:
225
+ return state["tmax"]
226
+
227
+
228
+ @dataclass
229
+ class TransformationHardening(_Model):
230
+ """C–Mn or low-alloy steel (see the module): ``composition`` (wt%), ``Ac1``/``Ac3``
231
+ (°C; Andrews's by default) plus ``superheat`` for laser heating rates, ``solidus``,
232
+ the initial ``martensite`` fraction and the hardness of the initial microstructure's
233
+ martensite (``martensite_hardness``; Maynier's at ``initial_rate`` by default) and of
234
+ the rest (``matrix_hardness``; Maynier's ferrite–pearlite after a slow cooling by
235
+ default), the critical cooling time ``t8/5`` up to which austenite turns into
236
+ martensite (``critical_time``, s) and the time beyond which none does
237
+ (``slow_time``), ``tempering``."""
238
+
239
+ composition: dict = field(default_factory=lambda: {"C": 0.2, "Mn": 1.5, "Si": 0.25})
240
+ ac1: float | None = None
241
+ ac3: float | None = None
242
+ superheat: float = 50.0
243
+ solidus: float = 1480.0
244
+ martensite: float = 0.0
245
+ martensite_hardness: float | None = None
246
+ matrix_hardness: float | None = None
247
+ initial_rate: float = 1.0 / 30.0
248
+ critical_time: float = 2.0
249
+ slow_time: float = 30.0
250
+ km: float = 0.011
251
+ tempering: Tempering = field(default_factory=Tempering)
252
+ ambient: float = 20.0
253
+ finish_below: float = 300.0
254
+
255
+ def __post_init__(self):
256
+ self.composition = _composition(self.composition)
257
+ self.tempering = Tempering.from_config(self.tempering)
258
+ ac1, ac3 = andrews_ac(self.composition)
259
+ self.ac1 = float(self.ac1 if self.ac1 is not None else ac1)
260
+ self.ac3 = float(self.ac3 if self.ac3 is not None else ac3)
261
+ if not self.ac1 < self.ac3:
262
+ raise ValueError("Ac1 < Ac3")
263
+ if not 0.0 <= self.martensite <= 1.0:
264
+ raise ValueError("martensite: an initial fraction in [0, 1]")
265
+ c = self.composition["C"]
266
+ hm, _, _hf = maynier_hardness(c, self.composition, 1000.0)
267
+ if self.martensite_hardness is None:
268
+ self.martensite_hardness = float(hm)
269
+ if self.matrix_hardness is None:
270
+ self.matrix_hardness = float(
271
+ maynier_hardness(c, self.composition, self.initial_rate)[2]
272
+ )
273
+ self.onset = self.ac1 + self.superheat
274
+
275
+ @property
276
+ def a1(self) -> float:
277
+ return self.ac1 + self.superheat
278
+
279
+ @property
280
+ def a3(self) -> float:
281
+ return self.ac3 + self.superheat
282
+
283
+ def austenite(self, peak, carbon) -> tuple[np.ndarray, np.ndarray]:
284
+ """Fraction and carbon (wt%) of the austenite at the peak temperature ``peak``
285
+ of a steel of carbon ``carbon``: lever rule, the austenite carbon from 0.77 at
286
+ ``A1`` to the steel's at ``A3`` (linear in temperature)."""
287
+ peak = np.asarray(peak, dtype=float)
288
+ c = np.clip(np.asarray(carbon, dtype=float), C_FERRITE + 1e-6, None)
289
+ s = np.clip((peak - self.a1) / (self.a3 - self.a1), 0.0, 1.0)
290
+ c_eut = np.maximum(C_EUTECTOID, c)
291
+ c_gamma = c_eut + (c - c_eut) * s
292
+ f = np.where(peak >= self.a1, (c - C_FERRITE) / np.maximum(c_gamma - C_FERRITE, 1e-9), 0.0)
293
+ f = np.clip(np.where(peak >= self.a3, 1.0, f), 0.0, 1.0)
294
+ return f, np.where(f > 0, c_gamma, c)
295
+
296
+ def initial_state(self, n: int) -> dict:
297
+ state = self._base_state(n)
298
+ state.update(
299
+ carbon=np.full(n, self.composition["C"]),
300
+ nitrogen=np.full(n, self.composition["N"]),
301
+ martensite=np.full(n, self.martensite),
302
+ hm0=np.full(n, float(self.martensite_hardness)),
303
+ ptemper=np.zeros(n),
304
+ bainite=np.zeros(n),
305
+ hb=np.zeros(n),
306
+ retained=np.zeros(n),
307
+ )
308
+ return state
309
+
310
+ def step(self, state, t_old, t_new, dt) -> None:
311
+ """One step of the temperatures of the points (°C), ``dt`` seconds."""
312
+ t_old = np.asarray(t_old, dtype=float)
313
+ t_new = np.asarray(t_new, dtype=float)
314
+ has_m = state["martensite"] > 0
315
+ warm = has_m & (t_new > self.tempering.t_min)
316
+ if warm.any():
317
+ idx = np.flatnonzero(warm)
318
+ state["ptemper"][idx] = _tempering_step(
319
+ state["ptemper"][idx], t_new[idx], dt, self.tempering.constant, self.tempering.t_min
320
+ )
321
+ done = self._track(state, t_old, t_new, dt)
322
+ if done.any():
323
+ self._complete(state, done)
324
+
325
+ def _complete(self, state, done) -> None:
326
+ """End of the excursions of the points ``done``: transformations at the peak
327
+ and on cooling to ambient."""
328
+ idx = np.flatnonzero(done)
329
+ peak = state["peak"][idx]
330
+ carbon = state["carbon"][idx]
331
+ nitrogen = state["nitrogen"][idx]
332
+ fg, cg = self.austenite(np.where(state["molten"][idx], self.a3 + 1.0, peak), carbon)
333
+ ng = np.where(fg > 0, nitrogen * np.minimum(1.0 / np.maximum(fg, 1e-9), 3.0), nitrogen)
334
+ t85 = state["t85"][idx]
335
+ t85 = np.where(np.isfinite(t85), t85, self.critical_time) # unseen: as quenched
336
+ rate = 300.0 / np.maximum(t85, 1e-6)
337
+ lt = np.log(np.maximum(t85, 1e-9))
338
+ share = np.clip(
339
+ (math.log(self.slow_time) - lt)
340
+ / (math.log(self.slow_time) - math.log(self.critical_time)),
341
+ 0.0,
342
+ 1.0,
343
+ )
344
+ ms = andrews_ms(cg, self.composition, ng)
345
+ km = np.where(ms > self.ambient, 1.0 - np.exp(-self.km * (ms - self.ambient)), 0.0)
346
+ hm, hb, hf = maynier_hardness(cg, self.composition, rate, nitrogen=ng)
347
+ # the austenite consumes the martensite first, then the bainite, then the matrix
348
+ m_old = state["martensite"][idx]
349
+ b_old = state["bainite"][idx]
350
+ m_left = np.maximum(m_old - fg, 0.0)
351
+ b_left = np.maximum(b_old - np.maximum(fg - m_old, 0.0), 0.0)
352
+ m_new = fg * share * km
353
+ b_new = fg * (1.0 - share)
354
+ retained = fg * share * (1.0 - km)
355
+ m_tot = m_left + m_new
356
+ w_old = np.divide(m_left, m_tot, out=np.zeros_like(m_tot), where=m_tot > 0)
357
+ state["hm0"][idx] = np.where(
358
+ m_tot > 0, w_old * state["hm0"][idx] + (1 - w_old) * hm, state["hm0"][idx]
359
+ )
360
+ state["ptemper"][idx] = w_old * state["ptemper"][idx]
361
+ state["martensite"][idx] = m_tot
362
+ b_tot = b_left + b_new
363
+ wb = np.divide(b_left, b_tot, out=np.zeros_like(b_tot), where=b_tot > 0)
364
+ state["hb"][idx] = np.where(
365
+ b_tot > 0, wb * state["hb"][idx] + (1 - wb) * np.maximum(hb, hf), state["hb"][idx]
366
+ )
367
+ state["bainite"][idx] = b_tot
368
+ state["retained"][idx] = np.where(fg > 0, retained, state["retained"][idx])
369
+ state["excursion"][idx] = False
370
+ state["peak"][idx] = -273.15
371
+ state["t8"][idx] = np.nan
372
+
373
+ def hardness(self, state) -> np.ndarray:
374
+ """Vickers hardness of the points: martensite (tempered), bainite or
375
+ ferrite–pearlite formed on cooling, retained austenite (as the matrix) and the
376
+ initial matrix, by their fractions."""
377
+ fm, fb = state["martensite"], state["bainite"]
378
+ fr = state["retained"]
379
+ hm = self.tempering.factor(state["ptemper"], state["hm0"])
380
+ rest = np.clip(1.0 - fm - fb - fr, 0.0, 1.0)
381
+ return fm * hm + fb * state["hb"] + (rest + fr) * float(self.matrix_hardness)
382
+
383
+ def treated(self, state) -> np.ndarray:
384
+ """Fraction of the points transformed by the tracks (martensite and bainite
385
+ formed, minus the initial martensite)."""
386
+ return np.clip(state["martensite"] + state["bainite"] - self.martensite, 0.0, 1.0)
387
+
388
+
389
+ @dataclass
390
+ class PeakHardening(_Model):
391
+ """Hardness gained as a function of the peak temperature of a cycle (``table``:
392
+ pairs ``(T_peak °C, ΔHV)``, increasing from 0 at its first temperature), on a matrix
393
+ of hardness ``base_hardness``; ``full``: the peak above which a new cycle replaces
394
+ the gain of the previous ones (re-transformed share ``(T_p − onset)/(full −
395
+ onset)``); ``tempering`` of the gain; ``carbon_hardening``: HV gained per wt% of
396
+ carbon and nitrogen dissolved in the melt (carburizing, nitriding)."""
397
+
398
+ table: tuple = ((875.0, 0.0), (1080.0, 50.0), (1300.0, 120.0), (1425.0, 150.0), (1600.0, 150.0))
399
+ base_hardness: float = 160.0
400
+ full: float | None = None
401
+ solidus: float = 1425.0
402
+ composition: dict = field(default_factory=lambda: {"C": 0.026, "Cr": 18.7})
403
+ carbon_hardening: float = 550.0
404
+ tempering: Tempering = field(
405
+ default_factory=lambda: Tempering(start=11000.0, end=19000.0, floor=0.0)
406
+ )
407
+ ambient: float = 20.0
408
+ finish_below: float = 300.0
409
+
410
+ def __post_init__(self):
411
+ tab = np.asarray(self.table, dtype=float).reshape(-1, 2)
412
+ if len(tab) < 2 or np.any(np.diff(tab[:, 0]) <= 0):
413
+ raise ValueError("table: at least two rows of increasing temperatures")
414
+ self.table = tuple(map(tuple, tab))
415
+ self._t, self._dh = tab[:, 0], tab[:, 1]
416
+ self.onset = float(self._t[0])
417
+ self.full = float(self.full if self.full is not None else self._t[np.argmax(self._dh)])
418
+ self.composition = _composition(self.composition)
419
+ self.tempering = Tempering.from_config(self.tempering)
420
+
421
+ def gain(self, peak) -> np.ndarray:
422
+ """Hardness gained by a cycle of peak ``peak`` (°C) from the untreated state."""
423
+ return np.interp(np.asarray(peak, dtype=float), self._t, self._dh, left=0.0)
424
+
425
+ def initial_state(self, n: int) -> dict:
426
+ state = self._base_state(n)
427
+ state.update(
428
+ carbon=np.full(n, self.composition["C"]),
429
+ nitrogen=np.full(n, self.composition["N"]),
430
+ gain=np.zeros(n),
431
+ ptemper=np.zeros(n),
432
+ )
433
+ return state
434
+
435
+ def step(self, state, t_old, t_new, dt) -> None:
436
+ t_old = np.asarray(t_old, dtype=float)
437
+ t_new = np.asarray(t_new, dtype=float)
438
+ warm = (state["gain"] > 0) & (t_new > self.tempering.t_min)
439
+ if warm.any():
440
+ idx = np.flatnonzero(warm)
441
+ state["ptemper"][idx] = _tempering_step(
442
+ state["ptemper"][idx], t_new[idx], dt, self.tempering.constant, self.tempering.t_min
443
+ )
444
+ done = self._track(state, t_old, t_new, dt)
445
+ if done.any():
446
+ self._complete(state, done)
447
+
448
+ def _complete(self, state, done) -> None:
449
+ idx = np.flatnonzero(done)
450
+ peak = state["peak"][idx]
451
+ share = np.clip((peak - self.onset) / max(self.full - self.onset, 1e-9), 0.0, 1.0)
452
+ fresh = self.gain(peak)
453
+ chem = self.carbon_hardening * np.maximum(
454
+ state["carbon"][idx]
455
+ + state["nitrogen"][idx]
456
+ - self.composition["C"]
457
+ - self.composition["N"],
458
+ 0.0,
459
+ )
460
+ old = self.tempering.factor(state["ptemper"][idx], state["gain"][idx])
461
+ new = fresh + chem
462
+ state["gain"][idx] = np.maximum(new, share * new + (1.0 - share) * old)
463
+ state["ptemper"][idx] = 0.0
464
+ state["excursion"][idx] = False
465
+ state["peak"][idx] = -273.15
466
+ state["t8"][idx] = np.nan
467
+
468
+ def hardness(self, state) -> np.ndarray:
469
+ return self.base_hardness + self.tempering.factor(state["ptemper"], state["gain"])
470
+
471
+ def treated(self, state) -> np.ndarray:
472
+ """Share of the full gain of the table that the points keep."""
473
+ return np.clip(
474
+ (self.hardness(state) - self.base_hardness) / max(self._dh.max(), 1e-9), 0, 1
475
+ )
476
+
477
+
478
+ @dataclass
479
+ class PeakSoftening(PeakHardening):
480
+ """Hardness lost as a function of the peak temperature of a cycle — the dissolution
481
+ of the hardening precipitates of an age-hardened aluminium alloy (Myhr & Grong 1991;
482
+ Shercliff & Ashby): ``table`` pairs ``(T_peak °C, ΔHV ≤ 0)``, 0 at its first
483
+ temperature, the hardness of the treated points after their natural ageing; a cycle
484
+ keeps the larger of its loss and that of the previous cycles (the precipitates do
485
+ not form again)."""
486
+
487
+ table: tuple = (
488
+ (200.0, 0.0),
489
+ (250.0, -8.0),
490
+ (300.0, -25.0),
491
+ (350.0, -42.0),
492
+ (400.0, -50.0),
493
+ (450.0, -45.0),
494
+ (520.0, -38.0),
495
+ (600.0, -38.0),
496
+ )
497
+ base_hardness: float = 105.0
498
+ solidus: float = 585.0
499
+ composition: dict = field(default_factory=lambda: {"C": 0.0})
500
+ carbon_hardening: float = 0.0
501
+ tempering: Tempering = field(
502
+ default_factory=lambda: Tempering(start=1e9, end=2e9, floor=1.0, minimum=0.0)
503
+ )
504
+
505
+ def _complete(self, state, done) -> None:
506
+ idx = np.flatnonzero(done)
507
+ fresh = self.gain(state["peak"][idx])
508
+ state["gain"][idx] = np.minimum(state["gain"][idx], fresh)
509
+ state["ptemper"][idx] = 0.0
510
+ state["excursion"][idx] = False
511
+ state["peak"][idx] = -273.15
512
+
513
+ def treated(self, state) -> np.ndarray:
514
+ """Share of the largest loss of the table that the points have."""
515
+ loss = max(-float(np.min(self._dh)), 1e-9)
516
+ return np.clip((self.base_hardness - self.hardness(state)) / loss, 0.0, 1.0)
517
+
518
+
519
+ MODELS = {
520
+ "transformation": TransformationHardening,
521
+ "peak": PeakHardening,
522
+ "softening": PeakSoftening,
523
+ }
524
+
525
+
526
+ def model_from_config(data):
527
+ """A metallurgical model from a mapping with a ``kind`` (``transformation``,
528
+ ``peak`` or ``softening``) and the parameters of its class."""
529
+ if isinstance(data, (TransformationHardening, PeakHardening)):
530
+ return data
531
+ data = dict(data)
532
+ kind = data.pop("kind", "transformation")
533
+ if kind not in MODELS:
534
+ raise ValueError(f"metallurgy kind: one of {tuple(MODELS)}")
535
+ if "tempering" in data:
536
+ data["tempering"] = Tempering.from_config(data["tempering"])
537
+ if "table" in data:
538
+ data["table"] = tuple(tuple(row) for row in data["table"])
539
+ return MODELS[kind](**data)
540
+
541
+
542
+ # -- composition changes in the melt pool --------------------------------------------------
543
+
544
+ TREATMENTS = ("hardening", "carburizing", "nitriding", "alloying")
545
+
546
+
547
+ @dataclass
548
+ class Alloying:
549
+ """A thermochemical treatment in the melt pool of each track: ``carburizing`` (a
550
+ graphite coating of ``coating`` g/m² on the treated faces), ``alloying`` (a coating
551
+ of composition ``elements``, wt%), ``nitriding`` (nitrogen at the partial
552
+ pressure ``pressure`` atm); ``efficiency``: the share of the coating (or of
553
+ Sieverts's solubility) that the melt takes up, the rest burnt or evaporated."""
554
+
555
+ kind: str = "carburizing"
556
+ coating: float = 20.0
557
+ elements: dict = field(default_factory=lambda: {"C": 100.0})
558
+ efficiency: float = 0.5
559
+ pressure: float = 1.0
560
+ faces: str = "both"
561
+
562
+ def __post_init__(self):
563
+ if self.kind not in TREATMENTS[1:]:
564
+ raise ValueError(f"alloying kind: one of {TREATMENTS[1:]}")
565
+ if self.kind == "carburizing":
566
+ self.elements = {"C": 100.0}
567
+ if self.faces not in ("top", "bottom", "both"):
568
+ raise ValueError("faces: top, bottom or both")
569
+ if not 0 <= self.efficiency <= 1:
570
+ raise ValueError("efficiency in [0, 1]")
571
+ for k in self.elements:
572
+ if k not in ELEMENTS:
573
+ raise ValueError(f"elements: one of {ELEMENTS}")
574
+
575
+ @classmethod
576
+ def from_config(cls, data):
577
+ if data is None or isinstance(data, Alloying):
578
+ return data
579
+ return cls(**dict(data))
580
+
581
+ def mix(
582
+ self,
583
+ state,
584
+ melted,
585
+ weights,
586
+ surface,
587
+ *,
588
+ density: float,
589
+ melt_temperature: float,
590
+ chromium: float = 0.0,
591
+ ) -> dict:
592
+ """Mix the melt of one track: ``melted`` (mask of the points), ``weights`` (their
593
+ volumes, mm³), ``surface``: per face, the areas (mm²) of the points of that face
594
+ whose coating the track melts (the coating is then gone: the caller clears it).
595
+ Updates the carbon and nitrogen of the state; returns the amounts added."""
596
+ out = {}
597
+ if not melted.any():
598
+ return out
599
+ vol = weights[melted]
600
+ mass = density * 1e-9 * vol.sum() * 1e3 # g (density kg/m3 -> g/mm3)
601
+ for key, el in (("carbon", "C"), ("nitrogen", "N")):
602
+ if key not in state:
603
+ continue
604
+ mean = float(np.average(state[key][melted], weights=vol))
605
+ added = 0.0
606
+ if self.kind in ("carburizing", "alloying") and el in self.elements:
607
+ area = sum(surface.values())
608
+ added = self.efficiency * self.coating * 1e-6 * area * self.elements[el] / 100.0
609
+ new = 100.0 * (mean * mass / 100.0 + added) / (mass + added) if mass > 0 else mean
610
+ if self.kind == "nitriding" and el == "N":
611
+ sol = sieverts_nitrogen(melt_temperature, chromium, self.pressure)
612
+ new = max(mean, self.efficiency * sol)
613
+ state[key][melted] = new
614
+ out[el] = new
615
+ return out