When a molecular structure contains many residues, tracking down one side chain by eye can be slow. The challenge is especially familiar when you are checking composition or charge: you may know what kind of feature to look for, but not where it is in the structure. In SAMSON, the Node Specification Language (NSL) lets you search side-chain nodes by attributes such as atom counts, formal charge, and partial charge.
Start with the side-chain attribute space
The side-chain attribute space matches side-chain nodes. The documentation uses the prefix sc in its examples, so a query such as sc.nC < 10 tests the number of carbons on a side chain. This gives you a way to search by a structural property rather than relying only on visual inspection or a remembered residue name.
Before building a search, decide what question you are asking. Are you looking for side chains with a particular element count? A formal charge in a range? A partial charge above a threshold? Keeping the question specific makes it easier to interpret what the query returns.
Use atom counts to narrow the search
Side-chain nodes inherit several count attributes from the structural-group attribute space. These include total atoms (nat), carbons (nC), hydrogens (nH), nitrogens (nN), oxygens (nO), sulfurs (nS), and coarse-grained atoms (ncga). These attributes accept integer comparisons and ranges.
For example, sc.nO > 1 is a way to find side chains with more than one oxygen, while sc.nS 1:2 searches for a sulfur count in the specified range. If you are checking for a broad composition pattern, an element-specific count is often easier to reason about than total atom count alone. The examples in the reference also show forms such as sc.nC 10:20 and sc.nat < 1000.
These counts describe the atoms associated with the side-chain node. They are useful for narrowing a set of candidates, but they do not by themselves tell you why a side chain has that composition. Use the result as a shortlist for inspection, not as a substitute for interpreting the molecular context.
Separate formal charge from partial charge
Charge searches are more informative when you distinguish the two charge attributes. formalCharge, abbreviated fc, is an integer attribute. For instance, sc.fc > 1 searches for formal charges greater than one, and sc.fc 6:8 illustrates a range query.
partialCharge, abbreviated pc, accepts floating-point values instead. The reference gives examples such as sc.pc > 1.5 and sc.pc 1.5:2.0. These are different kinds of checks: do not treat a partial-charge threshold as if it were a formal-charge value. Choose a threshold that fits the question you are investigating, then inspect the returned side chains in the context of the model.
A practical search routine
-
Describe the feature you want to investigate in one phrase, such as “side chains with multiple oxygens” or “side chains with a formal charge above one.”
-
Choose the matching attribute: an elemental count, total atom count, formal charge, or partial charge.
-
Write a focused NSL expression using the
scprefix, for examplesc.nO > 1orsc.fc > 1. -
Review the matches in the structure. A query identifies nodes that meet the specified condition; scientific interpretation still depends on their molecular environment and the purpose of your analysis.
Side-chain nodes also inherit general node attributes, including name, visible, and selected. Those can help describe or manage nodes, but for composition and charge triage, the structural-group counts and charge attributes are the most directly relevant starting points.
For the complete attribute list and additional examples, see the SAMSON side-chain attributes reference.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON.
