Molecular Graph

A molecular graph represents atoms as nodes and bonds as edges. It is the natural input for graph neural networks and many molecular property models.

A molecule can be represented as:

where is the set of atoms, is the set of bonds, are atom features, and are bond features.

Message passing then updates atom states:

Checks

  • Are hydrogens explicit or implicit?
  • Are bond order, aromaticity, chirality, formal charge, and ring membership encoded?
  • Does graph batching isolate molecules correctly?
  • Does the graph lose conformer or stereochemical information needed by the task?
  • Are graph features generated from the standardized molecule definition?

Atom and Bond Features

Common atom features include:

  • atomic number or element;
  • formal charge;
  • aromaticity;
  • hybridization;
  • degree and valence;
  • explicit or implicit hydrogens;
  • chirality tag;
  • ring membership.

Common bond features include:

  • bond order;
  • aromaticity;
  • conjugation;
  • ring membership;
  • stereochemical direction.

The feature set is part of the model contract:

where is the adjacency or edge index. If changes, cached features and splits may need regeneration.

Batching Boundary

For graph mini-batches, node tensors from many molecules are concatenated. A molecule-level readout must respect the batch index:

Pooling across all nodes without the batch boundary leaks information between examples.

Failure Modes

  • Chiral tags or bond stereo are dropped while the label depends on stereochemistry.
  • Formal charge and hydrogens are inconsistent with the protonation protocol.
  • Global attention or normalization mixes nodes across molecules in a batch.
  • A graph-only model is evaluated on a task requiring 3D conformer information.
  • Features are generated from raw input while labels and splits use standardized identity.