Skip to content

Macromolecule Registration — Supported HELM Structures

Compound Registration accepts peptide structures in HELM (Hierarchical Editing Language for Macromolecules) notation. This page lists the polymer types, topologies, monomer types, and connection types that are supported in this release, along with the validation rules applied at import. For structures and features not covered here, see Limitations.

Supported polymer types

Peptide polymers (HELM polymer type PEPTIDE) are supported for registration. Oligonucleotides (RNA, DNA) and conjugates are not in scope for this release.

Supported topologies

Topology Description Example HELM
Linear Residues connected N→C, no ring closure PEPTIDE1{A.G.V.L}$$$$V2.0
Head-to-tail cyclic Ring closure between the last residue's R2 and the first residue's R1 PEPTIDE1{A.G.K.F}$PEPTIDE1,PEPTIDE1,4:R2-1:R1$$$V2.0
Side-chain cross-linked (intra-chain) Bond between side-chain attachment points within a single polymer (e.g. disulfide bridge, lactam bridge) PEPTIDE1{A.C.G.G.C.V}$PEPTIDE1,PEPTIDE1,2:R3-5:R3$$$V2.0
Side-chain cross-linked (inter-chain) Bond between side-chain attachment points on two separate polymers PEPTIDE1{A.C.G}|PEPTIDE2{K.C.V}$PEPTIDE1,PEPTIDE2,2:R3-2:R3$$$V2.0
Branched A CHEM monomer attached to a side-chain attachment point PEPTIDE1{A.K.G}|CHEM1{[Ac]}$PEPTIDE1,CHEM1,2:R3-1:R1$$$V2.0
Terminal CHEM modification A CHEM monomer attached to the backbone endpoint of a polymer — the N-terminus (R1 of the first residue) or C-terminus (R2 of the last residue) PEPTIDE1{A.K.G}|CHEM1{[Ac]}$PEPTIDE1,CHEM1,1:R1-1:R1$$$V2.0
Multi-chain (unlinked) Two or more peptide polymers on the same canvas with no cross-link PEPTIDE1{A.G.V}|PEPTIDE2{K.L.F}$$$$V2.0

Note: Topologies can be combined within a single HELM string. For example, a cyclic polymer can also carry intra-chain side-chain cross-links, or a multi-chain structure can mix linear and cyclic polymers. The validation rules apply independently to each polymer and connection in the string.

Supported monomer types

Monomer type Details
Natural amino acids All 20 standard amino acids (A, R, N, D, C, E, Q, G, H, I, L, K, M, F, P, S, T, W, Y, V)
Non-natural and modified amino acids Any custom peptide-type monomer registered in the monomer library, including D-amino acids (e.g. [dA]) and other modified residues (e.g. [Orn]).
CHEM monomers Any custom CHEM monomer registered in the monomer library, used as branches, terminal modifications, or protecting groups (e.g. [Ac] for N-terminal acetylation, [Fmoc] and [OtBu] as protecting groups). Customer-specific CHEM monomers are supported.

Connection types

Connections between monomers are specified in the HELM connection section using attachment point notation (R1, R2, R3, …). The following connection types are supported:

  • Backbone connections — R1 (N-terminal) to R2 (C-terminal) between adjacent residues, used for linear and head-to-tail cyclic polymers.
  • Side-chain connections — R3 to R3, or R3 to R1 of a CHEM monomer, used for cross-links and branches.

Each attachment point on a monomer may be used at most once. Both polymers referenced in a connection must be declared in the polymer section of the HELM string.

Validation rules

Compound Registration validates the HELM string at import. The table below lists the checks applied, the exception raised when a check fails, and the error code included in the message.

Check Cause of failure Exception Error code
HELM string is syntactically well-formed The HELM string contains a syntax error, such as a missing closing brace or an invalid character InvalidLineNotationSyntaxException —
All monomers are present in the monomer library A monomer abbreviation used in the polymer section is not registered in the monomer library InvalidMacromoleculeException UNRECOGNIZED_MONOMER
All attachment points referenced in connections exist on the monomer A connection references an attachment point (e.g. R5) that is not defined on the specified monomer InvalidMacromoleculeException MISSING_ATTACHMENT_POINT
No attachment point is used more than once A connection uses an attachment point that is already used in another connection on the same monomer InvalidMacromoleculeException OCCUPIED_ATTACHMENT_POINT
All polymers referenced in connections are declared in the polymer section A connection references a polymer ID that does not appear in the polymer section of the HELM string InvalidMacromoleculeException ABSENT_POLYMER_REFERENCE
All monomer positions referenced in connections exist within the polymer A connection references a position index that is out of range for the specified polymer (e.g. position 10 in a 5-residue chain) InvalidMacromoleculeException ABSENT_MONOMER_REFERENCE

A single HELM string may produce more than one validation error. All errors are reported together.

Limitations

The following structures and features are not supported in this release:

  • Oligonucleotides (RNA, DNA) are not supported for registration.
  • Multi-component conjugates — a peptide and a small-molecule payload registered as separate linked records — are not supported. A peptide with an attached CHEM monomer (e.g. a linker or modification) registered as a single entity is supported.
  • Inline SMILES monomers — monomers specified as SMILES strings within the HELM notation — are not supported.