Back to Mover page.

PeptideStubMover

PeptideStubMover is a convenient method for modifying a pose or building a new pose from scratch. One can append, prepend, or insert residues to a pose. Created by Yifan Song ca. 2014; modified at various points by Vikram K. Mulligan.

Usage cases

PeptideStubMover is useful for following scenarios:

  • Given a structure, one wants to covalently connect new residues before or after a certain residue (anchor residue) in the pose. The connection mode can be a common peptide bond or other types of covalent linkages accepted by the anchor residue).
  • Given a structure, one wants to insert new residues after a certain residue (anchor residue).
  • One wants to generate a peptide with known length with a desired amino acid sequence from scratch.

PeptideStubMover is usually used as a starting point in the grand scheme of a larger problem, particularly for incorporating select modifications into a pose or designing peptides from scratch.

Inputs and Outputs

Depending on the specific usage, PeptideStubMover can take a pose as an input or a dummy file (make sure that the dummy file is not completely blank). It will generate as output a new pose with new residues added in the places requested. The residue numbering will be modified during the process.

Detailed workflow

The PeptideStubMover has a general setting as follows:

<PeptideStubMover name="&string" reset="(false &bool)">
        <Prepend resname="(&string)" anchor_rsd="residuenumber"  repeat="(1 &number")/>
	<Append resname="(&string)" repeat=(&number) jump="(false &bool)"  anchor_rsd=”residuenumber” connecting_atom=”atom type” />
	<Insert resname="(&string)" repeat="(1 &number)"/>
 </PeptideStubMover>

name—what is the name you want to call the mover with. Reset—whether to discard the pose information or not. Default is set false. If reset is set to true, all the information about the pose is cleared as well as the pose.

The PeptideStubMover has three modes, which will be described in more details later: Append, prepend, insert. At least one mode should be set during the process.

Append options

Append=add residue AFTER an anchor residue.

Resname—what type of residue you want to add. Any residue that is defined in the fa_standard can be used. Should be defined by the user.

Jump—it is by default set to false. If set to true, the new residue is added by a jump and not a covalent bond. Notice that if there is no residue in the pose (i.e. when you make a pose from scratch), the first residue is always added with a jump. Note that if repeat is mentioned with the jump, only the first residue is added by a jump and the residues after that are added by normal covalent bonds. Jump can only work in the append mode.

Anchor_rsd—can define which residue to use as an anchor to add the new residue to. In terms of a new peptide bond, this will the residue at the C-terminal residue. If not mentioned, it adds by default to the C-terminal residue in the pose.

Connecting_atom—which atom to use for the connection. If not mentioned, the default is to use the LOWR_CONNECT atom specified in the “.params” file of the anchor residue.

Repeat—by default is set to 1. If more than one is mentioned, keeps adding the same residue to the anchor residue. For example, the command line below will add 3 D-Ser to the C-terminal of the peptide with a common peptide bond.

<Append resname="DSER" repeat="3"/>
  • If you’re building a pose from scratch, append is the only mode that will work for the first residue. And by default the first residue of the pose is always added as a jump (nothing to bond it to!).

Prepend options

Prepend= Add residue BEFORE an anchor residue

Resname—what type of residue you want to add. Any residue that is defined in the fa_standard can be used. Should be defined by the user.

Anchor_rsd—can define which residue to use as an anchor to add the new residue to. If not mentioned, it adds by default to the C-terminal residue in the pose.

Connecting_atom—which atom to use for the connection. If not mentioned, the default is to use the UPPER_CONNECT atom specified in the “.params” file of the anchor residue.

Repeat—by default is set to 1. If more than one is mentioned, keeps adding the same residue to the anchor residue. For example, the command line below will add 2 L-Trp to the N-terminal of the peptide with a common peptide bond.

<Prepend resname="TRP" repeat="2"/>

Insert options

Insert=insert a residue after an anchor residue in a pose.

Resname—what type of residue you want to add. Any residue that is defined in the fa_standard can be used. Should be defined by the user.

Anchor_rsd—can define which residue to use as an anchor to add the new residue to. In terms of a new peptide bond, this will the residue at the C-terminal residue. If not mentioned, it adds by default to the C-terminal residue in the pose.

Connecting_atom—which atom to use for the connection. If not mentioned, the default is to use the LOWR_CONNECT atom specified in the “.params” file of the anchor residue.

