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