Mastering Residue Selection with the Node Specification Language in SAMSON

For molecular modelers, navigating and selecting specific residues in a molecular structure can be a challenge, especially when working with complex systems. SAMSON’s Node Specification Language (NSL) offers an efficient and systematic way to interact with molecular data, making the task much more accessible. In this post, we’ll explore residue attributes within NSL and how they can help streamline residue selection and analysis.

What Are Residue Attributes?

The residue attributes in NSL allow you to define and filter residues based on specific characteristics such as their visibility, sequence number, composition, secondary structure, and more. These attributes are particularly helpful for cases like:

  • Selecting residues based on their polarity or charge.
  • Targeting residues by their residue sequence numbers.
  • Filtering based on residue’s structural features, such as whether they are part of a beta strand or an alpha helix.

This capability enables precise operations on subsets of residues without the need for extensive manual filtering.

How It Works

Residue attributes in NSL use an intuitive format that aligns with SAMSON’s underlying molecular structure model. Each attribute has a long name, a short name for convenience, and specific possible values. For example:

  • residue.secondaryStructure (short name: r.ss) matches residues based on their secondary structure. Possible values include:
    • alpha (or aliases a, helix, h): Matches alpha helices.
    • beta (or aliases b, strand, s): Matches beta strands.
    • unstructured (or aliases u, loop, l): Matches unstructured regions in the structure.

Examples:

  • Select residues in alpha helices: residue.secondaryStructure alpha or r.ss a.
  • Target residues that are either alpha helices or beta sheets: r.ss a, b.

Advanced Selection with Residue Sequence Numbers

Another powerful feature is selecting residues based on residue sequence numbers. The residue.residueSequenceNumber (short name: r.id) attribute allows you to target specific residues or ranges efficiently.

For instance:

  • To select residue number 42: r.id == 42.
  • For residue ranges 1–10 and 20–30: r.id 1:10, 20:30.

This feature is especially useful for focusing on particular regions of a protein or nucleic acid structure.

Residue Charge, Polarity, and Type

Residue attributes also extend to physical and chemical properties:

  • To filter residues based on charge: Use residue.charge (r.c), with values such as negative (neg), neutral (neu), or positive (pos).
  • To focus on polarity: Use residue.polarity (r.p), with values like polar, acidicPolar (acidic), or basicPolar (basic).
  • For precise residue types, use residue.type (r.t) to target specific amino acid names (e.g., ALA for alanine, HIS for histidine, etc.).

Examples:

  • Select residues with a neutral charge: r.c neu.
  • Match alanines: r.t ALA.
  • Target residues with a polar side chain: r.p polar.

Why These Features Save Time

Molecular modelers often deal with large, complex systems where manual workflows can be time-consuming and error-prone. The residue attributes in NSL offer a consistent and flexible way to handle residue selection, ensuring faster results with greater accuracy.

If you’re a modeler looking to analyze specific residues based on their structure or chemical properties, using residue attributes in NSL will simplify your task and improve your ability to focus on key areas of interest.

Explore the full range of residue attributes and their capabilities in the official documentation page.

SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON today at SAMSON Connect.

Comments are closed.