Understanding Peptides in Ideation

Prev Next

This page explains the concepts behind the Peptide feature: how a peptide report is organized, how peptides are represented on the canvas, and what the SAR analysis tools (hotspots, synergies, clustering) tell a medicinal chemist. For step-by-step instructions, see the how-to guides linked at the end.

SAR Report vs SAR Slide

A SAR Report is the workspace that lives inside a project alongside your datasets. It is the object you share and manage access to.

A SAR Report contains one or more SAR Slides. A slide is a single view of the data — for a peptide report, each slide is one interactive viewer built around a reference peptide and an alignment. When you create a report you generate its first slide (the Generate SAR Slide button); you can add more slides later with Add SAR Slide — for example to compare a different reference peptide or a different alignment side by side.

Report vs Slide

"SAR Report" is the container; "SAR Slide" is one tab inside it. They are not the same thing.

How peptides are represented

HELM notation and monomers

Peptides are stored using HELM notation (Hierarchical Editing Language for Macromolecules), for example PEPTIDE1{H.S.Q.G.T.F...}$$$$. Each token in the sequence is a monomer — a natural amino acid (A, G, K, …) or a non-natural / modified residue (Aib, am, a PEG linker, and so on). The HELM subset Ideation accepts, and how it reads chains, branches, bridges and CHEM monomers, is listed in HELM Rules for Peptide Import.

For Ideation to draw and compute properties for a peptide, it must know the chemical structure of every monomer symbol used in the sequence. That knowledge comes from two places:

Concept What it is
Monomer library Your organization's collection of monomers in Biotoolkit Monomers: the public monomers and the ones your organization registered, each with its symbol, chemical structure and attachment points.
Biotoolkit Monomers The application where your organization keeps its monomer library: a shared, organization-wide registry of monomers. Ideation resolves each symbol against it; symbols it cannot resolve are reported as missing. Registrations are permanent and shared across all datasets, so each non-natural monomer only needs to be registered once.

Where the structures come from depends on the dataset file:

  • CSV/Excel (HELM) files reference monomers by symbol only, so every non-standard monomer must be registered in Biotoolkit Monomers before the import.
  • V3000 SDF files carry the peptides and a monomer template for each monomer, so nothing needs registering beforehand — the embedded templates supply the structures.

On import, Ideation resolves every symbol against Biotoolkit Monomers. For an SDF, the embedded templates of the monomers your peptides use are registered there during the import. A new monomer is added to your organization's library; a monomer of your library with the same symbol but another structure is updated, and Biotoolkit Monomers keeps its previous version; a public monomer is never changed. When the structure is already registered under another name, your symbol is added to that monomer as an alias, and your peptides keep the symbol you wrote. An alias applies to one polymer type, PEPTIDE or CHEM. Symbols Biotoolkit Monomers does not know and no template supplies are left missing — the peptide is preserved but its full structure and calculated properties are deferred until the monomers are registered and the dataset is synced. See How to Resolve Missing Monomers.

Backbone, branches, bridges and chem chains

The viewer draws the reference peptide as a chain of monomer nodes and layers several structural features on top:

Element Meaning
Backbone The main linear chain of monomers, numbered by position.
Branch A side chain that leaves the backbone at a given position and runs as its own numbered chain. Branches are drawn above the backbone with a red connector and a "Branch" label.
Bridge A bond between two monomers (disulfide, lactam, thioether, …), drawn as a colored arc. A bridge can also run through a chemical linker, drawn as a node at the arc's middle.
Chem chain One or more non-peptide chemical groups (CHEM monomers, called chems in the viewer) bonded to a residue, for example a PEG spacer carrying a biotin. One chem can carry further chems on its free attachment points. The viewer draws the whole chain, grouped into a single N chems pill by default.
Cyclization A ring layout for a run of monomers joined end-to-end by a bridge, or for a fully cyclic peptide.

Elements that appear in other peptides but not the reference (for example a bridge only some analogs have) are drawn dotted/faded and can be toggled on or off.

Alignment

Because peptides differ in length and composition, they are compared position-by-position through an alignment. Every SAR slide is built on an alignment that assigns each peptide's monomers to shared positions, inserting gaps where a peptide has nothing to contribute. An alignment belongs to the dataset, and a dataset can hold several: each slide references the one it was built on, so you can compare two framings of the same series side by side.

An alignment either comes from a file you upload (CSV for the backbone, Excel for backbone plus branches) or is computed by Ideation — which happens automatically for every dataset at import, and on demand whenever you ask for it. Two aligners are available:

  • Center-star aligns every peptide against one shared reference — the dataset's longest backbone — and stacks those pairwise results into a single frame. Monomer swaps are scored by how conservative they are, so a modified residue lines up with the amino acid it derives from.
  • PepSeA runs MAFFT, scoring monomers by their structural similarity through your organisation's monomer similarity matrix, and lets you choose the alignment strategy and gap penalty.

For how the sources compare and which one to use, see Understanding Peptide Alignment. For the task itself, see How to Align Peptides.

Understanding the SAR analysis

Reference peptide and variants

The reference peptide is the baseline the slide is built around. At each position (or bridge, region, or chem chain) the viewer collects the variants — the different monomers observed across all aligned peptides at that spot — and shows how many peptides carry each one, along with aggregated endpoint values. This is what a gallery displays when you open one.

Hotspots and synergies

Hotspot analysis scores how much each position (and optionally each bridge, chemical side chain, or region) impacts a chosen endpoint. Each element gets an impact bar (0–100%), a significance badge of Hot, Warm or Cold, and gallery deltas showing how each variant shifts the endpoint. Hotspots answer: which positions matter most for this property?

A single position rarely tells the whole story, so multi-position synergy analysis looks at combinations of positions — pairs, triples, or contiguous regions — and detects when changing them together departs from what their individual effects predict, either amplifying (synergistic) or cancelling (antagonistic). Each detected synergy appears as a region on the viewer and in a sortable list.

Both scores are relative, so some element always reads 100%; and both are built on the same per-position effects, which is why they are explained together in Understanding Hotspots and Synergies.

Clustering

Clustering groups the peptides by overall structural similarity. You choose how much weight to give the backbone, branches, bridges, and chem chains. By default Ideation finds the best number of clusters, and you can fix it instead. You can also make the clusters from a dataset column, such as a series: each value becomes a cluster. The Cluster Explorer then lets you inspect the groups — most importantly through the Summary Table, which shows each cluster's consensus pattern, quality, size, and property distributions side by side. Clustering answers: which families of analogs exist in this series, and how do their properties differ?

The grouping uses the same graded monomer-substitution model as the alignment, and the scatter plot is computed differently from the grouping itself — see Understanding Peptide Clustering.

Where to go next