How to Explore the Peptide Viewer

Prev Next

The peptide viewer is the interactive canvas of a SAR Slide. It draws the reference peptide's backbone, branches, bridges and chem chains, and shows the variants found at each of them across all aligned peptides. This guide covers the canvas, the settings drawer, selections, regions, branches and bridges, chem chains, galleries, endpoint summaries, display options, filters and the peptide table.

One canvas per SAR Slide

Each viewer canvas is one SAR Slide, shown as a tab in the report. Click a tab to switch slides, or Add SAR Slide to create a new one. To compare two slides side by side, drag a slide's tab next to the other one. The settings drawer shows the slide you last clicked.

The peptide viewer showing the toolbar, the reference peptide backbone over three lines, its bridges, and two open galleries with their endpoint values

Navigate the canvas

The toolbar at the top of the canvas controls the layout and how you interact with it. Its five menus open when you hover their button (a click works too):

Control What it does
Pan & Drag Zoom and pan the canvas. Drag monomers, chem chains, bridge linkers and regions to move them.
Select Enter selection mode (or hold Ctrl while in Pan & Drag).
Linear / Cyclic Switch between the linear layout and a circular layout. Shown only for a macrocyclic reference peptide, which opens in the cyclic layout the first time.
Layout menu Reset Layout (Reset to Saved Layout once a layout is saved), Save Layout (local) (kept until you save the SAR Report), Reset to Default Layout, Smart Guides and Hide All Galleries.
Monomers menu Expand All Monomers, Collapse All Monomers, Select All Monomers and Unselect All.
Regions menu Collapse All Regions, Expand All Regions and Delete All Regions.
Bridges menu Cyclize All Bridges, Uncyclize All, Expand All Linkers and Collapse All Linkers.
Chem Chains menu Group All Chains, Ungroup All Chains, Expand All Chems and Collapse All Chems.
Clear position filters Remove every position filter, including side chain and bridge filters. Shown only while such a filter is on.
Download as image Save the canvas as an image.
Settings Open the settings drawer of the slide (see Change the settings).

A menu item that would do nothing is greyed out, and its tooltip says why (for example Nothing is selected).

Every element of the canvas has its own menu. Right-click a monomer, a chem chain, a region, a bridge or the centre of a cycle, or hover it and click the ⋯ button that appears next to it. Right-click an empty spot of the canvas for the toolbar menus and, while something is selected, a Selection (n) submenu.

Two sliders control the linear layout: Monomers per line (across the top) sets how many monomers fit on a line before the backbone wraps, and Gap between lines (down the right edge) sets the space between the lines.

The tips at the bottom left of the canvas describe what the toolbar does not show, one tip at a time. Close them to keep a small Tips button that brings them back.

Smart Guides

While Smart Guides is on, anything you drag snaps to the rows and columns of the surrounding monomers and to the edges of regions and galleries. A dashed line shows where it will land. Turn it off in the toolbar's Layout menu, or in the Display settings, to place elements freely.

Change the settings

Click Settings in the toolbar to open the settings drawer. At its top, choose which settings you change:

  • SAR Report sets the defaults of every slide of the report. Its tabs are SAR Slides, Endpoints, Display, Table, Details and Manage Users.
  • Active SAR Slide changes only the slide you are looking at. A setting changed here overrides the SAR Report default. To go back to the defaults of a section, open its Override options menu and choose Reset all to SAR Report defaults.

The tabs of a slide run down the side of the drawer:

Tab What it holds
Query The dataset of the slide, its Reference Peptide and its Alignment. Choose another reference or alignment here, or open the alignment editor (see How to Align Peptides).
Endpoints The endpoints shown, their colours, and how the galleries summarize them (see Choose how an endpoint is summarized).
Clusters The clustering of the peptides (see How to Cluster Peptides). Its badge shows the number of clusters.
Hotspot Hotspot and synergy analysis (see How to Analyze Hotspots and Synergies). Its badge shows a check mark while the analysis is on.
Filters The filters of the slide (see Filter the peptides). Its badge shows how many filters are on.
Display How the canvas and the galleries are drawn (see Configure display options).
Table How the peptide table is coloured and compared with the reference (see Use the peptide table).
Legend The colours of the amino acids and of the bridge types, and what each shape on the canvas means.
Details The name of the slide, which you can change, and links to its project, dataset and SAR Report.

