Practical overview
When it fits
Use it when you want a PyTorch implementation of GotenNet to inspect or adapt for molecular-graph experiments, and can supply the model's atom, coordinate and adjacency inputs.
Who it is for
- Researchers exploring geometric learning and 3D equivariant transformer architectures.
- Developers prototyping molecular graph models with atom identifiers and spatial coordinates.
Documented uses
- Prototype experiments that use molecular atom IDs, coordinates and graph connectivity.
- Explore invariant model outputs and optional coordinate updates for molecular graph inputs.
Requirements & limits
- The README documents installation with pip and a model invocation using PyTorch.
- The usage example recommends float64 as the default dtype for equivariant network training.
- The repository identifies this as an unofficial implementation and links to a separate official repository.
- The example treats negative atom IDs as padding and accepts a boolean adjacency matrix.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Install and call GotenNet on example molecular-graph inputs
Install the PyTorch package and pass atom IDs, coordinates, and adjacency data to a GotenNet model.
Before you start
- Python environment with PyTorch available.
- The README recommends setting PyTorch's default floating-point dtype to float64 for equivariant network training.
Steps
Install the package with the command below.
pip install gotennet-pytorchIn Python, import
torchand settorch.set_default_dtype(torch.float64); then importGotenNetfromgotennet_pytorch.Create a model using the documented parameters:
dim=256,max_degree=2,depth=1,heads=2,dim_head=32,dim_edge_refinement=256, andreturn_coors=False.Prepare atom IDs, coordinates, and a boolean adjacency matrix, then call
model(atom_ids, adj_mat=adj_mat, coors=coors)and assign the returned values toinvariant, coors_out.
Expected outcome
The call returns an invariant output and a second value assigned to `coors_out`; with `return_coors=False`, the example does not request coordinate returns.
Guide limitations
- Negative atom indices are treated as padding; the README gives molecule length as
(atom_ids >= 0).sum(dim=-1). - The README labels the implementation unofficial and points to a separate official repository.
- The documented usage is an example; it does not establish model accuracy or suitability for a particular prediction task.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 16 October 2026
- Original website title
- lucidrains/gotennet-pytorch · Official homepage title · retained in its source language

