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.
- morphogen/__init__.py +60 -0
- morphogen/__main__.py +7 -0
- morphogen/_platform.py +55 -0
- morphogen/_public.py +153 -0
- morphogen/_utils.py +80 -0
- morphogen/_version.py +1 -0
- morphogen/analysis/__init__.py +174 -0
- morphogen/analysis/anisotropy.py +135 -0
- morphogen/analysis/basic.py +38 -0
- morphogen/analysis/cells.py +54 -0
- morphogen/analysis/connectivity.py +156 -0
- morphogen/analysis/correlation.py +195 -0
- morphogen/analysis/covariance.py +80 -0
- morphogen/analysis/fractal.py +54 -0
- morphogen/analysis/measures.py +188 -0
- morphogen/analysis/morphology.py +265 -0
- morphogen/analysis/particles.py +160 -0
- morphogen/analysis/percolation.py +2034 -0
- morphogen/analysis/power_laws.py +143 -0
- morphogen/analysis/random_sets.py +351 -0
- morphogen/analysis/stereology.py +289 -0
- morphogen/analysis/surface.py +107 -0
- morphogen/analysis/topology.py +92 -0
- morphogen/automata/__init__.py +74 -0
- morphogen/automata/engine.py +211 -0
- morphogen/automata/growth.py +686 -0
- morphogen/automata/lattice.py +143 -0
- morphogen/automata/reaction.py +255 -0
- morphogen/automata/rules.py +353 -0
- morphogen/automata/tilings.py +1715 -0
- morphogen/cli.py +3526 -0
- morphogen/config.py +2167 -0
- morphogen/contact/__init__.py +113 -0
- morphogen/contact/experiments.py +368 -0
- morphogen/contact/hertz.py +104 -0
- morphogen/contact/kernels.py +827 -0
- morphogen/contact/periodic.py +278 -0
- morphogen/contact/problem.py +578 -0
- morphogen/contact/surfaces.py +310 -0
- morphogen/coupling/__init__.py +43 -0
- morphogen/coupling/ageing.py +143 -0
- morphogen/coupling/diffusion.py +226 -0
- morphogen/coupling/fenicsx.py +484 -0
- morphogen/coupling/oxidation.py +447 -0
- morphogen/coupling/plates.py +247 -0
- morphogen/design/__init__.py +51 -0
- morphogen/design/csp.py +616 -0
- morphogen/design/frames.py +277 -0
- morphogen/design/search.py +287 -0
- morphogen/design/tiles.py +336 -0
- morphogen/distributions.py +312 -0
- morphogen/domain.py +203 -0
- morphogen/dynamics/__init__.py +179 -0
- morphogen/dynamics/model.py +638 -0
- morphogen/dynamics/openradioss.py +643 -0
- morphogen/dynamics/results.py +515 -0
- morphogen/fracture/__init__.py +170 -0
- morphogen/fracture/bulk.py +349 -0
- morphogen/fracture/cohesive.py +1614 -0
- morphogen/fracture/ductile.py +557 -0
- morphogen/fracture/lefm.py +1168 -0
- morphogen/fracture/mixed.py +1178 -0
- morphogen/fracture/periodic.py +733 -0
- morphogen/fracture/phasefield.py +714 -0
- morphogen/fracture/phasefield_finite.py +368 -0
- morphogen/fracture/surface.py +572 -0
- morphogen/fracture/toughness.py +566 -0
- morphogen/gpu.py +108 -0
- morphogen/gui/__init__.py +8 -0
- morphogen/gui/api.py +1927 -0
- morphogen/gui/desktop.py +387 -0
- morphogen/gui/icon.png +0 -0
- morphogen/gui/index.html +1909 -0
- morphogen/gui/server.py +229 -0
- morphogen/gui/tools/__init__.py +629 -0
- morphogen/gui/tools/compare.py +149 -0
- morphogen/gui/tools/contact.py +391 -0
- morphogen/gui/tools/couplings.py +1085 -0
- morphogen/gui/tools/crackfront.py +245 -0
- morphogen/gui/tools/design.py +224 -0
- morphogen/gui/tools/dynamics.py +824 -0
- morphogen/gui/tools/fracture.py +2586 -0
- morphogen/gui/tools/interop.py +1654 -0
- morphogen/gui/tools/learning.py +595 -0
- morphogen/gui/tools/mechanics.py +3881 -0
- morphogen/gui/tools/nonlocal_damage.py +1321 -0
- morphogen/gui/tools/phasefield.py +215 -0
- morphogen/gui/tools/physics.py +597 -0
- morphogen/gui/tools/stability.py +1756 -0
- morphogen/gui/tools/statistics.py +1408 -0
- morphogen/gui/viewer.js +1100 -0
- morphogen/homogenization/__init__.py +210 -0
- morphogen/homogenization/acoustics.py +566 -0
- morphogen/homogenization/amg.py +1005 -0
- morphogen/homogenization/apparent.py +1046 -0
- morphogen/homogenization/behaviours.cu +2285 -0
- morphogen/homogenization/behaviours.py +944 -0
- morphogen/homogenization/beremin.py +263 -0
- morphogen/homogenization/bifurcation.py +1085 -0
- morphogen/homogenization/bloch.py +507 -0
- morphogen/homogenization/bounds.py +226 -0
- morphogen/homogenization/core.py +458 -0
- morphogen/homogenization/coupled.py +1135 -0
- morphogen/homogenization/crystal.py +2967 -0
- morphogen/homogenization/dilatation.py +454 -0
- morphogen/homogenization/elements.py +157 -0
- morphogen/homogenization/fatigue.py +768 -0
- morphogen/homogenization/fe.py +1739 -0
- morphogen/homogenization/fenicsx.py +307 -0
- morphogen/homogenization/fft.py +499 -0
- morphogen/homogenization/fft_nonlinear.py +391 -0
- morphogen/homogenization/finite.py +613 -0
- morphogen/homogenization/flow.py +361 -0
- morphogen/homogenization/frames.py +1125 -0
- morphogen/homogenization/gpu.py +1241 -0
- morphogen/homogenization/harmonic.py +427 -0
- morphogen/homogenization/identification.py +579 -0
- morphogen/homogenization/kernels.py +760 -0
- morphogen/homogenization/laws.py +2061 -0
- morphogen/homogenization/materials.py +1080 -0
- morphogen/homogenization/mfront.py +589 -0
- morphogen/homogenization/networks.py +880 -0
- morphogen/homogenization/nonlinear.py +2612 -0
- morphogen/homogenization/ntfa.py +577 -0
- morphogen/homogenization/paths.py +476 -0
- morphogen/homogenization/photonic.py +467 -0
- morphogen/homogenization/poroelastic.py +212 -0
- morphogen/homogenization/porous.py +1120 -0
- morphogen/homogenization/postprocess.py +290 -0
- morphogen/homogenization/solvers.py +1140 -0
- morphogen/homogenization/tensors.py +240 -0
- morphogen/homogenization/voxel_fe.py +457 -0
- morphogen/homogenization/xfem.py +1016 -0
- morphogen/homogenization/zmat.py +1258 -0
- morphogen/iga/__init__.py +48 -0
- morphogen/iga/analysis.py +508 -0
- morphogen/iga/basis.py +214 -0
- morphogen/iga/geometry.py +501 -0
- morphogen/iga/homogenization.py +219 -0
- morphogen/iga/optimization.py +700 -0
- morphogen/iga/shapes.py +331 -0
- morphogen/image.py +128 -0
- morphogen/io/__init__.py +246 -0
- morphogen/io/amitex.py +741 -0
- morphogen/io/ebsd.py +881 -0
- morphogen/io/export.py +196 -0
- morphogen/io/geometry.py +158 -0
- morphogen/io/medit.py +147 -0
- morphogen/io/meshes.py +844 -0
- morphogen/io/metaimage.py +97 -0
- morphogen/io/mfront.py +1104 -0
- morphogen/io/native.py +57 -0
- morphogen/io/radioss.py +764 -0
- morphogen/io/solvers.py +371 -0
- morphogen/io/tables.py +278 -0
- morphogen/io/tiff.py +66 -0
- morphogen/io/vtk.py +701 -0
- morphogen/io/xdmf.py +200 -0
- morphogen/kernels/__init__.py +5 -0
- morphogen/kernels/annealing.py +192 -0
- morphogen/kernels/cells.py +69 -0
- morphogen/kernels/collective.py +87 -0
- morphogen/kernels/force_biased.py +595 -0
- morphogen/kernels/implicit.py +145 -0
- morphogen/kernels/leaves.py +132 -0
- morphogen/kernels/packing.py +304 -0
- morphogen/kernels/raster.py +279 -0
- morphogen/kernels/rsa.py +371 -0
- morphogen/kernels/union.py +135 -0
- morphogen/kernels/watershed.py +190 -0
- morphogen/laser/__init__.py +234 -0
- morphogen/laser/architectures.py +375 -0
- morphogen/laser/bending.py +216 -0
- morphogen/laser/cells.py +1694 -0
- morphogen/laser/design.py +940 -0
- morphogen/laser/figures.py +227 -0
- morphogen/laser/heat.py +804 -0
- morphogen/laser/materials.py +691 -0
- morphogen/laser/mechanics.py +1670 -0
- morphogen/laser/metallurgy.py +615 -0
- morphogen/laser/patterns.py +828 -0
- morphogen/laser/periodic.py +392 -0
- morphogen/laser/process.py +362 -0
- morphogen/laser/run.py +534 -0
- morphogen/laser/solid.py +216 -0
- morphogen/laser/specimen.py +200 -0
- morphogen/laser/structures.py +708 -0
- morphogen/learning/__init__.py +81 -0
- morphogen/learning/behaviour.py +398 -0
- morphogen/learning/data.py +328 -0
- morphogen/learning/learned.cpp +668 -0
- morphogen/learning/logarithmic.py +202 -0
- morphogen/learning/mfront.py +409 -0
- morphogen/learning/networks.py +767 -0
- morphogen/learning/run.py +212 -0
- morphogen/learning/standard.py +814 -0
- morphogen/learning/training.py +235 -0
- morphogen/mesh/__init__.py +29 -0
- morphogen/mesh/conforming.py +1423 -0
- morphogen/mesh/curved.py +600 -0
- morphogen/mesh/exact.py +1717 -0
- morphogen/mesh/octree.py +350 -0
- morphogen/mesh/polycrystal.py +1041 -0
- morphogen/mesh/polyhedra.py +677 -0
- morphogen/mesh/regularize.py +570 -0
- morphogen/mesh/surface.py +97 -0
- morphogen/mesh/tetra.py +512 -0
- morphogen/mesh/voxel.py +124 -0
- morphogen/micromorphic/__init__.py +31 -0
- morphogen/micromorphic/damage.py +359 -0
- morphogen/micromorphic/ductile.py +534 -0
- morphogen/micromorphic/finite.py +220 -0
- morphogen/micromorphic/microfoam.py +787 -0
- morphogen/micromorphic/space.py +341 -0
- morphogen/models/__init__.py +195 -0
- morphogen/models/affine.py +384 -0
- morphogen/models/automata.py +592 -0
- morphogen/models/base.py +500 -0
- morphogen/models/boolean.py +310 -0
- morphogen/models/bouligand.py +331 -0
- morphogen/models/branching.py +241 -0
- morphogen/models/combination.py +430 -0
- morphogen/models/deadleaves.py +766 -0
- morphogen/models/design.py +289 -0
- morphogen/models/ebsd.py +206 -0
- morphogen/models/fibers.py +1476 -0
- morphogen/models/foam.py +594 -0
- morphogen/models/gaussian.py +314 -0
- morphogen/models/growth.py +459 -0
- morphogen/models/hardcore.py +317 -0
- morphogen/models/hierarchical.py +269 -0
- morphogen/models/honeycomb.py +749 -0
- morphogen/models/implicit.py +177 -0
- morphogen/models/laminate.py +470 -0
- morphogen/models/lattice.py +351 -0
- morphogen/models/lattice_field.py +345 -0
- morphogen/models/levelset_foam.py +563 -0
- morphogen/models/nacre.py +411 -0
- morphogen/models/nested.py +924 -0
- morphogen/models/osteons.py +374 -0
- morphogen/models/pieces.py +167 -0
- morphogen/models/planar.py +126 -0
- morphogen/models/reconstruction.py +203 -0
- morphogen/models/scale_rich.py +1409 -0
- morphogen/models/scale_rich_3d.py +1616 -0
- morphogen/models/tessellation.py +735 -0
- morphogen/models/tiling_field.py +302 -0
- morphogen/models/tpms.py +197 -0
- morphogen/models/transparent.py +406 -0
- morphogen/models/union.py +141 -0
- morphogen/optimization/__init__.py +43 -0
- morphogen/optimization/cell.py +295 -0
- morphogen/optimization/filters.py +115 -0
- morphogen/optimization/mma.py +226 -0
- morphogen/optimization/run.py +219 -0
- morphogen/optimization/topology.py +632 -0
- morphogen/orientations.py +568 -0
- morphogen/parallel.py +599 -0
- morphogen/pipeline.py +978 -0
- morphogen/primitives.py +188 -0
- morphogen/results.py +564 -0
- morphogen/rve/__init__.py +73 -0
- morphogen/rve/report.py +627 -0
- morphogen/rve/scaling.py +363 -0
- morphogen/rve/study.py +1054 -0
- morphogen/rve/windows.py +345 -0
- morphogen/seeding.py +51 -0
- morphogen/settings.py +118 -0
- morphogen/stopping.py +48 -0
- morphogen/symmetry.py +384 -0
- morphogen/templates/activator_inhibitor.yaml +22 -0
- morphogen/templates/aggregation.yaml +23 -0
- morphogen/templates/boolean_cylinders.yaml +20 -0
- morphogen/templates/boolean_spheres.yaml +22 -0
- morphogen/templates/bouligand.yaml +28 -0
- morphogen/templates/cellular_automaton.yaml +25 -0
- morphogen/templates/coated_spheres.yaml +26 -0
- morphogen/templates/contact_fibers.yaml +27 -0
- morphogen/templates/cox_nanocomposite.yaml +22 -0
- morphogen/templates/cross_linked_fibers.yaml +26 -0
- morphogen/templates/curved_arcs.yaml +28 -0
- morphogen/templates/curved_fibers.yaml +24 -0
- morphogen/templates/dead_leaves.yaml +22 -0
- morphogen/templates/delaunay_network.yaml +22 -0
- morphogen/templates/dense_packing.yaml +22 -0
- morphogen/templates/diffusion.yaml +33 -0
- morphogen/templates/ebsd.yaml +34 -0
- morphogen/templates/ebsd_map.ctf +3087 -0
- morphogen/templates/fracture_composite.yaml +42 -0
- morphogen/templates/fracture_rubber.yaml +47 -0
- morphogen/templates/gaussian_excursion.yaml +17 -0
- morphogen/templates/graded_lattice.yaml +24 -0
- morphogen/templates/hardcore_fibers.yaml +22 -0
- morphogen/templates/hardcore_spheres.yaml +22 -0
- morphogen/templates/hierarchical_lattice.yaml +22 -0
- morphogen/templates/homogenization_acoustic_foam.yaml +36 -0
- morphogen/templates/homogenization_beremin.yaml +50 -0
- morphogen/templates/homogenization_cleavage.yaml +51 -0
- morphogen/templates/homogenization_cleavage_band.yaml +55 -0
- morphogen/templates/homogenization_contact.yaml +43 -0
- morphogen/templates/homogenization_crack_closure.yaml +49 -0
- morphogen/templates/homogenization_crystal_plasticity.yaml +50 -0
- morphogen/templates/homogenization_crystal_plasticity_fft.yaml +52 -0
- morphogen/templates/homogenization_crystallization.yaml +30 -0
- morphogen/templates/homogenization_debonding.yaml +43 -0
- morphogen/templates/homogenization_detwinning.yaml +58 -0
- morphogen/templates/homogenization_ductile_damage.yaml +47 -0
- morphogen/templates/homogenization_fatigue.yaml +40 -0
- morphogen/templates/homogenization_grain_fracture.yaml +56 -0
- morphogen/templates/homogenization_gyroid.yaml +30 -0
- morphogen/templates/homogenization_intergranular.yaml +43 -0
- morphogen/templates/homogenization_interphase.yaml +42 -0
- morphogen/templates/homogenization_mixed_loading.yaml +33 -0
- morphogen/templates/homogenization_ntfa.yaml +56 -0
- morphogen/templates/homogenization_piezoelectric.yaml +27 -0
- morphogen/templates/homogenization_polycrystal.yaml +30 -0
- morphogen/templates/homogenization_polycrystal_inclusions.yaml +30 -0
- morphogen/templates/homogenization_poroelastic.yaml +26 -0
- morphogen/templates/homogenization_rubber.yaml +40 -0
- morphogen/templates/homogenization_slip_cleavage.yaml +50 -0
- morphogen/templates/homogenization_spheres.yaml +31 -0
- morphogen/templates/homogenization_transport.yaml +29 -0
- morphogen/templates/homogenization_twinning.yaml +54 -0
- morphogen/templates/homogenization_viscoelastic.yaml +34 -0
- morphogen/templates/homogenization_viscoplastic.yaml +42 -0
- morphogen/templates/homogenization_voronoi.yaml +26 -0
- morphogen/templates/homogenization_xfem.yaml +23 -0
- morphogen/templates/hyperuniform_cells.yaml +24 -0
- morphogen/templates/laguerre.yaml +18 -0
- morphogen/templates/laser_bending.yaml +35 -0
- morphogen/templates/laser_cells.yaml +38 -0
- morphogen/templates/laser_corrugated.yaml +36 -0
- morphogen/templates/level_set_foam.yaml +29 -0
- morphogen/templates/menger_sponge.yaml +17 -0
- morphogen/templates/nacre.yaml +25 -0
- morphogen/templates/nucleation_growth.yaml +25 -0
- morphogen/templates/optimize_auxetic.yaml +29 -0
- morphogen/templates/optimize_auxetic_3d.yaml +27 -0
- morphogen/templates/optimize_bulk.yaml +23 -0
- morphogen/templates/optimize_conductivity.yaml +20 -0
- morphogen/templates/osteons.yaml +28 -0
- morphogen/templates/penetrable_spheres.yaml +21 -0
- morphogen/templates/poisson_fibers.yaml +21 -0
- morphogen/templates/random_laminate.yaml +26 -0
- morphogen/templates/random_lattice.yaml +27 -0
- morphogen/templates/random_walk_fibers.yaml +26 -0
- morphogen/templates/reaction_diffusion.yaml +22 -0
- morphogen/templates/reconstruction.yaml +22 -0
- morphogen/templates/rve_cellular_automaton.yaml +23 -0
- morphogen/templates/rve_crystal_plasticity_fft.yaml +51 -0
- morphogen/templates/rve_multiphysics.yaml +43 -0
- morphogen/templates/rve_poisson_fibers.yaml +22 -0
- morphogen/templates/rve_poisson_fibers_fe.yaml +33 -0
- morphogen/templates/rve_voronoi_windows.yaml +20 -0
- morphogen/templates/scale_rich_network.yaml +29 -0
- morphogen/templates/scale_rich_plates.yaml +30 -0
- morphogen/templates/sequential_dead_leaves.yaml +25 -0
- morphogen/templates/strut_lattice.yaml +21 -0
- morphogen/templates/tile_assembly.yaml +28 -0
- morphogen/templates/tpms.yaml +19 -0
- morphogen/templates/trabecular_bone.yaml +29 -0
- morphogen/templates/transparent_dead_leaves.yaml +23 -0
- morphogen/templates/vascular_tree.yaml +23 -0
- morphogen/templates/voronoi.yaml +20 -0
- morphogen/templates/wood.yaml +34 -0
- morphogen/templates/workflow.yaml +56 -0
- morphogen/texture.py +665 -0
- morphogen/theory.py +162 -0
- morphogen/viz/__init__.py +12 -0
- morphogen/viz/export.py +244 -0
- morphogen/viz/figures.py +707 -0
- morphogen/viz/png.py +148 -0
- morphogen/viz/sections.py +696 -0
- morphogen/viz/surfaces.py +1352 -0
- morphogen/viz/video.py +904 -0
- morphogen/viz/workflow.py +488 -0
- morphogen-1.0.0.dist-info/METADATA +2316 -0
- morphogen-1.0.0.dist-info/RECORD +381 -0
- morphogen-1.0.0.dist-info/WHEEL +4 -0
- morphogen-1.0.0.dist-info/entry_points.txt +5 -0
- 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
|