synkit 1.6.5__py3-none-win_amd64.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 (636) hide show
  1. synkit/CRN/Benchmark/__init__.py +53 -0
  2. synkit/CRN/Benchmark/crosschecks.py +13 -0
  3. synkit/CRN/Benchmark/kegg.py +12 -0
  4. synkit/CRN/Benchmark/networks.py +13 -0
  5. synkit/CRN/Benchmark/scaling.py +13 -0
  6. synkit/CRN/Benchmark/validate.py +13 -0
  7. synkit/CRN/Construct/__init__.py +16 -0
  8. synkit/CRN/Construct/abstract.py +668 -0
  9. synkit/CRN/Construct/arity.py +36 -0
  10. synkit/CRN/Construct/builder.py +619 -0
  11. synkit/CRN/Construct/derivation.py +63 -0
  12. synkit/CRN/Construct/flattener.py +100 -0
  13. synkit/CRN/Construct/keys.py +14 -0
  14. synkit/CRN/Construct/mixtures.py +117 -0
  15. synkit/CRN/Construct/rdkit_worker.py +69 -0
  16. synkit/CRN/Construct/smiles.py +99 -0
  17. synkit/CRN/Construct/state.py +31 -0
  18. synkit/CRN/Construct/strategy.py +75 -0
  19. synkit/CRN/Construct/worker.py +42 -0
  20. synkit/CRN/IO/__init__.py +36 -0
  21. synkit/CRN/IO/sbml.py +925 -0
  22. synkit/CRN/Pathway/__init__.py +72 -0
  23. synkit/CRN/Pathway/_adapter.py +333 -0
  24. synkit/CRN/Pathway/pathfinder.py +500 -0
  25. synkit/CRN/Pathway/reachability.py +796 -0
  26. synkit/CRN/Pathway/realizability.py +1322 -0
  27. synkit/CRN/Petrinet/__init__.py +93 -0
  28. synkit/CRN/Petrinet/analyzer.py +486 -0
  29. synkit/CRN/Petrinet/minimal_semiflows.py +436 -0
  30. synkit/CRN/Petrinet/net.py +1041 -0
  31. synkit/CRN/Petrinet/persistence.py +97 -0
  32. synkit/CRN/Petrinet/semiflows.py +483 -0
  33. synkit/CRN/Petrinet/siphon_search.py +402 -0
  34. synkit/CRN/Petrinet/structure.py +286 -0
  35. synkit/CRN/Props/__init__.py +130 -0
  36. synkit/CRN/Props/_rank.py +29 -0
  37. synkit/CRN/Props/deficiency.py +953 -0
  38. synkit/CRN/Props/dynamics.py +832 -0
  39. synkit/CRN/Props/helper.py +151 -0
  40. synkit/CRN/Props/stoich.py +751 -0
  41. synkit/CRN/Props/thermo.py +584 -0
  42. synkit/CRN/Query/__init__.py +66 -0
  43. synkit/CRN/Query/cache.py +41 -0
  44. synkit/CRN/Query/kegg_api.py +99 -0
  45. synkit/CRN/Query/kegg_extract.py +714 -0
  46. synkit/CRN/Query/kegg_impute.py +707 -0
  47. synkit/CRN/Query/kegg_parse.py +480 -0
  48. synkit/CRN/Query/to_syncrn.py +290 -0
  49. synkit/CRN/README.md +234 -0
  50. synkit/CRN/Structure/__init__.py +12 -0
  51. synkit/CRN/Structure/_graph_io.py +713 -0
  52. synkit/CRN/Structure/_matrices.py +88 -0
  53. synkit/CRN/Structure/_parse.py +544 -0
  54. synkit/CRN/Structure/reaction.py +237 -0
  55. synkit/CRN/Structure/rule.py +55 -0
  56. synkit/CRN/Structure/species.py +46 -0
  57. synkit/CRN/Structure/syncrn.py +929 -0
  58. synkit/CRN/Symmetry/__init__.py +20 -0
  59. synkit/CRN/Symmetry/_common.py +1059 -0
  60. synkit/CRN/Symmetry/_ir.py +940 -0
  61. synkit/CRN/Symmetry/automorphism.py +472 -0
  62. synkit/CRN/Symmetry/canon.py +441 -0
  63. synkit/CRN/Symmetry/isomorphism.py +412 -0
  64. synkit/CRN/Symmetry/symmetry.py +61 -0
  65. synkit/CRN/Symmetry/wl_canon.py +967 -0
  66. synkit/CRN/Visualize/__init__.py +11 -0
  67. synkit/CRN/Visualize/labels.py +113 -0
  68. synkit/CRN/Visualize/layout.py +708 -0
  69. synkit/CRN/Visualize/palette.py +292 -0
  70. synkit/CRN/Visualize/validation.py +122 -0
  71. synkit/CRN/Visualize/vis.py +1152 -0
  72. synkit/CRN/__init__.py +233 -0
  73. synkit/CRN/_build.py +50 -0
  74. synkit/CRN/_native_build.py +175 -0
  75. synkit/CRN/analysis.py +629 -0
  76. synkit/CRN/backend.py +74 -0
  77. synkit/CRN/cpp/CMakeLists.txt +58 -0
  78. synkit/CRN/cpp/algebra.cpp +46 -0
  79. synkit/CRN/cpp/closure.cpp +29 -0
  80. synkit/CRN/cpp/exact.h +55 -0
  81. synkit/CRN/cpp/pathway.cpp +46 -0
  82. synkit/CRN/cpp/semiflows.cpp +209 -0
  83. synkit/CRN/cpp/structural.cpp +240 -0
  84. synkit/CRN/cpp/symmetry.cpp +45 -0
  85. synkit/CRN/cpp/write_manifest.cmake +28 -0
  86. synkit/CRN/kinds.py +137 -0
  87. synkit/CRN/lib/synkit_crn.dll +0 -0
  88. synkit/CRN/lib/synkit_crn.json +33 -0
  89. synkit/CRN/native.py +388 -0
  90. synkit/CRN/native_analysis.py +459 -0
  91. synkit/Chem/Cluster/__init__.py +0 -0
  92. synkit/Chem/Cluster/butina.py +140 -0
  93. synkit/Chem/Fingerprint/__init__.py +0 -0
  94. synkit/Chem/Fingerprint/fp_calculator.py +155 -0
  95. synkit/Chem/Fingerprint/smiles_featurizer.py +258 -0
  96. synkit/Chem/Fingerprint/transformation_fp.py +139 -0
  97. synkit/Chem/Mapper/README.rst +43 -0
  98. synkit/Chem/Mapper/__init__.py +255 -0
  99. synkit/Chem/Mapper/_compat.py +130 -0
  100. synkit/Chem/Mapper/adapters/__init__.py +1 -0
  101. synkit/Chem/Mapper/adapters/prediction.py +126 -0
  102. synkit/Chem/Mapper/adapters/template.py +412 -0
  103. synkit/Chem/Mapper/chem/__init__.py +52 -0
  104. synkit/Chem/Mapper/chem/aam.py +673 -0
  105. synkit/Chem/Mapper/chem/blind.py +160 -0
  106. synkit/Chem/Mapper/chem/its.py +309 -0
  107. synkit/Chem/Mapper/chem/smiles.py +564 -0
  108. synkit/Chem/Mapper/graph/__init__.py +66 -0
  109. synkit/Chem/Mapper/graph/automorphism.py +395 -0
  110. synkit/Chem/Mapper/graph/blockcut.py +98 -0
  111. synkit/Chem/Mapper/graph/labeled_graph.py +104 -0
  112. synkit/Chem/Mapper/graph/refine.py +176 -0
  113. synkit/Chem/Mapper/graph/synkit_adapter.py +110 -0
  114. synkit/Chem/Mapper/io/__init__.py +13 -0
  115. synkit/Chem/Mapper/io/idxmapstr.py +82 -0
  116. synkit/Chem/Mapper/mapper.py +685 -0
  117. synkit/Chem/Mapper/reaction_search.py +554 -0
  118. synkit/Chem/Mapper/reporting/__init__.py +1 -0
  119. synkit/Chem/Mapper/reporting/alternatives.py +451 -0
  120. synkit/Chem/Mapper/reporting/analysis.py +681 -0
  121. synkit/Chem/Mapper/reporting/native_analysis.py +485 -0
  122. synkit/Chem/Mapper/reporting/spectrum.py +642 -0
  123. synkit/Chem/Mapper/solvers/__init__.py +1 -0
  124. synkit/Chem/Mapper/solvers/exact/__init__.py +141 -0
  125. synkit/Chem/Mapper/solvers/exact/assignment/__init__.py +1 -0
  126. synkit/Chem/Mapper/solvers/exact/assignment/assignment_certificate.py +113 -0
  127. synkit/Chem/Mapper/solvers/exact/assignment/assignment_domains.py +162 -0
  128. synkit/Chem/Mapper/solvers/exact/assignment/assignment_verification.py +58 -0
  129. synkit/Chem/Mapper/solvers/exact/assignment/incremental_assignment.py +247 -0
  130. synkit/Chem/Mapper/solvers/exact/certificate.py +128 -0
  131. synkit/Chem/Mapper/solvers/exact/core.py +183 -0
  132. synkit/Chem/Mapper/solvers/exact/distance_search/__init__.py +1 -0
  133. synkit/Chem/Mapper/solvers/exact/distance_search/bounds.py +319 -0
  134. synkit/Chem/Mapper/solvers/exact/distance_search/exhaustive.py +179 -0
  135. synkit/Chem/Mapper/solvers/exact/distance_search/inputs.py +283 -0
  136. synkit/Chem/Mapper/solvers/exact/distance_search/records.py +242 -0
  137. synkit/Chem/Mapper/solvers/exact/distance_search/search.py +1025 -0
  138. synkit/Chem/Mapper/solvers/exact/distance_search/verify.py +378 -0
  139. synkit/Chem/Mapper/solvers/exact/edit_support.py +375 -0
  140. synkit/Chem/Mapper/solvers/exact/hybrid.py +224 -0
  141. synkit/Chem/Mapper/solvers/exact/hydrogen.py +264 -0
  142. synkit/Chem/Mapper/solvers/exact/kernel_solvers/__init__.py +1 -0
  143. synkit/Chem/Mapper/solvers/exact/kernel_solvers/branching.py +499 -0
  144. synkit/Chem/Mapper/solvers/exact/kernel_solvers/enumerate.py +1050 -0
  145. synkit/Chem/Mapper/solvers/exact/kernel_solvers/enumeration_result.py +30 -0
  146. synkit/Chem/Mapper/solvers/exact/kernel_solvers/kernel.py +256 -0
  147. synkit/Chem/Mapper/solvers/exact/kernel_solvers/milp.py +194 -0
  148. synkit/Chem/Mapper/solvers/exact/native/__init__.py +1 -0
  149. synkit/Chem/Mapper/solvers/exact/native/build.py +154 -0
  150. synkit/Chem/Mapper/solvers/exact/native/candidates.py +593 -0
  151. synkit/Chem/Mapper/solvers/exact/native/canonical.py +396 -0
  152. synkit/Chem/Mapper/solvers/exact/native/disk_frontier.py +415 -0
  153. synkit/Chem/Mapper/solvers/exact/native/frontier.py +390 -0
  154. synkit/Chem/Mapper/solvers/exact/native/hydrogen_quotient.py +213 -0
  155. synkit/Chem/Mapper/solvers/exact/native/its.py +528 -0
  156. synkit/Chem/Mapper/solvers/exact/native/native_distance.cpp +2803 -0
  157. synkit/Chem/Mapper/solvers/exact/native/orbit_aggregation.py +328 -0
  158. synkit/Chem/Mapper/solvers/exact/native/parallel.py +205 -0
  159. synkit/Chem/Mapper/solvers/exact/native/pmcd.py +203 -0
  160. synkit/Chem/Mapper/solvers/exact/native/runtime.py +40 -0
  161. synkit/Chem/Mapper/solvers/exact/native/search.py +294 -0
  162. synkit/Chem/Mapper/solvers/exact/native/separator.py +224 -0
  163. synkit/Chem/Mapper/solvers/exact/native_build.py +12 -0
  164. synkit/Chem/Mapper/solvers/exact/pabs/__init__.py +1 -0
  165. synkit/Chem/Mapper/solvers/exact/pabs/cost_lattice.py +43 -0
  166. synkit/Chem/Mapper/solvers/exact/pabs/factor_spectrum.py +110 -0
  167. synkit/Chem/Mapper/solvers/exact/pabs/multi_shell.py +368 -0
  168. synkit/Chem/Mapper/solvers/exact/pabs/propagation.py +679 -0
  169. synkit/Chem/Mapper/solvers/exact/pabs/propagation_bounds.py +436 -0
  170. synkit/Chem/Mapper/solvers/exact/pabs/propagation_limits.py +13 -0
  171. synkit/Chem/Mapper/solvers/exact/pabs/propagation_search.py +856 -0
  172. synkit/Chem/Mapper/solvers/exact/pabs/propagation_symmetry.py +66 -0
  173. synkit/Chem/Mapper/solvers/exact/pabs/residual_typed_bonds.py +136 -0
  174. synkit/Chem/Mapper/solvers/exact/pabs/reward_frontier.py +201 -0
  175. synkit/Chem/Mapper/solvers/exact/pabs/separator_bound.py +258 -0
  176. synkit/Chem/Mapper/solvers/exact/pabs/separator_spectrum.py +308 -0
  177. synkit/Chem/Mapper/solvers/exact/pabs/sparse_reward_bound.py +207 -0
  178. synkit/Chem/Mapper/solvers/exact/pabs/suffix_spectrum.py +299 -0
  179. synkit/Chem/Mapper/solvers/exact/search.py +55 -0
  180. synkit/Chem/Mapper/solvers/exact/seeds/__init__.py +1 -0
  181. synkit/Chem/Mapper/solvers/exact/seeds/seed.py +104 -0
  182. synkit/Chem/Mapper/solvers/exact/seeds/seed_fragments.py +148 -0
  183. synkit/Chem/Mapper/solvers/exact/seeds/seed_relaxation.py +181 -0
  184. synkit/Chem/Mapper/solvers/exact/symmetry.py +223 -0
  185. synkit/Chem/Mapper/solvers/native/__init__.py +4 -0
  186. synkit/Chem/Mapper/solvers/native/assignment.py +99 -0
  187. synkit/Chem/Mapper/solvers/native/astar.py +22 -0
  188. synkit/Chem/Mapper/solvers/native/build.py +385 -0
  189. synkit/Chem/Mapper/solvers/native/classification.py +641 -0
  190. synkit/Chem/Mapper/solvers/native/core.py +378 -0
  191. synkit/Chem/Mapper/solvers/native/cpp/CMakeLists.txt +120 -0
  192. synkit/Chem/Mapper/solvers/native/cpp/examples/map_reaction.cpp +29 -0
  193. synkit/Chem/Mapper/solvers/native/cpp/examples/slap_graph.cpp +63 -0
  194. synkit/Chem/Mapper/solvers/native/cpp/include/synkit_mapper/assignment/assignment.h +18 -0
  195. synkit/Chem/Mapper/solvers/native/cpp/include/synkit_mapper/astar/astar.h +18 -0
  196. synkit/Chem/Mapper/solvers/native/cpp/include/synkit_mapper/astar/bound.h +33 -0
  197. synkit/Chem/Mapper/solvers/native/cpp/include/synkit_mapper/core/pmcd_witness.h +16 -0
  198. synkit/Chem/Mapper/solvers/native/cpp/include/synkit_mapper/core/runtime.h +130 -0
  199. synkit/Chem/Mapper/solvers/native/cpp/include/synkit_mapper/hydrogen/hydrogen.h +73 -0
  200. synkit/Chem/Mapper/solvers/native/cpp/include/synkit_mapper/mapper.h +175 -0
  201. synkit/Chem/Mapper/solvers/native/cpp/include/synkit_mapper/mces/mces.h +9 -0
  202. synkit/Chem/Mapper/solvers/native/cpp/include/synkit_mapper/pabs/seed.h +34 -0
  203. synkit/Chem/Mapper/solvers/native/cpp/include/synkit_mapper/reaction/reaction.h +30 -0
  204. synkit/Chem/Mapper/solvers/native/cpp/include/synkit_mapper/sepdp/sepdp.h +21 -0
  205. synkit/Chem/Mapper/solvers/native/cpp/include/synkit_mapper/slap.h +72 -0
  206. synkit/Chem/Mapper/solvers/native/cpp/include/synkit_mapper/solvers/solvers.h +16 -0
  207. synkit/Chem/Mapper/solvers/native/cpp/include/synkit_mapper/symmetry/classification.h +140 -0
  208. synkit/Chem/Mapper/solvers/native/cpp/include/synkit_mapper/symmetry/cpabs.h +33 -0
  209. synkit/Chem/Mapper/solvers/native/cpp/src/assignment/abb.cpp +302 -0
  210. synkit/Chem/Mapper/solvers/native/cpp/src/astar/CMakeLists.txt +12 -0
  211. synkit/Chem/Mapper/solvers/native/cpp/src/astar/README.md +47 -0
  212. synkit/Chem/Mapper/solvers/native/cpp/src/astar/astar.cpp +228 -0
  213. synkit/Chem/Mapper/solvers/native/cpp/src/astar/astar_graph.cpp +37 -0
  214. synkit/Chem/Mapper/solvers/native/cpp/src/astar/bound.cpp +212 -0
  215. synkit/Chem/Mapper/solvers/native/cpp/src/core/dispatch.cpp +272 -0
  216. synkit/Chem/Mapper/solvers/native/cpp/src/core/pmcd_witness.cpp +36 -0
  217. synkit/Chem/Mapper/solvers/native/cpp/src/hydrogen/hydrogen.cpp +380 -0
  218. synkit/Chem/Mapper/solvers/native/cpp/src/mces/README.md +57 -0
  219. synkit/Chem/Mapper/solvers/native/cpp/src/mces/mces.cpp +287 -0
  220. synkit/Chem/Mapper/solvers/native/cpp/src/pabs/bridge.cpp +334 -0
  221. synkit/Chem/Mapper/solvers/native/cpp/src/pabs/chemical_floor.inc +181 -0
  222. synkit/Chem/Mapper/solvers/native/cpp/src/pabs/endpoint_symmetry.inc +104 -0
  223. synkit/Chem/Mapper/solvers/native/cpp/src/pabs/exact_helpers.h +20 -0
  224. synkit/Chem/Mapper/solvers/native/cpp/src/pabs/lp_assignment_certificate.h +165 -0
  225. synkit/Chem/Mapper/solvers/native/cpp/src/pabs/lp_certificate.h +125 -0
  226. synkit/Chem/Mapper/solvers/native/cpp/src/pabs/lp_model.h +365 -0
  227. synkit/Chem/Mapper/solvers/native/cpp/src/pabs/lp_provider.inc +319 -0
  228. synkit/Chem/Mapper/solvers/native/cpp/src/pabs/lp_rounding.inc +170 -0
  229. synkit/Chem/Mapper/solvers/native/cpp/src/pabs/lp_test_hooks.h +342 -0
  230. synkit/Chem/Mapper/solvers/native/cpp/src/pabs/objective_reduction.inc +137 -0
  231. synkit/Chem/Mapper/solvers/native/cpp/src/pabs/overlap_dual.inc +351 -0
  232. synkit/Chem/Mapper/solvers/native/cpp/src/pabs/profile_seed.inc +214 -0
  233. synkit/Chem/Mapper/solvers/native/cpp/src/pabs/seed_heuristics.inc +640 -0
  234. synkit/Chem/Mapper/solvers/native/cpp/src/pabs/sparse_embedding.cpp +430 -0
  235. synkit/Chem/Mapper/solvers/native/cpp/src/pabs/sparse_root_lp.h +176 -0
  236. synkit/Chem/Mapper/solvers/native/cpp/src/pabs/test_hooks.inc +262 -0
  237. synkit/Chem/Mapper/solvers/native/cpp/src/reaction/reaction.cpp +611 -0
  238. synkit/Chem/Mapper/solvers/native/cpp/src/sepdp/README.md +61 -0
  239. synkit/Chem/Mapper/solvers/native/cpp/src/sepdp/sepdp.cpp +253 -0
  240. synkit/Chem/Mapper/solvers/native/cpp/src/slap.cpp +810 -0
  241. synkit/Chem/Mapper/solvers/native/cpp/src/solvers/formulation.h +138 -0
  242. synkit/Chem/Mapper/solvers/native/cpp/src/solvers/maxsat.cpp +526 -0
  243. synkit/Chem/Mapper/solvers/native/cpp/src/solvers/ortools.cpp +475 -0
  244. synkit/Chem/Mapper/solvers/native/cpp/src/solvers/seed.h +80 -0
  245. synkit/Chem/Mapper/solvers/native/cpp/src/solvers/weighted_cnf.h +256 -0
  246. synkit/Chem/Mapper/solvers/native/cpp/src/supporting/README.md +43 -0
  247. synkit/Chem/Mapper/solvers/native/cpp/src/supporting/dfs.cpp +123 -0
  248. synkit/Chem/Mapper/solvers/native/cpp/src/supporting/edit_support.cpp +224 -0
  249. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/classification.cpp +553 -0
  250. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/classification_pipeline.cpp +124 -0
  251. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/classification_stream.h +13 -0
  252. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/cpabs.cpp +455 -0
  253. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/edge_deck.cpp +743 -0
  254. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/vendor/nauty/COPYRIGHT +44 -0
  255. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/vendor/nauty/LICENSE-2.0.txt +202 -0
  256. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/vendor/nauty/naugraph.c +732 -0
  257. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/vendor/nauty/naurng.c +94 -0
  258. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/vendor/nauty/naurng.h +49 -0
  259. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/vendor/nauty/nausparse.c +1771 -0
  260. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/vendor/nauty/nausparse.h +133 -0
  261. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/vendor/nauty/nautil.c +750 -0
  262. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/vendor/nauty/naututil.h +355 -0
  263. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/vendor/nauty/nauty.c +1256 -0
  264. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/vendor/nauty/nauty.h +1544 -0
  265. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/vendor/nauty/schreier.c +1131 -0
  266. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/vendor/nauty/schreier.h +70 -0
  267. synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/vendor/nauty/sorttemplates.c +580 -0
  268. synkit/Chem/Mapper/solvers/native/hydrogen.py +711 -0
  269. synkit/Chem/Mapper/solvers/native/implicit.py +506 -0
  270. synkit/Chem/Mapper/solvers/native/implicit_certificate.py +187 -0
  271. synkit/Chem/Mapper/solvers/native/implicit_preparation.py +309 -0
  272. synkit/Chem/Mapper/solvers/native/lib/synkit_mapper.dll +0 -0
  273. synkit/Chem/Mapper/solvers/native/mces.py +16 -0
  274. synkit/Chem/Mapper/solvers/native/reaction.py +179 -0
  275. synkit/Chem/Mapper/solvers/native/reaction_build.py +277 -0
  276. synkit/Chem/Mapper/solvers/native/reaction_text.py +26 -0
  277. synkit/Chem/Mapper/solvers/native/runtime.py +242 -0
  278. synkit/Chem/Mapper/solvers/native/sepdp.py +47 -0
  279. synkit/Chem/Mapper/solvers/native/slap.py +266 -0
  280. synkit/Chem/Mapper/solvers/native/solvers.py +67 -0
  281. synkit/Chem/Mapper/solvers/native/stereo.py +86 -0
  282. synkit/Chem/Mapper/solvers/native/supporting.py +34 -0
  283. synkit/Chem/Mapper/solvers/native/symmetry.py +91 -0
  284. synkit/Chem/Mapper/solvers/slap/__init__.py +29 -0
  285. synkit/Chem/Mapper/solvers/slap/lap.py +174 -0
  286. synkit/Chem/Mapper/solvers/slap/sequential.py +696 -0
  287. synkit/Chem/Mapper/validation/__init__.py +1 -0
  288. synkit/Chem/Mapper/validation/aam_validator.py +442 -0
  289. synkit/Chem/Mapper/validation/annotations.py +274 -0
  290. synkit/Chem/Mapper/validation/bonds.py +124 -0
  291. synkit/Chem/Mapper/validation/cohorts.py +72 -0
  292. synkit/Chem/Mapper/validation/identifiability.py +150 -0
  293. synkit/Chem/Mapper/validation/numerical_scope.py +36 -0
  294. synkit/Chem/Mapper/validation/orbits.py +137 -0
  295. synkit/Chem/Molecule/__init__.py +0 -0
  296. synkit/Chem/Molecule/_chirality_loci.py +165 -0
  297. synkit/Chem/Molecule/_chirality_types.py +231 -0
  298. synkit/Chem/Molecule/_helical_loci.py +167 -0
  299. synkit/Chem/Molecule/_stereo_axis_evidence.py +202 -0
  300. synkit/Chem/Molecule/_stereo_element_detection.py +193 -0
  301. synkit/Chem/Molecule/_stereo_orientation_constraints.py +511 -0
  302. synkit/Chem/Molecule/_tetrahedral_carriers.py +63 -0
  303. synkit/Chem/Molecule/atom_features.py +379 -0
  304. synkit/Chem/Molecule/chirality.py +1041 -0
  305. synkit/Chem/Molecule/cip_assignment.py +569 -0
  306. synkit/Chem/Molecule/cip_ranking.py +843 -0
  307. synkit/Chem/Molecule/coordinate_stereo.py +503 -0
  308. synkit/Chem/Molecule/derived_stereo_naming.py +165 -0
  309. synkit/Chem/Molecule/descriptors.py +452 -0
  310. synkit/Chem/Molecule/formula.py +249 -0
  311. synkit/Chem/Molecule/global_stereo.py +175 -0
  312. synkit/Chem/Molecule/graph_annotator.py +300 -0
  313. synkit/Chem/Molecule/standardize.py +817 -0
  314. synkit/Chem/Molecule/stereo_evidence.py +179 -0
  315. synkit/Chem/Molecule/stereo_perception.py +1032 -0
  316. synkit/Chem/Molecule/valence.py +123 -0
  317. synkit/Chem/Reaction/Mapper/__init__.py +44 -0
  318. synkit/Chem/Reaction/__init__.py +20 -0
  319. synkit/Chem/Reaction/aam_validator.py +5 -0
  320. synkit/Chem/Reaction/balance_check.py +138 -0
  321. synkit/Chem/Reaction/canon_rsmi.py +249 -0
  322. synkit/Chem/Reaction/cleaning.py +58 -0
  323. synkit/Chem/Reaction/deionize.py +199 -0
  324. synkit/Chem/Reaction/explicit_h_audit.py +232 -0
  325. synkit/Chem/Reaction/fix_aam.py +64 -0
  326. synkit/Chem/Reaction/neutralize.py +207 -0
  327. synkit/Chem/Reaction/radical_wildcard.py +224 -0
  328. synkit/Chem/Reaction/standardize.py +203 -0
  329. synkit/Chem/Reaction/tautomerize.py +205 -0
  330. synkit/Chem/__init__.py +1 -0
  331. synkit/Chem/utils.py +315 -0
  332. synkit/Data/__init__.py +0 -0
  333. synkit/Data/aldol.json.gz +1 -0
  334. synkit/Data/gen_partial_aam.py +147 -0
  335. synkit/Data/paracetamol.json.gz +1 -0
  336. synkit/Graph/Canon/__init__.py +16 -0
  337. synkit/Graph/Canon/_native/__init__.py +13 -0
  338. synkit/Graph/Canon/_native/build.py +93 -0
  339. synkit/Graph/Canon/_native/lib/synkit_canon.dll +0 -0
  340. synkit/Graph/Canon/_native/prepare.py +49 -0
  341. synkit/Graph/Canon/_native/runtime.py +140 -0
  342. synkit/Graph/Canon/_native/search.py +137 -0
  343. synkit/Graph/Canon/canon_algs.py +228 -0
  344. synkit/Graph/Canon/canon_graph.py +531 -0
  345. synkit/Graph/Canon/cpp/CMakeLists.txt +42 -0
  346. synkit/Graph/Canon/cpp/README.md +123 -0
  347. synkit/Graph/Canon/cpp/examples/canonical_graph.cpp +16 -0
  348. synkit/Graph/Canon/cpp/include/synkit_canon/canon.h +85 -0
  349. synkit/Graph/Canon/cpp/src/canonical.cpp +391 -0
  350. synkit/Graph/Canon/cpp/src/symmetry.h +83 -0
  351. synkit/Graph/Canon/cpp/tests/symmetry.cpp +93 -0
  352. synkit/Graph/Canon/exact.py +1020 -0
  353. synkit/Graph/Canon/exact_refinement.py +368 -0
  354. synkit/Graph/Canon/nauty.py +143 -0
  355. synkit/Graph/Context/__init__.py +0 -0
  356. synkit/Graph/Context/hier_context.py +244 -0
  357. synkit/Graph/Context/radius_expand.py +252 -0
  358. synkit/Graph/FG/__init__.py +19 -0
  359. synkit/Graph/FG/api.py +39 -0
  360. synkit/Graph/FG/audit.py +155 -0
  361. synkit/Graph/FG/catalog.py +919 -0
  362. synkit/Graph/FG/detector.py +288 -0
  363. synkit/Graph/FG/model.py +97 -0
  364. synkit/Graph/FG/recognizers.py +274 -0
  365. synkit/Graph/FG/ring_system.py +154 -0
  366. synkit/Graph/Feature/Descriptors/topology.py +857 -0
  367. synkit/Graph/Feature/Fingerprint/__init__.py +0 -0
  368. synkit/Graph/Feature/Fingerprint/wl_rxn_fps.py +222 -0
  369. synkit/Graph/Feature/__init__.py +5 -0
  370. synkit/Graph/Feature/graph_descriptors.py +323 -0
  371. synkit/Graph/Feature/graph_fps.py +96 -0
  372. synkit/Graph/Feature/graph_signature.py +239 -0
  373. synkit/Graph/Feature/hash_fps.py +133 -0
  374. synkit/Graph/Feature/morgan_fps.py +88 -0
  375. synkit/Graph/Feature/path_fps.py +81 -0
  376. synkit/Graph/Feature/wl_hash.py +134 -0
  377. synkit/Graph/Fusion/__init__.py +85 -0
  378. synkit/Graph/Fusion/candidate.py +559 -0
  379. synkit/Graph/Fusion/constructor.py +877 -0
  380. synkit/Graph/Fusion/identity.py +184 -0
  381. synkit/Graph/Fusion/interface.py +700 -0
  382. synkit/Graph/Fusion/search.py +241 -0
  383. synkit/Graph/Hyrogen/__init__.py +6 -0
  384. synkit/Graph/Hyrogen/_misc.py +591 -0
  385. synkit/Graph/Hyrogen/hcomplete.py +995 -0
  386. synkit/Graph/Hyrogen/hcomplete_legacy.py +368 -0
  387. synkit/Graph/Hyrogen/hcompletion_algorithms.py +713 -0
  388. synkit/Graph/Hyrogen/hextend.py +570 -0
  389. synkit/Graph/Hyrogen/hextend_legacy.py +215 -0
  390. synkit/Graph/ITS/__init__.py +4 -0
  391. synkit/Graph/ITS/its_builder.py +120 -0
  392. synkit/Graph/ITS/its_construction.py +719 -0
  393. synkit/Graph/ITS/its_decompose.py +572 -0
  394. synkit/Graph/ITS/its_destruction.py +331 -0
  395. synkit/Graph/ITS/its_expand.py +1251 -0
  396. synkit/Graph/ITS/its_relabel.py +187 -0
  397. synkit/Graph/ITS/its_reverter.py +356 -0
  398. synkit/Graph/ITS/normalize_aam.py +145 -0
  399. synkit/Graph/ITS/partial_its.py +238 -0
  400. synkit/Graph/ITS/rc_extractor.py +656 -0
  401. synkit/Graph/ITS/stereo.py +74 -0
  402. synkit/Graph/MTG/__init__.py +107 -0
  403. synkit/Graph/MTG/gluing.py +451 -0
  404. synkit/Graph/MTG/history.py +928 -0
  405. synkit/Graph/MTG/inventory.py +118 -0
  406. synkit/Graph/MTG/local.py +447 -0
  407. synkit/Graph/MTG/mcs_matcher.py +246 -0
  408. synkit/Graph/MTG/mtg.py +611 -0
  409. synkit/Graph/MTG/mtg_explore.py +74 -0
  410. synkit/Graph/MTG/observation.py +209 -0
  411. synkit/Graph/MTG/process.py +577 -0
  412. synkit/Graph/MTG/queries.py +66 -0
  413. synkit/Graph/MTG/realization.py +95 -0
  414. synkit/Graph/MTG/series_parallel.py +107 -0
  415. synkit/Graph/MTG/utils.py +424 -0
  416. synkit/Graph/Matcher/__init__.py +10 -0
  417. synkit/Graph/Matcher/approx_mcs.py +1264 -0
  418. synkit/Graph/Matcher/auto_est.py +736 -0
  419. synkit/Graph/Matcher/automorphism.py +314 -0
  420. synkit/Graph/Matcher/batch_cluster.py +224 -0
  421. synkit/Graph/Matcher/dedup_matches.py +247 -0
  422. synkit/Graph/Matcher/graph_cluster.py +191 -0
  423. synkit/Graph/Matcher/graph_matcher.py +312 -0
  424. synkit/Graph/Matcher/graph_morphism.py +421 -0
  425. synkit/Graph/Matcher/mcs_matcher.py +804 -0
  426. synkit/Graph/Matcher/multi_turbo_iso.py +186 -0
  427. synkit/Graph/Matcher/orbit.py +284 -0
  428. synkit/Graph/Matcher/partial_matcher.py +694 -0
  429. synkit/Graph/Matcher/sing.py +544 -0
  430. synkit/Graph/Matcher/subgraph_matcher.py +812 -0
  431. synkit/Graph/Matcher/turbo_iso.py +272 -0
  432. synkit/Graph/Matcher/wl_sel.py +537 -0
  433. synkit/Graph/Mech/__init__.py +26 -0
  434. synkit/Graph/Mech/conversion.py +1466 -0
  435. synkit/Graph/Mech/conversion_debug.py +237 -0
  436. synkit/Graph/Mech/electron_accounting.py +200 -0
  437. synkit/Graph/Mech/lwg_editor.py +406 -0
  438. synkit/Graph/Mech/lwg_ops.py +313 -0
  439. synkit/Graph/Morphism/__init__.py +99 -0
  440. synkit/Graph/Morphism/constraints.py +460 -0
  441. synkit/Graph/Morphism/llg.py +999 -0
  442. synkit/Graph/Morphism/morphism.py +349 -0
  443. synkit/Graph/Morphism/stereo.py +258 -0
  444. synkit/Graph/Morphism/stereo_morphism.py +383 -0
  445. synkit/Graph/Morphism/stereo_morphism_helpers.py +957 -0
  446. synkit/Graph/Morphism/stereo_morphism_types.py +117 -0
  447. synkit/Graph/Stereo/__init__.py +376 -0
  448. synkit/Graph/Stereo/_descriptor_core.py +207 -0
  449. synkit/Graph/Stereo/_descriptor_serialization.py +138 -0
  450. synkit/Graph/Stereo/canonical.py +648 -0
  451. synkit/Graph/Stereo/changes.py +964 -0
  452. synkit/Graph/Stereo/composition.py +391 -0
  453. synkit/Graph/Stereo/configured.py +946 -0
  454. synkit/Graph/Stereo/couplings.py +245 -0
  455. synkit/Graph/Stereo/descriptors.py +1030 -0
  456. synkit/Graph/Stereo/enumeration.py +597 -0
  457. synkit/Graph/Stereo/extended_descriptors.py +406 -0
  458. synkit/Graph/Stereo/global_configured.py +152 -0
  459. synkit/Graph/Stereo/global_stereo.py +304 -0
  460. synkit/Graph/Stereo/identity.py +648 -0
  461. synkit/Graph/Stereo/interchange.py +496 -0
  462. synkit/Graph/Stereo/legacy.py +460 -0
  463. synkit/Graph/Stereo/matching.py +899 -0
  464. synkit/Graph/Stereo/native.py +154 -0
  465. synkit/Graph/Stereo/orbits.py +668 -0
  466. synkit/Graph/Stereo/outcomes.py +99 -0
  467. synkit/Graph/Stereo/pairwise.py +350 -0
  468. synkit/Graph/Stereo/rdkit_adapter.py +662 -0
  469. synkit/Graph/Stereo/rdkit_identity.py +118 -0
  470. synkit/Graph/Stereo/rdkit_resonance.py +140 -0
  471. synkit/Graph/Stereo/reaction_interchange.py +266 -0
  472. synkit/Graph/Stereo/semantics.py +296 -0
  473. synkit/Graph/Stereo/supports.py +257 -0
  474. synkit/Graph/Stereo/wire.py +339 -0
  475. synkit/Graph/Wildcard/__init__.py +0 -0
  476. synkit/Graph/Wildcard/fuse_graph.py +156 -0
  477. synkit/Graph/Wildcard/graph_wc.py +303 -0
  478. synkit/Graph/Wildcard/its_merge.py +857 -0
  479. synkit/Graph/Wildcard/radwc.py +114 -0
  480. synkit/Graph/Wildcard/wc_matcher.py +576 -0
  481. synkit/Graph/Wildcard/wildcard.py +225 -0
  482. synkit/Graph/__init__.py +17 -0
  483. synkit/Graph/canon_graph.py +14 -0
  484. synkit/Graph/syn_graph.py +199 -0
  485. synkit/Graph/utils.py +324 -0
  486. synkit/IO/__init__.py +4 -0
  487. synkit/IO/chem_converter.py +1059 -0
  488. synkit/IO/combinatorial/__init__.py +8 -0
  489. synkit/IO/combinatorial/gml_to_graph.py +223 -0
  490. synkit/IO/combinatorial/graph_to_gml.py +280 -0
  491. synkit/IO/combinatorial/graph_to_smarts.py +186 -0
  492. synkit/IO/combinatorial/smarts_expander.py +147 -0
  493. synkit/IO/combinatorial/smarts_generalizer.py +133 -0
  494. synkit/IO/combinatorial/smarts_to_graph.py +179 -0
  495. synkit/IO/conversion.py +42 -0
  496. synkit/IO/data_io.py +269 -0
  497. synkit/IO/data_process.py +143 -0
  498. synkit/IO/debug.py +73 -0
  499. synkit/IO/gml_to_nx.py +150 -0
  500. synkit/IO/graph_to_mol.py +199 -0
  501. synkit/IO/mol_to_graph.py +1105 -0
  502. synkit/IO/mol_to_graph_chemistry.py +545 -0
  503. synkit/IO/nx_to_gml.py +209 -0
  504. synkit/IO/smiles_to_id.py +123 -0
  505. synkit/Mechanism/__init__.py +151 -0
  506. synkit/Mechanism/adapters.py +136 -0
  507. synkit/Mechanism/audit.py +323 -0
  508. synkit/Mechanism/benchmark.py +638 -0
  509. synkit/Mechanism/compatibility.py +13 -0
  510. synkit/Mechanism/drawing.py +85 -0
  511. synkit/Mechanism/electron_models.py +725 -0
  512. synkit/Mechanism/equivalence.py +521 -0
  513. synkit/Mechanism/evidence.py +262 -0
  514. synkit/Mechanism/interchange.py +141 -0
  515. synkit/Mechanism/model.py +918 -0
  516. synkit/Mechanism/neighbor_stereo.py +312 -0
  517. synkit/Mechanism/radical_data.py +740 -0
  518. synkit/Mechanism/replay.py +986 -0
  519. synkit/Mechanism/schema.py +264 -0
  520. synkit/Mechanism/stereo_state.py +416 -0
  521. synkit/Mechanism/symbols.py +91 -0
  522. synkit/Rule/Apply/__init__.py +35 -0
  523. synkit/Rule/Apply/conditions.py +45 -0
  524. synkit/Rule/Apply/dpo.py +998 -0
  525. synkit/Rule/Apply/rule_matcher.py +218 -0
  526. synkit/Rule/Apply/validation.py +354 -0
  527. synkit/Rule/Compose/__init__.py +106 -0
  528. synkit/Rule/Compose/_identity.py +43 -0
  529. synkit/Rule/Compose/composition.py +976 -0
  530. synkit/Rule/Compose/laws.py +439 -0
  531. synkit/Rule/Compose/search.py +771 -0
  532. synkit/Rule/Compose/synrule.py +170 -0
  533. synkit/Rule/Modify/__init__.py +0 -0
  534. synkit/Rule/Modify/implict_rule.py +56 -0
  535. synkit/Rule/Modify/longest_path.py +92 -0
  536. synkit/Rule/Modify/molecule_rule.py +115 -0
  537. synkit/Rule/Modify/prune_templates.py +78 -0
  538. synkit/Rule/Modify/rule_utils.py +194 -0
  539. synkit/Rule/Modify/strip_rule.py +97 -0
  540. synkit/Rule/__init__.py +28 -0
  541. synkit/Rule/generic_stereo.py +884 -0
  542. synkit/Rule/stereo_identity.py +271 -0
  543. synkit/Rule/syn_rule.py +1090 -0
  544. synkit/Synthesis/MSR/__init__.py +0 -0
  545. synkit/Synthesis/MSR/path_finder.py +239 -0
  546. synkit/Synthesis/Metrics/__init__.py +0 -0
  547. synkit/Synthesis/Metrics/_base.py +52 -0
  548. synkit/Synthesis/Metrics/_plot.py +129 -0
  549. synkit/Synthesis/Metrics/_ranking.py +179 -0
  550. synkit/Synthesis/RBL/__init__.py +80 -0
  551. synkit/Synthesis/RBL/engine.py +1249 -0
  552. synkit/Synthesis/RBL/matching.py +652 -0
  553. synkit/Synthesis/RBL/overlap.py +336 -0
  554. synkit/Synthesis/RBL/pipeline.py +376 -0
  555. synkit/Synthesis/RBL/policy.py +139 -0
  556. synkit/Synthesis/RBL/proof.py +370 -0
  557. synkit/Synthesis/RBL/reaction.py +506 -0
  558. synkit/Synthesis/RBL/state.py +169 -0
  559. synkit/Synthesis/RBL/validation.py +1060 -0
  560. synkit/Synthesis/Reactor/__init__.py +60 -0
  561. synkit/Synthesis/Reactor/core/__init__.py +1 -0
  562. synkit/Synthesis/Reactor/core/engine.py +967 -0
  563. synkit/Synthesis/Reactor/core/product.py +621 -0
  564. synkit/Synthesis/Reactor/core/rewrite.py +561 -0
  565. synkit/Synthesis/Reactor/core/strategy.py +44 -0
  566. synkit/Synthesis/Reactor/matching/__init__.py +1 -0
  567. synkit/Synthesis/Reactor/matching/mixin.py +920 -0
  568. synkit/Synthesis/Reactor/matching/policy.py +345 -0
  569. synkit/Synthesis/Reactor/matching/symmetry.py +309 -0
  570. synkit/Synthesis/Reactor/output/__init__.py +1 -0
  571. synkit/Synthesis/Reactor/output/deduplication.py +703 -0
  572. synkit/Synthesis/Reactor/output/policy.py +16 -0
  573. synkit/Synthesis/Reactor/output/serialization.py +485 -0
  574. synkit/Synthesis/Reactor/output/structural.py +893 -0
  575. synkit/Synthesis/Reactor/stereo/__init__.py +1 -0
  576. synkit/Synthesis/Reactor/stereo/assignment.py +35 -0
  577. synkit/Synthesis/Reactor/stereo/mixin.py +780 -0
  578. synkit/Synthesis/Reactor/variants/__init__.py +1 -0
  579. synkit/Synthesis/Reactor/variants/imbalanced.py +180 -0
  580. synkit/Synthesis/Reactor/variants/partial.py +84 -0
  581. synkit/Synthesis/Reactor/workflow/__init__.py +1 -0
  582. synkit/Synthesis/Reactor/workflow/batch.py +550 -0
  583. synkit/Synthesis/Reactor/workflow/benchmark.py +143 -0
  584. synkit/Synthesis/Reactor/workflow/postprocess.py +267 -0
  585. synkit/Synthesis/Reactor/workflow/rule_filter.py +210 -0
  586. synkit/Synthesis/__init__.py +0 -0
  587. synkit/Synthesis/reactor_utils.py +316 -0
  588. synkit/Utils/__init__.py +0 -0
  589. synkit/Utils/utils.py +172 -0
  590. synkit/Vis/__init__.py +91 -0
  591. synkit/Vis/crn/__init__.py +40 -0
  592. synkit/Vis/epd/__init__.py +20 -0
  593. synkit/Vis/epd/arrows.py +425 -0
  594. synkit/Vis/epd/chem.py +197 -0
  595. synkit/Vis/epd/constants.py +83 -0
  596. synkit/Vis/epd/layout.py +283 -0
  597. synkit/Vis/epd/mapping.py +51 -0
  598. synkit/Vis/epd/models.py +136 -0
  599. synkit/Vis/epd/render.py +543 -0
  600. synkit/Vis/epd/utils.py +108 -0
  601. synkit/Vis/epd/visualizer.py +811 -0
  602. synkit/Vis/graph_visualizer.py +375 -0
  603. synkit/Vis/its/__init__.py +19 -0
  604. synkit/Vis/its/drawer.py +615 -0
  605. synkit/Vis/its_drawer.py +35 -0
  606. synkit/Vis/molecule/__init__.py +31 -0
  607. synkit/Vis/molecule/drawer.py +563 -0
  608. synkit/Vis/molecule/reaction.py +285 -0
  609. synkit/Vis/molecule_drawer.py +33 -0
  610. synkit/Vis/mtg/__init__.py +17 -0
  611. synkit/Vis/mtg/drawer.py +769 -0
  612. synkit/Vis/mtg_drawer.py +34 -0
  613. synkit/Vis/pdf_writer.py +146 -0
  614. synkit/Vis/reaction/__init__.py +19 -0
  615. synkit/Vis/reaction/rule.py +141 -0
  616. synkit/Vis/reaction/rxn.py +532 -0
  617. synkit/Vis/reaction_drawer.py +41 -0
  618. synkit/Vis/space/__init__.py +17 -0
  619. synkit/Vis/space/chemical.py +80 -0
  620. synkit/Vis/space/embedding.py +87 -0
  621. synkit/Vis/vis_synedu/Vis/__init__.py +7 -0
  622. synkit/Vis/vis_synedu/Vis/dpo.py +862 -0
  623. synkit/Vis/vis_synedu/rxn_vis.py +377 -0
  624. synkit/Vis/vis_synedu/vis.py +501 -0
  625. synkit/Vis/visual_drawer.py +215 -0
  626. synkit/Vis/visual_model.py +520 -0
  627. synkit/__init__.py +3 -0
  628. synkit/_native.py +91 -0
  629. synkit/examples.py +50 -0
  630. synkit/version.py +23 -0
  631. synkit-1.6.5.dist-info/METADATA +156 -0
  632. synkit-1.6.5.dist-info/RECORD +636 -0
  633. synkit-1.6.5.dist-info/WHEEL +4 -0
  634. synkit-1.6.5.dist-info/licenses/LICENSE +21 -0
  635. synkit-1.6.5.dist-info/licenses/synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/vendor/nauty/COPYRIGHT +44 -0
  636. synkit-1.6.5.dist-info/licenses/synkit/Chem/Mapper/solvers/native/cpp/src/symmetry/vendor/nauty/LICENSE-2.0.txt +202 -0