Select monomers

Click Select in the toolbar (or hold Ctrl while in Pan & Drag mode). A Selection Options panel lets you choose Rectangle or Lasso selection.

Select mode active with the Selection Options panel offering rectangle and lasso selection

To build a selection:

  • Click a monomer, a chem or a bridge linker.
  • Hold Ctrl and click more elements to add them.
  • Drag on the canvas to catch several at once, in a rectangle or a lasso.
  • Use Select All Monomers in the Monomers menu.
  • Click an empty spot without Ctrl to clear the selection.

The selection toolbar (also in the Selection (n) submenu of the canvas right-click menu) then offers:

  • Create Region and Cyclize Selection, with the number of residues they act on. Chems and linkers do not count.
  • Expand Selected, Collapse Selected and Reset Layout of Selection.
  • Keep Only Selection Variable: every other position and chain is locked to the reference, so only the selection varies.
  • Filter on Selected Monomers and Chems: keeps only the peptides that carry the selected monomers and chems, and leaves the other filters as they are.
  • Unselect All.

Work with regions

A region groups positions, next to each other or not, so you can collapse them into a single pill, filter them, and show them as one gallery.

  • To create a region, select monomers and choose Create Region.
  • To manage a region, right-click it or click its ⋯ button.

The region context menu with rename, Show Gallery, Expand Region, Filter on the reference, Keep only this region variable, and Delete Region

The region menu offers: rename (pencil), Show Gallery, Expand Region or Collapse Region, Expand Region Monomers and Collapse Region Monomers, Filter on the reference, Keep only this region variable and Delete Region. The toolbar's Regions menu acts on all your regions at once. The app manages the Branch and synergy regions itself: the delete actions leave them.

Read branches and bridges

Branches are drawn above the backbone with a red connector and a Branch label. They are collapsed at first: right-click the branch and choose Expand Branch to see its monomers. A branch's positions are numbered on their own, from 1 (or from 0, as set for that branch in the alignment editor). Region labels and galleries write them B1, B2….

The Branched Peptides viewer with an expanded Branch 1 region connected to the backbone by a red link

A branch hangs off the R3 of a backbone residue. It can bond through its first residue or its last one, as your HELM says (3:R3-1:R1 or 3:R3-3:R2, see HELM Rules for Peptide Import). The red connector lands on the residue that carries the bond, and the branch grows away from it. A branch you dragged stays where you put it.

Bridges are coloured arcs between two monomers, one colour per bridge type (disulfide, lactam, thioether…, see the Legend tab). A bridge found only in other peptides, not in the reference, is drawn dotted. Show or hide those with Include Non-Reference Bridges.

Some bridges run through a chemical linker, a CHEM monomer bonded to both residues. The linker is drawn as a node in the middle of the arc:

  • Expand or collapse it from the bridge's menu, or with Expand All Linkers / Collapse All Linkers in the Bridges menu. Drag the corner of an expanded linker to resize it.
  • Drag the node to reshape the bridge. Reset Position in the bridge's menu puts it back.
  • Click the node to open the bridge's gallery, as you would click the arc.

All bridges between the same two residues are drawn as one bridge. Its gallery shows one variant per kind of bridge: each linker, the direct bridge, and the peptides without a bridge there.

Read chem chains

A chem chain is the chemistry bonded to a residue's side chain: a PEG spacer, a biotin tag, a lipid. It is made of one or more chems, each a CHEM monomer of your HELM. A chem can carry further chems, for example a PEG spacer that ends in a biotin. The viewer draws one node per chem, each bonded to the one before it.

