Entity Relation Map
Entity notes define what object a model is operating on. In Molecular Modeling, the same model family can mean different things depending on whether the unit is a molecule, protein, pocket, complex, assay row, or dataset.
The central relation for structure-based modeling is:
The central relation for supervised chem-bio ML is:
This is the Target-assay-label contract.
Object Hierarchy
- Molecule is the general chemical object.
- Ligand is a molecule considered as a binding partner.
- Target is the biological object a task is centered on.
- Protein is the biological target or modeled macromolecule.
- Pocket is a local region of a protein.
- Protein-ligand complex combines ligand pose and protein context.
- Assay defines how a label was measured.
- Bioactivity label records the measured or curated response.
- Dataset collects examples, labels, metadata, and splits.
- Target-assay-label contract connects the measured object, measurement protocol, label semantics, and split rule.
Representation Choices
- Sequence: residues, nucleotides, SMILES tokens, or k-mers.
- Graph: atoms, residues, bonds, contacts, or interaction edges.
- Structure: 3D coordinates, distances, local frames, surfaces, or voxels.
- Metadata: assay protocol, source, target, assembly, or split group.
Split Units
The split unit should match the generalization claim:
- Molecule-side generalization: scaffold or molecular cluster.
- Protein-side generalization: sequence or structure family.
- Complex-side generalization: both ligand scaffold and protein family.
- Assay-side generalization: assay, campaign, target, or source group.
- Genome-side generalization: region, chromosome, species, or source group.
Checks
- What is one example?
- What is the target label?
- What target, assay, and context produced the label?
- Is the label assay-conditioned, target-conditioned, censored, transformed, or thresholded?
- Which entities are inputs and which are metadata?
- Which entity defines the split group?
- Could the same molecule, homologous protein, related complex, or shared assay leak across splits?
- Does the representation preserve the chemistry or geometry needed for the task?