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
morphogen/laser/run.py ADDED
@@ -0,0 +1,534 @@
1
+ """Configuration files of laser-architectured sheets (``morphogen laser``).
2
+
3
+ Example (the reference case of Wang 2022, thesis ch. 5, and its optimization)::
4
+
5
+ laser_sheet:
6
+ material: annealed_ms1500 # aisi430, dp1180, or a mapping (preset + changes)
7
+ treatment: hardening # carburizing, nitriding, alloying
8
+ configuration: symmetric # single: the upper face only
9
+ layers: 4 # through the thickness
10
+ laser:
11
+ beam: {power: 150, speed: 10, radius: 0.5, absorptivity: 0.55}
12
+ bottom: {power: 100, speed: 10, radius: 0.6, absorptivity: 0.55, profile: tophat}
13
+ pause: 30 # s between tracks
14
+ specimen: {kind: dogbone, length: 30, width: 5, thickness: 1.0}
15
+ element: 0.5 # mm
16
+ pattern: {kind: corrugated, count: 1, amplitude: 1.0, period: 15}
17
+ loading: {kind: tension} # or {kind: bending, span: 30, deflection: 1.0}
18
+ directions: [0, 45, 90] # optional: a specimen per direction (anisotropy)
19
+ compare: # reference patterns, evaluated too
20
+ base: {kind: none}
21
+ straight: {kind: straight, count: 1}
22
+ optimization: # optional
23
+ method: bayesian # grid, nelder_mead, differential_evolution, genetic
24
+ evaluations: 30
25
+ objective: strength_ductility # energy, uniform_elongation, tensile_strength...
26
+ parameters: {pattern.amplitude: [0.0, 2.5], pattern.period: [6.0, 30.0]}
27
+ constraints: {yield_strength: [400, null]}
28
+ check_element: 0.25 # the best design again on a finer mesh
29
+ cellular: # optional: a cellular design (laser.cells)
30
+ phases: wang # ferrite and martensite of Wang et al. 2023
31
+ size: 0.5 # mm, the cells
32
+ objective: ductility # energy, tensile_strength, strength_ductility
33
+ constraints: {tensile_strength: [700, null]}
34
+ start: {amplitude: 1.5, period: 10} # a track drawn by a spot of min_width cells
35
+ method: exchange # swap (BESO), hca, topology
36
+ symmetry: [point]
37
+ period: 10 # mm: the cells change by periods
38
+ min_width: 2 # cells: the spot
39
+ iterations: 40
40
+ realize: true # its tracks treated by the process above
41
+ seed: 1
42
+ outputs:
43
+ directory: out/laser
44
+ figures: true # PNG figures (matplotlib)
45
+ fields: [vti] # hardness and peak temperature maps
46
+ gcode: true # the laser path of the best design
47
+
48
+ Results: ``laser.json`` (the settings, the measures of each design: the pattern, the
49
+ references, the optimum and its check), ``curves.csv`` (the engineering curves),
50
+ ``history.csv`` (the evaluations of the optimization), ``path.gcode`` and
51
+ ``path.csv`` (the tracks), ``fields.vti`` (hardness, treated share and peak temperature
52
+ of the sheet, a pixel per 0.05 mm, a layer per slice) and the figures; with a cellular
53
+ design, ``cells.csv`` (its history), ``cells_design.csv`` (the phase of each cell, a
54
+ row per row of cells), ``cells_path.gcode`` (its tracks) and ``cells.png``; the measures
55
+ of its tracks treated by the process are the design ``cellular`` of ``laser.json``.
56
+ """
57
+
58
+ from __future__ import annotations
59
+
60
+ import json
61
+ import time
62
+ from dataclasses import dataclass, field
63
+ from pathlib import Path
64
+
65
+ import numpy as np
66
+
67
+ from morphogen._utils import to_jsonable
68
+ from morphogen.config import ConfigError, _check_keys, read_config_file
69
+ from morphogen.laser.design import METHODS, OBJECTIVES, SheetCase, optimize
70
+ from morphogen.laser.heat import Beam
71
+ from morphogen.laser.materials import SheetMaterial
72
+ from morphogen.laser.specimen import Specimen
73
+
74
+ SECTION = {
75
+ "directions",
76
+ "material",
77
+ "treatment",
78
+ "alloying",
79
+ "configuration",
80
+ "layers",
81
+ "laser",
82
+ "specimen",
83
+ "element",
84
+ "pattern",
85
+ "compare",
86
+ "loading",
87
+ "ambient",
88
+ }
89
+ OPTIMIZATION = {
90
+ "method",
91
+ "evaluations",
92
+ "objective",
93
+ "parameters",
94
+ "constraints",
95
+ "target",
96
+ "initial",
97
+ "levels",
98
+ "penalty",
99
+ "check_element",
100
+ "options",
101
+ }
102
+ OUTPUTS = {"directory", "figures", "fields", "gcode", "resolution"}
103
+ CELLULAR = {
104
+ "case",
105
+ "phases",
106
+ "critical",
107
+ "size",
108
+ "element",
109
+ "objective",
110
+ "constraints",
111
+ "start",
112
+ "method",
113
+ "budget",
114
+ "symmetry",
115
+ "period",
116
+ "min_width",
117
+ "candidates",
118
+ "iterations",
119
+ "patience",
120
+ "realize",
121
+ "fracture_radius",
122
+ }
123
+ CELL_METHODS = ("exchange", "swap", "hca", "topology")
124
+
125
+
126
+ @dataclass
127
+ class LaserConfig:
128
+ """A validated configuration: the case, the references, the optimization."""
129
+
130
+ case: SheetCase
131
+ compare: dict
132
+ optimization: dict | None
133
+ seed: int
134
+ cellular: dict | None
135
+ directory: Path
136
+ figures: bool
137
+ fields: list
138
+ gcode: bool
139
+ resolution: float
140
+ source: dict = field(default_factory=dict)
141
+
142
+
143
+ def load_laser_config(source, *, base_dir=None) -> LaserConfig:
144
+ """Validate a configuration (file path or mapping)."""
145
+ if isinstance(source, (str, Path)):
146
+ path = Path(source)
147
+ data = read_config_file(path)
148
+ base = path.parent if base_dir is None else Path(base_dir)
149
+ else:
150
+ data = dict(source)
151
+ base = Path.cwd() if base_dir is None else Path(base_dir)
152
+ _check_keys(
153
+ "configuration",
154
+ data,
155
+ {"laser_sheet", "optimization", "cellular", "seed", "outputs", "version", "threads"},
156
+ {"laser_sheet"},
157
+ )
158
+ sec = dict(data["laser_sheet"] or {})
159
+ _check_keys("laser_sheet", sec, SECTION)
160
+ try:
161
+ case = case_from_config(sec)
162
+ except (TypeError, ValueError) as exc:
163
+ raise ConfigError(f"laser_sheet: {exc}") from None
164
+ compare = dict(sec.get("compare") or {})
165
+ for name, pat in compare.items():
166
+ if not isinstance(pat, dict) or "kind" not in pat:
167
+ raise ConfigError(f"laser_sheet.compare.{name}: a pattern with a kind")
168
+ opt = data.get("optimization")
169
+ if opt is not None:
170
+ opt = dict(opt)
171
+ _check_keys("optimization", opt, OPTIMIZATION, {"parameters"})
172
+ if opt.get("method", "bayesian") not in METHODS:
173
+ raise ConfigError(f"optimization.method: one of {METHODS}")
174
+ if opt.get("objective", "strength_ductility") not in OBJECTIVES:
175
+ raise ConfigError(f"optimization.objective: one of {OBJECTIVES}")
176
+ if not isinstance(opt["parameters"], dict) or not opt["parameters"]:
177
+ raise ConfigError("optimization.parameters: a mapping of names to [low, high]")
178
+ cel = data.get("cellular")
179
+ if cel is not None:
180
+ cel = dict(cel or {})
181
+ _check_keys("cellular", cel, CELLULAR)
182
+ if cel.get("method", "exchange") not in CELL_METHODS:
183
+ raise ConfigError(f"cellular.method: one of {CELL_METHODS}")
184
+ try:
185
+ cellular_problem(cel, case)
186
+ except (TypeError, ValueError) as exc:
187
+ raise ConfigError(f"cellular: {exc}") from None
188
+ seed = data.get("seed", 0)
189
+ if isinstance(seed, bool) or not isinstance(seed, int) or seed < 0:
190
+ raise ConfigError(f"seed: a non-negative integer, got {seed!r}")
191
+ out = dict(data.get("outputs") or {})
192
+ _check_keys("outputs", out, OUTPUTS)
193
+ directory = Path(out.get("directory", "morphogen_laser"))
194
+ if not directory.is_absolute():
195
+ directory = base / directory
196
+ fields_ = out.get("fields", ["vti"]) or []
197
+ fields_ = [fields_] if isinstance(fields_, str) else list(fields_)
198
+ for f in fields_:
199
+ if f not in ("vti", "vtk", "npz"):
200
+ raise ConfigError(f"outputs.fields: vti, vtk or npz, got {f!r}")
201
+ return LaserConfig(
202
+ case=case,
203
+ compare=compare,
204
+ optimization=opt,
205
+ seed=seed,
206
+ cellular=cel,
207
+ directory=directory,
208
+ figures=bool(out.get("figures", True)),
209
+ fields=fields_,
210
+ gcode=bool(out.get("gcode", True)),
211
+ resolution=float(out.get("resolution", 0.05)),
212
+ source=data,
213
+ )
214
+
215
+
216
+ def case_from_config(sec: dict) -> SheetCase:
217
+ """A :class:`SheetCase` of a ``laser_sheet`` section."""
218
+ laser = dict(sec.get("laser") or {})
219
+ _check_keys("laser_sheet.laser", laser, {"beam", "bottom", "pause"})
220
+ material = SheetMaterial.from_config(sec.get("material", "annealed_ms1500"))
221
+ configuration = sec.get("configuration", "symmetric")
222
+ beam_cfg = dict(laser.get("beam") or {"power": 150.0, "speed": 10.0, "radius": 0.5})
223
+ beam_cfg.setdefault("absorptivity", material.absorptivity)
224
+ beam = Beam.from_config(beam_cfg)
225
+ bottom = None
226
+ if configuration != "single" and laser.get("bottom") is not None:
227
+ bcfg = dict(laser["bottom"])
228
+ bcfg.setdefault("absorptivity", material.absorptivity)
229
+ bcfg.setdefault("speed", beam.speed)
230
+ bottom = Beam.from_config(bcfg)
231
+ spec = dict(sec.get("specimen") or {})
232
+ spec.setdefault("thickness", material.thickness)
233
+ return SheetCase(
234
+ material=material,
235
+ specimen=Specimen.from_config(spec),
236
+ beam=beam,
237
+ bottom=bottom,
238
+ configuration=configuration,
239
+ treatment=sec.get("treatment", "hardening"),
240
+ alloying=sec.get("alloying"),
241
+ layers=int(sec.get("layers", 4)),
242
+ pattern=dict(sec.get("pattern") or {"kind": "straight", "count": 1}),
243
+ pause=float(laser.get("pause", 30.0)),
244
+ element=float(sec.get("element", 0.5)),
245
+ loading=dict(sec.get("loading") or {}),
246
+ ambient=float(sec.get("ambient", 20.0)),
247
+ directions=sec.get("directions"),
248
+ )
249
+
250
+
251
+ def cellular_problem(cel: dict, case: SheetCase):
252
+ """The :class:`~morphogen.laser.cells.CellProblem` of a ``cellular`` section on the
253
+ specimen of the case."""
254
+ from morphogen.laser.cells import CellProblem, Phase, wang_phases
255
+
256
+ phases = cel.get("phases", "wang")
257
+ if phases == "wang":
258
+ phases = wang_phases(**({"critical": float(cel["critical"])} if "critical" in cel else {}))
259
+ elif isinstance(phases, (list, tuple)):
260
+ phases = tuple(Phase.from_config(p) for p in phases)
261
+ else:
262
+ raise ValueError("phases: wang, or a list of phases {name, law, critical, cost}")
263
+ extra = {}
264
+ if "fracture_radius" in cel:
265
+ extra["fracture_radius"] = cel["fracture_radius"]
266
+ if cel.get("case") is not None: # a structure: compact tension, L-shaped plate
267
+ from morphogen.laser.structures import case_from_config as structure
268
+
269
+ extra["case"] = structure(dict(cel["case"]))
270
+ return CellProblem(
271
+ specimen=case.specimen,
272
+ phases=phases,
273
+ size=float(cel.get("size", 0.5)),
274
+ element=float(cel.get("element", case.element)),
275
+ objective=cel.get("objective", "ductility"),
276
+ constraints=dict(cel.get("constraints") or {}),
277
+ **extra,
278
+ )
279
+
280
+
281
+ def run_cellular(cel: dict, case: SheetCase, *, log=None):
282
+ """Run the cellular design of a ``cellular`` section: the start (a track drawn by
283
+ the spot), the automaton or the densities, and the tracks of the result treated by
284
+ the process of the case (``realize``). Returns the optimization, the start and the
285
+ evaluated case of the tracks (or None)."""
286
+ from morphogen.laser.cells import beso, corrugation, design_tracks, hca, topology
287
+
288
+ say = log or (lambda *a: None)
289
+ problem = cellular_problem(cel, case)
290
+ grid = problem.grid
291
+ start_cfg = dict(cel.get("start") or {})
292
+ width = int(cel.get("min_width", 2) or 1)
293
+ if "tracks" in start_cfg: # polylines (mm) drawn by the spot
294
+ lines = [np.asarray(t, dtype=float) for t in start_cfg["tracks"]]
295
+ else:
296
+ period = start_cfg.get("period")
297
+ lines = corrugation(
298
+ problem.specimen,
299
+ float(start_cfg.get("amplitude", 0.0)),
300
+ float(period) if period else None,
301
+ count=int(start_cfg.get("count", 1)),
302
+ )
303
+ start = grid.stamp(lines, width=max(width, 1))
304
+ method = cel.get("method", "exchange")
305
+ budget = cel.get("budget")
306
+ iterations = int(cel.get("iterations", 40))
307
+ say(f"cellular design ({method}, cells of {problem.size} mm)")
308
+ if method in ("exchange", "swap"):
309
+ run = beso(
310
+ problem,
311
+ start,
312
+ budget=budget,
313
+ moves=method,
314
+ symmetry=tuple(cel.get("symmetry") or ()),
315
+ period=cel.get("period"),
316
+ min_width=width if width > 1 else None,
317
+ candidates=int(cel.get("candidates", 6)),
318
+ iterations=iterations,
319
+ patience=int(cel.get("patience", 8)),
320
+ )
321
+ else:
322
+ fun = hca if method == "hca" else topology
323
+ run = fun(
324
+ problem,
325
+ start.astype(float),
326
+ budget=float(start.mean() if budget is None else budget),
327
+ iterations=iterations,
328
+ )
329
+ realized = None
330
+ if cel.get("realize", True) and problem.case.kind == "tension":
331
+ tracks = design_tracks(grid, run.design)
332
+ sub = case.with_values({})
333
+ sub.pattern = {"kind": "polylines", "tracks": [t.tolist() for t in tracks]}
334
+ say(f"treating the {len(tracks)} track(s) of the design")
335
+ realized = sub.evaluate(keep_fields=True)
336
+ return run, start, realized
337
+
338
+
339
+ def run_laser(cfg: LaserConfig, *, callback=None, log=None) -> tuple[dict, Path]:
340
+ """Evaluate the designs of a configuration, optimize when asked, write the results;
341
+ returns the summary and the folder."""
342
+ t0 = time.perf_counter()
343
+ say = log or (lambda *a: None)
344
+ designs = {}
345
+ say("evaluating the pattern of the configuration")
346
+ designs["pattern"] = cfg.case.evaluate(keep_fields=True)
347
+ for name, pat in cfg.compare.items():
348
+ say(f"evaluating the reference {name}")
349
+ ref = cfg.case.with_values({}) # shares the cached kernels of the case
350
+ ref.pattern = dict(pat)
351
+ designs[name] = ref.evaluate(keep_fields=True)
352
+ opt_out = None
353
+ if cfg.optimization is not None:
354
+ o = dict(cfg.optimization)
355
+ check = o.pop("check_element", None)
356
+ options = dict(o.pop("options", {}) or {})
357
+ say(f"optimizing ({o.get('method', 'bayesian')}, {o.get('evaluations', 40)} evaluations)")
358
+ opt_out = optimize(
359
+ cfg.case, o.pop("parameters"), seed=cfg.seed, callback=callback, **o, **options
360
+ )
361
+ best_case = cfg.case.with_values(opt_out.values)
362
+ designs["optimum"] = best_case.evaluate(keep_fields=True)
363
+ if check:
364
+ say(f"checking the optimum on elements of {check} mm")
365
+ fine = best_case.with_values({"element": float(check)})
366
+ designs["optimum_check"] = fine.evaluate(keep_fields=True)
367
+ cells_out = None
368
+ if cfg.cellular is not None:
369
+ cells_out = run_cellular(cfg.cellular, cfg.case, log=say)
370
+ if cells_out[2] is not None:
371
+ designs["cellular"] = cells_out[2]
372
+ summary = write_laser_results(cfg, designs, opt_out)
373
+ if cells_out is not None:
374
+ summary["cellular"] = write_cellular_results(cfg, cells_out)
375
+ summary["time_s"] = time.perf_counter() - t0
376
+ (cfg.directory / "laser.json").write_text(
377
+ json.dumps(to_jsonable(summary), indent=2), encoding="utf-8"
378
+ )
379
+ return summary, cfg.directory
380
+
381
+
382
+ def write_laser_results(cfg: LaserConfig, designs: dict, opt_out) -> dict:
383
+ """Write the files of the results (see the module); returns the summary."""
384
+ from morphogen import pipeline
385
+
386
+ out = cfg.directory
387
+ out.mkdir(parents=True, exist_ok=True)
388
+ summary = {
389
+ "versions": pipeline.versions(),
390
+ "config": cfg.source,
391
+ "material": cfg.case.material.name,
392
+ "designs": {
393
+ k: {
394
+ "measures": v.measures,
395
+ "time_s": v.time_s,
396
+ "tracks": len(v.path),
397
+ "steps": v.tensile.steps if v.tensile is not None else 0,
398
+ }
399
+ for k, v in designs.items()
400
+ },
401
+ }
402
+ # curves
403
+ rows = []
404
+ for name, res in designs.items():
405
+ for d, r in (res.directions or {None: res}).items():
406
+ tag = name if d is None else f"{name}_{d:g}"
407
+ if r.tensile is not None:
408
+ t = r.tensile
409
+ for e, st, f, u in zip(t.strain, t.stress, t.force, t.displacement, strict=True):
410
+ rows.append(
411
+ {"design": tag, "strain": e, "stress": st, "force": f, "displacement": u}
412
+ )
413
+ if r.bending is not None:
414
+ b = r.bending
415
+ for u, f in zip(b.deflection, b.load, strict=True):
416
+ rows.append({"design": tag, "deflection": u, "load": f})
417
+ pipeline.write_rows(out / "curves.csv", rows)
418
+ if opt_out is not None:
419
+ pipeline.write_rows(out / "history.csv", opt_out.history)
420
+ summary["optimization"] = {
421
+ "method": opt_out.method,
422
+ "values": opt_out.values,
423
+ "objective": opt_out.objective,
424
+ "feasible": opt_out.feasible,
425
+ "evaluations": opt_out.evaluations,
426
+ "time_s": opt_out.time_s,
427
+ "settings": opt_out.settings,
428
+ }
429
+ best = designs.get("optimum", designs["pattern"])
430
+ best_case = cfg.case if "optimum" not in designs else cfg.case.with_values(opt_out.values)
431
+ if cfg.gcode and len(best.path):
432
+ (out / "path.gcode").write_text(best.path.to_gcode(), encoding="utf-8")
433
+ prow = []
434
+ for k, t in enumerate(best.path):
435
+ for x, y in t.points:
436
+ prow.append(
437
+ {
438
+ "track": k,
439
+ "x": x,
440
+ "y": y,
441
+ "power": t.beam.power,
442
+ "bottom_power": t.bottom.power if t.bottom is not None else 0.0,
443
+ "speed": t.beam.speed,
444
+ }
445
+ )
446
+ pipeline.write_rows(out / "path.csv", prow)
447
+ if cfg.fields:
448
+ _write_fields(best_case, best, out, cfg.fields, cfg.resolution)
449
+ if cfg.figures:
450
+ try:
451
+ from morphogen.laser import figures
452
+
453
+ figures.write_figures(best_case, designs, opt_out, out, resolution=cfg.resolution)
454
+ except ImportError: # matplotlib missing
455
+ summary["figures"] = "matplotlib is needed for the figures"
456
+ return summary
457
+
458
+
459
+ def write_cellular_results(cfg: LaserConfig, cells_out) -> dict:
460
+ """Write the files of a cellular design (see the module); returns its summary."""
461
+ from morphogen import pipeline
462
+
463
+ run, start, realized = cells_out
464
+ out = cfg.directory
465
+ out.mkdir(parents=True, exist_ok=True)
466
+ pipeline.write_rows(out / "cells.csv", run.history)
467
+ np.savetxt(out / "cells_design.csv", np.asarray(run.design), fmt="%d", delimiter=",")
468
+ if cfg.gcode and realized is not None and len(realized.path):
469
+ (out / "cells_path.gcode").write_text(realized.path.to_gcode(), encoding="utf-8")
470
+ first = run.history[0] if run.history else {}
471
+ summary = {
472
+ "method": run.method,
473
+ "evaluations": run.evaluations,
474
+ "time_s": run.time_s,
475
+ "start": {
476
+ k: first.get(k)
477
+ for k in ("value", "tensile_strength", "failure_strain", "energy", "budget")
478
+ },
479
+ "best": {"value": run.evaluation.value, **run.evaluation.measures},
480
+ }
481
+ if cfg.figures:
482
+ try:
483
+ from morphogen.laser.figures import cells_figure
484
+
485
+ problem = cellular_problem(cfg.cellular, cfg.case)
486
+ grid = problem.grid
487
+ curves = {}
488
+ for name, d in (("start", start), ("design", run.design)):
489
+ ev = problem.evaluate(d)
490
+ curves[name] = (ev.result.strain, ev.result.stress, ev.measures["failure_strain"])
491
+ cells_figure(grid, {"start": start, "design": run.design}, curves, out / "cells.png")
492
+ except ImportError: # matplotlib missing
493
+ summary["figures"] = "matplotlib is needed for the figures"
494
+ return summary
495
+
496
+
497
+ def hardness_map(case: SheetCase, path, resolution: float = 0.05) -> dict:
498
+ """The treated parallel part of a case on a grid of pixels (``resolution`` mm): the
499
+ hardness, treated share and peak temperature of each layer, ``(nx, ny, layers)``."""
500
+ x0, x1, y0, y1 = case.specimen.band()
501
+ nx = max(2, round((x1 - x0) / resolution))
502
+ ny = max(2, round((y1 - y0) / resolution))
503
+ xs = x0 + (np.arange(nx) + 0.5) * (x1 - x0) / nx
504
+ ys = y0 + (np.arange(ny) + 0.5) * (y1 - y0) / ny
505
+ pts = np.column_stack([np.repeat(xs, ny), np.tile(ys, nx)])
506
+ res = case.laser_treatment().apply(path, pts)
507
+ shape = (nx, ny, res.layers)
508
+ return {
509
+ "x": xs,
510
+ "y": ys,
511
+ "spacing": ((x1 - x0) / nx, (y1 - y0) / ny),
512
+ "hardness": res.hardness.reshape(shape),
513
+ "treated": res.treated.reshape(shape),
514
+ "peak": res.peak.reshape(shape),
515
+ "carbon": res.carbon.reshape(shape),
516
+ }
517
+
518
+
519
+ def _write_fields(case: SheetCase, res, out: Path, formats, resolution: float) -> None:
520
+ from morphogen import io
521
+ from morphogen.image import VoxelImage
522
+
523
+ maps = hardness_map(case, res.path, resolution)
524
+ dz = case.specimen.thickness / case.layers
525
+ spacing = (*maps["spacing"], dz)
526
+ images = [
527
+ VoxelImage(maps[k].astype(np.float32), spacing=spacing, name=k)
528
+ for k in ("hardness", "treated", "peak", "carbon")
529
+ ]
530
+ for fmt in formats:
531
+ if fmt == "npz":
532
+ np.savez_compressed(out / "fields.npz", **{k: maps[k] for k in maps})
533
+ else:
534
+ io.save_image(images, out / f"fields.{fmt}")