Each chem works like a monomer: click it to open its gallery, expand it to see its structure, right-click it for its menu, drag it. Dragging the residue moves its whole chain. Reset Position in a chem's menu puts it back in place.

Group and ungroup a chain

A chain of several chems opens grouped, as a single pill labelled with its size (3 chems). To see the chems, hover the pill and click its + button, or choose Ungroup Chem Chain in its menu. Group Chem Chain and the − button fold it again. The Chem Chains menu does the same for every chain at once. The chains you ungrouped are saved with the slide.

The chain is the variant

A chain gallery compares whole chains: one column per distinct chain found at that residue, plus a None column for the peptides without one. Each column header writes the chain from the residue outwards: K - Tri3Am >R² EG2 >R² AcCap reads "a lysine carries Tri3Am, whose R2 carries EG2, whose R2 carries AcCap". The same name is used in the enlarged gallery, the filters, the hotspots and the synergies.

Where a chem chain can attach

A chem chain hangs off a residue's R3. Among the natural amino acids, only D, C, E and K have one. A chem bonded to a bridge linker is not drawn yet. See HELM Rules for Peptide Import for how to write chem chains in HELM.

Expand monomers

Each monomer is drawn as a labelled bead. Expand it, from its menu, the selection toolbar or Expand All Monomers, to draw its chemical structure in place. The Expanded monomer size slider in Display › Monomers sets the size of every expanded monomer you have not resized by hand.

An expanded monomer draws its free attachment points with the cap group Biotoolkit Monomers gives them. A C-terminal residue then reads as the carboxylic acid it is.

Read structures without expanding: zoom in

Zoom in far enough and every monomer and chem in view draws its structure inside its bead, with its symbol at the bottom. Zoom out and the symbols come back. Turn this off with Show Structures at High Zoom in Display › Monomers. It does not apply while monomers are coloured by Amino acid distribution (Pie chart).

Collapsed monomer beads at high zoom, each drawing its chemical structure inside its colored ring with the residue symbol at the bottom

Cyclize

You can lay out the monomers between the two ends of a bridge as a ring:

  • Select them and choose Cyclize Selection, choose Cyclize in a bridge's menu, or use Cyclize All Bridges in the Bridges menu.
  • A bridge through a chemical linker cyclizes too: the linker takes its place on the ring.
  • Undo it with Uncyclize or Uncyclize All. Cyclizing works in the linear layout only.

A macrocyclic peptide opens in the cyclic layout the first time. Switch with the Linear / Cyclic toggle.

Open galleries

In Pan & Drag mode, click a monomer, a bridge, a region or a chem chain to open its gallery: a small table of the variants found there across all aligned peptides, with their endpoint values (and their change from the reference when hotspot analysis is on). Click again to close it. Drag a gallery to move it.

In a gallery:

  • Click a variant's count to filter the slide on that variant and list its peptides.
  • Click an endpoint name to open its settings, or the grey suffix after it, for example (Mean), to change how it is summarized.
  • Click Expand gallery to open the enlarged gallery.

Explore the enlarged gallery

The icons at the top left of the enlarged gallery switch between five views. Hover an icon to see its name.

The enlarged gallery of a region on the Scatter Plot view, with the five view icons at the top left, the X-Axis, Y-Axis, Color and Size choices, and Filter By Selection

View What it shows
Grid View One card per variant, with its structure and its endpoint values.
Table View One row per variant.
Property Distribution One boxplot per variant for the Endpoint you pick, sorted by Sort by (Median, Mean, Min, Max, Peptide count or Name). The reference comes first.
Radar Comparison The selected variants across the numeric endpoints you tick (at least three).
Scatter Plot One point per variant. X-Axis and Y-Axis take any numeric endpoint, plus Hotspot Δ and Synergy Δ when the gallery has them. Color and Size (Peptide count, Constant or an endpoint) are optional.

To filter the slide on some variants:

  1. Select them: click a card or a row, a boxplot, a variant chip of the radar, or a point of the scatter plot. In the scatter plot you can also drag a rectangle around several points (hold Shift to add to the selection).
  2. Click Filter By Selection. The slide keeps the peptides that carry one of the selected variants. This replaces the gallery's current filter.

