Find the right conformations by atom count

When a molecular project contains several conformations, it can be surprisingly easy to inspect the wrong one. Names may be similar, and a long list of structures does not immediately reveal which conformations are large enough for a particular analysis. Filtering by atom count gives you a simple, reproducible way to narrow the list before you continue.

Start with the number of atoms

In SAMSON’s Node Specification Language (NSL), the conformation attribute space matches conformation nodes. Its short name is co. The numberOfAtoms attribute has the short name nat, and it accepts integer values.

To find conformations containing more than 100 atoms, use:

co.nat > 100

The fully written version is conformation.nat > 100. The short and long forms refer to the same attribute. This is useful when you want a compact expression for repeated work, or a more explicit one that is easier for a colleague to read.

Use a range when size matters in both directions

Sometimes a threshold is not enough. You may want to focus on conformations in a particular size band—for example, when comparing structures of similar scale. NSL supports a range expression:

co.nat 100:200

This matches conformations with a number of atoms between 100 and 200. The equivalent longer form is conformation.nat 100:200. A range can make a search easier to interpret than a long list of individual values, and it gives you a clear criterion to record alongside your analysis.

Keep the attribute straight

One detail is worth checking when writing expressions: nat is the short name for numberOfAtoms. The short name for name is n. So, for an atom-count filter, use co.nat, not co.n. The latter refers to a name attribute and takes a quoted string, such as co.n "A".

That distinction matters when you are adapting an expression from another search. A query can look syntactically plausible while referring to a different property than the one you intend. Checking the attribute name before relying on a result is a small habit that can prevent confusion later.

Make the filter part of your workflow

A practical approach is to begin with a question you can express numerically: “Do I need conformations larger than 100 atoms?” or “Am I comparing structures between 100 and 200 atoms?” Translate that question directly into co.nat > 100 or co.nat 100:200, then inspect the matching conformations in the context of your project.

Atom count is a useful first-pass criterion, not a complete description of molecular suitability. Two conformations with the same number of atoms may still differ in ways that matter for your task. Use the filter to reduce an unwieldy set and make the next inspection more focused—not as a substitute for checking the structures themselves.

Other conformation attributes

Conformations also inherit node attributes such as name, selected, and selectionFlag. For example, a name can be specified as co.n "A", while co.selected and not co.selected express whether a conformation is selected. These inherited attributes can help describe or identify nodes, while co.nat is the attribute specifically intended for filtering by atom count.

For the full attribute reference and additional syntax details, see the SAMSON conformation attributes documentation.

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

Comments are closed.