k3-node 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 (459) hide show
  1. k3_node/__init__.py +122 -0
  2. k3_node/applications/__init__.py +17 -0
  3. k3_node/applications/bio/__init__.py +21 -0
  4. k3_node/applications/chemistry/__init__.py +155 -0
  5. k3_node/applications/materials/__init__.py +127 -0
  6. k3_node/applications/materials/basis.py +449 -0
  7. k3_node/applications/materials/chgnet.py +360 -0
  8. k3_node/applications/materials/core.py +351 -0
  9. k3_node/applications/materials/grace.py +246 -0
  10. k3_node/applications/materials/io.py +230 -0
  11. k3_node/applications/materials/m3gnet.py +462 -0
  12. k3_node/applications/materials/megnet.py +395 -0
  13. k3_node/applications/materials/qet.py +220 -0
  14. k3_node/applications/materials/readout.py +235 -0
  15. k3_node/applications/materials/so3net.py +234 -0
  16. k3_node/applications/materials/tensornet.py +381 -0
  17. k3_node/applications/materials/test_materials.py +167 -0
  18. k3_node/applications/materials/wrappers.py +95 -0
  19. k3_node/data/__init__.py +47 -0
  20. k3_node/data/batch.py +102 -0
  21. k3_node/data/collate.py +282 -0
  22. k3_node/data/data.py +532 -0
  23. k3_node/data/database.py +154 -0
  24. k3_node/data/dataset.py +182 -0
  25. k3_node/data/download.py +49 -0
  26. k3_node/data/extract.py +45 -0
  27. k3_node/data/feature_store.py +70 -0
  28. k3_node/data/graph_store.py +92 -0
  29. k3_node/data/hetero_data.py +374 -0
  30. k3_node/data/hypergraph_data.py +59 -0
  31. k3_node/data/in_memory_dataset.py +177 -0
  32. k3_node/data/makedirs.py +7 -0
  33. k3_node/data/on_disk_dataset.py +77 -0
  34. k3_node/data/separate.py +115 -0
  35. k3_node/data/storage.py +593 -0
  36. k3_node/data/temporal.py +154 -0
  37. k3_node/data/test_batch.py +67 -0
  38. k3_node/data/test_data.py +68 -0
  39. k3_node/data/test_dataset_and_stores.py +111 -0
  40. k3_node/data/test_hetero_data.py +33 -0
  41. k3_node/data/test_temporal_and_hyper.py +32 -0
  42. k3_node/data/view.py +43 -0
  43. k3_node/datasets/__init__.py +88 -0
  44. k3_node/datasets/actor.py +101 -0
  45. k3_node/datasets/airports.py +84 -0
  46. k3_node/datasets/amazon.py +66 -0
  47. k3_node/datasets/ba2motif_dataset.py +73 -0
  48. k3_node/datasets/ba_shapes.py +81 -0
  49. k3_node/datasets/bitcoin_otc.py +77 -0
  50. k3_node/datasets/citation_full.py +81 -0
  51. k3_node/datasets/coauthor.py +66 -0
  52. k3_node/datasets/dblp.py +106 -0
  53. k3_node/datasets/digits.py +63 -0
  54. k3_node/datasets/email_eu_core.py +60 -0
  55. k3_node/datasets/entities.py +158 -0
  56. k3_node/datasets/explainer_dataset.py +101 -0
  57. k3_node/datasets/facebook.py +51 -0
  58. k3_node/datasets/fake.py +256 -0
  59. k3_node/datasets/freebase.py +90 -0
  60. k3_node/datasets/geometric_shapes.py +69 -0
  61. k3_node/datasets/github.py +51 -0
  62. k3_node/datasets/graph_generator/__init__.py +6 -0
  63. k3_node/datasets/graph_generator/ba_graph.py +20 -0
  64. k3_node/datasets/graph_generator/base.py +29 -0
  65. k3_node/datasets/graph_generator/er_graph.py +21 -0
  66. k3_node/datasets/icews.py +58 -0
  67. k3_node/datasets/imdb.py +96 -0
  68. k3_node/datasets/jodie.py +56 -0
  69. k3_node/datasets/karate.py +56 -0
  70. k3_node/datasets/lastfm_asia.py +51 -0
  71. k3_node/datasets/mesh_correspondence.py +50 -0
  72. k3_node/datasets/molecule_net.py +148 -0
  73. k3_node/datasets/motif_generator/__init__.py +7 -0
  74. k3_node/datasets/motif_generator/base.py +29 -0
  75. k3_node/datasets/motif_generator/custom.py +17 -0
  76. k3_node/datasets/motif_generator/cycle.py +25 -0
  77. k3_node/datasets/motif_generator/house.py +27 -0
  78. k3_node/datasets/movielens.py +55 -0
  79. k3_node/datasets/planetoid.py +137 -0
  80. k3_node/datasets/polblogs.py +63 -0
  81. k3_node/datasets/ppi.py +189 -0
  82. k3_node/datasets/qm7.py +65 -0
  83. k3_node/datasets/qm9.py +132 -0
  84. k3_node/datasets/reddit.py +121 -0
  85. k3_node/datasets/sbm_dataset.py +165 -0
  86. k3_node/datasets/seal.py +74 -0
  87. k3_node/datasets/shape_scenes.py +92 -0
  88. k3_node/datasets/test_datasets.py +322 -0
  89. k3_node/datasets/tu_dataset.py +131 -0
  90. k3_node/datasets/twitch.py +66 -0
  91. k3_node/datasets/webkb.py +102 -0
  92. k3_node/datasets/wikics.py +85 -0
  93. k3_node/datasets/word_net.py +184 -0
  94. k3_node/etl/__init__.py +37 -0
  95. k3_node/etl/encoders.py +248 -0
  96. k3_node/etl/graph_builders.py +270 -0
  97. k3_node/etl/relational_to_graph.py +201 -0
  98. k3_node/etl/table_to_graph.py +244 -0
  99. k3_node/etl/test_etl.py +318 -0
  100. k3_node/export/__init__.py +15 -0
  101. k3_node/export/cross_backend.py +172 -0
  102. k3_node/export/onnx_exporter.py +190 -0
  103. k3_node/export/runtime.py +254 -0
  104. k3_node/export/tensorrt_exporter.py +201 -0
  105. k3_node/export/test_export.py +337 -0
  106. k3_node/export/tflite_exporter.py +112 -0
  107. k3_node/hub/__init__.py +29 -0
  108. k3_node/hub/dataset_hub.py +242 -0
  109. k3_node/hub/hub_mixin.py +599 -0
  110. k3_node/hub/model_card.py +133 -0
  111. k3_node/hub/test_hub.py +419 -0
  112. k3_node/io/__init__.py +22 -0
  113. k3_node/io/fs.py +117 -0
  114. k3_node/io/npz.py +45 -0
  115. k3_node/io/off.py +29 -0
  116. k3_node/io/planetoid.py +98 -0
  117. k3_node/io/tu.py +137 -0
  118. k3_node/io/txt_array.py +58 -0
  119. k3_node/layers/__init__.py +14 -0
  120. k3_node/layers/aggr/__init__.py +70 -0
  121. k3_node/layers/aggr/attention.py +77 -0
  122. k3_node/layers/aggr/base.py +403 -0
  123. k3_node/layers/aggr/basic.py +412 -0
  124. k3_node/layers/aggr/deep_sets.py +65 -0
  125. k3_node/layers/aggr/deepsets.py +29 -0
  126. k3_node/layers/aggr/equilibrium.py +107 -0
  127. k3_node/layers/aggr/fused.py +43 -0
  128. k3_node/layers/aggr/gmt.py +89 -0
  129. k3_node/layers/aggr/gru.py +58 -0
  130. k3_node/layers/aggr/lcm.py +143 -0
  131. k3_node/layers/aggr/lstm.py +58 -0
  132. k3_node/layers/aggr/mlp.py +75 -0
  133. k3_node/layers/aggr/multi.py +154 -0
  134. k3_node/layers/aggr/patch_transformer.py +137 -0
  135. k3_node/layers/aggr/quantile.py +125 -0
  136. k3_node/layers/aggr/resolver.py +68 -0
  137. k3_node/layers/aggr/scaler.py +133 -0
  138. k3_node/layers/aggr/set2set.py +87 -0
  139. k3_node/layers/aggr/set_transformer.py +107 -0
  140. k3_node/layers/aggr/sort.py +68 -0
  141. k3_node/layers/aggr/test_aggr.py +337 -0
  142. k3_node/layers/aggr/utils.py +210 -0
  143. k3_node/layers/aggr/variance_preserving.py +54 -0
  144. k3_node/layers/attention/__init__.py +5 -0
  145. k3_node/layers/attention/pair_attention.py +448 -0
  146. k3_node/layers/attention/performer.py +187 -0
  147. k3_node/layers/attention/polynormer.py +160 -0
  148. k3_node/layers/attention/qformer.py +143 -0
  149. k3_node/layers/attention/sgformer.py +106 -0
  150. k3_node/layers/attention/test_attention.py +68 -0
  151. k3_node/layers/attention/test_pair_attention.py +91 -0
  152. k3_node/layers/conv/__init__.py +149 -0
  153. k3_node/layers/conv/agnn_conv.py +120 -0
  154. k3_node/layers/conv/antisymmetric_conv.py +94 -0
  155. k3_node/layers/conv/appnp.py +105 -0
  156. k3_node/layers/conv/appnp_conv.py +157 -0
  157. k3_node/layers/conv/arma_conv.py +231 -0
  158. k3_node/layers/conv/cg_conv.py +92 -0
  159. k3_node/layers/conv/cheb_conv.py +137 -0
  160. k3_node/layers/conv/cluster_gcn_conv.py +102 -0
  161. k3_node/layers/conv/conv.py +100 -0
  162. k3_node/layers/conv/crystal_conv.py +140 -0
  163. k3_node/layers/conv/cugraph.py +84 -0
  164. k3_node/layers/conv/diffusion_conv.py +144 -0
  165. k3_node/layers/conv/dir_gnn_conv.py +93 -0
  166. k3_node/layers/conv/dna_conv.py +192 -0
  167. k3_node/layers/conv/edge_conv.py +107 -0
  168. k3_node/layers/conv/eg_conv.py +155 -0
  169. k3_node/layers/conv/fa_conv.py +107 -0
  170. k3_node/layers/conv/feast_conv.py +126 -0
  171. k3_node/layers/conv/film_conv.py +143 -0
  172. k3_node/layers/conv/gat_conv.py +244 -0
  173. k3_node/layers/conv/gated_graph_conv.py +136 -0
  174. k3_node/layers/conv/gatv2_conv.py +205 -0
  175. k3_node/layers/conv/gcn.py +144 -0
  176. k3_node/layers/conv/gcn2_conv.py +126 -0
  177. k3_node/layers/conv/gcn_conv.py +135 -0
  178. k3_node/layers/conv/gen_conv.py +163 -0
  179. k3_node/layers/conv/general_conv.py +218 -0
  180. k3_node/layers/conv/gin_conv.py +218 -0
  181. k3_node/layers/conv/gmm_conv.py +172 -0
  182. k3_node/layers/conv/gps_conv.py +153 -0
  183. k3_node/layers/conv/graph_attention.py +262 -0
  184. k3_node/layers/conv/graph_conv.py +84 -0
  185. k3_node/layers/conv/gravnet_conv.py +93 -0
  186. k3_node/layers/conv/han_conv.py +175 -0
  187. k3_node/layers/conv/heat_conv.py +131 -0
  188. k3_node/layers/conv/hetero_conv.py +128 -0
  189. k3_node/layers/conv/hgt_conv.py +218 -0
  190. k3_node/layers/conv/hypergraph_conv.py +182 -0
  191. k3_node/layers/conv/le_conv.py +81 -0
  192. k3_node/layers/conv/lg_conv.py +58 -0
  193. k3_node/layers/conv/meshcnn_conv.py +84 -0
  194. k3_node/layers/conv/message_passing.py +451 -0
  195. k3_node/layers/conv/mf_conv.py +95 -0
  196. k3_node/layers/conv/mixhop_conv.py +108 -0
  197. k3_node/layers/conv/nn_conv.py +110 -0
  198. k3_node/layers/conv/pan_conv.py +100 -0
  199. k3_node/layers/conv/pdn_conv.py +109 -0
  200. k3_node/layers/conv/pna_conv.py +177 -0
  201. k3_node/layers/conv/point_conv.py +101 -0
  202. k3_node/layers/conv/point_gnn_conv.py +90 -0
  203. k3_node/layers/conv/point_transformer_conv.py +132 -0
  204. k3_node/layers/conv/ppf_conv.py +135 -0
  205. k3_node/layers/conv/ppnp.py +89 -0
  206. k3_node/layers/conv/res_gated_graph_conv.py +126 -0
  207. k3_node/layers/conv/rgat_conv.py +251 -0
  208. k3_node/layers/conv/rgcn_conv.py +321 -0
  209. k3_node/layers/conv/sage_conv.py +154 -0
  210. k3_node/layers/conv/sg_conv.py +96 -0
  211. k3_node/layers/conv/signed_conv.py +100 -0
  212. k3_node/layers/conv/simple_conv.py +75 -0
  213. k3_node/layers/conv/spline_conv.py +182 -0
  214. k3_node/layers/conv/ssg_conv.py +101 -0
  215. k3_node/layers/conv/supergat_conv.py +195 -0
  216. k3_node/layers/conv/tag_conv.py +98 -0
  217. k3_node/layers/conv/test_backend_consistency.py +164 -0
  218. k3_node/layers/conv/test_conv.py +176 -0
  219. k3_node/layers/conv/test_conv_pyg.py +566 -0
  220. k3_node/layers/conv/transformer_conv.py +168 -0
  221. k3_node/layers/conv/utils.py +403 -0
  222. k3_node/layers/conv/wl_conv.py +151 -0
  223. k3_node/layers/conv/x_conv.py +187 -0
  224. k3_node/layers/dense/__init__.py +40 -0
  225. k3_node/layers/dense/dense_gat_conv.py +149 -0
  226. k3_node/layers/dense/dense_gcn_conv.py +117 -0
  227. k3_node/layers/dense/dense_gin_conv.py +88 -0
  228. k3_node/layers/dense/dense_graph_conv.py +95 -0
  229. k3_node/layers/dense/dense_sage_conv.py +85 -0
  230. k3_node/layers/dense/diff_pool.py +76 -0
  231. k3_node/layers/dense/dmon_pool.py +223 -0
  232. k3_node/layers/dense/linear.py +327 -0
  233. k3_node/layers/dense/mincut_pool.py +92 -0
  234. k3_node/layers/dense/test_dense.py +377 -0
  235. k3_node/layers/functional/__init__.py +13 -0
  236. k3_node/layers/functional/bro.py +49 -0
  237. k3_node/layers/functional/edge_dropout.py +55 -0
  238. k3_node/layers/functional/gini.py +44 -0
  239. k3_node/layers/functional/test_functional.py +34 -0
  240. k3_node/layers/kge/__init__.py +17 -0
  241. k3_node/layers/kge/base.py +255 -0
  242. k3_node/layers/kge/complex.py +98 -0
  243. k3_node/layers/kge/distmult.py +79 -0
  244. k3_node/layers/kge/loader.py +50 -0
  245. k3_node/layers/kge/rotate.py +103 -0
  246. k3_node/layers/kge/test_kge.py +76 -0
  247. k3_node/layers/kge/transe.py +96 -0
  248. k3_node/layers/norm/__init__.py +23 -0
  249. k3_node/layers/norm/batch_norm.py +328 -0
  250. k3_node/layers/norm/diff_group_norm.py +141 -0
  251. k3_node/layers/norm/graph_norm.py +105 -0
  252. k3_node/layers/norm/graph_size_norm.py +57 -0
  253. k3_node/layers/norm/instance_norm.py +163 -0
  254. k3_node/layers/norm/layer_norm.py +245 -0
  255. k3_node/layers/norm/mean_subtraction_norm.py +57 -0
  256. k3_node/layers/norm/msg_norm.py +58 -0
  257. k3_node/layers/norm/pair_norm.py +94 -0
  258. k3_node/layers/norm/test_norm.py +275 -0
  259. k3_node/layers/pool/__init__.py +83 -0
  260. k3_node/layers/pool/approx_knn.py +101 -0
  261. k3_node/layers/pool/asap.py +173 -0
  262. k3_node/layers/pool/avg_pool.py +165 -0
  263. k3_node/layers/pool/cluster_pool.py +168 -0
  264. k3_node/layers/pool/connect/__init__.py +10 -0
  265. k3_node/layers/pool/connect/base.py +103 -0
  266. k3_node/layers/pool/connect/filter_edges.py +113 -0
  267. k3_node/layers/pool/consecutive.py +30 -0
  268. k3_node/layers/pool/decimation.py +48 -0
  269. k3_node/layers/pool/edge_pool.py +189 -0
  270. k3_node/layers/pool/glob.py +139 -0
  271. k3_node/layers/pool/graclus.py +66 -0
  272. k3_node/layers/pool/knn.py +253 -0
  273. k3_node/layers/pool/max_pool.py +159 -0
  274. k3_node/layers/pool/mem_pool.py +145 -0
  275. k3_node/layers/pool/pan_pool.py +144 -0
  276. k3_node/layers/pool/point_cloud.py +212 -0
  277. k3_node/layers/pool/pool.py +119 -0
  278. k3_node/layers/pool/sag_pool.py +174 -0
  279. k3_node/layers/pool/select/__init__.py +10 -0
  280. k3_node/layers/pool/select/base.py +112 -0
  281. k3_node/layers/pool/select/topk.py +206 -0
  282. k3_node/layers/pool/test_pool.py +456 -0
  283. k3_node/layers/pool/topk_pool.py +103 -0
  284. k3_node/layers/pool/voxel_grid.py +70 -0
  285. k3_node/layers/unpool/__init__.py +9 -0
  286. k3_node/layers/unpool/knn_interpolate.py +57 -0
  287. k3_node/layers/unpool/test_unpool.py +31 -0
  288. k3_node/loader/__init__.py +62 -0
  289. k3_node/loader/base.py +69 -0
  290. k3_node/loader/cache.py +68 -0
  291. k3_node/loader/cluster.py +127 -0
  292. k3_node/loader/data_list_loader.py +45 -0
  293. k3_node/loader/dataloader.py +117 -0
  294. k3_node/loader/dense_data_loader.py +62 -0
  295. k3_node/loader/dynamic_batch_sampler.py +93 -0
  296. k3_node/loader/graph_saint.py +188 -0
  297. k3_node/loader/hgt_loader.py +90 -0
  298. k3_node/loader/imbalanced_sampler.py +87 -0
  299. k3_node/loader/keras_dataset.py +334 -0
  300. k3_node/loader/link_loader.py +179 -0
  301. k3_node/loader/link_neighbor_loader.py +202 -0
  302. k3_node/loader/mixin.py +190 -0
  303. k3_node/loader/neighbor_loader.py +159 -0
  304. k3_node/loader/neighbor_sampler.py +167 -0
  305. k3_node/loader/node_loader.py +185 -0
  306. k3_node/loader/prefetch.py +115 -0
  307. k3_node/loader/random_node_loader.py +89 -0
  308. k3_node/loader/sampler_utils.py +499 -0
  309. k3_node/loader/shadow.py +115 -0
  310. k3_node/loader/temporal_dataloader.py +98 -0
  311. k3_node/loader/test_dataloader.py +113 -0
  312. k3_node/loader/test_keras_dataset.py +221 -0
  313. k3_node/loader/test_neighbor_loader.py +122 -0
  314. k3_node/loader/test_sampler_utils.py +82 -0
  315. k3_node/loader/test_samplers.py +96 -0
  316. k3_node/loader/test_subgraph_loaders.py +89 -0
  317. k3_node/loader/utils.py +232 -0
  318. k3_node/loader/zip_loader.py +88 -0
  319. k3_node/metrics.py +94 -0
  320. k3_node/models/__init__.py +424 -0
  321. k3_node/models/attentive_fp.py +232 -0
  322. k3_node/models/attract_repel.py +108 -0
  323. k3_node/models/autoencoder.py +318 -0
  324. k3_node/models/basic_gnn.py +443 -0
  325. k3_node/models/bio/__init__.py +4 -0
  326. k3_node/models/captum.py +52 -0
  327. k3_node/models/chemistry/__init__.py +4 -0
  328. k3_node/models/correct_and_smooth.py +146 -0
  329. k3_node/models/deep_graph_infomax.py +113 -0
  330. k3_node/models/deepgcn.py +121 -0
  331. k3_node/models/dimenet.py +737 -0
  332. k3_node/models/dimenet_utils.py +153 -0
  333. k3_node/models/gnnff.py +263 -0
  334. k3_node/models/gps_model.py +1122 -0
  335. k3_node/models/gpse.py +638 -0
  336. k3_node/models/graph_unet.py +199 -0
  337. k3_node/models/graphmae2.py +954 -0
  338. k3_node/models/graphormer.py +1258 -0
  339. k3_node/models/graphormer_3d.py +868 -0
  340. k3_node/models/grover.py +1066 -0
  341. k3_node/models/jumping_knowledge.py +200 -0
  342. k3_node/models/label_prop.py +110 -0
  343. k3_node/models/lightgcn.py +171 -0
  344. k3_node/models/linkx.py +181 -0
  345. k3_node/models/lpformer.py +404 -0
  346. k3_node/models/mask_label.py +114 -0
  347. k3_node/models/materials/__init__.py +33 -0
  348. k3_node/models/meta.py +133 -0
  349. k3_node/models/metapath2vec.py +234 -0
  350. k3_node/models/mlp.py +264 -0
  351. k3_node/models/mole_bert.py +379 -0
  352. k3_node/models/neural_fingerprint.py +95 -0
  353. k3_node/models/node2vec.py +213 -0
  354. k3_node/models/pmlp.py +157 -0
  355. k3_node/models/polynormer.py +229 -0
  356. k3_node/models/rect.py +93 -0
  357. k3_node/models/renet.py +221 -0
  358. k3_node/models/rev_gnn.py +128 -0
  359. k3_node/models/schnet.py +484 -0
  360. k3_node/models/sgformer.py +195 -0
  361. k3_node/models/signed_gcn.py +185 -0
  362. k3_node/models/test_attentive_fp.py +32 -0
  363. k3_node/models/test_attract_repel.py +33 -0
  364. k3_node/models/test_autoencoder.py +119 -0
  365. k3_node/models/test_basic_gnn.py +102 -0
  366. k3_node/models/test_correct_and_smooth.py +40 -0
  367. k3_node/models/test_deep_graph_infomax.py +68 -0
  368. k3_node/models/test_deepgcn.py +21 -0
  369. k3_node/models/test_dimenet.py +86 -0
  370. k3_node/models/test_domain_apis.py +138 -0
  371. k3_node/models/test_gnnff.py +24 -0
  372. k3_node/models/test_gps_model.py +271 -0
  373. k3_node/models/test_gpse.py +34 -0
  374. k3_node/models/test_graph_unet.py +26 -0
  375. k3_node/models/test_graphmae2.py +226 -0
  376. k3_node/models/test_graphormer.py +233 -0
  377. k3_node/models/test_graphormer3d.py +163 -0
  378. k3_node/models/test_grover.py +287 -0
  379. k3_node/models/test_jumping_knowledge.py +129 -0
  380. k3_node/models/test_label_prop.py +37 -0
  381. k3_node/models/test_lightgcn.py +38 -0
  382. k3_node/models/test_linkx.py +31 -0
  383. k3_node/models/test_lpformer.py +22 -0
  384. k3_node/models/test_mask_label.py +90 -0
  385. k3_node/models/test_meta.py +159 -0
  386. k3_node/models/test_metapath2vec.py +45 -0
  387. k3_node/models/test_mlp.py +62 -0
  388. k3_node/models/test_mole_bert.py +164 -0
  389. k3_node/models/test_neural_fingerprint.py +13 -0
  390. k3_node/models/test_node2vec.py +57 -0
  391. k3_node/models/test_pmlp.py +81 -0
  392. k3_node/models/test_polynormer.py +104 -0
  393. k3_node/models/test_rect.py +23 -0
  394. k3_node/models/test_renet.py +32 -0
  395. k3_node/models/test_rev_gnn.py +24 -0
  396. k3_node/models/test_schnet.py +43 -0
  397. k3_node/models/test_sgformer.py +48 -0
  398. k3_node/models/test_signed_gcn.py +28 -0
  399. k3_node/models/test_tgn.py +77 -0
  400. k3_node/models/test_unimol.py +179 -0
  401. k3_node/models/test_unimol2.py +114 -0
  402. k3_node/models/test_unimol_plus.py +131 -0
  403. k3_node/models/test_visnet.py +44 -0
  404. k3_node/models/tgn.py +382 -0
  405. k3_node/models/unimol.py +1156 -0
  406. k3_node/models/unimol2.py +616 -0
  407. k3_node/models/unimol_docking_v2.py +301 -0
  408. k3_node/models/unimol_plus.py +456 -0
  409. k3_node/models/utils.py +97 -0
  410. k3_node/models/visnet.py +759 -0
  411. k3_node/ops/__init__.py +4 -0
  412. k3_node/ops/conv.py +56 -0
  413. k3_node/ops/creation.py +43 -0
  414. k3_node/ops/graph.py +27 -0
  415. k3_node/ops/host.py +41 -0
  416. k3_node/ops/matmul.py +49 -0
  417. k3_node/ops/numpy.py +24 -0
  418. k3_node/ops/segment.py +54 -0
  419. k3_node/ops/sparse.py +51 -0
  420. k3_node/rag/__init__.py +49 -0
  421. k3_node/rag/encoders.py +312 -0
  422. k3_node/rag/pipeline.py +192 -0
  423. k3_node/rag/projector.py +184 -0
  424. k3_node/rag/subgraph.py +270 -0
  425. k3_node/rag/test_rag.py +347 -0
  426. k3_node/rag/verbalizer.py +162 -0
  427. k3_node/tasks/__init__.py +19 -0
  428. k3_node/tasks/backbone_resolver.py +125 -0
  429. k3_node/tasks/base.py +67 -0
  430. k3_node/tasks/graph_classification.py +270 -0
  431. k3_node/tasks/graph_regression.py +228 -0
  432. k3_node/tasks/link_prediction.py +306 -0
  433. k3_node/tasks/node_classification.py +194 -0
  434. k3_node/tasks/node_regression.py +138 -0
  435. k3_node/tasks/test_tasks.py +319 -0
  436. k3_node/test_docstring_examples.py +106 -0
  437. k3_node/test_training_forwarding.py +116 -0
  438. k3_node/training.py +115 -0
  439. k3_node/transforms/__init__.py +166 -0
  440. k3_node/transforms/base_transform.py +32 -0
  441. k3_node/transforms/compose.py +58 -0
  442. k3_node/transforms/general.py +676 -0
  443. k3_node/transforms/graph.py +1070 -0
  444. k3_node/transforms/spatial.py +797 -0
  445. k3_node/transforms/test_random_link_split.py +45 -0
  446. k3_node/transforms/test_spatial_transforms.py +65 -0
  447. k3_node/transforms/test_transforms.py +253 -0
  448. k3_node/transforms/utils.py +102 -0
  449. k3_node/utils/__init__.py +5 -0
  450. k3_node/utils/backend_import.py +12 -0
  451. k3_node/utils/graph.py +286 -0
  452. k3_node/utils/keras.py +94 -0
  453. k3_node/utils/random.py +103 -0
  454. k3_node/utils/smiles.py +235 -0
  455. k3_node-1.0.0.dist-info/METADATA +284 -0
  456. k3_node-1.0.0.dist-info/RECORD +459 -0
  457. k3_node-1.0.0.dist-info/WHEEL +5 -0
  458. k3_node-1.0.0.dist-info/licenses/LICENSE +21 -0
  459. k3_node-1.0.0.dist-info/top_level.txt +1 -0