Unselect All clears the selection, and Cancel closes the dialog without filtering.

Choose how an endpoint is summarized

A gallery cell covers every peptide that carries that variant, so it needs one value per endpoint. The endpoint's Aggregation type says how this value is computed from the peptides' values. Its Aggregation Rendering says whether the cell shows that value or a small chart of all the values.

Set both in the endpoint's settings: open the Endpoints tab of the settings and click the endpoint. The quicker way is in the gallery: click the grey suffix after the endpoint's name, (Mean) for example. Its menu lists the aggregation types, the renderings and Endpoint settings….

For a numeric endpoint:

Aggregation type The cell shows
Best The highest or lowest value, following the endpoint's Direction (in Data Interpretation, in its settings).
Max / Min The highest / lowest value.
Mean / Median The mean / median.
Geo mean The geometric mean. Offered only when every value is positive.

A numeric endpoint starts on Mean. One with a small set of possible values (a score from 1 to 5, for example) starts on Best and offers only Best, Max and Min. The Aggregation Rendering is Aggregated Value, Histogram or Boxplot. A histogram or a boxplot needs at least three values: below that, the cell shows the value.

A text endpoint starts on Most frequent and also offers Best. Either way the cell shows the value carried by the most peptides. A text endpoint with a small set of values can use the Bar Chart rendering: one bar per value, with the number of peptides carrying it.

Values and charts take the colours of the endpoint.

Where it is saved

Aggregation type and Aggregation Rendering are endpoint settings. Set them on the SAR Report level for every slide, or on the Active SAR Slide level for one slide.

Configure display options

The Display tab of the settings controls how the canvas and the galleries are drawn. On the SAR Report level it sets the defaults of every slide.

The Display tab of the settings drawer with color-by, display toggles, and gallery options

  • Monomers: Color monomers by (Amino acid colors, Number of variants, Popularity (peptide count), Amino acid distribution (Pie chart), or Hotspot while hotspot analysis is on; hover an option to see what it shows), Expanded monomer size and Show Structures at High Zoom.
  • Positions: Show Empty Positions (gaps) and, below it, Include Internal Empty Positions, Include Leading Empty Positions (N-terminus) and Include Trailing Empty Positions (C-terminus). Turn off Include Internal Empty Positions to hide the gaps between two residues of a chain and close up the backbone. Also Show Position Indexes and Show N/C-Terminus Labels.
  • Bridges & Side Chains: Show Bridges (with Include Non-Reference Bridges) and Show Side Chemical Chains (with Include Non-Reference Chains).
  • Layout: Show Line Break Links and Enable Smart Guides (snap while dragging).
  • Galleries: Default monomers per page, Property label width (px), Autofit monomer columns to variant name and Monomer column width (px). With autofit on, each monomer and bridge column is as wide as its variant name and values. Turn it off to give all columns the same width.
  • Molecule Rendering: how structures are drawn.

The Legend tab showing visual representations, bridge colors, and amino-acid color groups

Filter the peptides

The Filters tab of the settings keeps only some peptides in the slide: the galleries and the peptide table then show only those. The count at the top shows how many peptides are kept, and Clear all filters removes every filter. The tab has three sections, each showing how many of its filters are on:

  • MMP/Scans: the peptides close to the reference peptide, or a scan found in your dataset (see below).
  • Properties: the endpoints, the peptide name, and the cluster while clustering is on.
  • Positions: the monomer, chem chain or bridge at a position. Clicking a variant in a gallery adds a filter here.

Filter on the changes from the reference

The MMP/Scans section of the Filters tab, active, on Changes From Reference with 1 Change (MMP): the table keeps the reference and the two peptides one change away from it

