A molecular project can accumulate folders of structures faster than anyone can remember what is inside them. One folder may contain a small molecule, another a protein-sized system, and a third several chains or structural models. Opening folders one by one to check basic composition is tedious—and makes it easy to overlook a useful candidate.
SAMSON’s Node Specification Language (NSL) lets you search folder nodes by properties such as atom counts, chain counts, residue counts, and total charge. These searches are useful for an initial triage: identify folders that meet a size or composition criterion, then inspect the promising structures in more detail.
Start with the folder scope
Folder attributes use the folder attribute space, abbreviated f. A query such as f.nat < 1000 therefore searches folders by their number of atoms; it is not a general-purpose query for individual atoms. The short names make repeated searches compact, while the full names can be easier to remember when you are learning the language.
Use counts to narrow the search
For a first pass, choose the count that best describes the kind of structure you want to find:
f.nat 100:200matches folders with between 100 and 200 atoms.f.nc 2:4matches folders with between 2 and 4 chains.f.nm 2:4matches folders with between 2 and 4 molecules.f.nr 100:120matches folders with between 100 and 120 residues.f.nsm > 4matches folders with more than 4 structural models.
These attributes answer different questions. Atom count is a broad size measure; chain and molecule counts can help distinguish different kinds of assemblies; residue count is useful when working with residue-based structures; and structural-model count can help locate folders containing multiple models. Pick the measure that corresponds to your actual bottleneck rather than relying on one count as a proxy for everything.
Check composition and charge
Element-specific counts can help you find folders with a particular composition. For example, f.nC < 10 searches for fewer than 10 carbon atoms, while f.nO 10:20 searches for between 10 and 20 oxygen atoms. The same pattern is available for hydrogen (f.nH), nitrogen (f.nN), and sulfur (f.nS). You can also search coarse-grained atom counts with f.ncga.
When charge is the relevant property, use f.fc for formal charge or f.pc for partial charge. For example, f.fc 6:8 matches folders whose structures have a total formal charge between 6 and 8. The expression f.pc 1.5:2.0 searches for a total partial charge in that range. Formal charge values are integers; partial charge values can be real numbers.
Make the search repeatable
A practical workflow is to begin with one broad criterion, such as an atom-count range, and then run additional searches for the property you need to inspect next. Keeping each query focused makes it easier to understand why a folder matched. For example, compare the atom-count, chain-count, and residue-count results rather than assuming that a particular atom count implies a particular biological or chemical identity.
Folder attributes also include inherited node properties, such as name, visibility, and selection state. For instance, f.n "A" and f.v are listed as examples for name and visibility. These can be useful when your search is about folder organization or display state rather than molecular composition.
For the complete list of folder attributes, short names, and examples, see the SAMSON folder attributes reference.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON.
