morphogen 1.0.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (381) hide show
  1. morphogen/__init__.py +60 -0
  2. morphogen/__main__.py +7 -0
  3. morphogen/_platform.py +55 -0
  4. morphogen/_public.py +153 -0
  5. morphogen/_utils.py +80 -0
  6. morphogen/_version.py +1 -0
  7. morphogen/analysis/__init__.py +174 -0
  8. morphogen/analysis/anisotropy.py +135 -0
  9. morphogen/analysis/basic.py +38 -0
  10. morphogen/analysis/cells.py +54 -0
  11. morphogen/analysis/connectivity.py +156 -0
  12. morphogen/analysis/correlation.py +195 -0
  13. morphogen/analysis/covariance.py +80 -0
  14. morphogen/analysis/fractal.py +54 -0
  15. morphogen/analysis/measures.py +188 -0
  16. morphogen/analysis/morphology.py +265 -0
  17. morphogen/analysis/particles.py +160 -0
  18. morphogen/analysis/percolation.py +2034 -0
  19. morphogen/analysis/power_laws.py +143 -0
  20. morphogen/analysis/random_sets.py +351 -0
  21. morphogen/analysis/stereology.py +289 -0
  22. morphogen/analysis/surface.py +107 -0
  23. morphogen/analysis/topology.py +92 -0
  24. morphogen/automata/__init__.py +74 -0
  25. morphogen/automata/engine.py +211 -0
  26. morphogen/automata/growth.py +686 -0
  27. morphogen/automata/lattice.py +143 -0
  28. morphogen/automata/reaction.py +255 -0
  29. morphogen/automata/rules.py +353 -0
  30. morphogen/automata/tilings.py +1715 -0
  31. morphogen/cli.py +3526 -0
  32. morphogen/config.py +2167 -0
  33. morphogen/contact/__init__.py +113 -0
  34. morphogen/contact/experiments.py +368 -0
  35. morphogen/contact/hertz.py +104 -0
  36. morphogen/contact/kernels.py +827 -0
  37. morphogen/contact/periodic.py +278 -0
  38. morphogen/contact/problem.py +578 -0
  39. morphogen/contact/surfaces.py +310 -0
  40. morphogen/coupling/__init__.py +43 -0
  41. morphogen/coupling/ageing.py +143 -0
  42. morphogen/coupling/diffusion.py +226 -0
  43. morphogen/coupling/fenicsx.py +484 -0
  44. morphogen/coupling/oxidation.py +447 -0
  45. morphogen/coupling/plates.py +247 -0
  46. morphogen/design/__init__.py +51 -0
  47. morphogen/design/csp.py +616 -0
  48. morphogen/design/frames.py +277 -0
  49. morphogen/design/search.py +287 -0
  50. morphogen/design/tiles.py +336 -0
  51. morphogen/distributions.py +312 -0
  52. morphogen/domain.py +203 -0
  53. morphogen/dynamics/__init__.py +179 -0
  54. morphogen/dynamics/model.py +638 -0
  55. morphogen/dynamics/openradioss.py +643 -0
  56. morphogen/dynamics/results.py +515 -0
  57. morphogen/fracture/__init__.py +170 -0
  58. morphogen/fracture/bulk.py +349 -0
  59. morphogen/fracture/cohesive.py +1614 -0
  60. morphogen/fracture/ductile.py +557 -0
  61. morphogen/fracture/lefm.py +1168 -0
  62. morphogen/fracture/mixed.py +1178 -0
  63. morphogen/fracture/periodic.py +733 -0
  64. morphogen/fracture/phasefield.py +714 -0
  65. morphogen/fracture/phasefield_finite.py +368 -0
  66. morphogen/fracture/surface.py +572 -0
  67. morphogen/fracture/toughness.py +566 -0
  68. morphogen/gpu.py +108 -0
  69. morphogen/gui/__init__.py +8 -0
  70. morphogen/gui/api.py +1927 -0
  71. morphogen/gui/desktop.py +387 -0
  72. morphogen/gui/icon.png +0 -0
  73. morphogen/gui/index.html +1909 -0
  74. morphogen/gui/server.py +229 -0
  75. morphogen/gui/tools/__init__.py +629 -0
  76. morphogen/gui/tools/compare.py +149 -0
  77. morphogen/gui/tools/contact.py +391 -0
  78. morphogen/gui/tools/couplings.py +1085 -0
  79. morphogen/gui/tools/crackfront.py +245 -0
  80. morphogen/gui/tools/design.py +224 -0
  81. morphogen/gui/tools/dynamics.py +824 -0
  82. morphogen/gui/tools/fracture.py +2586 -0
  83. morphogen/gui/tools/interop.py +1654 -0
  84. morphogen/gui/tools/learning.py +595 -0
  85. morphogen/gui/tools/mechanics.py +3881 -0
  86. morphogen/gui/tools/nonlocal_damage.py +1321 -0
  87. morphogen/gui/tools/phasefield.py +215 -0
  88. morphogen/gui/tools/physics.py +597 -0
  89. morphogen/gui/tools/stability.py +1756 -0
  90. morphogen/gui/tools/statistics.py +1408 -0
  91. morphogen/gui/viewer.js +1100 -0
  92. morphogen/homogenization/__init__.py +210 -0
  93. morphogen/homogenization/acoustics.py +566 -0
  94. morphogen/homogenization/amg.py +1005 -0
  95. morphogen/homogenization/apparent.py +1046 -0
  96. morphogen/homogenization/behaviours.cu +2285 -0
  97. morphogen/homogenization/behaviours.py +944 -0
  98. morphogen/homogenization/beremin.py +263 -0
  99. morphogen/homogenization/bifurcation.py +1085 -0
  100. morphogen/homogenization/bloch.py +507 -0
  101. morphogen/homogenization/bounds.py +226 -0
  102. morphogen/homogenization/core.py +458 -0
  103. morphogen/homogenization/coupled.py +1135 -0
  104. morphogen/homogenization/crystal.py +2967 -0
  105. morphogen/homogenization/dilatation.py +454 -0
  106. morphogen/homogenization/elements.py +157 -0
  107. morphogen/homogenization/fatigue.py +768 -0
  108. morphogen/homogenization/fe.py +1739 -0
  109. morphogen/homogenization/fenicsx.py +307 -0
  110. morphogen/homogenization/fft.py +499 -0
  111. morphogen/homogenization/fft_nonlinear.py +391 -0
  112. morphogen/homogenization/finite.py +613 -0
  113. morphogen/homogenization/flow.py +361 -0
  114. morphogen/homogenization/frames.py +1125 -0
  115. morphogen/homogenization/gpu.py +1241 -0
  116. morphogen/homogenization/harmonic.py +427 -0
  117. morphogen/homogenization/identification.py +579 -0
  118. morphogen/homogenization/kernels.py +760 -0
  119. morphogen/homogenization/laws.py +2061 -0
  120. morphogen/homogenization/materials.py +1080 -0
  121. morphogen/homogenization/mfront.py +589 -0
  122. morphogen/homogenization/networks.py +880 -0
  123. morphogen/homogenization/nonlinear.py +2612 -0
  124. morphogen/homogenization/ntfa.py +577 -0
  125. morphogen/homogenization/paths.py +476 -0
  126. morphogen/homogenization/photonic.py +467 -0
  127. morphogen/homogenization/poroelastic.py +212 -0
  128. morphogen/homogenization/porous.py +1120 -0
  129. morphogen/homogenization/postprocess.py +290 -0
  130. morphogen/homogenization/solvers.py +1140 -0
  131. morphogen/homogenization/tensors.py +240 -0
  132. morphogen/homogenization/voxel_fe.py +457 -0
  133. morphogen/homogenization/xfem.py +1016 -0
  134. morphogen/homogenization/zmat.py +1258 -0
  135. morphogen/iga/__init__.py +48 -0
  136. morphogen/iga/analysis.py +508 -0
  137. morphogen/iga/basis.py +214 -0
  138. morphogen/iga/geometry.py +501 -0
  139. morphogen/iga/homogenization.py +219 -0
  140. morphogen/iga/optimization.py +700 -0
  141. morphogen/iga/shapes.py +331 -0
  142. morphogen/image.py +128 -0
  143. morphogen/io/__init__.py +246 -0
  144. morphogen/io/amitex.py +741 -0
  145. morphogen/io/ebsd.py +881 -0
  146. morphogen/io/export.py +196 -0
  147. morphogen/io/geometry.py +158 -0
  148. morphogen/io/medit.py +147 -0
  149. morphogen/io/meshes.py +844 -0
  150. morphogen/io/metaimage.py +97 -0
  151. morphogen/io/mfront.py +1104 -0
  152. morphogen/io/native.py +57 -0
  153. morphogen/io/radioss.py +764 -0
  154. morphogen/io/solvers.py +371 -0
  155. morphogen/io/tables.py +278 -0
  156. morphogen/io/tiff.py +66 -0
  157. morphogen/io/vtk.py +701 -0
  158. morphogen/io/xdmf.py +200 -0
  159. morphogen/kernels/__init__.py +5 -0
  160. morphogen/kernels/annealing.py +192 -0
  161. morphogen/kernels/cells.py +69 -0
  162. morphogen/kernels/collective.py +87 -0
  163. morphogen/kernels/force_biased.py +595 -0
  164. morphogen/kernels/implicit.py +145 -0
  165. morphogen/kernels/leaves.py +132 -0
  166. morphogen/kernels/packing.py +304 -0
  167. morphogen/kernels/raster.py +279 -0
  168. morphogen/kernels/rsa.py +371 -0
  169. morphogen/kernels/union.py +135 -0
  170. morphogen/kernels/watershed.py +190 -0
  171. morphogen/laser/__init__.py +234 -0
  172. morphogen/laser/architectures.py +375 -0
  173. morphogen/laser/bending.py +216 -0
  174. morphogen/laser/cells.py +1694 -0
  175. morphogen/laser/design.py +940 -0
  176. morphogen/laser/figures.py +227 -0
  177. morphogen/laser/heat.py +804 -0
  178. morphogen/laser/materials.py +691 -0
  179. morphogen/laser/mechanics.py +1670 -0
  180. morphogen/laser/metallurgy.py +615 -0
  181. morphogen/laser/patterns.py +828 -0
  182. morphogen/laser/periodic.py +392 -0
  183. morphogen/laser/process.py +362 -0
  184. morphogen/laser/run.py +534 -0
  185. morphogen/laser/solid.py +216 -0
  186. morphogen/laser/specimen.py +200 -0
  187. morphogen/laser/structures.py +708 -0
  188. morphogen/learning/__init__.py +81 -0
  189. morphogen/learning/behaviour.py +398 -0
  190. morphogen/learning/data.py +328 -0
  191. morphogen/learning/learned.cpp +668 -0
  192. morphogen/learning/logarithmic.py +202 -0
  193. morphogen/learning/mfront.py +409 -0
  194. morphogen/learning/networks.py +767 -0
  195. morphogen/learning/run.py +212 -0
  196. morphogen/learning/standard.py +814 -0
  197. morphogen/learning/training.py +235 -0
  198. morphogen/mesh/__init__.py +29 -0
  199. morphogen/mesh/conforming.py +1423 -0
  200. morphogen/mesh/curved.py +600 -0
  201. morphogen/mesh/exact.py +1717 -0
  202. morphogen/mesh/octree.py +350 -0
  203. morphogen/mesh/polycrystal.py +1041 -0
  204. morphogen/mesh/polyhedra.py +677 -0
  205. morphogen/mesh/regularize.py +570 -0
  206. morphogen/mesh/surface.py +97 -0
  207. morphogen/mesh/tetra.py +512 -0
  208. morphogen/mesh/voxel.py +124 -0
  209. morphogen/micromorphic/__init__.py +31 -0
  210. morphogen/micromorphic/damage.py +359 -0
  211. morphogen/micromorphic/ductile.py +534 -0
  212. morphogen/micromorphic/finite.py +220 -0
  213. morphogen/micromorphic/microfoam.py +787 -0
  214. morphogen/micromorphic/space.py +341 -0
  215. morphogen/models/__init__.py +195 -0
  216. morphogen/models/affine.py +384 -0
  217. morphogen/models/automata.py +592 -0
  218. morphogen/models/base.py +500 -0
  219. morphogen/models/boolean.py +310 -0
  220. morphogen/models/bouligand.py +331 -0
  221. morphogen/models/branching.py +241 -0
  222. morphogen/models/combination.py +430 -0
  223. morphogen/models/deadleaves.py +766 -0
  224. morphogen/models/design.py +289 -0
  225. morphogen/models/ebsd.py +206 -0
  226. morphogen/models/fibers.py +1476 -0
  227. morphogen/models/foam.py +594 -0
  228. morphogen/models/gaussian.py +314 -0
  229. morphogen/models/growth.py +459 -0
  230. morphogen/models/hardcore.py +317 -0
  231. morphogen/models/hierarchical.py +269 -0
  232. morphogen/models/honeycomb.py +749 -0
  233. morphogen/models/implicit.py +177 -0
  234. morphogen/models/laminate.py +470 -0
  235. morphogen/models/lattice.py +351 -0
  236. morphogen/models/lattice_field.py +345 -0
  237. morphogen/models/levelset_foam.py +563 -0
  238. morphogen/models/nacre.py +411 -0
  239. morphogen/models/nested.py +924 -0
  240. morphogen/models/osteons.py +374 -0
  241. morphogen/models/pieces.py +167 -0
  242. morphogen/models/planar.py +126 -0
  243. morphogen/models/reconstruction.py +203 -0
  244. morphogen/models/scale_rich.py +1409 -0
  245. morphogen/models/scale_rich_3d.py +1616 -0
  246. morphogen/models/tessellation.py +735 -0
  247. morphogen/models/tiling_field.py +302 -0
  248. morphogen/models/tpms.py +197 -0
  249. morphogen/models/transparent.py +406 -0
  250. morphogen/models/union.py +141 -0
  251. morphogen/optimization/__init__.py +43 -0
  252. morphogen/optimization/cell.py +295 -0
  253. morphogen/optimization/filters.py +115 -0
  254. morphogen/optimization/mma.py +226 -0
  255. morphogen/optimization/run.py +219 -0
  256. morphogen/optimization/topology.py +632 -0
  257. morphogen/orientations.py +568 -0
  258. morphogen/parallel.py +599 -0
  259. morphogen/pipeline.py +978 -0
  260. morphogen/primitives.py +188 -0
  261. morphogen/results.py +564 -0
  262. morphogen/rve/__init__.py +73 -0
  263. morphogen/rve/report.py +627 -0
  264. morphogen/rve/scaling.py +363 -0
  265. morphogen/rve/study.py +1054 -0
  266. morphogen/rve/windows.py +345 -0
  267. morphogen/seeding.py +51 -0
  268. morphogen/settings.py +118 -0
  269. morphogen/stopping.py +48 -0
  270. morphogen/symmetry.py +384 -0
  271. morphogen/templates/activator_inhibitor.yaml +22 -0
  272. morphogen/templates/aggregation.yaml +23 -0
  273. morphogen/templates/boolean_cylinders.yaml +20 -0
  274. morphogen/templates/boolean_spheres.yaml +22 -0
  275. morphogen/templates/bouligand.yaml +28 -0
  276. morphogen/templates/cellular_automaton.yaml +25 -0
  277. morphogen/templates/coated_spheres.yaml +26 -0
  278. morphogen/templates/contact_fibers.yaml +27 -0
  279. morphogen/templates/cox_nanocomposite.yaml +22 -0
  280. morphogen/templates/cross_linked_fibers.yaml +26 -0
  281. morphogen/templates/curved_arcs.yaml +28 -0
  282. morphogen/templates/curved_fibers.yaml +24 -0
  283. morphogen/templates/dead_leaves.yaml +22 -0
  284. morphogen/templates/delaunay_network.yaml +22 -0
  285. morphogen/templates/dense_packing.yaml +22 -0
  286. morphogen/templates/diffusion.yaml +33 -0
  287. morphogen/templates/ebsd.yaml +34 -0
  288. morphogen/templates/ebsd_map.ctf +3087 -0
  289. morphogen/templates/fracture_composite.yaml +42 -0
  290. morphogen/templates/fracture_rubber.yaml +47 -0
  291. morphogen/templates/gaussian_excursion.yaml +17 -0
  292. morphogen/templates/graded_lattice.yaml +24 -0
  293. morphogen/templates/hardcore_fibers.yaml +22 -0
  294. morphogen/templates/hardcore_spheres.yaml +22 -0
  295. morphogen/templates/hierarchical_lattice.yaml +22 -0
  296. morphogen/templates/homogenization_acoustic_foam.yaml +36 -0
  297. morphogen/templates/homogenization_beremin.yaml +50 -0
  298. morphogen/templates/homogenization_cleavage.yaml +51 -0
  299. morphogen/templates/homogenization_cleavage_band.yaml +55 -0
  300. morphogen/templates/homogenization_contact.yaml +43 -0
  301. morphogen/templates/homogenization_crack_closure.yaml +49 -0
  302. morphogen/templates/homogenization_crystal_plasticity.yaml +50 -0
  303. morphogen/templates/homogenization_crystal_plasticity_fft.yaml +52 -0
  304. morphogen/templates/homogenization_crystallization.yaml +30 -0
  305. morphogen/templates/homogenization_debonding.yaml +43 -0
  306. morphogen/templates/homogenization_detwinning.yaml +58 -0
  307. morphogen/templates/homogenization_ductile_damage.yaml +47 -0
  308. morphogen/templates/homogenization_fatigue.yaml +40 -0
  309. morphogen/templates/homogenization_grain_fracture.yaml +56 -0
  310. morphogen/templates/homogenization_gyroid.yaml +30 -0
  311. morphogen/templates/homogenization_intergranular.yaml +43 -0
  312. morphogen/templates/homogenization_interphase.yaml +42 -0
  313. morphogen/templates/homogenization_mixed_loading.yaml +33 -0
  314. morphogen/templates/homogenization_ntfa.yaml +56 -0
  315. morphogen/templates/homogenization_piezoelectric.yaml +27 -0
  316. morphogen/templates/homogenization_polycrystal.yaml +30 -0
  317. morphogen/templates/homogenization_polycrystal_inclusions.yaml +30 -0
  318. morphogen/templates/homogenization_poroelastic.yaml +26 -0
  319. morphogen/templates/homogenization_rubber.yaml +40 -0
  320. morphogen/templates/homogenization_slip_cleavage.yaml +50 -0
  321. morphogen/templates/homogenization_spheres.yaml +31 -0
  322. morphogen/templates/homogenization_transport.yaml +29 -0
  323. morphogen/templates/homogenization_twinning.yaml +54 -0
  324. morphogen/templates/homogenization_viscoelastic.yaml +34 -0
  325. morphogen/templates/homogenization_viscoplastic.yaml +42 -0
  326. morphogen/templates/homogenization_voronoi.yaml +26 -0
  327. morphogen/templates/homogenization_xfem.yaml +23 -0
  328. morphogen/templates/hyperuniform_cells.yaml +24 -0
  329. morphogen/templates/laguerre.yaml +18 -0
  330. morphogen/templates/laser_bending.yaml +35 -0
  331. morphogen/templates/laser_cells.yaml +38 -0
  332. morphogen/templates/laser_corrugated.yaml +36 -0
  333. morphogen/templates/level_set_foam.yaml +29 -0
  334. morphogen/templates/menger_sponge.yaml +17 -0
  335. morphogen/templates/nacre.yaml +25 -0
  336. morphogen/templates/nucleation_growth.yaml +25 -0
  337. morphogen/templates/optimize_auxetic.yaml +29 -0
  338. morphogen/templates/optimize_auxetic_3d.yaml +27 -0
  339. morphogen/templates/optimize_bulk.yaml +23 -0
  340. morphogen/templates/optimize_conductivity.yaml +20 -0
  341. morphogen/templates/osteons.yaml +28 -0
  342. morphogen/templates/penetrable_spheres.yaml +21 -0
  343. morphogen/templates/poisson_fibers.yaml +21 -0
  344. morphogen/templates/random_laminate.yaml +26 -0
  345. morphogen/templates/random_lattice.yaml +27 -0
  346. morphogen/templates/random_walk_fibers.yaml +26 -0
  347. morphogen/templates/reaction_diffusion.yaml +22 -0
  348. morphogen/templates/reconstruction.yaml +22 -0
  349. morphogen/templates/rve_cellular_automaton.yaml +23 -0
  350. morphogen/templates/rve_crystal_plasticity_fft.yaml +51 -0
  351. morphogen/templates/rve_multiphysics.yaml +43 -0
  352. morphogen/templates/rve_poisson_fibers.yaml +22 -0
  353. morphogen/templates/rve_poisson_fibers_fe.yaml +33 -0
  354. morphogen/templates/rve_voronoi_windows.yaml +20 -0
  355. morphogen/templates/scale_rich_network.yaml +29 -0
  356. morphogen/templates/scale_rich_plates.yaml +30 -0
  357. morphogen/templates/sequential_dead_leaves.yaml +25 -0
  358. morphogen/templates/strut_lattice.yaml +21 -0
  359. morphogen/templates/tile_assembly.yaml +28 -0
  360. morphogen/templates/tpms.yaml +19 -0
  361. morphogen/templates/trabecular_bone.yaml +29 -0
  362. morphogen/templates/transparent_dead_leaves.yaml +23 -0
  363. morphogen/templates/vascular_tree.yaml +23 -0
  364. morphogen/templates/voronoi.yaml +20 -0
  365. morphogen/templates/wood.yaml +34 -0
  366. morphogen/templates/workflow.yaml +56 -0
  367. morphogen/texture.py +665 -0
  368. morphogen/theory.py +162 -0
  369. morphogen/viz/__init__.py +12 -0
  370. morphogen/viz/export.py +244 -0
  371. morphogen/viz/figures.py +707 -0
  372. morphogen/viz/png.py +148 -0
  373. morphogen/viz/sections.py +696 -0
  374. morphogen/viz/surfaces.py +1352 -0
  375. morphogen/viz/video.py +904 -0
  376. morphogen/viz/workflow.py +488 -0
  377. morphogen-1.0.0.dist-info/METADATA +2316 -0
  378. morphogen-1.0.0.dist-info/RECORD +381 -0
  379. morphogen-1.0.0.dist-info/WHEEL +4 -0
  380. morphogen-1.0.0.dist-info/entry_points.txt +5 -0
  381. morphogen-1.0.0.dist-info/licenses/LICENSE +674 -0
