Getting Started with Peptides

Prev Next

This tutorial walks you end to end: import a peptide dataset, resolve a missing monomer, create a peptide SAR Report, and take a first look at the viewer. It ties together the individual how-to guides into one journey.

Prerequisites

  • You are logged into Ideation, and the peptide plugin is enabled.
  • You have a peptide file with a HELM column (CSV/Excel) or a V3000 SDF. If a CSV or Excel file uses custom monomers, register them in Biotoolkit Monomers first.

Step 1: Import a peptide dataset

  1. On the Home page, click Create Dataset.
  2. Choose a Project and drop your file. Ideation detects a peptide file and sets Dataset Type to Peptide; check it, and select it yourself for a compressed file.
  3. Click Next, confirm the HELM Column and a Reference Peptide under Peptide Specific Configuration, select at least one property, and submit.
  4. Watch the import timeline: Initializing → Importing Peptides → Ready for a CSV or Excel file. An SDF adds Registering Monomers before Importing Peptides.

The Import Status step showing the peptide import timeline of a CSV file

Once the dataset is ready, Ideation computes two alignments for it in the background — a Center-star alignment and a PepSeA alignment — so you don't need to bring one. For the full details, see How to Create a Peptide Dataset.

Step 2: Resolve any missing monomers

If some peptides used monomers Ideation could not resolve, the dataset opens with a Missing Monomers column in the grid, with the affected rows highlighted, and an amber warning triangle ("N structures imported with missing data") shows on its card and next to the Source on the Details tab of its settings.

  1. Click the warning to open the import issues dialog and read why each structure is listed and what it is missing — a missing monomer is fixable here, a HELM error has to be corrected in the source file (see HELM Rules for Peptide Import).
  2. If the dialog ends with a box listing monomers not registered in Biotoolkit Monomers, open its Biotoolkit Monomers link to register them there.
  3. Back in the dialog, click Sync monomers to recompute structures and properties.

The dataset page with the Missing Monomers column and highlighted rows

See How to Resolve Missing Monomers for more.

Step 3: Create a SAR Report

  1. From Home, click Create SAR Report and pick your peptide dataset.
  2. Choose a Reference Peptide.
  3. Under Alignment, keep the alignment that is preselected — one of the two that came with the import, badged Center-star or PepSeA. If they still read In progress, wait a moment for one to complete. To use your own instead, click New Alignment → Import from a file.
  4. Click Generate SAR Slide.

The Create New SAR Report dialog showing the reference peptide and the Alignment section with its Available Alignments list

Your report opens with its first SAR Slide. You can add more slides later with Add SAR Slide. See How to Create a Peptide SAR Report and How to Align Peptides.

Step 4: Take a first look at the viewer

The viewer draws your reference peptide's backbone, with its bridges, branches, chem chains and regions. Try these first actions:

  • Pan and zoom the canvas in Pan & Drag mode.
  • Click a monomer to open its gallery of variants and endpoint values.
  • Switch to Select mode to select a run of monomers and Create Region.
  • Click Settings in the toolbar to change the slide's reference peptide, endpoints, filters and display.

The peptide viewer with the backbone over three lines, its bridges, and two open galleries

What you learned

  • A peptide dataset is imported from a HELM file (CSV/Excel) or an SDF. The monomers of a HELM file come from Biotoolkit Monomers; those of an SDF are registered there during the import.
  • Missing monomers are resolved by registering them and then syncing the dataset.
  • Import also computes two alignments for you, so a dataset is ready to analyze straight away. You can still import or compute another one at any time.
  • A SAR Report holds one or more SAR Slides, each built on a reference peptide and an alignment.
  • The viewer visualizes the backbone, branches, bridges, cyclization, regions, and per-position variants.

Next steps