core.models.equiformer_v2.heads.scalar

Copyright (c) Meta, Inc. and its affiliates.

This source code is licensed under the MIT license found in the LICENSE file in the root directory of this source tree.

Classes

EqV2ScalarHead

Base class for all neural network modules.

Module Contents

class core.models.equiformer_v2.heads.scalar.EqV2ScalarHead(backbone, output_name: str = 'energy', reduce: str = 'sum')

Bases: torch.nn.Module, fairchem.core.models.base.HeadInterface

Base class for all neural network modules.

Your models should also subclass this class.

Modules can also contain other Modules, allowing to nest them in a tree structure. You can assign the submodules as regular attributes:

import torch.nn as nn
import torch.nn.functional as F

class Model(nn.Module):
    def __init__(self):
        super().__init__()
        self.conv1 = nn.Conv2d(1, 20, 5)
        self.conv2 = nn.Conv2d(20, 20, 5)

    def forward(self, x):
        x = F.relu(self.conv1(x))
        return F.relu(self.conv2(x))

Submodules assigned in this way will be registered, and will have their parameters converted too when you call to(), etc.

Note

As per the example above, an __init__() call to the parent class must be made before assignment on the child.

Variables:

training (bool) – Boolean represents whether this module is in training or evaluation mode.

output_name

reduce

avg_num_nodes

energy_block

forward(data: torch_geometric.data.Batch, emb: dict[str, torch.Tensor | fairchem.core.models.base.GraphData])

Head forward.

Parameters:

• data (DataBatch) – Atomic systems as input

• emb (dict[str->torch.Tensor]) – Embeddings of the input as generated by the backbone

Returns:

outputs – Return one or more targets generated by this head

Return type:

dict[str->torch.Tensor]