morphogen 1.0.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (381) hide show
  1. morphogen/__init__.py +60 -0
  2. morphogen/__main__.py +7 -0
  3. morphogen/_platform.py +55 -0
  4. morphogen/_public.py +153 -0
  5. morphogen/_utils.py +80 -0
  6. morphogen/_version.py +1 -0
  7. morphogen/analysis/__init__.py +174 -0
  8. morphogen/analysis/anisotropy.py +135 -0
  9. morphogen/analysis/basic.py +38 -0
  10. morphogen/analysis/cells.py +54 -0
  11. morphogen/analysis/connectivity.py +156 -0
  12. morphogen/analysis/correlation.py +195 -0
  13. morphogen/analysis/covariance.py +80 -0
  14. morphogen/analysis/fractal.py +54 -0
  15. morphogen/analysis/measures.py +188 -0
  16. morphogen/analysis/morphology.py +265 -0
  17. morphogen/analysis/particles.py +160 -0
  18. morphogen/analysis/percolation.py +2034 -0
  19. morphogen/analysis/power_laws.py +143 -0
  20. morphogen/analysis/random_sets.py +351 -0
  21. morphogen/analysis/stereology.py +289 -0
  22. morphogen/analysis/surface.py +107 -0
  23. morphogen/analysis/topology.py +92 -0
  24. morphogen/automata/__init__.py +74 -0
  25. morphogen/automata/engine.py +211 -0
  26. morphogen/automata/growth.py +686 -0
  27. morphogen/automata/lattice.py +143 -0
  28. morphogen/automata/reaction.py +255 -0
  29. morphogen/automata/rules.py +353 -0
  30. morphogen/automata/tilings.py +1715 -0
  31. morphogen/cli.py +3526 -0
  32. morphogen/config.py +2167 -0
  33. morphogen/contact/__init__.py +113 -0
  34. morphogen/contact/experiments.py +368 -0
  35. morphogen/contact/hertz.py +104 -0
  36. morphogen/contact/kernels.py +827 -0
  37. morphogen/contact/periodic.py +278 -0
  38. morphogen/contact/problem.py +578 -0
  39. morphogen/contact/surfaces.py +310 -0
  40. morphogen/coupling/__init__.py +43 -0
  41. morphogen/coupling/ageing.py +143 -0
  42. morphogen/coupling/diffusion.py +226 -0
  43. morphogen/coupling/fenicsx.py +484 -0
  44. morphogen/coupling/oxidation.py +447 -0
  45. morphogen/coupling/plates.py +247 -0
  46. morphogen/design/__init__.py +51 -0
  47. morphogen/design/csp.py +616 -0
  48. morphogen/design/frames.py +277 -0
  49. morphogen/design/search.py +287 -0
  50. morphogen/design/tiles.py +336 -0
  51. morphogen/distributions.py +312 -0
  52. morphogen/domain.py +203 -0
  53. morphogen/dynamics/__init__.py +179 -0
  54. morphogen/dynamics/model.py +638 -0
  55. morphogen/dynamics/openradioss.py +643 -0
  56. morphogen/dynamics/results.py +515 -0
  57. morphogen/fracture/__init__.py +170 -0
  58. morphogen/fracture/bulk.py +349 -0
  59. morphogen/fracture/cohesive.py +1614 -0
  60. morphogen/fracture/ductile.py +557 -0
  61. morphogen/fracture/lefm.py +1168 -0
  62. morphogen/fracture/mixed.py +1178 -0
  63. morphogen/fracture/periodic.py +733 -0
  64. morphogen/fracture/phasefield.py +714 -0
  65. morphogen/fracture/phasefield_finite.py +368 -0
  66. morphogen/fracture/surface.py +572 -0
  67. morphogen/fracture/toughness.py +566 -0
  68. morphogen/gpu.py +108 -0
  69. morphogen/gui/__init__.py +8 -0
  70. morphogen/gui/api.py +1927 -0
  71. morphogen/gui/desktop.py +387 -0
  72. morphogen/gui/icon.png +0 -0
  73. morphogen/gui/index.html +1909 -0
  74. morphogen/gui/server.py +229 -0
  75. morphogen/gui/tools/__init__.py +629 -0
  76. morphogen/gui/tools/compare.py +149 -0
  77. morphogen/gui/tools/contact.py +391 -0
  78. morphogen/gui/tools/couplings.py +1085 -0
  79. morphogen/gui/tools/crackfront.py +245 -0
  80. morphogen/gui/tools/design.py +224 -0
  81. morphogen/gui/tools/dynamics.py +824 -0
  82. morphogen/gui/tools/fracture.py +2586 -0
  83. morphogen/gui/tools/interop.py +1654 -0
  84. morphogen/gui/tools/learning.py +595 -0
  85. morphogen/gui/tools/mechanics.py +3881 -0
  86. morphogen/gui/tools/nonlocal_damage.py +1321 -0
  87. morphogen/gui/tools/phasefield.py +215 -0
  88. morphogen/gui/tools/physics.py +597 -0
  89. morphogen/gui/tools/stability.py +1756 -0
  90. morphogen/gui/tools/statistics.py +1408 -0
  91. morphogen/gui/viewer.js +1100 -0
  92. morphogen/homogenization/__init__.py +210 -0
  93. morphogen/homogenization/acoustics.py +566 -0
  94. morphogen/homogenization/amg.py +1005 -0
  95. morphogen/homogenization/apparent.py +1046 -0
  96. morphogen/homogenization/behaviours.cu +2285 -0
  97. morphogen/homogenization/behaviours.py +944 -0
  98. morphogen/homogenization/beremin.py +263 -0
  99. morphogen/homogenization/bifurcation.py +1085 -0
  100. morphogen/homogenization/bloch.py +507 -0
  101. morphogen/homogenization/bounds.py +226 -0
  102. morphogen/homogenization/core.py +458 -0
  103. morphogen/homogenization/coupled.py +1135 -0
  104. morphogen/homogenization/crystal.py +2967 -0
  105. morphogen/homogenization/dilatation.py +454 -0
  106. morphogen/homogenization/elements.py +157 -0
  107. morphogen/homogenization/fatigue.py +768 -0
  108. morphogen/homogenization/fe.py +1739 -0
  109. morphogen/homogenization/fenicsx.py +307 -0
  110. morphogen/homogenization/fft.py +499 -0
  111. morphogen/homogenization/fft_nonlinear.py +391 -0
  112. morphogen/homogenization/finite.py +613 -0
  113. morphogen/homogenization/flow.py +361 -0
  114. morphogen/homogenization/frames.py +1125 -0
  115. morphogen/homogenization/gpu.py +1241 -0
  116. morphogen/homogenization/harmonic.py +427 -0
  117. morphogen/homogenization/identification.py +579 -0
  118. morphogen/homogenization/kernels.py +760 -0
  119. morphogen/homogenization/laws.py +2061 -0
  120. morphogen/homogenization/materials.py +1080 -0
  121. morphogen/homogenization/mfront.py +589 -0
  122. morphogen/homogenization/networks.py +880 -0
  123. morphogen/homogenization/nonlinear.py +2612 -0
  124. morphogen/homogenization/ntfa.py +577 -0
  125. morphogen/homogenization/paths.py +476 -0
  126. morphogen/homogenization/photonic.py +467 -0
  127. morphogen/homogenization/poroelastic.py +212 -0
  128. morphogen/homogenization/porous.py +1120 -0
  129. morphogen/homogenization/postprocess.py +290 -0
  130. morphogen/homogenization/solvers.py +1140 -0
  131. morphogen/homogenization/tensors.py +240 -0
  132. morphogen/homogenization/voxel_fe.py +457 -0
  133. morphogen/homogenization/xfem.py +1016 -0
  134. morphogen/homogenization/zmat.py +1258 -0
  135. morphogen/iga/__init__.py +48 -0
  136. morphogen/iga/analysis.py +508 -0
  137. morphogen/iga/basis.py +214 -0
  138. morphogen/iga/geometry.py +501 -0
  139. morphogen/iga/homogenization.py +219 -0
  140. morphogen/iga/optimization.py +700 -0
  141. morphogen/iga/shapes.py +331 -0
  142. morphogen/image.py +128 -0
  143. morphogen/io/__init__.py +246 -0
  144. morphogen/io/amitex.py +741 -0
  145. morphogen/io/ebsd.py +881 -0
  146. morphogen/io/export.py +196 -0
  147. morphogen/io/geometry.py +158 -0
  148. morphogen/io/medit.py +147 -0
  149. morphogen/io/meshes.py +844 -0
  150. morphogen/io/metaimage.py +97 -0
  151. morphogen/io/mfront.py +1104 -0
  152. morphogen/io/native.py +57 -0
  153. morphogen/io/radioss.py +764 -0
  154. morphogen/io/solvers.py +371 -0
  155. morphogen/io/tables.py +278 -0
  156. morphogen/io/tiff.py +66 -0
  157. morphogen/io/vtk.py +701 -0
  158. morphogen/io/xdmf.py +200 -0
  159. morphogen/kernels/__init__.py +5 -0
  160. morphogen/kernels/annealing.py +192 -0
  161. morphogen/kernels/cells.py +69 -0
  162. morphogen/kernels/collective.py +87 -0
  163. morphogen/kernels/force_biased.py +595 -0
  164. morphogen/kernels/implicit.py +145 -0
  165. morphogen/kernels/leaves.py +132 -0
  166. morphogen/kernels/packing.py +304 -0
  167. morphogen/kernels/raster.py +279 -0
  168. morphogen/kernels/rsa.py +371 -0
  169. morphogen/kernels/union.py +135 -0
  170. morphogen/kernels/watershed.py +190 -0
  171. morphogen/laser/__init__.py +234 -0
  172. morphogen/laser/architectures.py +375 -0
  173. morphogen/laser/bending.py +216 -0
  174. morphogen/laser/cells.py +1694 -0
  175. morphogen/laser/design.py +940 -0
  176. morphogen/laser/figures.py +227 -0
  177. morphogen/laser/heat.py +804 -0
  178. morphogen/laser/materials.py +691 -0
  179. morphogen/laser/mechanics.py +1670 -0
  180. morphogen/laser/metallurgy.py +615 -0
  181. morphogen/laser/patterns.py +828 -0
  182. morphogen/laser/periodic.py +392 -0
  183. morphogen/laser/process.py +362 -0
  184. morphogen/laser/run.py +534 -0
  185. morphogen/laser/solid.py +216 -0
  186. morphogen/laser/specimen.py +200 -0
  187. morphogen/laser/structures.py +708 -0
  188. morphogen/learning/__init__.py +81 -0
  189. morphogen/learning/behaviour.py +398 -0
  190. morphogen/learning/data.py +328 -0
  191. morphogen/learning/learned.cpp +668 -0
  192. morphogen/learning/logarithmic.py +202 -0
  193. morphogen/learning/mfront.py +409 -0
  194. morphogen/learning/networks.py +767 -0
  195. morphogen/learning/run.py +212 -0
  196. morphogen/learning/standard.py +814 -0
  197. morphogen/learning/training.py +235 -0
  198. morphogen/mesh/__init__.py +29 -0
  199. morphogen/mesh/conforming.py +1423 -0
  200. morphogen/mesh/curved.py +600 -0
  201. morphogen/mesh/exact.py +1717 -0
  202. morphogen/mesh/octree.py +350 -0
  203. morphogen/mesh/polycrystal.py +1041 -0
  204. morphogen/mesh/polyhedra.py +677 -0
  205. morphogen/mesh/regularize.py +570 -0
  206. morphogen/mesh/surface.py +97 -0
  207. morphogen/mesh/tetra.py +512 -0
  208. morphogen/mesh/voxel.py +124 -0
  209. morphogen/micromorphic/__init__.py +31 -0
  210. morphogen/micromorphic/damage.py +359 -0
  211. morphogen/micromorphic/ductile.py +534 -0
  212. morphogen/micromorphic/finite.py +220 -0
  213. morphogen/micromorphic/microfoam.py +787 -0
  214. morphogen/micromorphic/space.py +341 -0
  215. morphogen/models/__init__.py +195 -0
  216. morphogen/models/affine.py +384 -0
  217. morphogen/models/automata.py +592 -0
  218. morphogen/models/base.py +500 -0
  219. morphogen/models/boolean.py +310 -0
  220. morphogen/models/bouligand.py +331 -0
  221. morphogen/models/branching.py +241 -0
  222. morphogen/models/combination.py +430 -0
  223. morphogen/models/deadleaves.py +766 -0
  224. morphogen/models/design.py +289 -0
  225. morphogen/models/ebsd.py +206 -0
  226. morphogen/models/fibers.py +1476 -0
  227. morphogen/models/foam.py +594 -0
  228. morphogen/models/gaussian.py +314 -0
  229. morphogen/models/growth.py +459 -0
  230. morphogen/models/hardcore.py +317 -0
  231. morphogen/models/hierarchical.py +269 -0
  232. morphogen/models/honeycomb.py +749 -0
  233. morphogen/models/implicit.py +177 -0
  234. morphogen/models/laminate.py +470 -0
  235. morphogen/models/lattice.py +351 -0
  236. morphogen/models/lattice_field.py +345 -0
  237. morphogen/models/levelset_foam.py +563 -0
  238. morphogen/models/nacre.py +411 -0
  239. morphogen/models/nested.py +924 -0
  240. morphogen/models/osteons.py +374 -0
  241. morphogen/models/pieces.py +167 -0
  242. morphogen/models/planar.py +126 -0
  243. morphogen/models/reconstruction.py +203 -0
  244. morphogen/models/scale_rich.py +1409 -0
  245. morphogen/models/scale_rich_3d.py +1616 -0
  246. morphogen/models/tessellation.py +735 -0
  247. morphogen/models/tiling_field.py +302 -0
  248. morphogen/models/tpms.py +197 -0
  249. morphogen/models/transparent.py +406 -0
  250. morphogen/models/union.py +141 -0
  251. morphogen/optimization/__init__.py +43 -0
  252. morphogen/optimization/cell.py +295 -0
  253. morphogen/optimization/filters.py +115 -0
  254. morphogen/optimization/mma.py +226 -0
  255. morphogen/optimization/run.py +219 -0
  256. morphogen/optimization/topology.py +632 -0
  257. morphogen/orientations.py +568 -0
  258. morphogen/parallel.py +599 -0
  259. morphogen/pipeline.py +978 -0
  260. morphogen/primitives.py +188 -0
  261. morphogen/results.py +564 -0
  262. morphogen/rve/__init__.py +73 -0
  263. morphogen/rve/report.py +627 -0
  264. morphogen/rve/scaling.py +363 -0
  265. morphogen/rve/study.py +1054 -0
  266. morphogen/rve/windows.py +345 -0
  267. morphogen/seeding.py +51 -0
  268. morphogen/settings.py +118 -0
  269. morphogen/stopping.py +48 -0
  270. morphogen/symmetry.py +384 -0
  271. morphogen/templates/activator_inhibitor.yaml +22 -0
  272. morphogen/templates/aggregation.yaml +23 -0
  273. morphogen/templates/boolean_cylinders.yaml +20 -0
  274. morphogen/templates/boolean_spheres.yaml +22 -0
  275. morphogen/templates/bouligand.yaml +28 -0
  276. morphogen/templates/cellular_automaton.yaml +25 -0
  277. morphogen/templates/coated_spheres.yaml +26 -0
  278. morphogen/templates/contact_fibers.yaml +27 -0
  279. morphogen/templates/cox_nanocomposite.yaml +22 -0
  280. morphogen/templates/cross_linked_fibers.yaml +26 -0
  281. morphogen/templates/curved_arcs.yaml +28 -0
  282. morphogen/templates/curved_fibers.yaml +24 -0
  283. morphogen/templates/dead_leaves.yaml +22 -0
  284. morphogen/templates/delaunay_network.yaml +22 -0
  285. morphogen/templates/dense_packing.yaml +22 -0
  286. morphogen/templates/diffusion.yaml +33 -0
  287. morphogen/templates/ebsd.yaml +34 -0
  288. morphogen/templates/ebsd_map.ctf +3087 -0
  289. morphogen/templates/fracture_composite.yaml +42 -0
  290. morphogen/templates/fracture_rubber.yaml +47 -0
  291. morphogen/templates/gaussian_excursion.yaml +17 -0
  292. morphogen/templates/graded_lattice.yaml +24 -0
  293. morphogen/templates/hardcore_fibers.yaml +22 -0
  294. morphogen/templates/hardcore_spheres.yaml +22 -0
  295. morphogen/templates/hierarchical_lattice.yaml +22 -0
  296. morphogen/templates/homogenization_acoustic_foam.yaml +36 -0
  297. morphogen/templates/homogenization_beremin.yaml +50 -0
  298. morphogen/templates/homogenization_cleavage.yaml +51 -0
  299. morphogen/templates/homogenization_cleavage_band.yaml +55 -0
  300. morphogen/templates/homogenization_contact.yaml +43 -0
  301. morphogen/templates/homogenization_crack_closure.yaml +49 -0
  302. morphogen/templates/homogenization_crystal_plasticity.yaml +50 -0
  303. morphogen/templates/homogenization_crystal_plasticity_fft.yaml +52 -0
  304. morphogen/templates/homogenization_crystallization.yaml +30 -0
  305. morphogen/templates/homogenization_debonding.yaml +43 -0
  306. morphogen/templates/homogenization_detwinning.yaml +58 -0
  307. morphogen/templates/homogenization_ductile_damage.yaml +47 -0
  308. morphogen/templates/homogenization_fatigue.yaml +40 -0
  309. morphogen/templates/homogenization_grain_fracture.yaml +56 -0
  310. morphogen/templates/homogenization_gyroid.yaml +30 -0
  311. morphogen/templates/homogenization_intergranular.yaml +43 -0
  312. morphogen/templates/homogenization_interphase.yaml +42 -0
  313. morphogen/templates/homogenization_mixed_loading.yaml +33 -0
  314. morphogen/templates/homogenization_ntfa.yaml +56 -0
  315. morphogen/templates/homogenization_piezoelectric.yaml +27 -0
  316. morphogen/templates/homogenization_polycrystal.yaml +30 -0
  317. morphogen/templates/homogenization_polycrystal_inclusions.yaml +30 -0
  318. morphogen/templates/homogenization_poroelastic.yaml +26 -0
  319. morphogen/templates/homogenization_rubber.yaml +40 -0
  320. morphogen/templates/homogenization_slip_cleavage.yaml +50 -0
  321. morphogen/templates/homogenization_spheres.yaml +31 -0
  322. morphogen/templates/homogenization_transport.yaml +29 -0
  323. morphogen/templates/homogenization_twinning.yaml +54 -0
  324. morphogen/templates/homogenization_viscoelastic.yaml +34 -0
  325. morphogen/templates/homogenization_viscoplastic.yaml +42 -0
  326. morphogen/templates/homogenization_voronoi.yaml +26 -0
  327. morphogen/templates/homogenization_xfem.yaml +23 -0
  328. morphogen/templates/hyperuniform_cells.yaml +24 -0
  329. morphogen/templates/laguerre.yaml +18 -0
  330. morphogen/templates/laser_bending.yaml +35 -0
  331. morphogen/templates/laser_cells.yaml +38 -0
  332. morphogen/templates/laser_corrugated.yaml +36 -0
  333. morphogen/templates/level_set_foam.yaml +29 -0
  334. morphogen/templates/menger_sponge.yaml +17 -0
  335. morphogen/templates/nacre.yaml +25 -0
  336. morphogen/templates/nucleation_growth.yaml +25 -0
  337. morphogen/templates/optimize_auxetic.yaml +29 -0
  338. morphogen/templates/optimize_auxetic_3d.yaml +27 -0
  339. morphogen/templates/optimize_bulk.yaml +23 -0
  340. morphogen/templates/optimize_conductivity.yaml +20 -0
  341. morphogen/templates/osteons.yaml +28 -0
  342. morphogen/templates/penetrable_spheres.yaml +21 -0
  343. morphogen/templates/poisson_fibers.yaml +21 -0
  344. morphogen/templates/random_laminate.yaml +26 -0
  345. morphogen/templates/random_lattice.yaml +27 -0
  346. morphogen/templates/random_walk_fibers.yaml +26 -0
  347. morphogen/templates/reaction_diffusion.yaml +22 -0
  348. morphogen/templates/reconstruction.yaml +22 -0
  349. morphogen/templates/rve_cellular_automaton.yaml +23 -0
  350. morphogen/templates/rve_crystal_plasticity_fft.yaml +51 -0
  351. morphogen/templates/rve_multiphysics.yaml +43 -0
  352. morphogen/templates/rve_poisson_fibers.yaml +22 -0
  353. morphogen/templates/rve_poisson_fibers_fe.yaml +33 -0
  354. morphogen/templates/rve_voronoi_windows.yaml +20 -0
  355. morphogen/templates/scale_rich_network.yaml +29 -0
  356. morphogen/templates/scale_rich_plates.yaml +30 -0
  357. morphogen/templates/sequential_dead_leaves.yaml +25 -0
  358. morphogen/templates/strut_lattice.yaml +21 -0
  359. morphogen/templates/tile_assembly.yaml +28 -0
  360. morphogen/templates/tpms.yaml +19 -0
  361. morphogen/templates/trabecular_bone.yaml +29 -0
  362. morphogen/templates/transparent_dead_leaves.yaml +23 -0
  363. morphogen/templates/vascular_tree.yaml +23 -0
  364. morphogen/templates/voronoi.yaml +20 -0
  365. morphogen/templates/wood.yaml +34 -0
  366. morphogen/templates/workflow.yaml +56 -0
  367. morphogen/texture.py +665 -0
  368. morphogen/theory.py +162 -0
  369. morphogen/viz/__init__.py +12 -0
  370. morphogen/viz/export.py +244 -0
  371. morphogen/viz/figures.py +707 -0
  372. morphogen/viz/png.py +148 -0
  373. morphogen/viz/sections.py +696 -0
  374. morphogen/viz/surfaces.py +1352 -0
  375. morphogen/viz/video.py +904 -0
  376. morphogen/viz/workflow.py +488 -0
  377. morphogen-1.0.0.dist-info/METADATA +2316 -0
  378. morphogen-1.0.0.dist-info/RECORD +381 -0
  379. morphogen-1.0.0.dist-info/WHEEL +4 -0
  380. morphogen-1.0.0.dist-info/entry_points.txt +5 -0
  381. morphogen-1.0.0.dist-info/licenses/LICENSE +674 -0
