Find the residues you need—without scanning a structure one residue at a time

When a molecular structure is large, finding a particular set of residues by visual inspection can be slow and easy to get wrong. Maybe you need to check which residues are in a helix, locate a particular residue type, or separate standard amino acids from nonstandard residues. SAMSON’s Node Specification Language (NSL) lets you describe those targets with residue attributes instead of relying only on manual browsing.

The key is to choose an attribute that matches the question you are asking. Residue queries use the residue attribute space, with r as a short prefix. For example, r.t ALA matches alanine residues. These are residue-level queries: they identify residues, not individual atoms.

Start with the kind of information you have

If you know a residue’s name or type, search by type. The type attribute accepts standard amino-acid names and nucleic-acid codes. For example, r.t HIS matches histidines, while r.t LYS, PRO matches lysines and prolines. A comma-separated list is useful when your target has more than one type.

If you know the residue’s position in the structure, use its sequence number instead: r.id == 42 targets residue number 42. You can specify ranges, too: r.id 1:10, 20:30 covers residues numbered 1 through 10 and 20 through 30. This is handy when you are checking a region by its structure IDs. Remember that these numbers are residue sequence numbers, not a measure of how many atoms a residue contains.

If you are investigating local structure, try r.ss h for alpha-helical residues or r.ss b for beta-strand residues. The longer forms are also available: r.ss helix and r.ss beta. For unstructured regions, use r.ss loop or r.ss u.

Use chemical properties to narrow a search

Residue attributes can also describe amino-acid side-chain properties. For charge, r.c neg matches residues with negatively charged side chains, and r.c neu, pos matches neutral or positively charged ones. For polarity, r.p polar finds polar side chains; r.p acidic, basic covers acidic or basic side chains.

These are residue-type properties, so they are useful for classifying amino acids. They should not be confused with a residue’s total formal charge or partial charge. Those are separate attributes: r.fc refers to formal charge, and r.pc to partial charge. For instance, r.fc > 1 tests formal charge, while r.pc > 1.5 tests partial charge. Use the property that fits the quantity you mean.

Check completeness and naming

Before interpreting a region, you may want to identify residues with a complete amino-acid backbone using r.caab. To distinguish standard PDB residue names from nonstandard ones, use r.srn and r.nsrn, respectively. These checks can help focus attention on incomplete backbones or unusual residue names before you continue an analysis.

A practical approach is to begin with the most direct attribute—type, sequence number, or secondary structure—and then inspect whether the resulting residues fit your expectation. If the result is not what you intended, check whether you queried residue type, charge, or sequence number; these describe different things. Also note the level of the query: when you specifically need atoms within matching residues, NSL supports expressions such as "CA" in r.t VAL, which matches alpha carbons by name in valine residues.

For the complete residue attribute reference and more examples, see the SAMSON residue attributes documentation.

Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON.

Comments are closed.