@@ -0,0 +1,811 @@
1
+ from __future__ import annotations
2
+
3
+ """High-level mechanism visualizer for EPD, product, and ITS inspection."""
4
+
5
+ import math
6
+ from typing import Any, Dict, List, Optional, Sequence, Tuple
7
+
8
+ import matplotlib.pyplot as plt
9
+ import networkx as nx
10
+ import numpy as np
11
+
12
+ from .arrows import arrow_specs_from_transitions
13
+ from .chem import collect_rc_amap_sets, edge_order_from_amap_key
14
+ from .constants import (
15
+ ACS_ATOM_COLORS,
16
+ DEFAULT_ATOM_COLOR,
17
+ NatureStyle,
18
+ transition_family,
19
+ )
20
+ from .layout import build_shared_layout
21
+ from .mapping import edge_nodes_from_amap_key
22
+ from .models import transitions_from_epd
23
+ from .render import (
24
+ add_legend,
25
+ draw_arrow,
26
+ draw_graph,
27
+ draw_its_graph,
28
+ draw_lone_pair_dots,
29
+ draw_virtual_h,
30
+ )
31
+ from .utils import median_bond_length, tget
32
+
33
+
34
+ def _transition_label(transition: Any) -> Optional[str]:
35
+ """Return the most specific action label available for display."""
36
+ data = tget(transition, "data", {}) or {}
37
+ if isinstance(data, dict) and data.get("internal_kind"):
38
+ return str(data["internal_kind"])
39
+ if isinstance(data, dict) and data.get("typed_kind"):
40
+ return str(data["typed_kind"])
41
+ kind = tget(transition, "kind")
42
+ return str(kind) if kind else None
43
+
44
+
45
+ def _transition_color(style: NatureStyle, transition: Any) -> str:
46
+ """Return an arrow color keyed by electron-flow family."""
47
+ kind = transition_family(str(tget(transition, "kind", "")))
48
+ if kind == "LP-/B+":
49
+ return style.forming_color
50
+ if kind == "B-/LP+":
51
+ return style.broken_color
52
+ if kind == "B-/B+":
53
+ return style.shift_color
54
+ if kind in {"LP-/H+", "H-/LP+", "H-/B+"}:
55
+ return style.proton_color
56
+ return style.arrow_color
57
+
58
+
59
+ def _endpoint_label(component: str, atoms: Tuple[int, ...]) -> str:
60
+ """Format one endpoint in atom-map space."""
61
+ clean = component.rstrip("+-") or "B"
62
+ atom_text = "-".join(str(x) for x in atoms)
63
+ if clean in {"LP", "lp", "∙", "H"}:
64
+ return f"{clean} {atom_text}"
65
+ return f"{clean} {atom_text}"
66
+
67
+
68
+ def _transition_step_text(index: int, transition: Any) -> str:
69
+ """Return a compact typed-action explanation for the step key."""
70
+ label = _transition_label(transition) or str(tget(transition, "kind", ""))
71
+ parts = label.split("/")
72
+ src_component = parts[0] if parts else "?"
73
+ dst_component = parts[1] if len(parts) > 1 else "?"
74
+ src = tuple(tget(transition, "src", ()) or ())
75
+ dst = tuple(tget(transition, "dst", ()) or ())
76
+ return (
77
+ f"{index:>2}. {label:<14} "
78
+ f"{_endpoint_label(src_component, src)} -> {_endpoint_label(dst_component, dst)}"
79
+ )
80
+
81
+
82
+ def _draw_step_key(
83
+ ax: plt.Axes,
84
+ transitions: Sequence[Any],
85
+ style: NatureStyle,
86
+ max_rows: int,
87
+ ) -> None:
88
+ """Draw a compact typed-action key below the mechanism."""
89
+ if not transitions or max_rows <= 0:
90
+ return
91
+
92
+ shown = list(transitions[:max_rows])
93
+ lines = ["Electron-flow steps"]
94
+ lines.extend(
95
+ _transition_step_text(i + 1, transition) for i, transition in enumerate(shown)
96
+ )
97
+ if len(transitions) > max_rows:
98
+ lines.append(f"... {len(transitions) - max_rows} more")
99
+
100
+ txt = ax.text(
101
+ 0.01,
102
+ -0.045,
103
+ "\n".join(lines),
104
+ transform=ax.transAxes,
105
+ ha="left",
106
+ va="top",
107
+ fontsize=8.7,
108
+ color=style.electron_badge_color,
109
+ family="monospace",
110
+ linespacing=1.28,
111
+ clip_on=False,
112
+ bbox=dict(
113
+ boxstyle="round,pad=0.35", fc="white", ec="#C9D4E8", lw=0.9, alpha=0.98
114
+ ),
115
+ )
116
+ txt.set_path_effects([])
117
+
118
+
119
+ def _draw_panel_arrow(
120
+ ax: plt.Axes, left_pos: Dict[int, np.ndarray], right_pos: Dict[int, np.ndarray]
121
+ ) -> None:
122
+ """Draw a reaction arrow between two molecule panels."""
123
+ x_right = max(p[0] for p in left_pos.values())
124
+ x_left = min(p[0] for p in right_pos.values())
125
+ y_all = [p[1] for p in left_pos.values()] + [p[1] for p in right_pos.values()]
126
+ y = 0.5 * (min(y_all) + max(y_all))
127
+ gap = x_left - x_right
128
+ if gap <= 0:
129
+ return
130
+
131
+ ax.annotate(
132
+ "",
133
+ xy=(x_left - 0.18 * gap, y),
134
+ xytext=(x_right + 0.18 * gap, y),
135
+ arrowprops=dict(
136
+ arrowstyle="-|>",
137
+ color="#2F343A",
138
+ lw=2.3,
139
+ mutation_scale=24,
140
+ ),
141
+ annotation_clip=False,
142
+ zorder=4,
143
+ )
144
+
145
+
146
+ def _edge_overlays(
147
+ graph: nx.Graph,
148
+ broken_amap: set[Tuple[int, int]],
149
+ forming_amap: set[Tuple[int, int]],
150
+ atom_map_key: str,
151
+ style: NatureStyle,
152
+ missing_order_graph: Optional[nx.Graph],
153
+ product_side: bool = False,
154
+ ) -> Tuple[
155
+ Dict[Tuple[int, int], str], Dict[Tuple[int, int], str], Dict[Tuple[int, int], float]
156
+ ]:
157
+ """Return colored existing and missing edges for one molecule panel."""
158
+ existing: Dict[Tuple[int, int], str] = {}
159
+ missing: Dict[Tuple[int, int], str] = {}
160
+ missing_orders: Dict[Tuple[int, int], float] = {}
161
+
162
+ colored_sets = (
163
+ ((forming_amap, style.forming_color), (broken_amap, style.broken_color))
164
+ if product_side
165
+ else ((broken_amap, style.broken_color), (forming_amap, style.forming_color))
166
+ )
167
+
168
+ for amap_edges, color in colored_sets:
169
+ for amap_edge in amap_edges:
170
+ node_edge = edge_nodes_from_amap_key(
171
+ graph, amap_edge, atom_map_key=atom_map_key
172
+ )
173
+ if node_edge is None:
174
+ continue
175
+ if graph.has_edge(*node_edge):
176
+ existing[node_edge] = color
177
+ continue
178
+ missing[node_edge] = color
179
+ missing_orders[node_edge] = (
180
+ edge_order_from_amap_key(
181
+ missing_order_graph, amap_edge, atom_map_key=atom_map_key
182
+ )
183
+ if missing_order_graph is not None
184
+ else 1.0
185
+ ) or 1.0
186
+
187
+ return existing, missing, missing_orders
188
+
189
+
190
+ def _arrange_panels(
191
+ pos_list: List[Dict[int, np.ndarray]],
192
+ gap: float,
193
+ ) -> List[Dict[int, np.ndarray]]:
194
+ """Place position dicts side by side with a horizontal gap."""
195
+ result: List[Dict[int, np.ndarray]] = []
196
+ x_cursor = 0.0
197
+ for pos in pos_list:
198
+ if not pos:
199
+ result.append(pos)
200
+ continue
201
+ xs = [v[0] for v in pos.values()]
202
+ x_min, x_max = min(xs), max(xs)
203
+ shift = np.array([x_cursor - x_min, 0.0])
204
+ result.append({k: v + shift for k, v in pos.items()})
205
+ x_cursor += (x_max - x_min) + gap
206
+ return result
207
+
208
+
209
+ class MechanismVisualizer:
210
+ """Render chemist-oriented electron-pushing mechanism figures.
211
+
212
+ :param atom_map_key: Node attribute used to map atoms across reactant, ITS, and product.
213
+ """
214
+
215
+ def __init__(self, atom_map_key: str = "atom_map") -> None:
216
+ self.atom_map_key = atom_map_key
217
+ self.style = NatureStyle()
218
+
219
+ self.main_title_fontsize = self.style.main_title_fontsize
220
+ self.panel_title_fontsize = self.style.panel_title_fontsize
221
+
222
+ def atom_color(self, element: str) -> str:
223
+ """Return ACS-style atom color for an element symbol."""
224
+ return ACS_ATOM_COLORS.get(str(element), DEFAULT_ATOM_COLOR)
225
+
226
+ def draw_trajectory_arrows(
227
+ self,
228
+ ax: plt.Axes,
229
+ graph: nx.Graph,
230
+ pos,
231
+ transitions: Sequence[Any],
232
+ step_labels: bool = True,
233
+ ) -> None:
234
+ """Draw all electron-pushing arrows over the reactant panel."""
235
+ transitions = transitions_from_epd(transitions)
236
+ scale = median_bond_length(graph, pos)
237
+ specs = arrow_specs_from_transitions(graph, pos, transitions, scale=scale)
238
+
239
+ for spec in specs:
240
+ if spec.get("virtual_h") is not None:
241
+ donor_pos, h_pos = spec["virtual_h"]
242
+ draw_virtual_h(ax, donor_pos, h_pos)
243
+
244
+ draw_arrow(
245
+ ax,
246
+ spec["tail"],
247
+ spec["head"],
248
+ color=_transition_color(self.style, spec.get("transition")),
249
+ rad=spec["rad"],
250
+ label=(spec["step"] if step_labels else None),
251
+ label_offset=0.16 * scale,
252
+ )
253
+
254
+ if spec.get("lp_tail") is not None and spec.get("lp_tail_dir") is not None:
255
+ draw_lone_pair_dots(
256
+ ax,
257
+ spec["lp_tail"],
258
+ spec["lp_tail_dir"],
259
+ spec["lp_sep"],
260
+ spec["lp_radius"],
261
+ )
262
+
263
+ if spec.get("lp_head") is not None and spec.get("lp_head_dir") is not None:
264
+ draw_lone_pair_dots(
265
+ ax,
266
+ spec["lp_head"],
267
+ spec["lp_head_dir"],
268
+ spec["lp_sep"],
269
+ spec["lp_radius"],
270
+ )
271
+
272
+ def visualize_trajectory(
273
+ self,
274
+ reactant_graph: nx.Graph,
275
+ transitions: Sequence[Any],
276
+ its_graph: nx.Graph,
277
+ all_graphs: Optional[Sequence[nx.Graph]] = None,
278
+ product_graph: Optional[nx.Graph] = None,
279
+ title: str = "Trajectory electron pushing",
280
+ figsize: Optional[Tuple[float, float]] = None,
281
+ show_its: bool = True,
282
+ reference_layout: str = "its",
283
+ show_atom_map: bool = True,
284
+ step_labels: bool = False,
285
+ gap: float = 1.7,
286
+ show_legend: bool = True,
287
+ fade_non_rc: bool = False,
288
+ use_rc_glow: bool = True,
289
+ show_all_its_labels: bool = False,
290
+ show_its_node_changes: bool = False,
291
+ show_its_bond_labels: bool = False,
292
+ show_product: bool = True,
293
+ show_step_table: bool = True,
294
+ max_step_table_rows: int = 8,
295
+ molecule_edge_label_mode: str = "none",
296
+ show_elementary_steps: bool = False,
297
+ arrows_per_step: int = 2,
298
+ ):
299
+ """Create a Reactant/Product/ITS trajectory figure.
300
+
301
+ :param reactant_graph: Reactant molecular graph.
302
+ :param transitions: Transition sequence that defines electron flow.
303
+ :param its_graph: ITS graph used as the right-hand panel and, by default, the master
304
+ reference layout.
305
+ :param product_graph: Optional product graph used to infer ``(before, after)`` ITS labels
306
+ when ITS edge tuples are not directly stored.
307
+ :param title: Figure title.
308
+ :param figsize: Matplotlib figure size.
309
+ :param show_its: Must be ``True`` for this visualizer.
310
+ :param reference_layout: Either ``'its'`` or ``'reactant'``.
311
+ :param show_atom_map: Whether to display compact atom-map badges.
312
+ :param step_labels: Whether to label arrow steps.
313
+ :param gap: Horizontal spacing between the two panels.
314
+ :param show_legend: Whether to show the minimal legend below the figure.
315
+ :param fade_non_rc: Fade non-reaction-center bonds to emphasize change.
316
+ :param use_rc_glow: Add a soft halo around changed bonds.
317
+ :param show_all_its_labels: Show pair labels on all ITS edges, not only changed ones.
318
+ :param show_its_node_changes: Show compact charge/lone-pair changes next to ITS atoms.
319
+ :param show_its_bond_labels: Show ``(before, after)`` labels on changed ITS bonds. Bond color
320
+ already communicates the change, so this is disabled by default
321
+ for cleaner report figures.
322
+ :param show_product: When ``product_graph`` is provided, include a product panel.
323
+ :param show_step_table: Show a compact typed-action key below the mechanism.
324
+ :param max_step_table_rows: Maximum number of transition rows shown in the typed-action key.
325
+ :param molecule_edge_label_mode: ``'none'`` for bond-order strokes only or ``'single'`` for the
326
+ old midpoint bond-symbol labels.
327
+ :param all_graphs: Full list of graphs from the trajectory (reactant + one graph per
328
+ transition step). Required when ``show_elementary_steps=True``.
329
+ :param show_elementary_steps: When ``True``, render one panel per group of ``arrows_per_step``
330
+ transitions instead of the default Reactant + ITS layout.
331
+ :param arrows_per_step: Number of elementary transitions to display per panel.
332
+ """
333
+ transitions = transitions_from_epd(transitions)
334
+
335
+ if show_elementary_steps:
336
+ return self._visualize_elementary_steps(
337
+ reactant_graph=reactant_graph,
338
+ transitions=transitions,
339
+ its_graph=its_graph,
340
+ all_graphs=all_graphs,
341
+ product_graph=product_graph,
342
+ title=title,
343
+ figsize=figsize,
344
+ arrows_per_step=arrows_per_step,
345
+ reference_layout=reference_layout,
346
+ show_atom_map=show_atom_map,
347
+ step_labels=step_labels,
348
+ gap=gap,
349
+ show_legend=show_legend,
350
+ fade_non_rc=fade_non_rc,
351
+ use_rc_glow=use_rc_glow,
352
+ )
353
+
354
+ show_product_panel = bool(show_product and product_graph is not None)
355
+ if figsize is None:
356
+ figsize = (15.6, 5.8) if show_product_panel else (12.4, 5.4)
357
+
358
+ if not show_its:
359
+ raise ValueError("This visualizer is designed for show_its=True.")
360
+
361
+ broken_amap, forming_amap = collect_rc_amap_sets(
362
+ transitions,
363
+ reactant_graph,
364
+ atom_map_key=self.atom_map_key,
365
+ )
366
+
367
+ pos_r_master, pos_its_master = build_shared_layout(
368
+ reactant_graph=reactant_graph,
369
+ its_graph=its_graph,
370
+ atom_map_key=self.atom_map_key,
371
+ reference_layout=reference_layout,
372
+ )
373
+ if show_product_panel:
374
+ pos_p_master, _ = build_shared_layout(
375
+ reactant_graph=product_graph,
376
+ its_graph=its_graph,
377
+ atom_map_key=self.atom_map_key,
378
+ reference_layout=reference_layout,
379
+ )
380
+ pos_r, pos_p, pos_its = _arrange_panels(
381
+ [pos_r_master, pos_p_master, pos_its_master],
382
+ gap,
383
+ )
384
+ else:
385
+ pos_r, pos_its = _arrange_panels([pos_r_master, pos_its_master], gap)
386
+ pos_p = None
387
+
388
+ (
389
+ reactant_existing_edge_colors,
390
+ reactant_missing_edge_colors,
391
+ reactant_missing_edge_orders,
392
+ ) = _edge_overlays(
393
+ graph=reactant_graph,
394
+ broken_amap=broken_amap,
395
+ forming_amap=forming_amap,
396
+ atom_map_key=self.atom_map_key,
397
+ style=self.style,
398
+ missing_order_graph=product_graph,
399
+ product_side=False,
400
+ )
401
+
402
+ product_existing_edge_colors: Dict[Tuple[int, int], str] = {}
403
+ product_missing_edge_colors: Dict[Tuple[int, int], str] = {}
404
+ product_missing_edge_orders: Dict[Tuple[int, int], float] = {}
405
+ if show_product_panel and product_graph is not None:
406
+ (
407
+ product_existing_edge_colors,
408
+ product_missing_edge_colors,
409
+ product_missing_edge_orders,
410
+ ) = _edge_overlays(
411
+ graph=product_graph,
412
+ broken_amap=broken_amap,
413
+ forming_amap=forming_amap,
414
+ atom_map_key=self.atom_map_key,
415
+ style=self.style,
416
+ missing_order_graph=reactant_graph,
417
+ product_side=True,
418
+ )
419
+
420
+ fig, ax = plt.subplots(figsize=figsize)
421
+ fig.patch.set_facecolor(self.style.background_color)
422
+ ax.set_facecolor(self.style.background_color)
423
+
424
+ scale_r = median_bond_length(reactant_graph, pos_r)
425
+ scale_its = median_bond_length(its_graph, pos_its)
426
+ atom_radius_r = 0.20 * scale_r
427
+ atom_radius_its = 0.20 * scale_its
428
+
429
+ draw_graph(
430
+ ax,
431
+ reactant_graph,
432
+ pos_r,
433
+ atom_color_func=self.atom_color,
434
+ style=self.style,
435
+ atom_map_key=self.atom_map_key,
436
+ existing_edge_colors=reactant_existing_edge_colors,
437
+ missing_edge_colors=reactant_missing_edge_colors,
438
+ missing_edge_orders=reactant_missing_edge_orders,
439
+ show_atom_map=show_atom_map,
440
+ atom_radius=atom_radius_r,
441
+ use_rc_glow=use_rc_glow,
442
+ fade_non_rc=fade_non_rc,
443
+ edge_label_mode=molecule_edge_label_mode,
444
+ )
445
+ self.draw_trajectory_arrows(
446
+ ax, reactant_graph, pos_r, transitions, step_labels=step_labels
447
+ )
448
+
449
+ if show_product_panel and product_graph is not None and pos_p is not None:
450
+ scale_p = median_bond_length(product_graph, pos_p)
451
+ draw_graph(
452
+ ax,
453
+ product_graph,
454
+ pos_p,
455
+ atom_color_func=self.atom_color,
456
+ style=self.style,
457
+ atom_map_key=self.atom_map_key,
458
+ existing_edge_colors=product_existing_edge_colors,
459
+ missing_edge_colors=product_missing_edge_colors,
460
+ missing_edge_orders=product_missing_edge_orders,
461
+ show_atom_map=show_atom_map,
462
+ atom_radius=0.20 * scale_p,
463
+ use_rc_glow=use_rc_glow,
464
+ fade_non_rc=fade_non_rc,
465
+ edge_label_mode=molecule_edge_label_mode,
466
+ )
467
+ _draw_panel_arrow(ax, pos_r, pos_p)
468
+
469
+ draw_its_graph(
470
+ ax,
471
+ its_graph,
472
+ pos_its,
473
+ atom_color_func=self.atom_color,
474
+ style=self.style,
475
+ atom_map_key=self.atom_map_key,
476
+ reactant_graph=reactant_graph,
477
+ product_graph=product_graph,
478
+ show_atom_map=show_atom_map,
479
+ atom_radius=atom_radius_its,
480
+ show_all_its_labels=show_all_its_labels,
481
+ use_rc_glow=use_rc_glow,
482
+ fade_non_rc=fade_non_rc,
483
+ show_node_changes=show_its_node_changes,
484
+ show_changed_labels=show_its_bond_labels,
485
+ )
486
+
487
+ panel_positions = [pos_r, pos_its] if pos_p is None else [pos_r, pos_p, pos_its]
488
+ top_y = (
489
+ max(p[1] for pos in panel_positions for p in pos.values()) + 0.66 * scale_r
490
+ )
491
+
492
+ ax.text(
493
+ sum(p[0] for p in pos_r.values()) / len(pos_r),
494
+ top_y,
495
+ "Reactant + electron flow",
496
+ ha="center",
497
+ va="bottom",
498
+ fontsize=self.panel_title_fontsize,
499
+ fontweight="bold",
500
+ color=self.style.panel_title_color,
501
+ )
502
+ if show_product_panel and pos_p is not None:
503
+ ax.text(
504
+ sum(p[0] for p in pos_p.values()) / len(pos_p),
505
+ top_y,
506
+ "Product",
507
+ ha="center",
508
+ va="bottom",
509
+ fontsize=self.panel_title_fontsize,
510
+ fontweight="bold",
511
+ color=self.style.panel_title_color,
512
+ )
513
+ ax.text(
514
+ sum(p[0] for p in pos_its.values()) / len(pos_its),
515
+ top_y,
516
+ "ITS changes",
517
+ ha="center",
518
+ va="bottom",
519
+ fontsize=self.panel_title_fontsize,
520
+ fontweight="bold",
521
+ color=self.style.panel_title_color,
522
+ )
523
+
524
+ if title:
525
+ fig.suptitle(
526
+ title,
527
+ fontsize=self.main_title_fontsize,
528
+ color="#111111",
529
+ y=0.985,
530
+ )
531
+
532
+ if show_step_table:
533
+ _draw_step_key(ax, transitions, self.style, max_step_table_rows)
534
+
535
+ if show_legend:
536
+ add_legend(
537
+ ax,
538
+ self.style,
539
+ transitions=transitions,
540
+ anchor=(0.76, -0.072) if show_step_table else (0.5, -0.025),
541
+ )
542
+
543
+ all_pos = [p for pos in panel_positions for p in pos.values()]
544
+ xs = [p[0] for p in all_pos]
545
+ ys = [p[1] for p in all_pos]
546
+ pad = 0.72 * max(scale_r, scale_its)
547
+
548
+ ax.set_xlim(min(xs) - pad, max(xs) + pad)
549
+ ax.set_ylim(min(ys) - pad, max(ys) + pad)
550
+ ax.set_aspect("equal")
551
+ ax.axis("off")
552
+ plt.tight_layout(
553
+ rect=[0, 0.15 if show_step_table else 0.04, 1, 0.93 if title else 1]
554
+ )
555
+ return fig, ax
556
+
557
+ def _visualize_elementary_steps( # noqa: C901
558
+ self,
559
+ reactant_graph: nx.Graph,
560
+ transitions: Sequence[Any],
561
+ its_graph: nx.Graph,
562
+ all_graphs: Optional[Sequence[nx.Graph]],
563
+ product_graph: Optional[nx.Graph],
564
+ title: str,
565
+ figsize: Optional[Tuple[float, float]],
566
+ arrows_per_step: int,
567
+ reference_layout: str,
568
+ show_atom_map: bool,
569
+ step_labels: bool,
570
+ gap: float,
571
+ show_legend: bool,
572
+ fade_non_rc: bool,
573
+ use_rc_glow: bool,
574
+ ) -> Tuple[plt.Figure, plt.Axes]:
575
+ """Render one panel per ``arrows_per_step`` transitions plus a final product panel."""
576
+ transitions = transitions_from_epd(transitions)
577
+ n = len(transitions)
578
+ n_steps = math.ceil(n / arrows_per_step) if n > 0 else 1
579
+
580
+ # Build (step_graph, step_transitions) pairs
581
+ step_pairs: List[Tuple[nx.Graph, Sequence[Any]]] = []
582
+ for i in range(n_steps):
583
+ start = i * arrows_per_step
584
+ end = min(start + arrows_per_step, n)
585
+ if all_graphs is not None and start < len(all_graphs):
586
+ step_graph = all_graphs[start]
587
+ else:
588
+ step_graph = reactant_graph
589
+ step_pairs.append((step_graph, transitions[start:end]))
590
+
591
+ # Final graph: graph after all transitions
592
+ if all_graphs is not None and len(all_graphs) > n:
593
+ final_graph: Optional[nx.Graph] = all_graphs[n]
594
+ elif product_graph is not None:
595
+ final_graph = product_graph
596
+ else:
597
+ final_graph = None
598
+
599
+ # Compute 2D positions for each panel using the ITS as alignment reference
600
+ panel_pos: List[Dict[int, np.ndarray]] = []
601
+ for step_graph, _ in step_pairs:
602
+ pos_g, _ = build_shared_layout(
603
+ reactant_graph=step_graph,
604
+ its_graph=its_graph,
605
+ atom_map_key=self.atom_map_key,
606
+ reference_layout=reference_layout,
607
+ )
608
+ panel_pos.append(pos_g)
609
+
610
+ if final_graph is not None:
611
+ pos_final, _ = build_shared_layout(
612
+ reactant_graph=final_graph,
613
+ its_graph=its_graph,
614
+ atom_map_key=self.atom_map_key,
615
+ reference_layout=reference_layout,
616
+ )
617
+ panel_pos.append(pos_final)
618
+
619
+ arranged = _arrange_panels(panel_pos, gap)
620
+
621
+ n_panels = len(arranged)
622
+ if figsize is None:
623
+ figsize = (6.5 * n_panels, 5.5)
624
+
625
+ fig, ax = plt.subplots(figsize=figsize)
626
+ fig.patch.set_facecolor(self.style.background_color)
627
+ ax.set_facecolor(self.style.background_color)
628
+
629
+ # Draw each step panel
630
+ for i, (step_graph, step_transitions) in enumerate(step_pairs):
631
+ pos = arranged[i]
632
+ scale = median_bond_length(step_graph, pos)
633
+ atom_radius = 0.25 * scale
634
+
635
+ broken_amap, forming_amap = collect_rc_amap_sets(
636
+ step_transitions, step_graph, atom_map_key=self.atom_map_key
637
+ )
638
+
639
+ existing_edge_colors: Dict = {}
640
+ missing_edge_colors: Dict = {}
641
+ missing_edge_orders: Dict = {}
642
+
643
+ for amap_edge in broken_amap:
644
+ node_edge = edge_nodes_from_amap_key(
645
+ step_graph, amap_edge, atom_map_key=self.atom_map_key
646
+ )
647
+ if node_edge is not None and step_graph.has_edge(*node_edge):
648
+ existing_edge_colors[node_edge] = self.style.broken_color
649
+
650
+ for amap_edge in forming_amap:
651
+ node_edge = edge_nodes_from_amap_key(
652
+ step_graph, amap_edge, atom_map_key=self.atom_map_key
653
+ )
654
+ if node_edge is None:
655
+ continue
656
+ if step_graph.has_edge(*node_edge):
657
+ existing_edge_colors[node_edge] = self.style.forming_color
658
+ else:
659
+ missing_edge_colors[node_edge] = self.style.forming_color
660
+ missing_edge_orders[node_edge] = 1.0
661
+
662
+ draw_graph(
663
+ ax,
664
+ step_graph,
665
+ pos,
666
+ atom_color_func=self.atom_color,
667
+ style=self.style,
668
+ atom_map_key=self.atom_map_key,
669
+ existing_edge_colors=existing_edge_colors,
670
+ missing_edge_colors=missing_edge_colors,
671
+ missing_edge_orders=missing_edge_orders,
672
+ show_atom_map=show_atom_map,
673
+ atom_radius=atom_radius,
674
+ use_rc_glow=use_rc_glow,
675
+ fade_non_rc=fade_non_rc,
676
+ edge_label_mode="none",
677
+ )
678
+ self.draw_trajectory_arrows(
679
+ ax, step_graph, pos, step_transitions, step_labels=step_labels
680
+ )
681
+
682
+ # Panel title
683
+ global_start = i * arrows_per_step + 1
684
+ global_end = min((i + 1) * arrows_per_step, n)
685
+ panel_label = (
686
+ f"Step {i + 1} (arrow {global_start})"
687
+ if global_start == global_end
688
+ else f"Step {i + 1} (arrows {global_start}–{global_end})"
689
+ )
690
+ cx = sum(p[0] for p in pos.values()) / len(pos)
691
+ top_y = max(p[1] for p in pos.values()) + 0.88 * scale
692
+ ax.text(
693
+ cx,
694
+ top_y,
695
+ panel_label,
696
+ ha="center",
697
+ va="bottom",
698
+ fontsize=self.panel_title_fontsize,
699
+ fontweight="bold",
700
+ color=self.style.panel_title_color,
701
+ )
702
+
703
+ # Draw final product panel
704
+ if final_graph is not None:
705
+ pos = arranged[-1]
706
+ scale = median_bond_length(final_graph, pos)
707
+ draw_graph(
708
+ ax,
709
+ final_graph,
710
+ pos,
711
+ atom_color_func=self.atom_color,
712
+ style=self.style,
713
+ atom_map_key=self.atom_map_key,
714
+ show_atom_map=show_atom_map,
715
+ atom_radius=0.25 * scale,
716
+ use_rc_glow=False,
717
+ fade_non_rc=False,
718
+ edge_label_mode="none",
719
+ )
720
+ cx = sum(p[0] for p in pos.values()) / len(pos)
721
+ top_y = max(p[1] for p in pos.values()) + 0.88 * scale
722
+ ax.text(
723
+ cx,
724
+ top_y,
725
+ "Product",
726
+ ha="center",
727
+ va="bottom",
728
+ fontsize=self.panel_title_fontsize,
729
+ fontweight="bold",
730
+ color=self.style.panel_title_color,
731
+ )
732
+
733
+ # --- Reaction arrows between consecutive panels ---
734
+ all_pos_flat = [p for pos in arranged for p in pos.values()]
735
+ scales = [
736
+ median_bond_length(g, arranged[i]) for i, (g, _) in enumerate(step_pairs)
737
+ ]
738
+ ref_scale = scales[0] if scales else 1.0
739
+
740
+ # Vertical center anchors each reaction arrow at a consistent height
741
+ all_y = [p[1] for p in all_pos_flat]
742
+ y_center = (min(all_y) + max(all_y)) / 2.0
743
+
744
+ for i in range(n_panels - 1):
745
+ x_right = max(p[0] for p in arranged[i].values())
746
+ x_left = min(p[0] for p in arranged[i + 1].values())
747
+ x_mid = (x_right + x_left) / 2.0
748
+ margin = 0.08 * gap
749
+
750
+ # Reaction arrow (→) in the gap
751
+ ax.annotate(
752
+ "",
753
+ xy=(x_left - margin, y_center),
754
+ xytext=(x_right + margin, y_center),
755
+ arrowprops=dict(
756
+ arrowstyle="-|>",
757
+ color="#2C3E50",
758
+ lw=3.0,
759
+ mutation_scale=30,
760
+ ),
761
+ annotation_clip=False,
762
+ zorder=15,
763
+ )
764
+
765
+ # Electron-flow labels above the arrow (from the step that bridges panel i → i+1)
766
+ if i < len(step_pairs):
767
+ kinds = [
768
+ _transition_label(t)
769
+ for t in step_pairs[i][1]
770
+ if _transition_label(t)
771
+ ]
772
+ if kinds:
773
+ ax.text(
774
+ x_mid,
775
+ y_center + 0.36 * ref_scale,
776
+ "\n".join(kinds),
777
+ ha="center",
778
+ va="bottom",
779
+ fontsize=12.0,
780
+ color="#1F3A5F",
781
+ family="monospace",
782
+ fontweight="bold",
783
+ linespacing=1.5,
784
+ zorder=16,
785
+ bbox=dict(
786
+ boxstyle="round,pad=0.35",
787
+ fc="white",
788
+ ec="#D0D8E8",
789
+ lw=1.0,
790
+ alpha=0.95,
791
+ ),
792
+ )
793
+
794
+ if title:
795
+ ax.set_title(
796
+ title, fontsize=self.main_title_fontsize, pad=8, color="#111111"
797
+ )
798
+
799
+ if show_legend:
800
+ add_legend(ax, self.style)
801
+
802
+ xs = [p[0] for p in all_pos_flat]
803
+ ys = [p[1] for p in all_pos_flat]
804
+ pad = 0.95 * (max(scales) if scales else 1.0)
805
+
806
+ ax.set_xlim(min(xs) - pad, max(xs) + pad)
807
+ ax.set_ylim(min(ys) - pad, max(ys) + pad)
808
+ ax.set_aspect("equal")
809
+ ax.axis("off")
810
+ plt.tight_layout(rect=[0, 0.08, 1, 1])
811
+ return fig, ax