@@ -0,0 +1,387 @@
1
+ """The stand-alone application of morphoGen: the graphical interface in a window of its
2
+ own rather than a tab of the web browser.
3
+
4
+ ``morphogen desktop`` (or ``morphogen-desktop``, an application of the system once
5
+ installed; a bundle that needs no Python with ``packaging/desktop``) starts the server of
6
+ the interface on a free port of the local machine, private to the application, and opens
7
+ the page in a window of the web engine of the system through pywebview (WebView2 on
8
+ Windows, WebKit on macOS, Qt WebEngine or WebKitGTK on Linux: ``pip install
9
+ 'morphogen[desktop]'``). The page then uses the dialogs of the system
10
+ (:class:`DesktopApi`, ``window.pywebview.api`` in the page): the folders of the workspaces
11
+ it saves and opens, the folders and files that the forms of the tools take (their
12
+ **Browse…** buttons), the files of the results saved where one chooses and opened by
13
+ their applications, the folder of a result shown in the file manager. A menu holds the
14
+ workspace, the folder of the session and the help; closing the window ends the session
15
+ (its files with it, unless saved; the computations still running stopped, the programs
16
+ they run killed), after a confirmation when the workspace holds items not saved.
17
+
18
+ Without pywebview, the application falls back on the web browser, as ``morphogen gui``.
19
+ """
20
+
21
+ from __future__ import annotations
22
+
23
+ import os
24
+ import shutil
25
+ import subprocess
26
+ import sys
27
+ import tempfile
28
+ import threading
29
+ import urllib.parse
30
+ import webbrowser
31
+ from pathlib import Path
32
+
33
+ from morphogen import __version__
34
+
35
+ #: The address of the project, for the menu Help
36
+ REPOSITORY = "https://github.com/jdirr/morphoGen"
37
+ #: The size of the window (logical pixels) and its smallest size
38
+ SIZE = (1440, 920)
39
+ MIN_SIZE = (960, 640)
40
+
41
+
42
+ def icon_path() -> Path | None:
43
+ """The icon of the application (a PNG of the package)."""
44
+ from importlib import resources
45
+
46
+ path = Path(str(resources.files("morphogen") / "gui" / "icon.png"))
47
+ return path if path.is_file() else None
48
+
49
+
50
+ def open_with_system(path) -> bool:
51
+ """Open a file or a folder with the application the system gives it."""
52
+ path = str(path)
53
+ try:
54
+ if sys.platform == "win32":
55
+ os.startfile(path) # the user's own file
56
+ elif sys.platform == "darwin":
57
+ subprocess.Popen(["open", path])
58
+ else:
59
+ subprocess.Popen(
60
+ ["xdg-open", path], stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL
61
+ )
62
+ except (OSError, AttributeError):
63
+ return False
64
+ return True
65
+
66
+
67
+ def reveal_in_system(path) -> bool:
68
+ """Show a file in the file manager (its folder, the file selected where the system
69
+ can), or open a folder."""
70
+ path = Path(path)
71
+ try:
72
+ if sys.platform == "win32" and path.is_file():
73
+ subprocess.Popen(["explorer", "/select,", str(path)])
74
+ return True
75
+ if sys.platform == "darwin" and path.is_file():
76
+ subprocess.Popen(["open", "-R", str(path)])
77
+ return True
78
+ except OSError:
79
+ return False
80
+ return open_with_system(path if path.is_dir() else path.parent)
81
+
82
+
83
+ class DesktopApi:
84
+ """What the page of the application asks of the system (``window.pywebview.api``):
85
+ dialogs, files and folders. ``session`` is the session of the server
86
+ (:class:`morphogen.gui.api.Session`); the window is set once created. Each method
87
+ returns plain values (a path, None when the dialog is cancelled, a boolean)."""
88
+
89
+ def __init__(
90
+ self,
91
+ session,
92
+ window=None,
93
+ *,
94
+ dialogs=None,
95
+ opener=open_with_system,
96
+ revealer=reveal_in_system,
97
+ ):
98
+ self._session = session
99
+ self._window = window
100
+ self._dialogs = dialogs # the module of the constants of the dialogs (webview)
101
+ self._open = opener
102
+ self._reveal = revealer
103
+ self._saved = None # the number given to the last item when the workspace was saved
104
+
105
+ def _dialog(self, kind: str, title: str = "", start: str = "", name: str = "", types=()):
106
+ if self._window is None:
107
+ return None
108
+ dialog = getattr(self._dialogs.FileDialog, kind)
109
+ start = str(Path(start).expanduser()) if start else str(Path.home())
110
+ options = {"directory": start, "allow_multiple": False}
111
+ if kind == "SAVE":
112
+ options["save_filename"] = name
113
+ if types:
114
+ options["file_types"] = tuple(types)
115
+ chosen = self._window.create_file_dialog(dialog, **options)
116
+ if not chosen:
117
+ return None
118
+ return str(chosen[0] if isinstance(chosen, (list, tuple)) else chosen)
119
+
120
+ def info(self) -> dict:
121
+ """The application and its session, for the page."""
122
+ return {
123
+ "desktop": True,
124
+ "version": __version__,
125
+ "session": str(self._session.root),
126
+ "platform": sys.platform,
127
+ }
128
+
129
+ def choose_folder(self, title: str = "", start: str = "") -> str | None:
130
+ """A folder chosen in the dialog of the system."""
131
+ return self._dialog("FOLDER", title, start)
132
+
133
+ def choose_file(self, title: str = "", start: str = "") -> str | None:
134
+ """A file chosen in the dialog of the system."""
135
+ return self._dialog("OPEN", title, start)
136
+
137
+ def _file(self, url: str) -> Path:
138
+ """The file of the session at the address of the page ``/files/<key>/<name>``."""
139
+ path = urllib.parse.unquote(urllib.parse.urlparse(str(url)).path)
140
+ parts = path.split("/", 3)
141
+ if len(parts) != 4 or parts[1] != "files":
142
+ raise ValueError(f"not a file of the session: {url}")
143
+ return self._session.file(parts[2], parts[3])
144
+
145
+ def save_file(self, url: str) -> str | None:
146
+ """Copy a file of the session (its address in the page) where the dialog of the
147
+ system says; the path written."""
148
+ source = self._file(url)
149
+ start = str(Path.home() / "Downloads") if (Path.home() / "Downloads").is_dir() else ""
150
+ target = self._dialog("SAVE", "Save the file", start, name=source.name)
151
+ if not target:
152
+ return None
153
+ shutil.copyfile(source, target)
154
+ return target
155
+
156
+ def open_file(self, url: str) -> bool:
157
+ """Open a file of the session (a figure, a video, a table) with its application."""
158
+ return self._open(self._file(url))
159
+
160
+ def reveal(self, key: str) -> bool:
161
+ """Show the folder of an item of the workspace (a result, a simulation) in the file
162
+ manager."""
163
+ folder = (self._session.root / str(key)).resolve()
164
+ if self._session.root.resolve() not in folder.parents or not folder.is_dir():
165
+ raise ValueError(f"no folder of the session for {key!r}")
166
+ return self._reveal(folder)
167
+
168
+ def open_session_folder(self) -> bool:
169
+ """Show the folder of the session (every result of the session) in the file manager."""
170
+ return self._reveal(self._session.root)
171
+
172
+ def workspace_saved(self) -> None:
173
+ """The page saved the workspace (closing then asks nothing, until another item
174
+ joins it)."""
175
+ self._saved = self._session._count
176
+
177
+ def unsaved(self) -> bool:
178
+ """Whether the workspace holds items, some joined since it was last saved."""
179
+ return bool(self._session.items) and self._session._count != self._saved
180
+
181
+
182
+ def _menu(webview, window, api: DesktopApi) -> list:
183
+ """The menus of the window: the workspace, the session, the help."""
184
+ try:
185
+ from webview.menu import Menu, MenuAction, MenuSeparator
186
+ except ImportError: # pragma: no cover - older pywebview
187
+ return []
188
+
189
+ def click(element: str):
190
+ return lambda: window.evaluate_js(f"document.getElementById({element!r}).click()")
191
+
192
+ def about():
193
+ window.evaluate_js(
194
+ f"alert('morphoGen {__version__}: morphological modelling and generation of virtual "
195
+ "microstructures, their homogenization, fracture and explicit dynamics. "
196
+ "GPL-3.0-or-later.')"
197
+ )
198
+
199
+ return [
200
+ Menu(
201
+ "File",
202
+ [
203
+ MenuAction("Open a workspace…", click("ws-open")),
204
+ MenuAction("Save the workspace…", click("ws-save")),
205
+ MenuSeparator(),
206
+ MenuAction("Show the folder of the session", api.open_session_folder),
207
+ MenuSeparator(),
208
+ MenuAction("Quit", window.destroy),
209
+ ],
210
+ ),
211
+ Menu(
212
+ "Help",
213
+ [
214
+ MenuAction("What each tab does", click("help-toggle")),
215
+ MenuAction("morphoGen on GitHub", lambda: webbrowser.open(REPOSITORY)),
216
+ MenuAction(
217
+ "OpenRadioss on GitHub",
218
+ lambda: webbrowser.open("https://github.com/OpenRadioss/OpenRadioss"),
219
+ ),
220
+ MenuSeparator(),
221
+ MenuAction("About morphoGen", about),
222
+ ],
223
+ ),
224
+ ]
225
+
226
+
227
+ def stop_jobs(server, timeout: float = 10.0) -> int:
228
+ """Stop the jobs still running on a server (at their next checkpoint: the programs
229
+ they run, OpenRadioss, are killed) and wait for them, ``timeout`` seconds at most;
230
+ the jobs stopped."""
231
+ import time
232
+
233
+ with server.jobs_lock:
234
+ running = [j for j in server.jobs.values() if j.status()["state"] == "running"]
235
+ for job in running:
236
+ job.stop()
237
+ end = time.monotonic() + timeout
238
+ for job in running:
239
+ thread = getattr(job, "thread", None)
240
+ if thread is not None and thread.is_alive():
241
+ thread.join(max(0.0, end - time.monotonic()))
242
+ return len(running)
243
+
244
+
245
+ def start_server(session_dir):
246
+ """The server of the interface on a free port of 127.0.0.1, serving from a thread;
247
+ returns it and its address."""
248
+ from morphogen.gui.server import GuiServer
249
+
250
+ server = GuiServer(("127.0.0.1", 0), Path(session_dir))
251
+ thread = threading.Thread(target=server.serve_forever, daemon=True)
252
+ thread.start()
253
+ return server, f"http://127.0.0.1:{server.server_address[1]}/"
254
+
255
+
256
+ def check(session_dir=None) -> int:
257
+ """Check that the application runs, without a window (for the bundles): the server
258
+ serves the page and its API, and a model is generated (the compiled kernels). Prints
259
+ what it checked; 0 when all went well."""
260
+ import json
261
+ import urllib.request
262
+
263
+ with tempfile.TemporaryDirectory(prefix="morphogen_desktop_") as tmp:
264
+ server, url = start_server(session_dir or tmp)
265
+ try:
266
+ page = urllib.request.urlopen(url, timeout=30).read()
267
+ if b"morphoGen" not in page:
268
+ raise RuntimeError("the page is not served")
269
+ info = json.loads(urllib.request.urlopen(url + "api/info", timeout=30).read())
270
+ models = json.loads(urllib.request.urlopen(url + "api/models", timeout=60).read())
271
+ body = json.dumps(
272
+ {
273
+ "model": "boolean_spheres",
274
+ "params": {"radius": 1.0, "volume_fraction": 0.3},
275
+ "domain": {"size": 8, "periodic": True},
276
+ "seed": 1,
277
+ "resolution": 64,
278
+ }
279
+ ).encode()
280
+ request = urllib.request.Request(
281
+ url + "api/generate", data=body, headers={"Content-Type": "application/json"}
282
+ )
283
+ generated = json.loads(urllib.request.urlopen(request, timeout=600).read())
284
+ if "error" in generated:
285
+ raise RuntimeError(generated["error"])
286
+ catalog = json.loads(urllib.request.urlopen(url + "api/tools", timeout=60).read())
287
+ except Exception as exc: # reported, the check failed
288
+ print(f"morphoGen {__version__}: the check failed: {type(exc).__name__}: {exc}")
289
+ return 1
290
+ finally:
291
+ server.shutdown()
292
+ server.server_close()
293
+ tabs = ", ".join(t["title"] for t in catalog["tabs"])
294
+ print(
295
+ f"morphoGen {info['version']}: the page, {len(models)} models and the tabs {tabs}; a "
296
+ "realization generated"
297
+ )
298
+ return 0
299
+
300
+
301
+ def run(
302
+ session_dir=None, *, debug: bool = False, browser: bool = False, gui: str | None = None
303
+ ) -> int:
304
+ """Run the application until its window closes (see the module); ``browser``: in the
305
+ web browser instead (as ``morphogen gui``); ``gui``: the renderer of pywebview (``qt``,
306
+ ``gtk``, ``edgechromium``, ``cocoa``; by default the one of the system)."""
307
+ try:
308
+ if browser:
309
+ raise ImportError("asked for the browser")
310
+ import webview
311
+ except ImportError as exc:
312
+ from morphogen.gui.server import serve
313
+
314
+ if not browser:
315
+ print(
316
+ f"no window ({exc}): pip install 'morphogen[desktop]' for the application; "
317
+ "the interface opens in the web browser instead"
318
+ )
319
+ serve(0, open_browser=True, session_dir=session_dir)
320
+ return 0
321
+ temporary = None
322
+ if session_dir is None:
323
+ temporary = tempfile.TemporaryDirectory(prefix="morphogen_desktop_")
324
+ session_dir = temporary.name
325
+ server, url = start_server(session_dir)
326
+ api = DesktopApi(server.session, dialogs=webview)
327
+ webview.settings["OPEN_EXTERNAL_LINKS_IN_BROWSER"] = True
328
+ webview.settings["ALLOW_DOWNLOADS"] = True
329
+ options = {
330
+ "js_api": api,
331
+ "width": SIZE[0],
332
+ "height": SIZE[1],
333
+ "min_size": MIN_SIZE,
334
+ "text_select": True,
335
+ "background_color": "#f6f6f2",
336
+ }
337
+ window = webview.create_window(f"morphoGen {__version__}", url, **options)
338
+ api._window = window
339
+ try:
340
+ window.menu = _menu(webview, window, api) # read when the window is shown
341
+ except (AttributeError, TypeError): # pragma: no cover - older pywebview
342
+ pass
343
+
344
+ def closing():
345
+ if not api.unsaved():
346
+ return True
347
+ return window.create_confirmation_dialog(
348
+ "Quit morphoGen",
349
+ "The items of the workspace are lost with the session unless saved (Save… beside "
350
+ "the workspace). Quit anyway?",
351
+ )
352
+
353
+ window.events.closing += closing
354
+ icon = icon_path()
355
+ try:
356
+ webview.start(gui=gui, debug=debug, icon=str(icon) if icon else None)
357
+ finally:
358
+ stop_jobs(server)
359
+ server.shutdown()
360
+ server.server_close()
361
+ if temporary is not None:
362
+ temporary.cleanup()
363
+ return 0
364
+
365
+
366
+ def main(argv=None) -> int:
367
+ """The program ``morphogen-desktop``: the application (``--check``: check it without a
368
+ window)."""
369
+ import argparse
370
+
371
+ parser = argparse.ArgumentParser(
372
+ prog="morphogen-desktop", description="morphoGen, the stand-alone application"
373
+ )
374
+ parser.add_argument("--version", action="version", version=f"morphoGen {__version__}")
375
+ parser.add_argument("--session", help="folder of the files of the session")
376
+ parser.add_argument("--debug", action="store_true", help="the developer tools of the page")
377
+ parser.add_argument("--browser", action="store_true", help="in the web browser")
378
+ parser.add_argument("--gui", help="the renderer of pywebview (qt, gtk, edgechromium, cocoa)")
379
+ parser.add_argument("--check", action="store_true", help="check the application, no window")
380
+ args = parser.parse_args(argv)
381
+ if args.check:
382
+ return check(args.session)
383
+ return run(args.session, debug=args.debug, browser=args.browser, gui=args.gui)
384
+
385
+
386
+ if __name__ == "__main__": # pragma: no cover
387
+ sys.exit(main())
morphogen/gui/icon.png ADDED
Binary file