When a molecular structure is large, inspecting every atom one by one is rarely practical. The challenge is often to narrow the view: find atoms with low occupancy, unusually high temperature factors, or a particular combination of structural features—without losing track of which chain or residue they belong to.
SAMSON’s Node Specification Language (NSL) lets you describe those atoms with compact expressions. This is useful for triage: create a focused selection, inspect it in context, and decide what deserves further attention. A query selects matching atoms; it does not, by itself, change their coordinates or repair the structure.
Start with a property, then add context
Two useful atom attributes for structure review are occupancy (a.oc) and temperatureFactor (a.tf). For example:
a.oc < 0.5selects atoms with occupancy below 0.5.a.tf > 75selects atoms with a temperature factor greater than 75.
Rather than viewing each result separately, combine conditions to make one focused query:
a.tf > 75 and a.oc < 0.5 and a.heavy
This asks for heavy (non-hydrogen) atoms that meet both numeric conditions. The thresholds are examples, not universal cutoffs: choose values that make sense for the structure and the question you are investigating.
It is also easy to narrow the search to a region. For example:
a.c A and a.resi 40:50 and a.heavy and a.tf > 75
This combines chain A, residue sequence numbers 40 through 50, heavy atoms, and a temperature-factor threshold. The chain and residue conditions help keep a list of matches interpretable: you can relate the selection back to a specific part of the model.
Why combine filters?
A single property may return more atoms than you can usefully inspect. A high temperature factor alone might identify atoms across many parts of a structure; adding a chain or residue range turns a broad scan into a local check. Conversely, beginning with a location and adding a property can help you compare which atoms in that region meet your criterion.
NSL supports comparisons such as >, <, and >=, as well as ranges written with a colon. For instance, a.oc 0.6:0.7 selects occupancies between 0.6 and 0.7, while a.resi 40:50 specifies a residue-number range. A comma can list alternatives for attributes that accept multiple values, such as a.c B, C for chains B or C.
Read the result with care
Occupancy and temperature factor are useful clues, not verdicts. Their interpretation depends on the structure and its experimental or modeling context. A query can help bring a subset of atoms to your attention, but it cannot establish why a value is high or low, or whether the atoms are biologically meaningful. Treat the selection as a starting point for inspection, not as an automatic quality judgment.
Attribute availability also matters. Some properties depend on information being present or computed: the documentation notes, for example, that geometry must be computed before the geometry attribute can be used, and hybridization may need to be assigned. Coarse-grained mass, radius, and type apply to coarse-grained atoms. Checking these prerequisites can save time when a query returns no matches.
Finally, atom attributes match atom nodes. The a prefix is the short name for the atom attribute space, and many full names have short aliases—for example, atom.occupancy and a.oc. Short forms make repeated filters easier to read and edit once you know what they mean.
For the complete attribute list, value types, and more examples, see the SAMSON atom attributes reference.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON.
