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.
- k3_node/__init__.py +122 -0
- k3_node/applications/__init__.py +17 -0
- k3_node/applications/bio/__init__.py +21 -0
- k3_node/applications/chemistry/__init__.py +155 -0
- k3_node/applications/materials/__init__.py +127 -0
- k3_node/applications/materials/basis.py +449 -0
- k3_node/applications/materials/chgnet.py +360 -0
- k3_node/applications/materials/core.py +351 -0
- k3_node/applications/materials/grace.py +246 -0
- k3_node/applications/materials/io.py +230 -0
- k3_node/applications/materials/m3gnet.py +462 -0
- k3_node/applications/materials/megnet.py +395 -0
- k3_node/applications/materials/qet.py +220 -0
- k3_node/applications/materials/readout.py +235 -0
- k3_node/applications/materials/so3net.py +234 -0
- k3_node/applications/materials/tensornet.py +381 -0
- k3_node/applications/materials/test_materials.py +167 -0
- k3_node/applications/materials/wrappers.py +95 -0
- k3_node/data/__init__.py +47 -0
- k3_node/data/batch.py +102 -0
- k3_node/data/collate.py +282 -0
- k3_node/data/data.py +532 -0
- k3_node/data/database.py +154 -0
- k3_node/data/dataset.py +182 -0
- k3_node/data/download.py +49 -0
- k3_node/data/extract.py +45 -0
- k3_node/data/feature_store.py +70 -0
- k3_node/data/graph_store.py +92 -0
- k3_node/data/hetero_data.py +374 -0
- k3_node/data/hypergraph_data.py +59 -0
- k3_node/data/in_memory_dataset.py +177 -0
- k3_node/data/makedirs.py +7 -0
- k3_node/data/on_disk_dataset.py +77 -0
- k3_node/data/separate.py +115 -0
- k3_node/data/storage.py +593 -0
- k3_node/data/temporal.py +154 -0
- k3_node/data/test_batch.py +67 -0
- k3_node/data/test_data.py +68 -0
- k3_node/data/test_dataset_and_stores.py +111 -0
- k3_node/data/test_hetero_data.py +33 -0
- k3_node/data/test_temporal_and_hyper.py +32 -0
- k3_node/data/view.py +43 -0
- k3_node/datasets/__init__.py +88 -0
- k3_node/datasets/actor.py +101 -0
- k3_node/datasets/airports.py +84 -0
- k3_node/datasets/amazon.py +66 -0
- k3_node/datasets/ba2motif_dataset.py +73 -0
- k3_node/datasets/ba_shapes.py +81 -0
- k3_node/datasets/bitcoin_otc.py +77 -0
- k3_node/datasets/citation_full.py +81 -0
- k3_node/datasets/coauthor.py +66 -0
- k3_node/datasets/dblp.py +106 -0
- k3_node/datasets/digits.py +63 -0
- k3_node/datasets/email_eu_core.py +60 -0
- k3_node/datasets/entities.py +158 -0
- k3_node/datasets/explainer_dataset.py +101 -0
- k3_node/datasets/facebook.py +51 -0
- k3_node/datasets/fake.py +256 -0
- k3_node/datasets/freebase.py +90 -0
- k3_node/datasets/geometric_shapes.py +69 -0
- k3_node/datasets/github.py +51 -0
- k3_node/datasets/graph_generator/__init__.py +6 -0
- k3_node/datasets/graph_generator/ba_graph.py +20 -0
- k3_node/datasets/graph_generator/base.py +29 -0
- k3_node/datasets/graph_generator/er_graph.py +21 -0
- k3_node/datasets/icews.py +58 -0
- k3_node/datasets/imdb.py +96 -0
- k3_node/datasets/jodie.py +56 -0
- k3_node/datasets/karate.py +56 -0
- k3_node/datasets/lastfm_asia.py +51 -0
- k3_node/datasets/mesh_correspondence.py +50 -0
- k3_node/datasets/molecule_net.py +148 -0
- k3_node/datasets/motif_generator/__init__.py +7 -0
- k3_node/datasets/motif_generator/base.py +29 -0
- k3_node/datasets/motif_generator/custom.py +17 -0
- k3_node/datasets/motif_generator/cycle.py +25 -0
- k3_node/datasets/motif_generator/house.py +27 -0
- k3_node/datasets/movielens.py +55 -0
- k3_node/datasets/planetoid.py +137 -0
- k3_node/datasets/polblogs.py +63 -0
- k3_node/datasets/ppi.py +189 -0
- k3_node/datasets/qm7.py +65 -0
- k3_node/datasets/qm9.py +132 -0
- k3_node/datasets/reddit.py +121 -0
- k3_node/datasets/sbm_dataset.py +165 -0
- k3_node/datasets/seal.py +74 -0
- k3_node/datasets/shape_scenes.py +92 -0
- k3_node/datasets/test_datasets.py +322 -0
- k3_node/datasets/tu_dataset.py +131 -0
- k3_node/datasets/twitch.py +66 -0
- k3_node/datasets/webkb.py +102 -0
- k3_node/datasets/wikics.py +85 -0
- k3_node/datasets/word_net.py +184 -0
- k3_node/etl/__init__.py +37 -0
- k3_node/etl/encoders.py +248 -0
- k3_node/etl/graph_builders.py +270 -0
- k3_node/etl/relational_to_graph.py +201 -0
- k3_node/etl/table_to_graph.py +244 -0
- k3_node/etl/test_etl.py +318 -0
- k3_node/export/__init__.py +15 -0
- k3_node/export/cross_backend.py +172 -0
- k3_node/export/onnx_exporter.py +190 -0
- k3_node/export/runtime.py +254 -0
- k3_node/export/tensorrt_exporter.py +201 -0
- k3_node/export/test_export.py +337 -0
- k3_node/export/tflite_exporter.py +112 -0
- k3_node/hub/__init__.py +29 -0
- k3_node/hub/dataset_hub.py +242 -0
- k3_node/hub/hub_mixin.py +599 -0
- k3_node/hub/model_card.py +133 -0
- k3_node/hub/test_hub.py +419 -0
- k3_node/io/__init__.py +22 -0
- k3_node/io/fs.py +117 -0
- k3_node/io/npz.py +45 -0
- k3_node/io/off.py +29 -0
- k3_node/io/planetoid.py +98 -0
- k3_node/io/tu.py +137 -0
- k3_node/io/txt_array.py +58 -0
- k3_node/layers/__init__.py +14 -0
- k3_node/layers/aggr/__init__.py +70 -0
- k3_node/layers/aggr/attention.py +77 -0
- k3_node/layers/aggr/base.py +403 -0
- k3_node/layers/aggr/basic.py +412 -0
- k3_node/layers/aggr/deep_sets.py +65 -0
- k3_node/layers/aggr/deepsets.py +29 -0
- k3_node/layers/aggr/equilibrium.py +107 -0
- k3_node/layers/aggr/fused.py +43 -0
- k3_node/layers/aggr/gmt.py +89 -0
- k3_node/layers/aggr/gru.py +58 -0
- k3_node/layers/aggr/lcm.py +143 -0
- k3_node/layers/aggr/lstm.py +58 -0
- k3_node/layers/aggr/mlp.py +75 -0
- k3_node/layers/aggr/multi.py +154 -0
- k3_node/layers/aggr/patch_transformer.py +137 -0
- k3_node/layers/aggr/quantile.py +125 -0
- k3_node/layers/aggr/resolver.py +68 -0
- k3_node/layers/aggr/scaler.py +133 -0
- k3_node/layers/aggr/set2set.py +87 -0
- k3_node/layers/aggr/set_transformer.py +107 -0
- k3_node/layers/aggr/sort.py +68 -0
- k3_node/layers/aggr/test_aggr.py +337 -0
- k3_node/layers/aggr/utils.py +210 -0
- k3_node/layers/aggr/variance_preserving.py +54 -0
- k3_node/layers/attention/__init__.py +5 -0
- k3_node/layers/attention/pair_attention.py +448 -0
- k3_node/layers/attention/performer.py +187 -0
- k3_node/layers/attention/polynormer.py +160 -0
- k3_node/layers/attention/qformer.py +143 -0
- k3_node/layers/attention/sgformer.py +106 -0
- k3_node/layers/attention/test_attention.py +68 -0
- k3_node/layers/attention/test_pair_attention.py +91 -0
- k3_node/layers/conv/__init__.py +149 -0
- k3_node/layers/conv/agnn_conv.py +120 -0
- k3_node/layers/conv/antisymmetric_conv.py +94 -0
- k3_node/layers/conv/appnp.py +105 -0
- k3_node/layers/conv/appnp_conv.py +157 -0
- k3_node/layers/conv/arma_conv.py +231 -0
- k3_node/layers/conv/cg_conv.py +92 -0
- k3_node/layers/conv/cheb_conv.py +137 -0
- k3_node/layers/conv/cluster_gcn_conv.py +102 -0
- k3_node/layers/conv/conv.py +100 -0
- k3_node/layers/conv/crystal_conv.py +140 -0
- k3_node/layers/conv/cugraph.py +84 -0
- k3_node/layers/conv/diffusion_conv.py +144 -0
- k3_node/layers/conv/dir_gnn_conv.py +93 -0
- k3_node/layers/conv/dna_conv.py +192 -0
- k3_node/layers/conv/edge_conv.py +107 -0
- k3_node/layers/conv/eg_conv.py +155 -0
- k3_node/layers/conv/fa_conv.py +107 -0
- k3_node/layers/conv/feast_conv.py +126 -0
- k3_node/layers/conv/film_conv.py +143 -0
- k3_node/layers/conv/gat_conv.py +244 -0
- k3_node/layers/conv/gated_graph_conv.py +136 -0
- k3_node/layers/conv/gatv2_conv.py +205 -0
- k3_node/layers/conv/gcn.py +144 -0
- k3_node/layers/conv/gcn2_conv.py +126 -0
- k3_node/layers/conv/gcn_conv.py +135 -0
- k3_node/layers/conv/gen_conv.py +163 -0
- k3_node/layers/conv/general_conv.py +218 -0
- k3_node/layers/conv/gin_conv.py +218 -0
- k3_node/layers/conv/gmm_conv.py +172 -0
- k3_node/layers/conv/gps_conv.py +153 -0
- k3_node/layers/conv/graph_attention.py +262 -0
- k3_node/layers/conv/graph_conv.py +84 -0
- k3_node/layers/conv/gravnet_conv.py +93 -0
- k3_node/layers/conv/han_conv.py +175 -0
- k3_node/layers/conv/heat_conv.py +131 -0
- k3_node/layers/conv/hetero_conv.py +128 -0
- k3_node/layers/conv/hgt_conv.py +218 -0
- k3_node/layers/conv/hypergraph_conv.py +182 -0
- k3_node/layers/conv/le_conv.py +81 -0
- k3_node/layers/conv/lg_conv.py +58 -0
- k3_node/layers/conv/meshcnn_conv.py +84 -0
- k3_node/layers/conv/message_passing.py +451 -0
- k3_node/layers/conv/mf_conv.py +95 -0
- k3_node/layers/conv/mixhop_conv.py +108 -0
- k3_node/layers/conv/nn_conv.py +110 -0
- k3_node/layers/conv/pan_conv.py +100 -0
- k3_node/layers/conv/pdn_conv.py +109 -0
- k3_node/layers/conv/pna_conv.py +177 -0
- k3_node/layers/conv/point_conv.py +101 -0
- k3_node/layers/conv/point_gnn_conv.py +90 -0
- k3_node/layers/conv/point_transformer_conv.py +132 -0
- k3_node/layers/conv/ppf_conv.py +135 -0
- k3_node/layers/conv/ppnp.py +89 -0
- k3_node/layers/conv/res_gated_graph_conv.py +126 -0
- k3_node/layers/conv/rgat_conv.py +251 -0
- k3_node/layers/conv/rgcn_conv.py +321 -0
- k3_node/layers/conv/sage_conv.py +154 -0
- k3_node/layers/conv/sg_conv.py +96 -0
- k3_node/layers/conv/signed_conv.py +100 -0
- k3_node/layers/conv/simple_conv.py +75 -0
- k3_node/layers/conv/spline_conv.py +182 -0
- k3_node/layers/conv/ssg_conv.py +101 -0
- k3_node/layers/conv/supergat_conv.py +195 -0
- k3_node/layers/conv/tag_conv.py +98 -0
- k3_node/layers/conv/test_backend_consistency.py +164 -0
- k3_node/layers/conv/test_conv.py +176 -0
- k3_node/layers/conv/test_conv_pyg.py +566 -0
- k3_node/layers/conv/transformer_conv.py +168 -0
- k3_node/layers/conv/utils.py +403 -0
- k3_node/layers/conv/wl_conv.py +151 -0
- k3_node/layers/conv/x_conv.py +187 -0
- k3_node/layers/dense/__init__.py +40 -0
- k3_node/layers/dense/dense_gat_conv.py +149 -0
- k3_node/layers/dense/dense_gcn_conv.py +117 -0
- k3_node/layers/dense/dense_gin_conv.py +88 -0
- k3_node/layers/dense/dense_graph_conv.py +95 -0
- k3_node/layers/dense/dense_sage_conv.py +85 -0
- k3_node/layers/dense/diff_pool.py +76 -0
- k3_node/layers/dense/dmon_pool.py +223 -0
- k3_node/layers/dense/linear.py +327 -0
- k3_node/layers/dense/mincut_pool.py +92 -0
- k3_node/layers/dense/test_dense.py +377 -0
- k3_node/layers/functional/__init__.py +13 -0
- k3_node/layers/functional/bro.py +49 -0
- k3_node/layers/functional/edge_dropout.py +55 -0
- k3_node/layers/functional/gini.py +44 -0
- k3_node/layers/functional/test_functional.py +34 -0
- k3_node/layers/kge/__init__.py +17 -0
- k3_node/layers/kge/base.py +255 -0
- k3_node/layers/kge/complex.py +98 -0
- k3_node/layers/kge/distmult.py +79 -0
- k3_node/layers/kge/loader.py +50 -0
- k3_node/layers/kge/rotate.py +103 -0
- k3_node/layers/kge/test_kge.py +76 -0
- k3_node/layers/kge/transe.py +96 -0
- k3_node/layers/norm/__init__.py +23 -0
- k3_node/layers/norm/batch_norm.py +328 -0
- k3_node/layers/norm/diff_group_norm.py +141 -0
- k3_node/layers/norm/graph_norm.py +105 -0
- k3_node/layers/norm/graph_size_norm.py +57 -0
- k3_node/layers/norm/instance_norm.py +163 -0
- k3_node/layers/norm/layer_norm.py +245 -0
- k3_node/layers/norm/mean_subtraction_norm.py +57 -0
- k3_node/layers/norm/msg_norm.py +58 -0
- k3_node/layers/norm/pair_norm.py +94 -0
- k3_node/layers/norm/test_norm.py +275 -0
- k3_node/layers/pool/__init__.py +83 -0
- k3_node/layers/pool/approx_knn.py +101 -0
- k3_node/layers/pool/asap.py +173 -0
- k3_node/layers/pool/avg_pool.py +165 -0
- k3_node/layers/pool/cluster_pool.py +168 -0
- k3_node/layers/pool/connect/__init__.py +10 -0
- k3_node/layers/pool/connect/base.py +103 -0
- k3_node/layers/pool/connect/filter_edges.py +113 -0
- k3_node/layers/pool/consecutive.py +30 -0
- k3_node/layers/pool/decimation.py +48 -0
- k3_node/layers/pool/edge_pool.py +189 -0
- k3_node/layers/pool/glob.py +139 -0
- k3_node/layers/pool/graclus.py +66 -0
- k3_node/layers/pool/knn.py +253 -0
- k3_node/layers/pool/max_pool.py +159 -0
- k3_node/layers/pool/mem_pool.py +145 -0
- k3_node/layers/pool/pan_pool.py +144 -0
- k3_node/layers/pool/point_cloud.py +212 -0
- k3_node/layers/pool/pool.py +119 -0
- k3_node/layers/pool/sag_pool.py +174 -0
- k3_node/layers/pool/select/__init__.py +10 -0
- k3_node/layers/pool/select/base.py +112 -0
- k3_node/layers/pool/select/topk.py +206 -0
- k3_node/layers/pool/test_pool.py +456 -0
- k3_node/layers/pool/topk_pool.py +103 -0
- k3_node/layers/pool/voxel_grid.py +70 -0
- k3_node/layers/unpool/__init__.py +9 -0
- k3_node/layers/unpool/knn_interpolate.py +57 -0
- k3_node/layers/unpool/test_unpool.py +31 -0
- k3_node/loader/__init__.py +62 -0
- k3_node/loader/base.py +69 -0
- k3_node/loader/cache.py +68 -0
- k3_node/loader/cluster.py +127 -0
- k3_node/loader/data_list_loader.py +45 -0
- k3_node/loader/dataloader.py +117 -0
- k3_node/loader/dense_data_loader.py +62 -0
- k3_node/loader/dynamic_batch_sampler.py +93 -0
- k3_node/loader/graph_saint.py +188 -0
- k3_node/loader/hgt_loader.py +90 -0
- k3_node/loader/imbalanced_sampler.py +87 -0
- k3_node/loader/keras_dataset.py +334 -0
- k3_node/loader/link_loader.py +179 -0
- k3_node/loader/link_neighbor_loader.py +202 -0
- k3_node/loader/mixin.py +190 -0
- k3_node/loader/neighbor_loader.py +159 -0
- k3_node/loader/neighbor_sampler.py +167 -0
- k3_node/loader/node_loader.py +185 -0
- k3_node/loader/prefetch.py +115 -0
- k3_node/loader/random_node_loader.py +89 -0
- k3_node/loader/sampler_utils.py +499 -0
- k3_node/loader/shadow.py +115 -0
- k3_node/loader/temporal_dataloader.py +98 -0
- k3_node/loader/test_dataloader.py +113 -0
- k3_node/loader/test_keras_dataset.py +221 -0
- k3_node/loader/test_neighbor_loader.py +122 -0
- k3_node/loader/test_sampler_utils.py +82 -0
- k3_node/loader/test_samplers.py +96 -0
- k3_node/loader/test_subgraph_loaders.py +89 -0
- k3_node/loader/utils.py +232 -0
- k3_node/loader/zip_loader.py +88 -0
- k3_node/metrics.py +94 -0
- k3_node/models/__init__.py +424 -0
- k3_node/models/attentive_fp.py +232 -0
- k3_node/models/attract_repel.py +108 -0
- k3_node/models/autoencoder.py +318 -0
- k3_node/models/basic_gnn.py +443 -0
- k3_node/models/bio/__init__.py +4 -0
- k3_node/models/captum.py +52 -0
- k3_node/models/chemistry/__init__.py +4 -0
- k3_node/models/correct_and_smooth.py +146 -0
- k3_node/models/deep_graph_infomax.py +113 -0
- k3_node/models/deepgcn.py +121 -0
- k3_node/models/dimenet.py +737 -0
- k3_node/models/dimenet_utils.py +153 -0
- k3_node/models/gnnff.py +263 -0
- k3_node/models/gps_model.py +1122 -0
- k3_node/models/gpse.py +638 -0
- k3_node/models/graph_unet.py +199 -0
- k3_node/models/graphmae2.py +954 -0
- k3_node/models/graphormer.py +1258 -0
- k3_node/models/graphormer_3d.py +868 -0
- k3_node/models/grover.py +1066 -0
- k3_node/models/jumping_knowledge.py +200 -0
- k3_node/models/label_prop.py +110 -0
- k3_node/models/lightgcn.py +171 -0
- k3_node/models/linkx.py +181 -0
- k3_node/models/lpformer.py +404 -0
- k3_node/models/mask_label.py +114 -0
- k3_node/models/materials/__init__.py +33 -0
- k3_node/models/meta.py +133 -0
- k3_node/models/metapath2vec.py +234 -0
- k3_node/models/mlp.py +264 -0
- k3_node/models/mole_bert.py +379 -0
- k3_node/models/neural_fingerprint.py +95 -0
- k3_node/models/node2vec.py +213 -0
- k3_node/models/pmlp.py +157 -0
- k3_node/models/polynormer.py +229 -0
- k3_node/models/rect.py +93 -0
- k3_node/models/renet.py +221 -0
- k3_node/models/rev_gnn.py +128 -0
- k3_node/models/schnet.py +484 -0
- k3_node/models/sgformer.py +195 -0
- k3_node/models/signed_gcn.py +185 -0
- k3_node/models/test_attentive_fp.py +32 -0
- k3_node/models/test_attract_repel.py +33 -0
- k3_node/models/test_autoencoder.py +119 -0
- k3_node/models/test_basic_gnn.py +102 -0
- k3_node/models/test_correct_and_smooth.py +40 -0
- k3_node/models/test_deep_graph_infomax.py +68 -0
- k3_node/models/test_deepgcn.py +21 -0
- k3_node/models/test_dimenet.py +86 -0
- k3_node/models/test_domain_apis.py +138 -0
- k3_node/models/test_gnnff.py +24 -0
- k3_node/models/test_gps_model.py +271 -0
- k3_node/models/test_gpse.py +34 -0
- k3_node/models/test_graph_unet.py +26 -0
- k3_node/models/test_graphmae2.py +226 -0
- k3_node/models/test_graphormer.py +233 -0
- k3_node/models/test_graphormer3d.py +163 -0
- k3_node/models/test_grover.py +287 -0
- k3_node/models/test_jumping_knowledge.py +129 -0
- k3_node/models/test_label_prop.py +37 -0
- k3_node/models/test_lightgcn.py +38 -0
- k3_node/models/test_linkx.py +31 -0
- k3_node/models/test_lpformer.py +22 -0
- k3_node/models/test_mask_label.py +90 -0
- k3_node/models/test_meta.py +159 -0
- k3_node/models/test_metapath2vec.py +45 -0
- k3_node/models/test_mlp.py +62 -0
- k3_node/models/test_mole_bert.py +164 -0
- k3_node/models/test_neural_fingerprint.py +13 -0
- k3_node/models/test_node2vec.py +57 -0
- k3_node/models/test_pmlp.py +81 -0
- k3_node/models/test_polynormer.py +104 -0
- k3_node/models/test_rect.py +23 -0
- k3_node/models/test_renet.py +32 -0
- k3_node/models/test_rev_gnn.py +24 -0
- k3_node/models/test_schnet.py +43 -0
- k3_node/models/test_sgformer.py +48 -0
- k3_node/models/test_signed_gcn.py +28 -0
- k3_node/models/test_tgn.py +77 -0
- k3_node/models/test_unimol.py +179 -0
- k3_node/models/test_unimol2.py +114 -0
- k3_node/models/test_unimol_plus.py +131 -0
- k3_node/models/test_visnet.py +44 -0
- k3_node/models/tgn.py +382 -0
- k3_node/models/unimol.py +1156 -0
- k3_node/models/unimol2.py +616 -0
- k3_node/models/unimol_docking_v2.py +301 -0
- k3_node/models/unimol_plus.py +456 -0
- k3_node/models/utils.py +97 -0
- k3_node/models/visnet.py +759 -0
- k3_node/ops/__init__.py +4 -0
- k3_node/ops/conv.py +56 -0
- k3_node/ops/creation.py +43 -0
- k3_node/ops/graph.py +27 -0
- k3_node/ops/host.py +41 -0
- k3_node/ops/matmul.py +49 -0
- k3_node/ops/numpy.py +24 -0
- k3_node/ops/segment.py +54 -0
- k3_node/ops/sparse.py +51 -0
- k3_node/rag/__init__.py +49 -0
- k3_node/rag/encoders.py +312 -0
- k3_node/rag/pipeline.py +192 -0
- k3_node/rag/projector.py +184 -0
- k3_node/rag/subgraph.py +270 -0
- k3_node/rag/test_rag.py +347 -0
- k3_node/rag/verbalizer.py +162 -0
- k3_node/tasks/__init__.py +19 -0
- k3_node/tasks/backbone_resolver.py +125 -0
- k3_node/tasks/base.py +67 -0
- k3_node/tasks/graph_classification.py +270 -0
- k3_node/tasks/graph_regression.py +228 -0
- k3_node/tasks/link_prediction.py +306 -0
- k3_node/tasks/node_classification.py +194 -0
- k3_node/tasks/node_regression.py +138 -0
- k3_node/tasks/test_tasks.py +319 -0
- k3_node/test_docstring_examples.py +106 -0
- k3_node/test_training_forwarding.py +116 -0
- k3_node/training.py +115 -0
- k3_node/transforms/__init__.py +166 -0
- k3_node/transforms/base_transform.py +32 -0
- k3_node/transforms/compose.py +58 -0
- k3_node/transforms/general.py +676 -0
- k3_node/transforms/graph.py +1070 -0
- k3_node/transforms/spatial.py +797 -0
- k3_node/transforms/test_random_link_split.py +45 -0
- k3_node/transforms/test_spatial_transforms.py +65 -0
- k3_node/transforms/test_transforms.py +253 -0
- k3_node/transforms/utils.py +102 -0
- k3_node/utils/__init__.py +5 -0
- k3_node/utils/backend_import.py +12 -0
- k3_node/utils/graph.py +286 -0
- k3_node/utils/keras.py +94 -0
- k3_node/utils/random.py +103 -0
- k3_node/utils/smiles.py +235 -0
- k3_node-1.0.0.dist-info/METADATA +284 -0
- k3_node-1.0.0.dist-info/RECORD +459 -0
- k3_node-1.0.0.dist-info/WHEEL +5 -0
- k3_node-1.0.0.dist-info/licenses/LICENSE +21 -0
- k3_node-1.0.0.dist-info/top_level.txt +1 -0
k3_node/models/visnet.py
ADDED
|
@@ -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
|