Repeat—by default is set to 1. If more than one is mentioned, keeps adding the same residue to the anchor residue. Only works for insert if the position is not set.

Position—where we want the new residue index to be. if not mentioned, insert works similar as append.

Special cases

N-acetylation and C-methylamidation

The N-acetylation and C-methylamidation patches can be used as "placeholders" when sampling conformations of an amino acid or short peptide that will be extended. In this case, these variant types should not be removed prior to applying the PeptideStubMover to extend the peptide. If they are present, the mainchain psi and omega angles are preserved when replacing the C-methylamidation with a new amino acid, and the omega (of the N-1 residue) and phi anglse are preserved when replacing the N-acetylation. This feature was added on 7 March 2020.

Auto-generated documentation

Autogenerated Tag Syntax Documentation:


Used to append/insert/prepend residues to a pose

References and author information for the PeptideStubMover mover:

PeptideStubMover Mover's citation(s): *Bhardwaj G, *Mulligan VK, *Bahl G, Gilmore JM, Harvey PJ, Cheneval O, Buchko GW, Pulavarti SVSRK, Kaas Q, Eletsky A, Huang P-S, Johnsen PS, Greisen P Jr., Rocklin GJ, Song Y, Linsky TW, Watkins A, Rettie SA, Xu X, Carter LP, Bonneau R, Olson JM, Coutsias E, Correnti CE, Szyperski T, Craik DJ, and Baker D. (2016). Accurate de novo design of hyperstable constrained peptides. Nature 538(7625):329-35. doi: 10.1038/nature19791. (*Co-primary authors.)

<PeptideStubMover name="(&string;)" reset="(&bool;)"
        update_pdb_numbering="(&bool;)"
        label="(PEPTIDE_STUB_EXTENSION &string;)" >
    <Append resname="(&string;)" position="(&non_negative_integer;)"
            jump="(false &bool;)" connecting_atom="(&string;)"
            repeat="(1 &non_negative_integer;)"
            anchor_rsd="(&non_negative_integer;)" anchor_rsd_selector="(&string;)"
            anchor_atom="(&string;)" />
    <Prepend resname="(&string;)" position="(&non_negative_integer;)"
            jump="(false &bool;)" connecting_atom="(&string;)"
            repeat="(1 &non_negative_integer;)"
            anchor_rsd="(&non_negative_integer;)" anchor_rsd_selector="(&string;)"
            anchor_atom="(&string;)" />
    <Insert resname="(&string;)" position="(&non_negative_integer;)"
            jump="(false &bool;)" connecting_atom="(&string;)"
            repeat="(1 &non_negative_integer;)"
            anchor_rsd="(&non_negative_integer;)" anchor_rsd_selector="(&string;)"
            anchor_atom="(&string;)" />
</PeptideStubMover>
  • reset: Delete the input pose
  • update_pdb_numbering: Update the PDB chain IDs and numbers for this pose
  • label: Residue label for residues added by this mover. This requires update_pdb_numbering="true"

Subtag Append:

  • resname: Name of stub residue
  • position: Position to insert stub residue
  • jump: Append residue by jump?
  • connecting_atom: Name of atom where residues should be connected
  • repeat: Number of times to add this residue
  • anchor_rsd: Residue to which the stub residue should bond
  • anchor_rsd_selector: Selector alternative to "anchor_rsd"
  • anchor_atom: Atom to which the stub residue should bond

Subtag Prepend:

  • resname: Name of stub residue
  • position: Position to insert stub residue
  • jump: Append residue by jump?
  • connecting_atom: Name of atom where residues should be connected
  • repeat: Number of times to add this residue
  • anchor_rsd: Residue to which the stub residue should bond
  • anchor_rsd_selector: Selector alternative to "anchor_rsd"
  • anchor_atom: Atom to which the stub residue should bond

Subtag Insert:

  • resname: Name of stub residue
  • position: Position to insert stub residue
  • jump: Append residue by jump?
  • connecting_atom: Name of atom where residues should be connected
  • repeat: Number of times to add this residue
  • anchor_rsd: Residue to which the stub residue should bond
  • anchor_rsd_selector: Selector alternative to "anchor_rsd"
  • anchor_atom: Atom to which the stub residue should bond