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/io/export.py ADDED
@@ -0,0 +1,196 @@
1
+ """One entry point for every export: :func:`export` writes an object to the format of the
2
+ suffix of its path, choosing the writer from the object and the suffix.
3
+
4
+ ===================== ====================================================================
5
+ object suffixes
6
+ ===================== ====================================================================
7
+ voxel image .vti .vtk .xdmf .mhd .npz .npy .tif (data); .png .svg .pdf .tex
8
+ (sections); .csv .txt .xlsx (voxels); .mp4 .gif (``kind``:
9
+ "sections" along ``axis``, "orthoslices", "turntable")
10
+ mesh (tetrahedra, .vtu .inp .msh .mesh .xdmf .stl and meshio's (data); .png (a view);
11
+ voxels, surface) .csv .txt .xlsx (nodes and elements); .mp4 .gif (``kind``:
12
+ "turntable", "sweep" along ``axis``, "field" with ``displacement``;
13
+ ``field`` colours them)
14
+ microstructure .json .csv .geo; the others voxelized (``shape``, by default 64,
15
+ or ``voxel_size``)
16
+ band structure .csv .txt .xlsx (the bands); figure suffixes (the plot)
17
+ bifurcation analysis .csv .txt .xlsx (irreps and patterns); .vtu (patterns of a mesh);
18
+ figure suffixes with ``frame`` (patterns of a frame)
19
+ loading path result .csv .txt .xlsx (its curve)
20
+ frame of beams .mp4 .gif with ``pattern`` (its dofs: a pattern oscillating), in
21
+ the plane or in space
22
+ matplotlib figure .png .tif .jpg .svg .pdf .eps .tex
23
+ frames (RGB arrays) .mp4 .gif or a folder
24
+ table .csv .txt .tsv .xlsx (records, columns, an array)
25
+ ===================== ====================================================================
26
+
27
+ Videos take ``fps``, ``mode`` ("once", "loop", "bounce") and ``repeat``; 3D views ``cmap``,
28
+ ``clim``, ``size``; field animations ``magnification``, ``wave`` and ``section``.
29
+ """
30
+
31
+ from __future__ import annotations
32
+
33
+ from pathlib import Path
34
+
35
+ import numpy as np
36
+
37
+ from morphogen.image import VoxelImage
38
+ from morphogen.io.tables import FORMATS as TABLES
39
+ from morphogen.io.tables import write_table, write_tables
40
+ from morphogen.viz.export import BITMAP, TIKZ, VECTOR, save_figure
41
+
42
+ FIGURES = BITMAP + VECTOR + TIKZ
43
+ VIDEOS = (".mp4", ".gif")
44
+ _VIDEO_OPTIONS = ("fps", "mode", "repeat", "crf")
45
+
46
+
47
+ def _split(options: dict) -> tuple[dict, dict]:
48
+ video = {k: options.pop(k) for k in _VIDEO_OPTIONS if k in options}
49
+ return video, options
50
+
51
+
52
+ def _video(obj, path: Path, options: dict) -> Path:
53
+ from morphogen.homogenization.frames import Frame, SpaceFrame
54
+ from morphogen.viz import video as vv
55
+
56
+ video, options = _split(dict(options))
57
+ kind = options.pop("kind", None)
58
+ if isinstance(obj, VoxelImage):
59
+ kind = kind or "sections"
60
+ if kind == "sections":
61
+ frames = vv.section_frames(obj, **options)
62
+ elif kind == "orthoslices":
63
+ frames = vv.orthoslice_frames(obj, **options)
64
+ elif kind == "turntable":
65
+ frames = vv.turntable_frames(obj, **options)
66
+ else:
67
+ raise ValueError(
68
+ "export: kind of a voxel image video: sections, orthoslices, turntable"
69
+ )
70
+ elif isinstance(obj, (Frame, SpaceFrame)):
71
+ frames = vv.frame_pattern_frames(obj, options.pop("pattern"), **options)
72
+ elif hasattr(obj, "elements") and hasattr(obj, "nodes"):
73
+ kind = kind or ("field" if "displacement" in options else "turntable")
74
+ if kind == "turntable":
75
+ frames = vv.turntable_frames(obj, **options)
76
+ elif kind == "sweep":
77
+ frames = vv.section_sweep_frames(obj, options.pop("field", None), **options)
78
+ elif kind == "field":
79
+ frames = vv.field_frames(
80
+ obj, options.pop("displacement"), options.pop("field", None), **options
81
+ )
82
+ else:
83
+ raise ValueError("export: kind of a mesh video: turntable, sweep, field")
84
+ else:
85
+ frames = list(obj)
86
+ return vv.write_video(frames, path, **video)
87
+
88
+
89
+ def _mesh_tables(mesh) -> dict:
90
+ nodes = np.asarray(mesh.nodes)
91
+ elements = np.asarray(mesh.elements if hasattr(mesh, "elements") else mesh.faces)
92
+ node_table = {
93
+ "node": np.arange(len(nodes)),
94
+ "x": nodes[:, 0],
95
+ "y": nodes[:, 1],
96
+ "z": nodes[:, 2],
97
+ }
98
+ element_table = {"element": np.arange(len(elements))}
99
+ element_table.update({f"n{k + 1}": elements[:, k] for k in range(elements.shape[1])})
100
+ phase = getattr(mesh, "phase", None)
101
+ if phase is not None:
102
+ element_table["phase"] = np.asarray(phase)
103
+ return {"nodes": node_table, "elements": element_table}
104
+
105
+
106
+ def _voxel_table(image: VoxelImage) -> dict:
107
+ data = np.asarray(image.data)
108
+ idx = np.indices(data.shape).reshape(3, -1)
109
+ x = np.asarray(image.origin)[:, None] + (idx + 0.5) * np.asarray(image.spacing)[:, None]
110
+ return {
111
+ "i": idx[0],
112
+ "j": idx[1],
113
+ "k": idx[2],
114
+ "x": x[0],
115
+ "y": x[1],
116
+ "z": x[2],
117
+ "value": data.ravel(),
118
+ }
119
+
120
+
121
+ def export(obj, path, **options) -> Path | list[Path]:
122
+ """Write ``obj`` to ``path`` in the format of its suffix (see the module); the options
123
+ go to the writer."""
124
+ from morphogen.homogenization.bifurcation import Bifurcation
125
+ from morphogen.homogenization.bloch import BandStructure
126
+ from morphogen.homogenization.paths import PathResult
127
+ from morphogen.io import save_image, save_mesh, save_microstructure
128
+ from morphogen.models.base import Microstructure
129
+
130
+ path = Path(path)
131
+ suffix = path.suffix.lower()
132
+ if isinstance(obj, Microstructure) and suffix not in (".json", ".csv", ".geo"):
133
+ shape, size = options.pop("shape", None), options.pop("voxel_size", None)
134
+ shape = 64 if shape is None and size is None else shape
135
+ return export(obj.voxelize(shape, voxel_size=size), path, **options)
136
+ if suffix in VIDEOS or (suffix == "" and options.get("kind")):
137
+ return _video(obj, path, options)
138
+ if hasattr(obj, "savefig"):
139
+ return save_figure(obj, path, **options)
140
+ if isinstance(obj, PathResult):
141
+ return write_table(path, obj.rows(), **options)
142
+ if isinstance(obj, BandStructure):
143
+ if suffix in TABLES:
144
+ table = {
145
+ "distance": obj.distance,
146
+ "kx": obj.wavevectors[:, 0],
147
+ "ky": obj.wavevectors[:, 1],
148
+ }
149
+ table["kz"] = obj.wavevectors[:, 2]
150
+ table.update(
151
+ {f"band_{n + 1}": obj.frequencies[:, n] for n in range(obj.frequencies.shape[1])}
152
+ )
153
+ return write_table(path, table, **options)
154
+ return save_figure(obj.plot().figure, path, **options)
155
+ if isinstance(obj, Bifurcation):
156
+ if suffix in TABLES:
157
+ rows = []
158
+ for row in obj.summary():
159
+ base = {k: row[k] for k in ("irrep", "dim", "multiplicity", "load")}
160
+ if row["patterns"]:
161
+ rows.extend({**base, **p} for p in row["patterns"])
162
+ else:
163
+ rows.append(base)
164
+ return write_table(path, rows, **options)
165
+ if suffix == ".vtu":
166
+ return obj.write(path, **options)
167
+ return save_figure(obj.figure(options.pop("frame"), **options), path)
168
+ if isinstance(obj, Microstructure):
169
+ return save_microstructure(obj, path, **options)
170
+ if isinstance(obj, VoxelImage) or (
171
+ isinstance(obj, (list, tuple)) and obj and all(isinstance(o, VoxelImage) for o in obj)
172
+ ):
173
+ image = obj if isinstance(obj, VoxelImage) else obj[0]
174
+ if suffix in TABLES:
175
+ return write_table(path, _voxel_table(image), **options)
176
+ if suffix in FIGURES and suffix not in (".tif", ".tiff"):
177
+ from morphogen.viz.figures import slices_figure
178
+
179
+ return save_figure(slices_figure(image, **options), path)
180
+ return save_image(obj, path, **options)
181
+ if hasattr(obj, "nodes") and (hasattr(obj, "elements") or hasattr(obj, "faces")):
182
+ if suffix in TABLES:
183
+ return write_tables(path, _mesh_tables(obj))
184
+ if suffix in BITMAP and hasattr(obj, "elements"):
185
+ from PIL import Image
186
+
187
+ from morphogen.viz.video import turntable_frames
188
+
189
+ frame = turntable_frames(obj, frames=1, **options)[0]
190
+ path.parent.mkdir(parents=True, exist_ok=True)
191
+ Image.fromarray(frame).save(path)
192
+ return path
193
+ return save_mesh(obj, path, **options)
194
+ if isinstance(obj, (dict, list, tuple, np.ndarray)):
195
+ return write_table(path, obj, **options)
196
+ raise TypeError(f"export: no writer for {type(obj).__name__} to {suffix or 'a folder'}")
@@ -0,0 +1,158 @@
1
+ """Explicit ("vector") geometry: JSON descriptions, CSV tables and Gmsh scripts."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import json
6
+ from pathlib import Path
7
+
8
+ import numpy as np
9
+
10
+ from morphogen._version import __version__
11
+ from morphogen.models.base import Microstructure
12
+ from morphogen.models.tessellation import Tessellation
13
+ from morphogen.models.union import PrimitiveUnion
14
+
15
+ #: Relative enlargement of the spheres closing round-capped cylinders in Gmsh scripts.
16
+ CAP_ENLARGEMENT = 0.01
17
+
18
+
19
+ def write_json(path, micro: Microstructure) -> Path:
20
+ """Full description of a realization; :func:`read_json` restores it exactly."""
21
+ path = Path(path)
22
+ with open(path, "w", encoding="utf-8", newline="\n") as f:
23
+ json.dump(micro.to_dict(), f)
24
+ f.write("\n")
25
+ return path
26
+
27
+
28
+ def read_json(path) -> Microstructure:
29
+ """A microstructure read from a JSON file
30
+ (:meth:`~morphogen.models.base.Microstructure.from_dict`)."""
31
+ with open(Path(path), encoding="utf-8") as f:
32
+ return Microstructure.from_dict(json.load(f))
33
+
34
+
35
+ def _write_csv(path: Path, columns: dict[str, np.ndarray]) -> Path:
36
+ names = list(columns)
37
+ data = np.column_stack([np.asarray(columns[n], dtype=float) for n in names])
38
+ with open(path, "w", encoding="ascii", newline="\n") as f:
39
+ f.write(",".join(names) + "\n")
40
+ np.savetxt(f, data, delimiter=",", fmt="%.12g")
41
+ return path
42
+
43
+
44
+ def write_csv(path, micro: Microstructure) -> list[Path]:
45
+ """Tables of primitives or cells: ``<stem>_spheres.csv``, ``<stem>_segments.csv``,
46
+ ``<stem>_cells.csv`` (only the relevant ones are written)."""
47
+ path = Path(path)
48
+ stem = path.with_suffix("")
49
+ out = []
50
+ if isinstance(micro, PrimitiveUnion):
51
+ s, g = micro.spheres, micro.segments
52
+ if len(s):
53
+ out.append(
54
+ _write_csv(
55
+ Path(f"{stem}_spheres.csv"),
56
+ {
57
+ "x": s.centers[:, 0],
58
+ "y": s.centers[:, 1],
59
+ "z": s.centers[:, 2],
60
+ "radius": s.radii,
61
+ },
62
+ )
63
+ )
64
+ if len(g):
65
+ out.append(
66
+ _write_csv(
67
+ Path(f"{stem}_segments.csv"),
68
+ {
69
+ "x0": g.start[:, 0],
70
+ "y0": g.start[:, 1],
71
+ "z0": g.start[:, 2],
72
+ "x1": g.end[:, 0],
73
+ "y1": g.end[:, 1],
74
+ "z1": g.end[:, 2],
75
+ "radius": g.radii,
76
+ },
77
+ )
78
+ )
79
+ elif isinstance(micro, Tessellation):
80
+ out.append(_write_csv(Path(f"{stem}_cells.csv"), micro.cell_table()))
81
+ else:
82
+ raise ValueError(f"no tabular description for {type(micro).__name__}")
83
+ return out
84
+
85
+
86
+ def write_geo(path, micro: PrimitiveUnion, *, phase: int = 1, mesh_size: float | None = None):
87
+ """Gmsh (OpenCASCADE) script building phase 1 (the union of the primitives clipped
88
+ by the box) or phase 0 (the box minus the union), for conforming tetrahedral meshing
89
+ with ``gmsh -3 file.geo``. Gmsh is an external program (GPL); nothing is linked.
90
+ """
91
+ if not isinstance(micro, PrimitiveUnion):
92
+ raise ValueError("Gmsh scripts can only be written for unions of spheres and cylinders")
93
+ if phase not in (0, 1):
94
+ raise ValueError("phase: 0 or 1")
95
+ path = Path(path)
96
+ domain = micro.domain
97
+ spheres, segments = micro._covering(0.0)
98
+ lo, size = domain.lower, domain.lengths
99
+ if mesh_size is None:
100
+ radii = np.concatenate([spheres.radii, segments.radii])
101
+ mesh_size = float(np.median(radii)) / 2.0 if len(radii) else float(size.min()) / 10.0
102
+ model = micro.model.name if micro.model is not None else "primitives"
103
+
104
+ def fmt(v):
105
+ return ", ".join(f"{float(x):.12g}" for x in v)
106
+
107
+ lines = [
108
+ f"// morphoGen {__version__}: {model}, phase {phase}",
109
+ "// Mesh with: gmsh -3 <this file> (OpenCASCADE booleans on many objects can be slow)",
110
+ ]
111
+ if domain.periodic:
112
+ lines.append("// The geometry is periodic; impose periodic meshes in Gmsh if needed.")
113
+ lines += [
114
+ 'SetFactory("OpenCASCADE");',
115
+ f"Mesh.MeshSizeMax = {mesh_size:.12g};",
116
+ f"Mesh.MeshSizeMin = {mesh_size / 4:.12g};",
117
+ f"Box(1) = {{{fmt(lo)}, {fmt(size)}}};",
118
+ ]
119
+ if segments.round_caps and len(segments):
120
+ lines.append(
121
+ f"// Round caps: spheres {1 + CAP_ENLARGEMENT:g} times the fibre radius, to avoid "
122
+ "the tangency of equal spheres and cylinders that breaks OpenCASCADE booleans."
123
+ )
124
+ tag = 2
125
+ for c, r in zip(spheres.centers, spheres.radii, strict=True):
126
+ lines.append(f"Sphere({tag}) = {{{fmt(c)}, {r:.12g}}};")
127
+ tag += 1
128
+ for a, b, r in zip(segments.start, segments.end, segments.radii, strict=True):
129
+ lines.append(f"Cylinder({tag}) = {{{fmt(a)}, {fmt(b - a)}, {r:.12g}}};")
130
+ tag += 1
131
+ if segments.round_caps:
132
+ rc = r * (1.0 + CAP_ENLARGEMENT)
133
+ for end in (a, b):
134
+ # caps entirely outside the box do not change the clipped geometry
135
+ if domain.distance_to_box(end)[0] > rc:
136
+ continue
137
+ lines.append(f"Sphere({tag}) = {{{fmt(end)}, {rc:.12g}}};")
138
+ tag += 1
139
+ last = tag - 1
140
+ if last < 2:
141
+ raise ValueError("the microstructure has no primitive inside the box")
142
+ if last > 2:
143
+ lines.append(
144
+ f"grains() = BooleanUnion{{ Volume{{2}}; Delete; }}{{ Volume{{3:{last}}}; Delete; }};"
145
+ )
146
+ else:
147
+ lines.append("grains() = {2};")
148
+ if phase == 1:
149
+ lines.append(
150
+ "solid() = BooleanIntersection{ Volume{grains()}; Delete; }{ Volume{1}; Delete; };"
151
+ )
152
+ else:
153
+ lines.append(
154
+ "solid() = BooleanDifference{ Volume{1}; Delete; }{ Volume{grains()}; Delete; };"
155
+ )
156
+ lines.append(f'Physical Volume("phase_{phase}", {phase + 1}) = {{solid()}};')
157
+ path.write_text("\n".join(lines) + "\n", encoding="ascii")
158
+ return path
morphogen/io/medit.py ADDED
@@ -0,0 +1,147 @@
1
+ """Medit ASCII meshes (``.mesh``) and solutions (``.sol``), as used by MMG."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import re
6
+ from pathlib import Path
7
+
8
+ import numpy as np
9
+
10
+ _BLOCKS = {
11
+ # keyword: number of integer node columns (followed by a reference)
12
+ "Tetrahedra": 4,
13
+ "Triangles": 3,
14
+ "Edges": 2,
15
+ }
16
+
17
+
18
+ def _write_block(f, name: str, data: np.ndarray, fmt: str) -> None:
19
+ f.write(f"{name}\n{len(data)}\n")
20
+ if len(data):
21
+ np.savetxt(f, data, fmt=fmt)
22
+
23
+
24
+ def write_mesh(
25
+ path,
26
+ nodes,
27
+ tetrahedra=None,
28
+ triangles=None,
29
+ *,
30
+ edges=None,
31
+ node_refs=None,
32
+ tet_refs=None,
33
+ tri_refs=None,
34
+ edge_refs=None,
35
+ required_triangles=None,
36
+ required_edges=None,
37
+ required_vertices=None,
38
+ corners=None,
39
+ ridges=None,
40
+ comments=(),
41
+ ) -> Path:
42
+ """Write vertices, tetrahedra, triangles and edges (0-based indices) with references.
43
+
44
+ Nodes with two coordinates make a 2D mesh (``Dimension 2``, for ``mmg2d``).
45
+ ``required_*`` (0-based indices) are written as ``RequiredVertices``,
46
+ ``RequiredEdges`` and ``RequiredTriangles``: MMG keeps them unchanged. ``corners``
47
+ (vertices) and ``ridges`` (edges) mark sharp features. ``comments`` are written as
48
+ ``#`` lines after the header.
49
+ """
50
+ path = Path(path)
51
+ nodes = np.asarray(nodes, dtype=float)
52
+ dim = nodes.shape[1]
53
+ if dim not in (2, 3):
54
+ raise ValueError("write_mesh: nodes with 2 or 3 coordinates")
55
+ with open(path, "w", encoding="ascii", newline="\n") as f:
56
+ f.write(f"MeshVersionFormatted 2\nDimension {dim}\n")
57
+ for line in comments:
58
+ f.write(f"# {line}\n")
59
+ refs = np.zeros(len(nodes), dtype=np.int64) if node_refs is None else node_refs
60
+ fmt = " ".join(["%.17g"] * dim) + " %d"
61
+ _write_block(f, "Vertices", np.column_stack([nodes, refs]), fmt)
62
+ for name, cells, refs in (
63
+ ("Tetrahedra", tetrahedra, tet_refs),
64
+ ("Triangles", triangles, tri_refs),
65
+ ("Edges", edges, edge_refs),
66
+ ):
67
+ if cells is None:
68
+ continue
69
+ cells = np.asarray(cells, dtype=np.int64)
70
+ r = np.zeros(len(cells), dtype=np.int64) if refs is None else np.asarray(refs)
71
+ _write_block(f, name, np.column_stack([cells + 1, r]), "%d")
72
+ for name, req in (
73
+ ("RequiredVertices", required_vertices),
74
+ ("Corners", corners),
75
+ ("RequiredEdges", required_edges),
76
+ ("Ridges", ridges),
77
+ ("RequiredTriangles", required_triangles),
78
+ ):
79
+ if req is not None:
80
+ req = np.asarray(req, dtype=np.int64) + 1
81
+ _write_block(f, name, req[:, None], "%d")
82
+ f.write("End\n")
83
+ return path
84
+
85
+
86
+ def write_sol(path, values, dimension: int = 3) -> Path:
87
+ """Scalar solution at the vertices (e.g. a level-set function, or the sizes of the
88
+ elements) of a mesh of ``dimension`` 3 or 2."""
89
+ path = Path(path)
90
+ values = np.asarray(values, dtype=float).ravel()
91
+ with open(path, "w", encoding="ascii", newline="\n") as f:
92
+ f.write(f"MeshVersionFormatted 2\nDimension {int(dimension)}\nSolAtVertices\n"
93
+ f"{len(values)}\n1 1\n") # fmt: skip
94
+ np.savetxt(f, values, fmt="%.17g")
95
+ f.write("End\n")
96
+ return path
97
+
98
+
99
+ def read_sol(path) -> np.ndarray:
100
+ """The scalar solution at the vertices of a ``.sol`` file (as written by MMG)."""
101
+ tokens = Path(path).read_text(encoding="ascii", errors="replace").split()
102
+ k = tokens.index("SolAtVertices")
103
+ count, n_sol, kind = int(tokens[k + 1]), int(tokens[k + 2]), int(tokens[k + 3])
104
+ if n_sol != 1 or kind != 1:
105
+ raise ValueError(f"{path}: not a scalar solution")
106
+ return np.asarray(tokens[k + 4 : k + 4 + count], dtype=float)
107
+
108
+
109
+ def read_mesh(path) -> dict[str, np.ndarray]:
110
+ """Vertices (n, 3), vertex refs, and for each element block its 0-based
111
+ connectivity and references (keys ``Tetrahedra``, ``Tetrahedra_refs``...); the
112
+ entities that the file marks, as 0-based indices (``Ridges`` and ``RequiredEdges``
113
+ among the edges, ``Corners`` and ``RequiredVertices`` among the vertices,
114
+ ``RequiredTriangles``)."""
115
+ text = Path(path).read_text(encoding="ascii", errors="replace")
116
+ out: dict[str, np.ndarray] = {}
117
+ dim_match = re.search(r"^\s*Dimension\s+(\d)", text, re.M)
118
+ dim = int(dim_match.group(1)) if dim_match else 3
119
+ for match in re.finditer(r"^\s*(Vertices|Tetrahedra|Triangles|Edges)\s*$", text, re.M):
120
+ name = match.group(1)
121
+ rest = text[match.end() :].lstrip()
122
+ count_str, _, body = rest.partition("\n")
123
+ count = int(count_str.split()[0])
124
+ ncol = dim + 1 if name == "Vertices" else _BLOCKS[name] + 1
125
+ if count == 0:
126
+ values = np.zeros((0, ncol))
127
+ else:
128
+ lines = body.split("\n", count)[:count]
129
+ values = np.array(" ".join(lines).split(), dtype=float).reshape(count, ncol)
130
+ if name == "Vertices":
131
+ out["Vertices"] = values[:, :dim]
132
+ out["Vertices_refs"] = values[:, dim].astype(np.int64)
133
+ else:
134
+ out[name] = values[:, :-1].astype(np.int64) - 1
135
+ out[f"{name}_refs"] = values[:, -1].astype(np.int64)
136
+ # the entities that MMG marks: 0-based indices of vertices, edges or triangles
137
+ for match in re.finditer(
138
+ r"^\s*(Ridges|Corners|RequiredVertices|RequiredEdges|RequiredTriangles)\s*$", text, re.M
139
+ ):
140
+ words = text[match.end() :].split(None, 1)
141
+ count = int(words[0])
142
+ values = words[1].split(None, count)[:count] if count else []
143
+ out[match.group(1)] = np.array(values, dtype=np.int64) - 1
144
+ if "Vertices" not in out:
145
+ raise ValueError(f"{path}: no vertices found")
146
+ out["comments"] = re.findall(r"^#\s?(.*)$", text, re.M)
147
+ return out