When a Structure Feels Too Large: Find Conformations by Atom Count

A molecular project can contain conformations at very different scales. When you need to locate the larger ones—for inspection, comparison, or simply to understand what is in the model—opening nodes one by one is a slow way to answer a basic question: how many atoms does each conformation contain?

SAMSON’s Node Specification Language (NSL) provides a direct filter for this task: conformation.numberOfAtoms, abbreviated co.nat. It matches conformation nodes according to their atom counts, so you can express a size criterion instead of relying on names or visual guesses.

Start with a threshold

To find conformations containing more than 100 atoms, use:

co.nat > 100

The full attribute name works too:

conformation.numberOfAtoms > 100

This is useful when “large” has a practical meaning in your current task—for example, when you want to narrow a crowded document to conformations above a chosen atom-count threshold. Change the number to fit the question you are asking. The attribute accepts integer values, and the comparison operator makes it possible to state a cutoff directly.

Use a range when a cutoff is not enough

Sometimes you need a band of sizes rather than everything above one threshold. To match conformations with atom counts between 100 and 200, the documented range expression is:

co.nat 100:200

The long form is conformation.nat 100:200. Keeping the query in this form makes its intent easy to read: the attribute is atom count, and the two integers define the range. If an exact endpoint matters for your analysis, check how the range behaves at that boundary in your SAMSON version rather than assuming whether the endpoints are included.

Keep the attribute and its abbreviation straight

There is a small but important distinction in the reference table: co.n means the conformation’s name, while co.nat means its number of atoms. For example, co.n "A" searches by name; it is not a numeric atom-count query. When writing a size filter, use nat.

You can also use the name attribute to look for a named conformation, such as co.n "A". Quoted strings are used for names, and the documentation also gives co.n "L*" as an example. Treat names and counts as different ways of identifying nodes: one describes a label, the other a quantity.

Selection status is a separate filter

Conformations inherit selection-related attributes from the general node attribute space. The expression co.selected matches selected conformations, while not co.selected matches those that are not selected. The inherited selectionFlag attribute can be written as co.sf; for example, co.sf false or co.sf.

These attributes answer a different question from co.nat: selection status tells you whether a node is selected, while atom count describes its size. Keeping that distinction in mind helps prevent a common workflow mix-up—trying to use a selection state to identify a structure’s scale, or assuming a name indicates its atom count.

A practical way to use the filter

  • Decide whether you need a minimum size or a bounded range.
  • Write the query with co.nat, such as co.nat > 100 or co.nat 100:200.
  • Use co.n only when you are filtering by a conformation name.
  • Use co.selected or co.sf when selection state is the criterion.

Atom-count filtering is a small tool, but it can make a large document easier to navigate: instead of inspecting every conformation to estimate its size, state the size criterion explicitly and focus on the matches. For the complete attribute reference and additional examples, see the SAMSON conformation attributes documentation.

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

Comments are closed.