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/theory.py ADDED
@@ -0,0 +1,162 @@
1
+ """Closed-form results of stochastic geometry used by the models (see docs/theory.md)."""
2
+
3
+ from __future__ import annotations
4
+
5
+ import math
6
+
7
+ import numpy as np
8
+ from scipy import integrate, special, stats
9
+
10
+ #: Poisson-Voronoi tessellation in R^3 (intensity theta of germs):
11
+ #: squared coefficient of variation of the cell volume (Gilbert 1962),
12
+ VORONOI_VOLUME_CV2 = 0.1790
13
+ #: mean number of faces of the typical cell (Meijering 1953), 2 + 48 pi^2 / 35,
14
+ VORONOI_MEAN_FACES = 2.0 + 48.0 * math.pi**2 / 35.0
15
+ #: and cell-boundary area per unit volume S_V = c * theta^(1/3), with
16
+ #: c = (256 pi / 3)^(1/3) Gamma(5/3) / 2 (Meijering 1953).
17
+ VORONOI_SURFACE_COEFF = (256.0 * math.pi / 3.0) ** (1.0 / 3.0) * math.gamma(5.0 / 3.0) / 2.0
18
+
19
+ #: Jamming (saturation) volume fraction of random sequential addition of equal spheres.
20
+ RSA_JAMMING_FRACTION = 0.3841
21
+ #: Fraction of the maximally random jammed packings of equal spheres (Torquato, Truskett
22
+ #: & Debenedetti 2000), which fast Lubachevsky–Stillinger compressions approach.
23
+ MRJ_FRACTION = 0.64
24
+
25
+
26
+ def sphere_covariogram(h, r):
27
+ """Volume of ``B(0, r) ∩ B(h, r)`` for ``|h| = h`` (broadcasts)."""
28
+ h = np.asarray(h, dtype=float)
29
+ r = np.asarray(r, dtype=float)
30
+ v = np.pi / 12.0 * (4.0 * r + h) * (2.0 * r - h) ** 2
31
+ return np.where(h < 2.0 * r, v, 0.0)
32
+
33
+
34
+ def disk_intersection_area(d, r):
35
+ """Area of the intersection of two disks of radius ``r`` whose centres are ``d`` apart."""
36
+ d = np.asarray(d, dtype=float)
37
+ x = np.clip(d / (2.0 * r), 0.0, 1.0)
38
+ a = 2.0 * r * r * np.arccos(x) - 0.5 * d * np.sqrt(np.maximum(4.0 * r * r - d * d, 0.0))
39
+ return np.where(d < 2.0 * r, a, 0.0)
40
+
41
+
42
+ def lens_area(d, r1, r2):
43
+ """Area of the intersection of two disks of radii ``r1`` and ``r2`` whose centres are
44
+ ``d`` apart (broadcasts): the smaller disk when it lies in the other, else the two
45
+ circular segments cut by their common chord."""
46
+ d, r1, r2 = np.broadcast_arrays(*(np.asarray(x, dtype=float) for x in (d, r1, r2)))
47
+ inside = d <= np.abs(r1 - r2)
48
+ out = np.where(inside, np.pi * np.minimum(r1, r2) ** 2, 0.0)
49
+ part = ~inside & (d < r1 + r2)
50
+ if np.any(part):
51
+ dd, a, b = d[part], r1[part], r2[part]
52
+ ca = np.clip((dd * dd + a * a - b * b) / (2.0 * dd * a), -1.0, 1.0)
53
+ cb = np.clip((dd * dd + b * b - a * a) / (2.0 * dd * b), -1.0, 1.0)
54
+ k = (-dd + a + b) * (dd + a - b) * (dd - a + b) * (dd + a + b)
55
+ out[part] = (
56
+ a * a * np.arccos(ca) + b * b * np.arccos(cb) - 0.5 * np.sqrt(np.maximum(k, 0.0))
57
+ )
58
+ return out
59
+
60
+
61
+ def cylinder_covariogram(along, across, radius, length):
62
+ """Volume of ``K ∩ (K + h)`` for the cylinder ``K`` of ``radius`` and ``length`` (flat
63
+ caps), ``h`` of components ``along = |h·u|`` and ``across = |h × u|`` relative to its
64
+ axis ``u`` (broadcasts): ``(l - along)+ lens(across)`` (Peyrega et al. 2009, eq. 15)."""
65
+ along = np.abs(np.asarray(along, dtype=float))
66
+ return np.maximum(length - along, 0.0) * disk_intersection_area(across, radius)
67
+
68
+
69
+ #: Gauss-Legendre nodes per piece of the integrals along the axis of spherocylinders
70
+ _CAPSULE_NODES = 24
71
+
72
+
73
+ def spherocylinder_covariogram(along, across, radius, length):
74
+ """Volume of ``K ∩ (K + h)`` for the spherocylinder ``K`` (round caps) of ``radius``
75
+ around an axis of ``length``, ``h`` of components ``along`` and ``across`` its axis
76
+ (broadcasts): the integral along the axis of the lens of the two sections, disks of
77
+ the radii ``rho(z)`` and ``rho(z - along)`` of the profile (``r`` on the axis, ``sqrt(r^2
78
+ - z^2)`` over the caps), ``across`` apart, by Gauss-Legendre over the pieces between
79
+ the ends of the axes and of the caps and the height where the facing caps have equal
80
+ sections (exact on the cylinders: ``(l - along)+ lens``)."""
81
+ a = np.abs(np.asarray(along, dtype=float))
82
+ a, d, r, ell = np.broadcast_arrays(
83
+ a, *(np.asarray(x, dtype=float) for x in (across, radius, length))
84
+ )
85
+ lo, hi = a - r, ell + r # the axis of K from 0 to l, that of K + h from a to a + l
86
+ cuts = np.stack([lo, np.zeros_like(a), ell, a, a + ell, 0.5 * (ell + a), hi], axis=-1)
87
+ cuts = np.sort(np.clip(cuts, lo[..., None], np.maximum(lo, hi)[..., None]), axis=-1)
88
+ x, w = np.polynomial.legendre.leggauss(_CAPSULE_NODES)
89
+ half = 0.5 * np.diff(cuts, axis=-1) # (..., 6)
90
+ z = 0.5 * (cuts[..., 1:] + cuts[..., :-1])[..., None] + half[..., None] * x # (..., 6, m)
91
+
92
+ def profile(t): # the radius of the section of K at the height t
93
+ out = np.sqrt(
94
+ np.maximum(r[..., None, None] ** 2 - np.maximum(-t, t - ell[..., None, None]) ** 2, 0.0)
95
+ )
96
+ return np.where((t >= 0.0) & (t <= ell[..., None, None]), r[..., None, None], out)
97
+
98
+ area = lens_area(d[..., None, None], profile(z), profile(z - a[..., None, None]))
99
+ return np.sum(half * np.sum(w * area, axis=-1), axis=-1)
100
+
101
+
102
+ def oriented_covariance(q: float, rate: float, covariogram, h, orientation, direction=None):
103
+ """``C(h) = 1 - 2 q + Q(h)`` of a Boolean model of grains of axes drawn from
104
+ ``orientation`` (fibres, or the cylinders of Poisson lines): ``Q(h) = q^2 exp(rate
105
+ E_u[covariogram(|h|, b)])``, ``covariogram(h, b)`` (broadcasting, ``b`` the angle between
106
+ ``h`` and the axis of a grain) its mean geometric covariogram over the sizes of the
107
+ grains, averaged over the angles of :func:`morphogen.orientations.angle_weights`. Along
108
+ ``direction`` (a vector), or, for isotropic axes, along any; without a direction, the
109
+ covariance of anisotropic axes averaged over the directions of ``h`` (72 directions of
110
+ a half sphere: 6 Gauss-Legendre cosines and 12 azimuths), the mean taken of ``Q``."""
111
+ from morphogen.orientations import ANGLE_GRID, Isotropic, angle_weights, half_sphere
112
+
113
+ h = np.asarray(h, dtype=float)
114
+ flat = np.abs(h.reshape(-1))
115
+ if direction is not None or isinstance(orientation, Isotropic):
116
+ b, w = angle_weights(orientation, direction)
117
+ big_q = q * q * np.exp(rate * (covariogram(flat[:, None], b[None, :]) @ w))
118
+ else: # the mean over the directions of h: the angles on the grid
119
+ grid = np.linspace(0.0, 0.5 * np.pi, ANGLE_GRID)
120
+ table = covariogram(flat[:, None], grid[None, :])
121
+ big_q = np.zeros(len(flat))
122
+ for u, wu in zip(*half_sphere(6), strict=True):
123
+ big_q += (
124
+ wu * q * q * np.exp(rate * (table @ angle_weights(orientation, u, grid=True)[1]))
125
+ )
126
+ return (1.0 - 2.0 * q + big_q).reshape(h.shape)
127
+
128
+
129
+ def boolean_intensity(volume_fraction: float, mean_grain_volume: float) -> float:
130
+ """Intensity theta of a Boolean model: p = 1 - exp(-theta * E[V])."""
131
+ return -math.log1p(-volume_fraction) / mean_grain_volume
132
+
133
+
134
+ def boolean_volume_fraction(intensity: float, mean_grain_volume: float) -> float:
135
+ """The volume fraction ``1 - exp(-θ V̄)`` of a Boolean model of intensity θ and mean grain
136
+ volume V̄."""
137
+ return -math.expm1(-intensity * mean_grain_volume)
138
+
139
+
140
+ def bivariate_normal_upper(level, rho):
141
+ """P(X > level, Y > level) for standard normals X, Y of correlation ``rho``.
142
+
143
+ Uses P = (1 - Phi(l))^2 + 1/(2 pi) int_0^asin(rho) exp(-l^2 / (1 + sin t)) dt.
144
+ """
145
+ rho = np.asarray(rho, dtype=float)
146
+ q = stats.norm.sf(level)
147
+ x, w = np.polynomial.legendre.leggauss(64)
148
+ a = np.arcsin(np.clip(rho, -1.0, 1.0))[..., None]
149
+ t = 0.5 * a * (x + 1.0)
150
+ f = np.exp(-(level**2) / (1.0 + np.sin(t)))
151
+ return q * q + 0.5 * a[..., 0] * np.sum(w * f, axis=-1) / (2.0 * math.pi)
152
+
153
+
154
+ def radial_integral(f, upper: float) -> float:
155
+ """``int_{|h| < upper} f(|h|) dh`` in R^3 for an isotropic function ``f``."""
156
+ value, _ = integrate.quad(lambda h: 4.0 * math.pi * h * h * f(h), 0.0, upper, limit=200)
157
+ return float(value)
158
+
159
+
160
+ def normal_quantile(p: float) -> float:
161
+ """The quantile of order ``p`` of the standard normal distribution."""
162
+ return float(special.ndtri(p))
@@ -0,0 +1,12 @@
1
+ """Visualization: images without dependencies, figures with matplotlib (``[plot]``).
2
+
3
+ * :mod:`morphogen.viz.png`: colour maps, sections and PNG encoding (standard library);
4
+ * :mod:`morphogen.viz.figures`: sections, periodic tilings, 3D surfaces, histories,
5
+ transformation kinetics, animated GIFs of the formation of structures, the beams of
6
+ frames coloured by their forces or energies and the replicas of networks of
7
+ non-identical beams.
8
+ """
9
+
10
+ from morphogen.viz.png import colormap, decode_png, encode_png, slice_of, to_rgb, upscale
11
+
12
+ __all__ = ["colormap", "decode_png", "encode_png", "slice_of", "to_rgb", "upscale"]
@@ -0,0 +1,244 @@
1
+ """Figures as files: bitmaps (``.png``, ``.tif``/``.tiff``), vector graphics (``.svg``,
2
+ ``.pdf``, ``.eps``) and TikZ (``.tex``, ``.tikz``): the pgfplots code of a matplotlib
3
+ figure, for LaTeX documents.
4
+
5
+ The TikZ code has one ``axis`` per axes of the figure, placed as in the figure, with its
6
+ labels, title, limits, scales, ticks and legend: the lines (``plot``) as coordinates, the
7
+ markers of scatter plots, line collections (frames, contours) as coordinate lists cut by
8
+ ``nan`` (``unbounded coords=jump``), filled rectangles (``axhspan``, bars) and polygons as
9
+ filled paths, texts as nodes, and images (slices, maps) as PNG files beside the ``.tex``
10
+ (``\\addplot graphics``). Use it with ``\\usepackage{pgfplots}``,
11
+ ``\\pgfplotsset{compat=1.18}``.
12
+ """
13
+
14
+ from __future__ import annotations
15
+
16
+ from pathlib import Path
17
+
18
+ import numpy as np
19
+
20
+ BITMAP = (".png", ".tif", ".tiff", ".jpg", ".jpeg")
21
+ VECTOR = (".svg", ".pdf", ".eps", ".ps")
22
+ TIKZ = (".tex", ".tikz", ".pgf")
23
+
24
+
25
+ def save_figure(fig, path, *, dpi: int = 200, transparent: bool = False) -> Path:
26
+ """Save a matplotlib figure by the suffix of ``path``: bitmaps at ``dpi``, vector
27
+ graphics, or the TikZ code of :func:`tikz` (its images beside it)."""
28
+ path = Path(path)
29
+ path.parent.mkdir(parents=True, exist_ok=True)
30
+ suffix = path.suffix.lower()
31
+ if suffix in TIKZ:
32
+ path.write_text(tikz(fig, path), encoding="utf-8")
33
+ elif suffix in BITMAP or suffix in VECTOR:
34
+ options = {"dpi": dpi, "transparent": transparent, "bbox_inches": "tight"}
35
+ if suffix in (".tif", ".tiff"):
36
+ options["pil_kwargs"] = {"compression": "tiff_lzw"}
37
+ fig.savefig(path, **options)
38
+ else:
39
+ raise ValueError(f"save_figure: a suffix among {sorted(BITMAP + VECTOR + TIKZ)}")
40
+ return path
41
+
42
+
43
+ def _number(x: float) -> str:
44
+ if not np.isfinite(x):
45
+ return "nan"
46
+ return f"{x:.6g}"
47
+
48
+
49
+ def _color(c) -> str:
50
+ from matplotlib.colors import to_rgba
51
+
52
+ r, g, b, _ = to_rgba(c)
53
+ return f"{{rgb,1:red,{r:.4f};green,{g:.4f};blue,{b:.4f}}}"
54
+
55
+
56
+ def _alpha(c, alpha=None) -> float:
57
+ from matplotlib.colors import to_rgba
58
+
59
+ a = to_rgba(c)[3]
60
+ return float(a if alpha is None else alpha * a)
61
+
62
+
63
+ def _tex(text: str) -> str:
64
+ """Matplotlib text (mathtext between $) to LaTeX: special characters escaped outside
65
+ math."""
66
+ parts = str(text).replace(r"\mathdefault", "").split("$")
67
+ out = []
68
+ for k, part in enumerate(parts):
69
+ if k % 2:
70
+ out.append("$" + part + "$")
71
+ else:
72
+ for a, b in (
73
+ ("\\", r"\textbackslash{}"),
74
+ ("&", r"\&"),
75
+ ("%", r"\%"),
76
+ ("#", r"\#"),
77
+ ("_", r"\_"),
78
+ ):
79
+ part = part.replace(a, b)
80
+ out.append(part.replace("{", r"\{").replace("}", r"\}"))
81
+ return "".join(out)
82
+
83
+
84
+ _DASHES = {"-": "solid", "--": "dashed", ":": "dotted", "-.": "dashdotted"}
85
+ _MARKS = {
86
+ "o": "*",
87
+ ".": "*",
88
+ "s": "square*",
89
+ "^": "triangle*",
90
+ "v": "triangle*",
91
+ "d": "diamond*",
92
+ "D": "diamond*",
93
+ "x": "x",
94
+ "+": "+",
95
+ "*": "star",
96
+ }
97
+
98
+
99
+ def _coordinates(x, y) -> str:
100
+ return " ".join(
101
+ f"({_number(a)},{_number(b)})" for a, b in zip(np.ravel(x), np.ravel(y), strict=True)
102
+ )
103
+
104
+
105
+ def _axis(ax, path: Path, index: int, fig_size, origin) -> list[str]:
106
+ from matplotlib.collections import LineCollection, PathCollection, PolyCollection
107
+ from matplotlib.image import AxesImage
108
+ from matplotlib.patches import Polygon, Rectangle
109
+
110
+ box = ax.get_position()
111
+ width, height = box.width * fig_size[0], box.height * fig_size[1]
112
+ x0, y0 = box.x0 * fig_size[0] - origin[0], box.y0 * fig_size[1] - origin[1]
113
+ xmin, xmax = ax.get_xlim()
114
+ ymin, ymax = ax.get_ylim()
115
+ opts = [
116
+ f"at={{({x0:.3f}cm,{y0:.3f}cm)}}",
117
+ f"width={width:.3f}cm",
118
+ f"height={height:.3f}cm",
119
+ "scale only axis",
120
+ f"xmin={_number(xmin)}",
121
+ f"xmax={_number(xmax)}",
122
+ f"ymin={_number(ymin)}",
123
+ f"ymax={_number(ymax)}",
124
+ "unbounded coords=jump",
125
+ ]
126
+ if ax.get_xscale() == "log":
127
+ opts.append("xmode=log")
128
+ if ax.get_yscale() == "log":
129
+ opts.append("ymode=log")
130
+ if ax.get_xlabel():
131
+ opts.append(f"xlabel={{{_tex(ax.get_xlabel())}}}")
132
+ if ax.get_ylabel():
133
+ opts.append(f"ylabel={{{_tex(ax.get_ylabel())}}}")
134
+ if ax.get_title():
135
+ opts.append(f"title={{{_tex(ax.get_title())}}}")
136
+ if not ax.axison:
137
+ opts.append("hide axis")
138
+ from matplotlib.ticker import FixedFormatter, FuncFormatter
139
+
140
+ labels = [t.get_text() for t in ax.get_xticklabels()]
141
+ explicit = isinstance(ax.xaxis.get_major_formatter(), (FixedFormatter, FuncFormatter))
142
+ if explicit and any(labels):
143
+ ticks = ax.get_xticks()
144
+ opts.append("xtick={" + ",".join(_number(t) for t in ticks) + "}")
145
+ opts.append("xticklabels={" + ",".join("{" + _tex(t) + "}" for t in labels) + "}")
146
+ if ax.get_aspect() in ("equal", 1.0):
147
+ opts.append("axis equal image")
148
+ body = []
149
+ for k, image in enumerate(im for im in ax.get_images() if isinstance(im, AxesImage)):
150
+ name = f"{path.stem}-{index}-{k}.png"
151
+ rgba = np.asarray(image.to_rgba(image.get_array(), bytes=True))
152
+ if image.origin == "lower": # the first row of the PNG is the top of the axes
153
+ rgba = rgba[::-1]
154
+ from PIL import Image
155
+
156
+ Image.fromarray(rgba).save(path.with_name(name))
157
+ e = image.get_extent()
158
+ body.append(
159
+ f"\\addplot graphics[xmin={_number(e[0])},xmax={_number(e[1])},"
160
+ f"ymin={_number(min(e[2:]))},ymax={_number(max(e[2:]))}] {{{name}}};"
161
+ )
162
+ for patch in ax.patches:
163
+ if isinstance(patch, (Rectangle, Polygon)):
164
+ xy = patch.get_transform().transform(patch.get_path().vertices)
165
+ xy = ax.transData.inverted().transform(xy)
166
+ fill = patch.get_facecolor()
167
+ body.append(
168
+ f"\\fill[color={_color(fill)}, opacity={_alpha(fill):.3f}] "
169
+ + " -- ".join(f"(axis cs:{_number(a)},{_number(b)})" for a, b in xy)
170
+ + " -- cycle;"
171
+ )
172
+ for coll in ax.collections:
173
+ if isinstance(coll, LineCollection):
174
+ segs = coll.get_segments()
175
+ colors = coll.get_colors() if len(coll.get_colors()) else ["k"]
176
+ widths = coll.get_linewidths() if len(coll.get_linewidths()) else [1.0]
177
+ xs, ys = [], []
178
+ for s in segs:
179
+ xs.extend([*s[:, 0], np.nan])
180
+ ys.extend([*s[:, 1], np.nan])
181
+ width = 0.0353 * widths[0]
182
+ body.append(
183
+ f"\\addplot[color={_color(colors[0])}, line width={width:.3f}cm, forget plot] "
184
+ f"coordinates {{{_coordinates(xs, ys)}}};"
185
+ )
186
+ elif isinstance(coll, PathCollection):
187
+ off = coll.get_offsets()
188
+ colors = coll.get_facecolors() if len(coll.get_facecolors()) else ["C0"]
189
+ body.append(
190
+ f"\\addplot[only marks, mark=*, mark size=1pt, color={_color(colors[0])}] "
191
+ f"coordinates {{{_coordinates(off[:, 0], off[:, 1])}}};"
192
+ )
193
+ elif isinstance(coll, PolyCollection):
194
+ for poly, fc in zip(coll.get_paths(), coll.get_facecolors(), strict=False):
195
+ body.append(
196
+ f"\\fill[color={_color(fc)}, opacity={_alpha(fc):.3f}] "
197
+ + " -- ".join(f"(axis cs:{_number(a)},{_number(b)})" for a, b in poly.vertices)
198
+ + " -- cycle;"
199
+ )
200
+ legend = ax.get_legend()
201
+ labelled = {t.get_text() for t in legend.get_texts()} if legend else set()
202
+ for line in ax.get_lines():
203
+ x, y = line.get_data()
204
+ if np.size(x) == 0:
205
+ continue
206
+ style = [
207
+ f"color={_color(line.get_color())}",
208
+ f"line width={0.0353 * line.get_linewidth():.3f}cm",
209
+ _DASHES.get(line.get_linestyle(), "solid"),
210
+ ]
211
+ marker = line.get_marker()
212
+ style.append(f"mark={_MARKS[marker]}" if marker in _MARKS else "mark=none")
213
+ if line.get_linestyle() in ("None", "none", " ", ""):
214
+ style.append("only marks")
215
+ label = line.get_label()
216
+ if label not in labelled:
217
+ style.append("forget plot")
218
+ body.append(f"\\addplot[{', '.join(style)}] coordinates {{{_coordinates(x, y)}}};")
219
+ if label in labelled:
220
+ body.append(f"\\addlegendentry{{{_tex(label)}}}")
221
+ for text in ax.texts:
222
+ x, y = text.get_position()
223
+ body.append(f"\\node at (axis cs:{_number(x)},{_number(y)}) {{{_tex(text.get_text())}}};")
224
+ return ["\\begin{axis}[" + ", ".join(opts) + "]", *body, "\\end{axis}"]
225
+
226
+
227
+ def tikz(fig, path=None) -> str:
228
+ """The pgfplots code of a matplotlib figure (see the module); its images are written
229
+ as PNG files beside ``path`` (by default ``figure.tex`` in the working directory)."""
230
+ path = Path("figure.tex") if path is None else Path(path)
231
+ size = fig.get_size_inches() * 2.54
232
+ axes = [ax for ax in fig.axes if ax.get_label() != "<colorbar>"]
233
+ origin = (
234
+ min(ax.get_position().x0 for ax in axes) * size[0] if axes else 0.0,
235
+ min(ax.get_position().y0 for ax in axes) * size[1] if axes else 0.0,
236
+ )
237
+ lines = [
238
+ "% pgfplots code written by morphoGen; \\usepackage{pgfplots} \\pgfplotsset{compat=1.18}",
239
+ "\\begin{tikzpicture}",
240
+ ]
241
+ for k, ax in enumerate(axes):
242
+ lines.extend(_axis(ax, path, k, size, origin))
243
+ lines.append("\\end{tikzpicture}")
244
+ return "\n".join(lines) + "\n"