@@ -0,0 +1,759 @@
1
+ import math
2
+ from typing import Optional, Tuple
3
+ import numpy as np
4
+ import keras
5
+ from keras import ops
6
+
7
+ from k3_node.layers.aggr import SumAggregation
8
+ from k3_node.layers.pool import radius_graph, global_add_pool, global_mean_pool
9
+
10
+
11
+ class CosineCutoff(keras.layers.Layer):
12
+ r"""Applies a cosine cutoff to input distances."""
13
+ def __init__(self, cutoff: float, **kwargs):
14
+ super().__init__(**kwargs)
15
+ self.cutoff = cutoff
16
+
17
+ def build(self, input_shape=None):
18
+ self.built = True
19
+
20
+ def call(self, distances):
21
+ cutoffs = 0.5 * (ops.cos(distances * np.pi / self.cutoff) + 1.0)
22
+ mask = ops.cast(distances < self.cutoff, cutoffs.dtype)
23
+ return cutoffs * mask
24
+
25
+
26
+ class ExpNormalSmearing(keras.layers.Layer):
27
+ r"""Applies exponential normal smearing to input distances."""
28
+ def __init__(
29
+ self,
30
+ cutoff: float = 5.0,
31
+ num_rbf: int = 128,
32
+ trainable: bool = True,
33
+ **kwargs,
34
+ ):
35
+ super().__init__(**kwargs)
36
+ self.cutoff = cutoff
37
+ self.num_rbf = num_rbf
38
+ self.cutoff_fn = CosineCutoff(cutoff)
39
+ self.alpha = 5.0 / cutoff
40
+
41
+ start_value = float(np.exp(-cutoff))
42
+ means = np.linspace(start_value, 1.0, num_rbf, dtype=np.float32)
43
+ betas = np.full((num_rbf,), (2.0 / num_rbf * (1.0 - start_value)) ** -2, dtype=np.float32)
44
+
45
+ self.means = self.add_weight(
46
+ name="means",
47
+ shape=(num_rbf,),
48
+ initializer=keras.initializers.Constant(means),
49
+ trainable=trainable,
50
+ dtype="float32",
51
+ )
52
+ self.betas = self.add_weight(
53
+ name="betas",
54
+ shape=(num_rbf,),
55
+ initializer=keras.initializers.Constant(betas),
56
+ trainable=trainable,
57
+ dtype="float32",
58
+ )
59
+
60
+ def build(self, input_shape=None):
61
+ if hasattr(self.cutoff_fn, "built") and not self.cutoff_fn.built:
62
+ self.cutoff_fn.build(input_shape)
63
+ self.built = True
64
+
65
+ def call(self, dist):
66
+ dist = ops.expand_dims(dist, -1)
67
+ exp_dist = ops.exp(self.alpha * (-dist))
68
+ diff = exp_dist - ops.expand_dims(self.means, 0)
69
+ smeared = self.cutoff_fn(dist) * ops.exp(-ops.expand_dims(self.betas, 0) * ops.power(diff, 2))
70
+ return smeared
71
+
72
+
73
+ class Sphere(keras.layers.Layer):
74
+ r"""Computes spherical harmonics of 3D vectors up to degree lmax (1 or 2)."""
75
+ def __init__(self, lmax: int = 1, **kwargs):
76
+ super().__init__(**kwargs)
77
+ self.lmax = lmax
78
+
79
+ def build(self, input_shape=None):
80
+ self.built = True
81
+
82
+ def call(self, edge_vec):
83
+ x = edge_vec[..., 0]
84
+ y = edge_vec[..., 1]
85
+ z = edge_vec[..., 2]
86
+
87
+ sh_1_0, sh_1_1, sh_1_2 = x, y, z
88
+ if self.lmax == 1:
89
+ return ops.stack([sh_1_0, sh_1_1, sh_1_2], axis=-1)
90
+
91
+ sh_2_0 = math.sqrt(3.0) * x * z
92
+ sh_2_1 = math.sqrt(3.0) * x * y
93
+ y2 = ops.power(y, 2)
94
+ x2z2 = ops.power(x, 2) + ops.power(z, 2)
95
+ sh_2_2 = y2 - 0.5 * x2z2
96
+ sh_2_3 = math.sqrt(3.0) * y * z
97
+ sh_2_4 = math.sqrt(3.0) / 2.0 * (ops.power(z, 2) - ops.power(x, 2))
98
+
99
+ if self.lmax == 2:
100
+ return ops.stack([
101
+ sh_1_0, sh_1_1, sh_1_2,
102
+ sh_2_0, sh_2_1, sh_2_2, sh_2_3, sh_2_4,
103
+ ], axis=-1)
104
+
105
+ raise ValueError(f"'lmax' needs to be 1 or 2 (got {self.lmax})")
106
+
107
+
108
+ class VecLayerNorm(keras.layers.Layer):
109
+ r"""Layer normalization for 3D vector channels."""
110
+ def __init__(
111
+ self,
112
+ hidden_channels: int,
113
+ trainable: bool = False,
114
+ norm_type: Optional[str] = "max_min",
115
+ **kwargs,
116
+ ):
117
+ super().__init__(**kwargs)
118
+ self.hidden_channels = hidden_channels
119
+ self.norm_type = norm_type
120
+ self.eps = 1e-12
121
+
122
+ self.weight_param = self.add_weight(
123
+ name="weight",
124
+ shape=(hidden_channels,),
125
+ initializer="ones",
126
+ trainable=trainable,
127
+ dtype="float32",
128
+ )
129
+
130
+ def build(self, input_shape=None):
131
+ self.built = True
132
+
133
+ def max_min_norm(self, vec):
134
+ dist = ops.sqrt(ops.sum(ops.power(vec, 2), axis=1, keepdims=True)) + self.eps
135
+ direct = vec / dist
136
+
137
+ max_val = ops.max(dist, axis=-1, keepdims=True)
138
+ min_val = ops.min(dist, axis=-1, keepdims=True)
139
+ delta = max_val - min_val
140
+ delta = ops.where(delta == 0, ops.ones_like(delta), delta)
141
+ dist = (dist - min_val) / delta
142
+ return ops.relu(dist) * direct
143
+
144
+ def call(self, vec):
145
+ c = ops.shape(vec)[1]
146
+ if c == 3:
147
+ if self.norm_type == "max_min":
148
+ vec = self.max_min_norm(vec)
149
+ w = ops.reshape(self.weight_param, (1, 1, self.hidden_channels))
150
+ return vec * w
151
+ elif c == 8:
152
+ vec1 = vec[:, :3]
153
+ vec2 = vec[:, 3:]
154
+ if self.norm_type == "max_min":
155
+ vec1 = self.max_min_norm(vec1)
156
+ vec2 = self.max_min_norm(vec2)
157
+ vec = ops.concatenate([vec1, vec2], axis=1)
158
+ w = ops.reshape(self.weight_param, (1, 1, self.hidden_channels))
159
+ return vec * w
160
+
161
+ return vec
162
+
163
+
164
+ class Distance(keras.layers.Layer):
165
+ r"""Pairwise distances and directions between atoms within cutoff."""
166
+ def __init__(
167
+ self,
168
+ cutoff: float,
169
+ max_num_neighbors: int = 32,
170
+ add_self_loops: bool = True,
171
+ **kwargs,
172
+ ):
173
+ super().__init__(**kwargs)
174
+ self.cutoff = cutoff
175
+ self.max_num_neighbors = max_num_neighbors
176
+ self.add_self_loops = add_self_loops
177
+
178
+ def build(self, input_shape=None):
179
+ self.built = True
180
+
181
+ def call(self, pos, batch=None):
182
+ edge_index = radius_graph(
183
+ pos,
184
+ r=self.cutoff,
185
+ batch=batch,
186
+ loop=self.add_self_loops,
187
+ max_num_neighbors=self.max_num_neighbors,
188
+ )
189
+ row = edge_index[0]
190
+ col = edge_index[1]
191
+ pos_row = ops.take(pos, row, axis=0)
192
+ pos_col = ops.take(pos, col, axis=0)
193
+ edge_vec = pos_row - pos_col
194
+ edge_weight = ops.sqrt(ops.sum(ops.power(edge_vec, 2), axis=-1))
195
+
196
+ if self.add_self_loops:
197
+ mask = row != col
198
+ edge_weight = ops.where(mask, edge_weight, ops.zeros_like(edge_weight))
199
+
200
+ return edge_index, edge_weight, edge_vec
201
+
202
+
203
+ class NeighborEmbedding(keras.layers.Layer):
204
+ def __init__(
205
+ self,
206
+ hidden_channels: int,
207
+ num_rbf: int,
208
+ cutoff: float,
209
+ max_z: int = 100,
210
+ **kwargs,
211
+ ):
212
+ super().__init__(**kwargs)
213
+ self.hidden_channels = hidden_channels
214
+ self.num_rbf = num_rbf
215
+ self.embedding = keras.layers.Embedding(max_z, hidden_channels)
216
+ self.distance_proj = keras.layers.Dense(hidden_channels)
217
+ self.combine = keras.layers.Dense(hidden_channels)
218
+ self.cutoff = CosineCutoff(cutoff)
219
+ self.sum_aggr = SumAggregation()
220
+
221
+ def build(self, input_shape=None):
222
+ if hasattr(self.embedding, "built") and not self.embedding.built:
223
+ self.embedding.build((None,))
224
+ if hasattr(self.distance_proj, "built") and not self.distance_proj.built:
225
+ self.distance_proj.build((None, self.num_rbf))
226
+ if hasattr(self.combine, "built") and not self.combine.built:
227
+ self.combine.build((None, self.hidden_channels * 2))
228
+ if hasattr(self.cutoff, "built") and not self.cutoff.built:
229
+ self.cutoff.build()
230
+ self.built = True
231
+
232
+ def call(self, z, x, edge_index, edge_weight, edge_attr):
233
+ row = edge_index[0]
234
+ col = edge_index[1]
235
+ mask = row != col
236
+
237
+ where_mask = ops.where(mask)
238
+ indices = where_mask[0] if isinstance(where_mask, (tuple, list)) else where_mask
239
+ indices = ops.reshape(indices, (-1,))
240
+
241
+ row = ops.reshape(ops.take(row, indices, axis=0), (-1,))
242
+ col = ops.reshape(ops.take(col, indices, axis=0), (-1,))
243
+ edge_weight = ops.reshape(ops.take(edge_weight, indices, axis=0), (-1,))
244
+ edge_attr = ops.take(edge_attr, indices, axis=0)
245
+
246
+ C = self.cutoff(edge_weight)
247
+ W = self.distance_proj(edge_attr) * ops.expand_dims(C, -1)
248
+
249
+ z = ops.cast(z, "int32")
250
+ h = self.embedding(z)
251
+ h_j = ops.take(h, row, axis=0)
252
+ msg = h_j * W
253
+
254
+ num_nodes = ops.shape(x)[0]
255
+ x_neighbors = self.sum_aggr(msg, index=col, dim_size=num_nodes)
256
+ x_neighbors = self.combine(ops.concatenate([x, x_neighbors], axis=1))
257
+ return x_neighbors
258
+
259
+
260
+ class EdgeEmbedding(keras.layers.Layer):
261
+ def __init__(self, num_rbf: int, hidden_channels: int, **kwargs):
262
+ super().__init__(**kwargs)
263
+ self.num_rbf = num_rbf
264
+ self.hidden_channels = hidden_channels
265
+ self.edge_proj = keras.layers.Dense(hidden_channels)
266
+
267
+ def build(self, input_shape=None):
268
+ if hasattr(self.edge_proj, "built") and not self.edge_proj.built:
269
+ self.edge_proj.build((None, self.num_rbf))
270
+ self.built = True
271
+
272
+ def call(self, edge_index, edge_attr, x):
273
+ row = edge_index[0]
274
+ col = edge_index[1]
275
+ x_j = ops.take(x, row, axis=0)
276
+ x_i = ops.take(x, col, axis=0)
277
+ return (x_i + x_j) * self.edge_proj(edge_attr)
278
+
279
+
280
+ class ViS_MP(keras.layers.Layer):
281
+ def __init__(
282
+ self,
283
+ num_heads: int,
284
+ hidden_channels: int,
285
+ cutoff: float,
286
+ vecnorm_type: Optional[str] = None,
287
+ trainable_vecnorm: bool = False,
288
+ last_layer: bool = False,
289
+ **kwargs,
290
+ ):
291
+ super().__init__(**kwargs)
292
+ if hidden_channels % num_heads != 0:
293
+ raise ValueError(
294
+ f"hidden_channels ({hidden_channels}) must be divisible by num_heads ({num_heads})"
295
+ )
296
+ self.num_heads = num_heads
297
+ self.hidden_channels = hidden_channels
298
+ self.head_dim = hidden_channels // num_heads
299
+ self.last_layer = last_layer
300
+
301
+ self.layernorm = keras.layers.LayerNormalization()
302
+ self.vec_layernorm = VecLayerNorm(
303
+ hidden_channels,
304
+ trainable=trainable_vecnorm,
305
+ norm_type=vecnorm_type,
306
+ )
307
+
308
+ self.act = keras.activations.silu
309
+ self.attn_activation = keras.activations.silu
310
+ self.cutoff = CosineCutoff(cutoff)
311
+
312
+ self.vec_proj = keras.layers.Dense(hidden_channels * 3, use_bias=False)
313
+ self.q_proj = keras.layers.Dense(hidden_channels)
314
+ self.k_proj = keras.layers.Dense(hidden_channels)
315
+ self.v_proj = keras.layers.Dense(hidden_channels)
316
+ self.dk_proj = keras.layers.Dense(hidden_channels)
317
+ self.dv_proj = keras.layers.Dense(hidden_channels)
318
+ self.s_proj = keras.layers.Dense(hidden_channels * 2)
319
+
320
+ if not self.last_layer:
321
+ self.f_proj = keras.layers.Dense(hidden_channels)
322
+ self.w_src_proj = keras.layers.Dense(hidden_channels, use_bias=False)
323
+ self.w_trg_proj = keras.layers.Dense(hidden_channels, use_bias=False)
324
+
325
+ self.o_proj = keras.layers.Dense(hidden_channels * 3)
326
+ self.sum_aggr = SumAggregation()
327
+
328
+ def build(self, input_shape=None):
329
+ if hasattr(self.layernorm, "built") and not self.layernorm.built:
330
+ self.layernorm.build((None, self.hidden_channels))
331
+ if hasattr(self.vec_layernorm, "built") and not self.vec_layernorm.built:
332
+ self.vec_layernorm.build((None, None, self.hidden_channels))
333
+ if hasattr(self.cutoff, "built") and not self.cutoff.built:
334
+ self.cutoff.build()
335
+ if hasattr(self.vec_proj, "built") and not self.vec_proj.built:
336
+ self.vec_proj.build((None, self.hidden_channels))
337
+ if hasattr(self.q_proj, "built") and not self.q_proj.built:
338
+ self.q_proj.build((None, self.hidden_channels))
339
+ if hasattr(self.k_proj, "built") and not self.k_proj.built:
340
+ self.k_proj.build((None, self.hidden_channels))
341
+ if hasattr(self.v_proj, "built") and not self.v_proj.built:
342
+ self.v_proj.build((None, self.hidden_channels))
343
+ if hasattr(self.dk_proj, "built") and not self.dk_proj.built:
344
+ self.dk_proj.build((None, self.hidden_channels))
345
+ if hasattr(self.dv_proj, "built") and not self.dv_proj.built:
346
+ self.dv_proj.build((None, self.hidden_channels))
347
+ if hasattr(self.s_proj, "built") and not self.s_proj.built:
348
+ self.s_proj.build((None, self.hidden_channels))
349
+ if not self.last_layer:
350
+ if hasattr(self, "f_proj") and hasattr(self.f_proj, "built") and not self.f_proj.built:
351
+ self.f_proj.build((None, self.hidden_channels))
352
+ if hasattr(self, "w_src_proj") and hasattr(self.w_src_proj, "built") and not self.w_src_proj.built:
353
+ self.w_src_proj.build((None, self.hidden_channels))
354
+ if hasattr(self, "w_trg_proj") and hasattr(self.w_trg_proj, "built") and not self.w_trg_proj.built:
355
+ self.w_trg_proj.build((None, self.hidden_channels))
356
+ if hasattr(self, "t_src_proj") and hasattr(self.t_src_proj, "built") and not self.t_src_proj.built:
357
+ self.t_src_proj.build((None, self.hidden_channels))
358
+ if hasattr(self, "t_trg_proj") and hasattr(self.t_trg_proj, "built") and not self.t_trg_proj.built:
359
+ self.t_trg_proj.build((None, self.hidden_channels))
360
+ if hasattr(self.o_proj, "built") and not self.o_proj.built:
361
+ self.o_proj.build((None, self.hidden_channels))
362
+ self.built = True
363
+
364
+ @staticmethod
365
+ def vector_rejection(vec, d_ij):
366
+ d_proj = ops.expand_dims(d_ij, 2)
367
+ vec_proj = ops.sum(vec * d_proj, axis=1, keepdims=True)
368
+ return vec - vec_proj * d_proj
369
+
370
+ def call(self, x, vec, edge_index, r_ij, f_ij, d_ij):
371
+ row = edge_index[0]
372
+ col = edge_index[1]
373
+ num_nodes = ops.shape(x)[0]
374
+
375
+ x = self.layernorm(x)
376
+ vec = self.vec_layernorm(vec)
377
+
378
+ q = ops.reshape(self.q_proj(x), (-1, self.num_heads, self.head_dim))
379
+ k = ops.reshape(self.k_proj(x), (-1, self.num_heads, self.head_dim))
380
+ v = ops.reshape(self.v_proj(x), (-1, self.num_heads, self.head_dim))
381
+
382
+ dk = self.act(self.dk_proj(f_ij))
383
+ dk = ops.reshape(dk, (-1, self.num_heads, self.head_dim))
384
+ dv = self.act(self.dv_proj(f_ij))
385
+ dv = ops.reshape(dv, (-1, self.num_heads, self.head_dim))
386
+
387
+ vec_proj_val = self.vec_proj(vec)
388
+ vec1 = vec_proj_val[..., :self.hidden_channels]
389
+ vec2 = vec_proj_val[..., self.hidden_channels:2 * self.hidden_channels]
390
+ vec3 = vec_proj_val[..., 2 * self.hidden_channels:]
391
+ vec_dot = ops.sum(vec1 * vec2, axis=1)
392
+
393
+ # Message passing
394
+ q_i = ops.take(q, col, axis=0)
395
+ k_j = ops.take(k, row, axis=0)
396
+ v_j = ops.take(v, row, axis=0)
397
+ vec_j = ops.take(vec, row, axis=0)
398
+
399
+ attn = ops.sum(q_i * k_j * dk, axis=-1)
400
+ attn = self.attn_activation(attn) * ops.expand_dims(self.cutoff(r_ij), 1)
401
+
402
+ v_j = v_j * dv
403
+ v_j = ops.reshape(v_j * ops.expand_dims(attn, 2), (-1, self.hidden_channels))
404
+
405
+ s_val = self.act(self.s_proj(v_j))
406
+ s1 = s_val[:, :self.hidden_channels]
407
+ s2 = s_val[:, self.hidden_channels:]
408
+
409
+ vec_j = vec_j * ops.expand_dims(s1, 1) + ops.expand_dims(s2, 1) * ops.expand_dims(d_ij, 2)
410
+
411
+ x_out = self.sum_aggr(v_j, index=col, dim_size=num_nodes)
412
+ # For vec aggregation, flatten (N, channels, hid) -> sum -> reshape
413
+ c_dim = ops.shape(vec_j)[1]
414
+ vec_j_flat = ops.reshape(vec_j, (-1, c_dim * self.hidden_channels))
415
+ vec_out_flat = self.sum_aggr(vec_j_flat, index=col, dim_size=num_nodes)
416
+ vec_out = ops.reshape(vec_out_flat, (-1, c_dim, self.hidden_channels))
417
+
418
+ o_val = self.o_proj(x_out)
419
+ o1 = o_val[:, :self.hidden_channels]
420
+ o2 = o_val[:, self.hidden_channels:2 * self.hidden_channels]
421
+ o3 = o_val[:, 2 * self.hidden_channels:]
422
+
423
+ dx = vec_dot * o2 + o3
424
+ dvec = vec3 * ops.expand_dims(o1, 1) + vec_out
425
+
426
+ if not self.last_layer:
427
+ vec_i = ops.take(vec, col, axis=0)
428
+ vec_j = ops.take(vec, row, axis=0)
429
+ w1 = self.vector_rejection(self.w_trg_proj(vec_i), d_ij)
430
+ w2 = self.vector_rejection(self.w_src_proj(vec_j), -d_ij)
431
+ w_dot = ops.sum(w1 * w2, axis=1)
432
+ df_ij = self.act(self.f_proj(f_ij)) * w_dot
433
+ return dx, dvec, df_ij
434
+ else:
435
+ return dx, dvec, None
436
+
437
+
438
+ class ViS_MP_Vertex(ViS_MP):
439
+ def __init__(
440
+ self,
441
+ num_heads: int,
442
+ hidden_channels: int,
443
+ cutoff: float,
444
+ vecnorm_type: Optional[str] = None,
445
+ trainable_vecnorm: bool = False,
446
+ last_layer: bool = False,
447
+ **kwargs,
448
+ ):
449
+ super().__init__(num_heads, hidden_channels, cutoff, vecnorm_type, trainable_vecnorm, last_layer, **kwargs)
450
+ if not self.last_layer:
451
+ self.f_proj = keras.layers.Dense(hidden_channels * 2)
452
+ self.t_src_proj = keras.layers.Dense(hidden_channels, use_bias=False)
453
+ self.t_trg_proj = keras.layers.Dense(hidden_channels, use_bias=False)
454
+
455
+ def call(self, x, vec, edge_index, r_ij, f_ij, d_ij):
456
+ res = super().call(x, vec, edge_index, r_ij, f_ij, d_ij)
457
+ if self.last_layer:
458
+ return res
459
+ dx, dvec, _ = res
460
+ row = edge_index[0]
461
+ col = edge_index[1]
462
+ vec_i = ops.take(vec, col, axis=0)
463
+ vec_j = ops.take(vec, row, axis=0)
464
+ w1 = self.vector_rejection(self.w_trg_proj(vec_i), d_ij)
465
+ w2 = self.vector_rejection(self.w_src_proj(vec_j), -d_ij)
466
+ w_dot = ops.sum(w1 * w2, axis=1)
467
+
468
+ t1 = self.vector_rejection(self.t_trg_proj(vec_i), d_ij)
469
+ t2 = self.vector_rejection(self.t_src_proj(vec_i), -d_ij)
470
+ t_dot = ops.sum(t1 * t2, axis=1)
471
+
472
+ f_val = self.act(self.f_proj(f_ij))
473
+ f1 = f_val[:, :self.hidden_channels]
474
+ f2 = f_val[:, self.hidden_channels:]
475
+ df_ij = f1 * w_dot + f2 * t_dot
476
+ return dx, dvec, df_ij
477
+
478
+
479
+ class GatedEquivariantBlock(keras.layers.Layer):
480
+ def __init__(
481
+ self,
482
+ hidden_channels: int,
483
+ out_channels: int,
484
+ intermediate_channels: Optional[int] = None,
485
+ scalar_activation: bool = False,
486
+ **kwargs,
487
+ ):
488
+ super().__init__(**kwargs)
489
+ self.hidden_channels = hidden_channels
490
+ self.out_channels = out_channels
491
+ self.intermediate_channels = intermediate_channels or hidden_channels
492
+
493
+ self.vec1_proj = keras.layers.Dense(hidden_channels, use_bias=False)
494
+ self.vec2_proj = keras.layers.Dense(out_channels, use_bias=False)
495
+
496
+ self.update_net = keras.Sequential([
497
+ keras.layers.Dense(self.intermediate_channels),
498
+ keras.layers.Activation("silu"),
499
+ keras.layers.Dense(out_channels * 2),
500
+ ])
501
+ self.scalar_activation = scalar_activation
502
+
503
+ def build(self, input_shape=None):
504
+ if hasattr(self.vec1_proj, "built") and not self.vec1_proj.built:
505
+ self.vec1_proj.build((None, self.hidden_channels))
506
+ if hasattr(self.vec2_proj, "built") and not self.vec2_proj.built:
507
+ self.vec2_proj.build((None, self.hidden_channels))
508
+ if hasattr(self.update_net, "built") and not self.update_net.built:
509
+ self.update_net.build((None, self.hidden_channels * 2))
510
+ self.built = True
511
+
512
+ def call(self, x, v):
513
+ vec1 = ops.sqrt(ops.sum(ops.power(self.vec1_proj(v), 2), axis=-2) + 1e-12)
514
+ vec2 = self.vec2_proj(v)
515
+
516
+ h = ops.concatenate([x, vec1], axis=-1)
517
+ upd = self.update_net(h)
518
+ x = upd[:, :self.out_channels]
519
+ v_gate = upd[:, self.out_channels:]
520
+ v = ops.expand_dims(v_gate, 1) * vec2
521
+
522
+ if self.scalar_activation:
523
+ x = ops.silu(x)
524
+
525
+ return x, v
526
+
527
+
528
+ class EquivariantScalar(keras.layers.Layer):
529
+ def __init__(self, hidden_channels: int, **kwargs):
530
+ super().__init__(**kwargs)
531
+ self.block1 = GatedEquivariantBlock(hidden_channels, hidden_channels // 2, scalar_activation=True)
532
+ self.block2 = GatedEquivariantBlock(hidden_channels // 2, 1, scalar_activation=False)
533
+
534
+ def build(self, input_shape=None):
535
+ if hasattr(self.block1, "built") and not self.block1.built:
536
+ self.block1.build()
537
+ if hasattr(self.block2, "built") and not self.block2.built:
538
+ self.block2.build()
539
+ self.built = True
540
+
541
+ def pre_reduce(self, x, v):
542
+ x, v = self.block1(x, v)
543
+ x, v = self.block2(x, v)
544
+ return x
545
+
546
+
547
+ class Atomref(keras.layers.Layer):
548
+ def __init__(self, atomref: Optional[any] = None, max_z: int = 100, **kwargs):
549
+ super().__init__(**kwargs)
550
+ if atomref is None:
551
+ atomref = np.zeros((max_z, 1), dtype=np.float32)
552
+ else:
553
+ atomref = np.array(atomref, dtype=np.float32)
554
+ if atomref.ndim == 1:
555
+ atomref = np.expand_dims(atomref, -1)
556
+
557
+ self.atomref = keras.layers.Embedding(
558
+ len(atomref),
559
+ 1,
560
+ embeddings_initializer=keras.initializers.Constant(atomref),
561
+ )
562
+
563
+ def build(self, input_shape=None):
564
+ if hasattr(self.atomref, "built") and not self.atomref.built:
565
+ self.atomref.build((None,))
566
+ self.built = True
567
+
568
+ def call(self, x, z):
569
+ z = ops.cast(z, "int32")
570
+ return x + self.atomref(z)
571
+
572
+
573
+ class ViSNetBlock(keras.layers.Layer):
574
+ def __init__(
575
+ self,
576
+ lmax: int = 1,
577
+ vecnorm_type: Optional[str] = None,
578
+ trainable_vecnorm: bool = False,
579
+ num_heads: int = 8,
580
+ num_layers: int = 6,
581
+ hidden_channels: int = 128,
582
+ num_rbf: int = 32,
583
+ trainable_rbf: bool = False,
584
+ max_z: int = 100,
585
+ cutoff: float = 5.0,
586
+ max_num_neighbors: int = 32,
587
+ vertex: bool = False,
588
+ **kwargs,
589
+ ):
590
+ super().__init__(**kwargs)
591
+ self.lmax = lmax
592
+ self.hidden_channels = hidden_channels
593
+ self.num_layers = num_layers
594
+
595
+ self.distance = Distance(cutoff, max_num_neighbors=max_num_neighbors)
596
+ self.distance_expansion = ExpNormalSmearing(cutoff, num_rbf, trainable=trainable_rbf)
597
+ self.sphere = Sphere(lmax=lmax)
598
+ self.neighbor_embedding = NeighborEmbedding(hidden_channels, num_rbf, cutoff, max_z=max_z)
599
+ self.edge_embedding = EdgeEmbedding(num_rbf, hidden_channels)
600
+
601
+ mp_class = ViS_MP_Vertex if vertex else ViS_MP
602
+ self.vis_mp_layers = [
603
+ mp_class(
604
+ num_heads=num_heads,
605
+ hidden_channels=hidden_channels,
606
+ cutoff=cutoff,
607
+ vecnorm_type=vecnorm_type,
608
+ trainable_vecnorm=trainable_vecnorm,
609
+ last_layer=(i == num_layers - 1),
610
+ )
611
+ for i in range(num_layers)
612
+ ]
613
+
614
+ self.out_norm = keras.layers.LayerNormalization()
615
+ self.vec_out_norm = VecLayerNorm(
616
+ hidden_channels,
617
+ trainable=trainable_vecnorm,
618
+ norm_type=vecnorm_type,
619
+ )
620
+
621
+ def build(self, input_shape=None):
622
+ if hasattr(self.distance, "built") and not self.distance.built:
623
+ self.distance.build((None, 3))
624
+ if hasattr(self.distance_expansion, "built") and not self.distance_expansion.built:
625
+ self.distance_expansion.build((None,))
626
+ if hasattr(self.sphere, "built") and not self.sphere.built:
627
+ self.sphere.build((None, 3))
628
+ if hasattr(self.neighbor_embedding, "built") and not self.neighbor_embedding.built:
629
+ self.neighbor_embedding.build((None, self.hidden_channels))
630
+ if hasattr(self.edge_embedding, "built") and not self.edge_embedding.built:
631
+ self.edge_embedding.build()
632
+ for layer in self.vis_mp_layers:
633
+ if hasattr(layer, "built") and not layer.built:
634
+ layer.build()
635
+ if hasattr(self.out_norm, "built") and not self.out_norm.built:
636
+ self.out_norm.build((None, self.hidden_channels))
637
+ if hasattr(self.vec_out_norm, "built") and not self.vec_out_norm.built:
638
+ self.vec_out_norm.build((None, None, self.hidden_channels))
639
+ self.built = True
640
+
641
+ def call(self, z, pos, batch=None):
642
+ edge_index, edge_weight, edge_vec = self.distance(pos, batch=batch)
643
+ edge_attr = self.distance_expansion(edge_weight)
644
+ edge_vec = self.sphere(edge_vec)
645
+
646
+ x = ops.zeros((ops.shape(z)[0], self.hidden_channels), dtype="float32")
647
+ x = self.neighbor_embedding(z, x, edge_index, edge_weight, edge_attr)
648
+
649
+ num_vec_channels = ((self.lmax + 1) ** 2) - 1
650
+ vec = ops.zeros((ops.shape(z)[0], num_vec_channels, self.hidden_channels), dtype="float32")
651
+ edge_attr = self.edge_embedding(edge_index, edge_attr, x)
652
+
653
+ for attn in self.vis_mp_layers[:-1]:
654
+ dx, dvec, dedge_attr = attn(x, vec, edge_index, edge_weight, edge_attr, edge_vec)
655
+ x = x + dx
656
+ vec = vec + dvec
657
+ edge_attr = edge_attr + dedge_attr
658
+
659
+ dx, dvec, _ = self.vis_mp_layers[-1](x, vec, edge_index, edge_weight, edge_attr, edge_vec)
660
+ x = x + dx
661
+ vec = vec + dvec
662
+
663
+ x = self.out_norm(x)
664
+ vec = self.vec_out_norm(vec)
665
+ return x, vec
666
+
667
+
668
+ class ViSNet(keras.layers.Layer):
669
+ r"""The equivariant vector-scalar interactive graph neural network (ViSNet)
670
+ from the `"Enhancing Geometric Representations for Molecules with Equivariant
671
+ Vector-Scalar Interactive Message Passing" <https://arxiv.org/abs/2210.16518>`_ paper.
672
+
673
+ Example:
674
+ ```python
675
+ import numpy as np
676
+ from k3_node.models import ViSNet
677
+
678
+ z = np.array([6, 8, 1, 1, 1]) # atomic numbers of a small molecule
679
+ pos = np.random.rand(5, 3).astype("float32") * 2.0 # 3D coordinates (Angstrom)
680
+ batch = np.array([0, 0, 0, 1, 1]) # two molecules: atoms 0-2 and atoms 3-4
681
+
682
+ model = ViSNet(lmax=1, num_heads=2, num_layers=2, hidden_channels=16, num_rbf=8, cutoff=5.0)
683
+ energy, forces = model(z, pos, batch=batch) # forces are None unless derivative=True
684
+ print(tuple(energy.shape)) # (2, 1)
685
+ ```
686
+ """
687
+ def __init__(
688
+ self,
689
+ lmax: int = 1,
690
+ vecnorm_type: Optional[str] = None,
691
+ trainable_vecnorm: bool = False,
692
+ num_heads: int = 8,
693
+ num_layers: int = 6,
694
+ hidden_channels: int = 128,
695
+ num_rbf: int = 32,
696
+ trainable_rbf: bool = False,
697
+ max_z: int = 100,
698
+ cutoff: float = 5.0,
699
+ max_num_neighbors: int = 32,
700
+ vertex: bool = False,
701
+ atomref: Optional[any] = None,
702
+ reduce_op: str = "sum",
703
+ mean: float = 0.0,
704
+ std: float = 1.0,
705
+ derivative: bool = False,
706
+ **kwargs,
707
+ ):
708
+ super().__init__(**kwargs)
709
+ self.representation_model = ViSNetBlock(
710
+ lmax=lmax,
711
+ vecnorm_type=vecnorm_type,
712
+ trainable_vecnorm=trainable_vecnorm,
713
+ num_heads=num_heads,
714
+ num_layers=num_layers,
715
+ hidden_channels=hidden_channels,
716
+ num_rbf=num_rbf,
717
+ trainable_rbf=trainable_rbf,
718
+ max_z=max_z,
719
+ cutoff=cutoff,
720
+ max_num_neighbors=max_num_neighbors,
721
+ vertex=vertex,
722
+ )
723
+ self.output_model = EquivariantScalar(hidden_channels=hidden_channels)
724
+ self.prior_model = Atomref(atomref=atomref, max_z=max_z) if atomref is not None else None
725
+ self.reduce_op = reduce_op
726
+ self.mean = mean
727
+ self.std = std
728
+ self.derivative = derivative
729
+
730
+ def build(self, input_shape=None):
731
+ if hasattr(self.representation_model, "built") and not self.representation_model.built:
732
+ self.representation_model.build(input_shape)
733
+ if hasattr(self.output_model, "built") and not self.output_model.built:
734
+ self.output_model.build()
735
+ if self.prior_model is not None and hasattr(self.prior_model, "built") and not self.prior_model.built:
736
+ self.prior_model.build()
737
+ self.built = True
738
+
739
+ def call(self, z, pos, batch=None, batch_size=None):
740
+ if batch is None:
741
+ batch = ops.zeros(ops.shape(z), dtype="int32")
742
+ batch_size = 1
743
+ else:
744
+ batch = ops.cast(batch, "int32")
745
+
746
+ x, v = self.representation_model(z, pos, batch=batch)
747
+ x = self.output_model.pre_reduce(x, v)
748
+ x = x * self.std
749
+
750
+ if self.prior_model is not None:
751
+ x = self.prior_model(x, z)
752
+
753
+ if self.reduce_op == "mean":
754
+ y = global_mean_pool(x, batch, size=batch_size)
755
+ else:
756
+ y = global_add_pool(x, batch, size=batch_size)
757
+
758
+ y = y + self.mean
759
+ return y, None