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/domain.py ADDED
@@ -0,0 +1,203 @@
1
+ """Simulation domains (boxes) and the voxel grids that discretize them.
2
+
3
+ Conventions used throughout morphoGen:
4
+
5
+ * a domain is the axis-aligned box ``[origin, origin + size)``;
6
+ * a voxel grid of shape ``(nx, ny, nz)`` splits the domain into equal voxels,
7
+ voxel ``(i, j, k)`` being centred at ``origin + (i + 1/2, j + 1/2, k + 1/2) * spacing``;
8
+ * arrays are indexed ``[i, j, k]`` along ``(x, y, z)``; file writers convert to the
9
+ x-fastest order used by VTK, MetaImage and FFT codes.
10
+ """
11
+
12
+ from __future__ import annotations
13
+
14
+ from dataclasses import dataclass
15
+
16
+ import numpy as np
17
+
18
+ from morphogen._utils import as_triplet
19
+
20
+
21
+ @dataclass(frozen=True)
22
+ class Domain:
23
+ """Axis-aligned box in which microstructures are generated.
24
+
25
+ Parameters
26
+ ----------
27
+ size
28
+ Edge lengths (a single value for a cube), in the length unit of the study.
29
+ origin
30
+ Lower corner of the box.
31
+ periodic
32
+ If true the box is a torus: grains, fibres and cells wrap around the faces so
33
+ that the sample tiles space (periodic boundary conditions, FFT solvers).
34
+ If false the sample is an unbiased window cut from the infinite random medium.
35
+ unit
36
+ Name of the length unit (metadata only, e.g. ``"um"``).
37
+ """
38
+
39
+ size: tuple[float, float, float]
40
+ origin: tuple[float, float, float] = (0.0, 0.0, 0.0)
41
+ periodic: bool = True
42
+ unit: str = ""
43
+
44
+ def __post_init__(self) -> None:
45
+ object.__setattr__(self, "size", as_triplet(self.size, "domain.size", positive=True))
46
+ object.__setattr__(self, "origin", as_triplet(self.origin, "domain.origin"))
47
+ object.__setattr__(self, "periodic", bool(self.periodic))
48
+ object.__setattr__(self, "unit", str(self.unit))
49
+
50
+ @classmethod
51
+ def cube(cls, length: float, *, periodic: bool = True, origin=(0.0, 0.0, 0.0), unit: str = ""):
52
+ """Cubic domain of edge ``length``."""
53
+ return cls(size=(length, length, length), origin=origin, periodic=periodic, unit=unit)
54
+
55
+ @property
56
+ def lower(self) -> np.ndarray:
57
+ return np.array(self.origin, dtype=float)
58
+
59
+ @property
60
+ def upper(self) -> np.ndarray:
61
+ return self.lower + np.array(self.size, dtype=float)
62
+
63
+ @property
64
+ def center(self) -> np.ndarray:
65
+ return self.lower + 0.5 * np.array(self.size, dtype=float)
66
+
67
+ @property
68
+ def lengths(self) -> np.ndarray:
69
+ return np.array(self.size, dtype=float)
70
+
71
+ @property
72
+ def volume(self) -> float:
73
+ return float(np.prod(self.size))
74
+
75
+ @property
76
+ def surface_area(self) -> float:
77
+ lx, ly, lz = self.size
78
+ return 2.0 * (lx * ly + ly * lz + lz * lx)
79
+
80
+ @property
81
+ def diagonal(self) -> float:
82
+ return float(np.linalg.norm(self.size))
83
+
84
+ def dilated(self, margin: float) -> Domain:
85
+ """Non-periodic box enlarged by ``margin`` on every side."""
86
+ m = float(margin)
87
+ return Domain(
88
+ size=tuple(s + 2 * m for s in self.size),
89
+ origin=tuple(o - m for o in self.origin),
90
+ periodic=False,
91
+ unit=self.unit,
92
+ )
93
+
94
+ def contains(self, points) -> np.ndarray:
95
+ """Boolean mask of the points lying in ``[lower, upper)``."""
96
+ p = np.asarray(points, dtype=float).reshape(-1, 3)
97
+ return np.all((p >= self.lower) & (p < self.upper), axis=1)
98
+
99
+ def wrap(self, points) -> np.ndarray:
100
+ """Bring points back into the box by periodicity."""
101
+ p = np.asarray(points, dtype=float)
102
+ lo, ln = self.lower, self.lengths
103
+ w = lo + np.mod(p - lo, ln)
104
+ # np.mod can return the period itself for tiny negative inputs
105
+ return np.where(w >= lo + ln, lo, w)
106
+
107
+ def distance_to_box(self, points) -> np.ndarray:
108
+ """Euclidean distance from points to the box (0 inside)."""
109
+ p = np.asarray(points, dtype=float).reshape(-1, 3)
110
+ d = np.maximum(np.maximum(self.lower - p, p - self.upper), 0.0)
111
+ return np.sqrt(np.sum(d * d, axis=1))
112
+
113
+ def grid(self, shape=None, *, voxel_size=None) -> Grid:
114
+ """Voxel grid covering the domain.
115
+
116
+ Give either ``shape`` (an integer is the number of voxels along the longest edge,
117
+ voxels being as cubic as possible; or three integers) or ``voxel_size``.
118
+ """
119
+ return Grid.for_domain(self, shape=shape, voxel_size=voxel_size)
120
+
121
+ def to_dict(self) -> dict:
122
+ return {
123
+ "size": list(self.size),
124
+ "origin": list(self.origin),
125
+ "periodic": self.periodic,
126
+ "unit": self.unit,
127
+ }
128
+
129
+ @classmethod
130
+ def from_dict(cls, data: dict) -> Domain:
131
+ unknown = set(data) - {"size", "origin", "periodic", "unit"}
132
+ if unknown:
133
+ raise ValueError(f"domain: unknown keys {sorted(unknown)}")
134
+ if "size" not in data:
135
+ raise ValueError("domain: 'size' is required")
136
+ return cls(
137
+ size=data["size"],
138
+ origin=data.get("origin", (0.0, 0.0, 0.0)),
139
+ periodic=data.get("periodic", True),
140
+ unit=data.get("unit", ""),
141
+ )
142
+
143
+
144
+ @dataclass(frozen=True)
145
+ class Grid:
146
+ """Regular voxel grid over a domain (see the module docstring for conventions)."""
147
+
148
+ domain: Domain
149
+ shape: tuple[int, int, int]
150
+
151
+ def __post_init__(self) -> None:
152
+ shape = as_triplet(self.shape, "grid.shape", positive=True, integer=True)
153
+ object.__setattr__(self, "shape", shape)
154
+
155
+ @classmethod
156
+ def for_domain(cls, domain: Domain, shape=None, voxel_size=None) -> Grid:
157
+ if (shape is None) == (voxel_size is None):
158
+ raise ValueError("give exactly one of 'shape' and 'voxel_size'")
159
+ lengths = domain.lengths
160
+ if voxel_size is not None:
161
+ h = as_triplet(voxel_size, "voxel_size", positive=True)
162
+ n = np.maximum(1, np.rint(lengths / np.array(h))).astype(int)
163
+ elif np.ndim(shape) == 0:
164
+ n_long = int(shape)
165
+ if n_long < 1 or n_long != shape:
166
+ raise ValueError(f"shape: expected a positive integer, got {shape!r}")
167
+ h = lengths.max() / n_long
168
+ n = np.maximum(1, np.rint(lengths / h)).astype(int)
169
+ else:
170
+ n = np.array(as_triplet(shape, "shape", positive=True, integer=True))
171
+ return cls(domain=domain, shape=tuple(int(v) for v in n))
172
+
173
+ @property
174
+ def spacing(self) -> np.ndarray:
175
+ return self.domain.lengths / np.array(self.shape, dtype=float)
176
+
177
+ @property
178
+ def origin(self) -> np.ndarray:
179
+ return self.domain.lower
180
+
181
+ @property
182
+ def n_voxels(self) -> int:
183
+ return int(np.prod(self.shape))
184
+
185
+ @property
186
+ def voxel_volume(self) -> float:
187
+ return float(np.prod(self.spacing))
188
+
189
+ def centers(self, axis: int) -> np.ndarray:
190
+ """Coordinates of the voxel centres along ``axis``."""
191
+ h = self.spacing[axis]
192
+ return self.origin[axis] + (np.arange(self.shape[axis]) + 0.5) * h
193
+
194
+ def center_points(self, k_start: int = 0, k_stop: int | None = None) -> np.ndarray:
195
+ """Voxel centres of the slab ``k_start <= k < k_stop`` as an (n, 3) array.
196
+
197
+ Points are ordered like ``array[:, :, k_start:k_stop].ravel()`` (C order).
198
+ """
199
+ k_stop = self.shape[2] if k_stop is None else k_stop
200
+ x, y = self.centers(0), self.centers(1)
201
+ z = self.centers(2)[k_start:k_stop]
202
+ gx, gy, gz = np.meshgrid(x, y, z, indexing="ij")
203
+ return np.stack([gx.ravel(), gy.ravel(), gz.ravel()], axis=1)
@@ -0,0 +1,179 @@
1
+ """Explicit dynamics with OpenRadioss: crushing, tension, shear and impacts of a
2
+ morphology at the rates of crashes, shocks and drops.
3
+
4
+ morphoGen writes the inputs of the explicit finite element solver OpenRadioss for the
5
+ mesh of a morphology (its voxels or a conforming mesh of its level set), the materials of
6
+ its phases and a loading (:mod:`morphogen.io.radioss`), runs them (:func:`run_openradioss`,
7
+ an installation found or installed by :func:`install_openradioss`) and reads the results
8
+ back (:func:`read_explicit_run`): the nominal stress-strain curves of its faces, its
9
+ energies and its fields over time. :func:`explicit_test` does it all.
10
+
11
+ >>> from morphogen import dynamics
12
+ >>> test = dynamics.explicit_test(micro, {0: "void", 1: {"young": 70e3, "poisson": 0.3,
13
+ ... "density": 2.7e-9, "plasticity": {"yield": 200, "hardening": 500}}},
14
+ ... {"kind": "compression", "strain": 0.5, "strain_rate": 500}, "crush") # doctest: +SKIP
15
+ >>> dynamics.summary(test.result)["plateau stress (20-40 %)"] # doctest: +SKIP
16
+ """
17
+
18
+ from __future__ import annotations
19
+
20
+ from dataclasses import dataclass
21
+ from pathlib import Path
22
+
23
+ from morphogen.dynamics.model import (
24
+ LOADINGS,
25
+ ExplicitLoading,
26
+ ExplicitMaterial,
27
+ JohnsonCook,
28
+ UnitSystem,
29
+ critical_time_step,
30
+ element_lengths,
31
+ explicit_materials,
32
+ explicit_mesh,
33
+ )
34
+ from morphogen.dynamics.openradioss import (
35
+ OpenRadioss,
36
+ RadiossRun,
37
+ convert_outputs,
38
+ default_home,
39
+ find_openradioss,
40
+ has_openradioss,
41
+ install_openradioss,
42
+ release_asset,
43
+ release_info,
44
+ run_openradioss,
45
+ )
46
+ from morphogen.dynamics.results import (
47
+ ExplicitFrame,
48
+ ExplicitResult,
49
+ read_explicit_run,
50
+ summary,
51
+ write_frames,
52
+ write_tables,
53
+ )
54
+
55
+
56
+ @dataclass
57
+ class ExplicitTest:
58
+ """An explicit dynamic test of :func:`explicit_test`: its inputs
59
+ (:class:`~morphogen.io.radioss.RadiossInputs`), its run (None when not run) and its
60
+ results read back (None when not run)."""
61
+
62
+ inputs: object
63
+ run: RadiossRun | None = None
64
+ result: ExplicitResult | None = None
65
+
66
+ @property
67
+ def directory(self) -> Path:
68
+ return Path(self.inputs.directory)
69
+
70
+
71
+ def explicit_test(
72
+ micro,
73
+ materials,
74
+ loading,
75
+ directory,
76
+ *,
77
+ mesh: str = "voxels",
78
+ resolution: int = 24,
79
+ element_size: float | None = None,
80
+ order: int = 1,
81
+ units=None,
82
+ density: float | None = None,
83
+ name: str | None = None,
84
+ frames: int = 50,
85
+ history: int = 1000,
86
+ time_step: float | None = None,
87
+ length_scale: float = 1.0,
88
+ run: bool = True,
89
+ threads: int | None = None,
90
+ mpi: int | None = None,
91
+ installation=None,
92
+ progress=None,
93
+ phase_names: dict | None = None,
94
+ ) -> ExplicitTest:
95
+ """An explicit dynamic test of a morphology in ``directory``: its mesh
96
+ (:func:`explicit_mesh`: ``mesh`` ``"voxels"`` of ``resolution`` voxels along its
97
+ longest edge, or ``"conforming"`` tetrahedra of ``element_size`` and ``order``), the
98
+ inputs of OpenRadioss (:func:`morphogen.io.write_radioss`: ``materials`` a mapping
99
+ phase -> material, :func:`explicit_materials`, ``density`` that of the materials
100
+ that give none; ``loading`` an :class:`ExplicitLoading` or its configuration;
101
+ every value in the ``units``, a :class:`UnitSystem`, Mg mm s by default, the lengths
102
+ of the morphology times ``length_scale``), then, with ``run``, their run
103
+ (:func:`run_openradioss`)
104
+ and their results (:func:`read_explicit_run`). ``progress(fraction, message)``
105
+ follows the run."""
106
+ from morphogen.io.radioss import run_name, write_radioss
107
+
108
+ spec = explicit_materials(materials, density=density)
109
+ loading = ExplicitLoading.from_config(loading)
110
+ if progress:
111
+ progress(0.0, "mesh")
112
+ shape = explicit_mesh(
113
+ micro, spec, mesh=mesh, resolution=resolution, element_size=element_size, order=order
114
+ )
115
+ model = getattr(micro, "kind", None) or type(micro).__name__.lower()
116
+ names = phase_names
117
+ if names is None:
118
+ names = {int(k): str(v) for k, v in (getattr(micro, "phase_names", None) or {}).items()}
119
+ inputs = write_radioss(
120
+ directory,
121
+ shape,
122
+ {q: m for q, m in spec.items() if m is not None},
123
+ loading,
124
+ name=run_name(name or model),
125
+ units=units,
126
+ frames=frames,
127
+ history=history,
128
+ time_step=time_step,
129
+ length_scale=length_scale,
130
+ phase_names=names,
131
+ title=f"{loading.kind} of {model}",
132
+ )
133
+ test = ExplicitTest(inputs)
134
+ if not run:
135
+ return test
136
+
137
+ def scaled(fraction, message=""):
138
+ if progress:
139
+ progress(0.05 + 0.9 * fraction, message)
140
+
141
+ test.run = run_openradioss(
142
+ directory, inputs.name, threads=threads, mpi=mpi, installation=installation, progress=scaled
143
+ )
144
+ test.result = read_explicit_run(directory)
145
+ test.result.warnings[:0] = test.run.warnings
146
+ if progress:
147
+ progress(1.0, "done")
148
+ return test
149
+
150
+
151
+ __all__ = [
152
+ "LOADINGS",
153
+ "ExplicitFrame",
154
+ "ExplicitLoading",
155
+ "ExplicitMaterial",
156
+ "ExplicitResult",
157
+ "ExplicitTest",
158
+ "JohnsonCook",
159
+ "OpenRadioss",
160
+ "RadiossRun",
161
+ "UnitSystem",
162
+ "convert_outputs",
163
+ "critical_time_step",
164
+ "default_home",
165
+ "element_lengths",
166
+ "explicit_materials",
167
+ "explicit_mesh",
168
+ "explicit_test",
169
+ "find_openradioss",
170
+ "has_openradioss",
171
+ "install_openradioss",
172
+ "read_explicit_run",
173
+ "release_asset",
174
+ "release_info",
175
+ "run_openradioss",
176
+ "summary",
177
+ "write_frames",
178
+ "write_tables",
179
+ ]