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.