The MMP/Scans section compares each peptide with the reference peptide of the slide (set in the Query tab). A change is one residue replaced (by another monomer or a gap), one chem chain added, removed, replaced or moved, or one bridge added, removed or of another type.

  1. Turn on Activate MMP/Scans Filter.
  2. Under Filter by, choose Changes From Reference.
  3. Under Number of changes, choose 1 Change (MMP), 2 Changes, or Custom Range and set the range. A matched molecular pair (MMP) is a peptide one change away from the reference.
  4. Under Change types, untick the kinds of change you do not want: Monomers, Chem Chains or Bridges. A peptide is kept only when all its changes are of the ticked types.
  5. Optionally, pick some values in Monomers / chems, for example A to keep the peptides where alanine replaces a residue. A peptide is kept only when its changes bring in all of them.

Filter on a detected scan

The MMP/Scans section on Scans: nine scans found around reference REF, the five Scan type buttons, and the Alanine scan picked, keeping its 5 peptides and the reference

A scan is a series of peptides that each change the reference in the same way, for example an alanine scan. Ideation finds the scans among the peptides with at least three members. Only scans built around the current reference peptide are found: to see a scan built around another peptide, make it the reference in the Query tab.

  1. Turn on Activate MMP/Scans Filter.
  2. Under Filter by, choose Scans. The number in brackets is how many scans were found.
  3. Choose a Scan type (see the table below). Its number in brackets is how many scans of that type were found.
  4. Click a scan in Detected scans to keep only its peptides. Each scan shows its size, for example Alanine scan · 14 positions. Picking a saturation also opens the gallery of its position.

There are five scan types:

Scan type What it finds
Residue The same monomer put in at three positions or more, each time as the only change. For example an Alanine scan. A gap makes a Deletion scan.
Saturation Three monomers or more tried at one position, each as the only change. Also three chem chains or more on one residue, or three bridge types or more on one pair of positions.
Analog Residues replaced by a monomer with the same natural analog (a D-amino acid, an N-methyl…) at three positions or more. The natural analogs come from the monomer library. One All analogs scan, and one scan per natural analog, for example Alanine analogs.
Side Chain The same chem chain added, replaced or moved onto three residues or more, for example a lipidation scan. The residue may also be replaced.
Bridge The same bridge type (the same linker for a chemical bridge) on three pairs of positions or more, for example a disulfide scan. Its two residues may also be replaced.

Use the peptide table

The Peptides Alignment table at the bottom of the slide lists the peptides kept by the filters, aligned position by position, with their endpoint values. Its subtitle names the alignment: click the name to open it in the alignment editor, or the icon beside it to pick another alignment in the Query tab. On a branched peptide, the Backbone and branch buttons next to the title choose which chain the table shows.

The buttons at the right of the title:

  • Download saves the peptides of the table to an Excel file, with their endpoint values (and their cluster while clustering is on) and their alignment.
  • Table Settings opens the Table tab of the settings.
  • Enlarge the table to the full viewer, or hide it.

The Table tab has four sections:

The Table tab with Color table by set to Difference from reference and Dot for Identical Residues on: in the peptide table, residues equal to the reference read as dots

  • Colors: Color table by Amino acid, Difference from reference (a residue equal to the reference is white), Natural vs non-natural, Specific monomers (only the Colored monomers you choose keep their colour), or Modifications (bridges, chem chains, branches) (one colour per bridge type, linker, chain or branch; choose which in Modification types).
  • Reference: Dot for Identical Residues shows a dot where a residue is the same as the reference. Hide Constant Positions hides the positions where no shown peptide differs from the reference. Pin the Reference on Top keeps the reference peptide under the header.
  • Indicators: Show Bridge Indicators, Show Side Chain Indicators and Show Branch Indicators show a badge on the residues that carry them.
  • Endpoints: Show Endpoint Columns, and Endpoints as Delta vs Reference to show each numeric value as its change from the reference value. The change is a ratio (×2.00) when the endpoint's Threshold Type is Fold, and a difference (+0.31) otherwise. The colours and the sorting still use the values.

A residue equal to the reference but whose chem chain or bridges differ counts as different, as long as its indicator is shown.

Next steps