@@ -0,0 +1,246 @@
1
+ """Reading and writing images, meshes and geometries (format chosen by file extension).
2
+
3
+ ============= ======================================================================
4
+ Images ``.vti`` (VTK XML), ``.vtk`` (legacy VTK), ``.mhd`` (MetaImage),
5
+ ``.xdmf`` (XDMF with raw binary data), ``.npz`` (NumPy, round-trips
6
+ metadata), ``.npy``, ``.tif`` (tifffile)
7
+ Meshes ``.inp`` (Abaqus/CalculiX), ``.msh`` (Gmsh 2.2), ``.vtu``, ``.stl``,
8
+ ``.mesh`` (Medit, tetrahedra), ``.xdmf`` (tetrahedra with their cell
9
+ and facet tags for FEniCSx), other extensions through meshio
10
+ Geometries ``.json`` (full description), ``.csv`` (tables), ``.geo`` (Gmsh script)
11
+ Solvers periodic equations (Abaqus/CalculiX), DAMASK grids and materials, Neper
12
+ seeds (:mod:`morphogen.io.solvers`); the runs of AMITEX_FFTP and their
13
+ results (:mod:`morphogen.io.amitex`); MFront sources of the nonlinear
14
+ materials (:mod:`morphogen.io.mfront`); the inputs of OpenRadioss, the
15
+ explicit solver, and its listings and time histories
16
+ (:mod:`morphogen.io.radioss`, run by :mod:`morphogen.dynamics`)
17
+ Orientations ``.ang`` (EDAX/TSL) and ``.ctf`` (Oxford Instruments/HKL) orientation
18
+ maps of EBSD, and their grains (:mod:`morphogen.io.ebsd`)
19
+ ============= ======================================================================
20
+
21
+ Images larger than memory are written slab by slab by :func:`voxelize_to_file`.
22
+ """
23
+
24
+ from __future__ import annotations
25
+
26
+ from pathlib import Path
27
+
28
+ from morphogen.image import VoxelImage
29
+ from morphogen.io.amitex import (
30
+ amitex_stiffness,
31
+ read_amitex,
32
+ read_amitex_materials,
33
+ read_amitex_run,
34
+ read_amitex_zones,
35
+ write_amitex,
36
+ write_amitex_field,
37
+ write_amitex_loading,
38
+ )
39
+ from morphogen.io.ebsd import EBSDMap, read_ebsd, write_ebsd
40
+ from morphogen.io.export import export
41
+ from morphogen.io.geometry import read_json, write_csv, write_geo, write_json
42
+ from morphogen.io.meshes import (
43
+ read_msh,
44
+ read_stl,
45
+ read_tet_mesh,
46
+ write_inp,
47
+ write_inp_tet,
48
+ write_medit_tet,
49
+ write_meshio,
50
+ write_msh,
51
+ write_msh_tet,
52
+ write_periodic_pairs,
53
+ write_stl,
54
+ write_vtu_mesh,
55
+ write_vtu_tet,
56
+ )
57
+ from morphogen.io.metaimage import read_mhd, write_mhd
58
+ from morphogen.io.mfront import mfront_source, write_mfront
59
+ from morphogen.io.native import read_npy, read_npz, write_npy, write_npz
60
+ from morphogen.io.radioss import read_radioss_listing, read_radioss_th, write_radioss
61
+ from morphogen.io.solvers import (
62
+ write_damask,
63
+ write_fenicsx,
64
+ write_neper,
65
+ write_periodic_equations,
66
+ )
67
+ from morphogen.io.tables import read_table, write_table, write_tables
68
+ from morphogen.io.tiff import read_tiff, write_tiff
69
+ from morphogen.io.vtk import (
70
+ read_vti,
71
+ read_vtk,
72
+ read_vtk_grid,
73
+ read_vtu,
74
+ write_vti,
75
+ write_vtk,
76
+ write_vtu,
77
+ )
78
+ from morphogen.io.xdmf import read_xdmf, voxelize_to_file, write_xdmf
79
+ from morphogen.mesh.surface import SurfaceMesh
80
+ from morphogen.mesh.tetra import TetMesh
81
+ from morphogen.mesh.voxel import VoxelMesh
82
+ from morphogen.models.base import Microstructure
83
+
84
+ IMAGE_FORMATS = ("vti", "vtk", "mhd", "xdmf", "npz", "npy", "tif")
85
+ MESH_FORMATS = ("inp", "msh", "vtu")
86
+ GEOMETRY_FORMATS = ("json", "csv", "geo")
87
+
88
+
89
+ def _ext(path) -> str:
90
+ ext = Path(path).suffix.lower().lstrip(".")
91
+ return "tif" if ext == "tiff" else ext
92
+
93
+
94
+ def save_image(images, path, **options) -> Path:
95
+ """Write an image, or several images on the same grid (formats .vti and .vtk)."""
96
+ ext = _ext(path)
97
+ many = not isinstance(images, VoxelImage)
98
+ if ext == "vti":
99
+ return write_vti(path, images, **options)
100
+ if ext == "vtk":
101
+ return write_vtk(path, images, **options)
102
+ if ext == "xdmf":
103
+ return write_xdmf(path, images)
104
+ if many:
105
+ if len(images) != 1:
106
+ raise ValueError(f".{ext} files hold a single array; use .vti or .vtk")
107
+ images = images[0]
108
+ writers = {"mhd": write_mhd, "npz": write_npz, "npy": write_npy, "tif": write_tiff}
109
+ if ext not in writers:
110
+ raise ValueError(f"unknown image format .{ext}; use one of {IMAGE_FORMATS}")
111
+ return writers[ext](path, images, **options)
112
+
113
+
114
+ def load_image(path, name: str | None = None) -> VoxelImage:
115
+ """Read an image (the array called ``name``, or the first one)."""
116
+ ext = _ext(path)
117
+ if ext in ("vti", "vtk"):
118
+ images = read_vti(path) if ext == "vti" else read_vtk(path)
119
+ if name is None:
120
+ return images[0]
121
+ for img in images:
122
+ if img.name == name:
123
+ return img
124
+ raise ValueError(f"{path}: no array named {name!r}")
125
+ if ext == "xdmf":
126
+ return read_xdmf(path, name)
127
+ readers = {"mhd": read_mhd, "npz": read_npz, "npy": read_npy, "tif": read_tiff}
128
+ if ext not in readers:
129
+ raise ValueError(f"unknown image format .{ext}; use one of {IMAGE_FORMATS}")
130
+ return readers[ext](path)
131
+
132
+
133
+ def save_mesh(mesh, path, **options) -> Path:
134
+ """A mesh written to a file whose extension gives the format: a surface mesh as .stl, a
135
+ tetrahedral mesh as .inp, .msh, .vtu, .mesh or .xdmf (FEniCSx), a voxel mesh as .inp, .msh or
136
+ .vtu, and any of them in the other formats of meshio."""
137
+ ext = _ext(path)
138
+ if isinstance(mesh, SurfaceMesh):
139
+ if ext == "stl":
140
+ return write_stl(path, mesh, **options)
141
+ return write_meshio(path, mesh)
142
+ if isinstance(mesh, TetMesh):
143
+ writers = {
144
+ "inp": write_inp_tet,
145
+ "msh": write_msh_tet,
146
+ "vtu": write_vtu_tet,
147
+ "mesh": write_medit_tet,
148
+ "xdmf": write_fenicsx,
149
+ }
150
+ if ext in writers:
151
+ return writers[ext](path, mesh, **options)
152
+ return write_meshio(path, mesh)
153
+ if not isinstance(mesh, VoxelMesh):
154
+ raise TypeError("save_mesh expects a VoxelMesh, a TetMesh or a SurfaceMesh")
155
+ writers = {"inp": write_inp, "msh": write_msh, "vtu": write_vtu_mesh}
156
+ if ext in writers:
157
+ return writers[ext](path, mesh, **options)
158
+ return write_meshio(path, mesh)
159
+
160
+
161
+ def save_microstructure(micro: Microstructure, path, **options):
162
+ """Write the explicit geometry of a realization (.json, .csv tables or .geo script)."""
163
+ ext = _ext(path)
164
+ if ext == "json":
165
+ return write_json(path, micro)
166
+ if ext == "csv":
167
+ return write_csv(path, micro)
168
+ if ext == "geo":
169
+ return write_geo(path, micro, **options)
170
+ raise ValueError(f"unknown geometry format .{ext}; use one of {GEOMETRY_FORMATS}")
171
+
172
+
173
+ def load_microstructure(path) -> Microstructure:
174
+ """A microstructure read back from the .json file that :func:`save_microstructure` wrote."""
175
+ if _ext(path) != "json":
176
+ raise ValueError("microstructures are read back from .json files")
177
+ return read_json(path)
178
+
179
+
180
+ __all__ = [
181
+ "GEOMETRY_FORMATS",
182
+ "IMAGE_FORMATS",
183
+ "MESH_FORMATS",
184
+ "EBSDMap",
185
+ "amitex_stiffness",
186
+ "export",
187
+ "load_image",
188
+ "load_microstructure",
189
+ "mfront_source",
190
+ "read_amitex",
191
+ "read_amitex_materials",
192
+ "read_amitex_run",
193
+ "read_amitex_zones",
194
+ "read_ebsd",
195
+ "read_json",
196
+ "read_mhd",
197
+ "read_msh",
198
+ "read_npy",
199
+ "read_npz",
200
+ "read_radioss_listing",
201
+ "read_radioss_th",
202
+ "read_stl",
203
+ "read_table",
204
+ "read_tet_mesh",
205
+ "read_tiff",
206
+ "read_vti",
207
+ "read_vtk",
208
+ "read_vtk_grid",
209
+ "read_vtu",
210
+ "read_xdmf",
211
+ "save_image",
212
+ "save_mesh",
213
+ "save_microstructure",
214
+ "voxelize_to_file",
215
+ "write_amitex",
216
+ "write_amitex_field",
217
+ "write_amitex_loading",
218
+ "write_csv",
219
+ "write_damask",
220
+ "write_ebsd",
221
+ "write_fenicsx",
222
+ "write_geo",
223
+ "write_inp",
224
+ "write_inp_tet",
225
+ "write_json",
226
+ "write_medit_tet",
227
+ "write_mfront",
228
+ "write_mhd",
229
+ "write_msh",
230
+ "write_msh_tet",
231
+ "write_neper",
232
+ "write_npy",
233
+ "write_npz",
234
+ "write_periodic_equations",
235
+ "write_periodic_pairs",
236
+ "write_radioss",
237
+ "write_stl",
238
+ "write_table",
239
+ "write_tables",
240
+ "write_tiff",
241
+ "write_vti",
242
+ "write_vtk",
243
+ "write_vtu",
244
+ "write_vtu_tet",
245
+ "write_xdmf",
246
+ ]