Find the atoms that deserve a second look

When inspecting a molecular structure, it is easy to spend time reviewing atoms that are already well defined while overlooking the ones that may need attention. Alternate locations, low occupancy, and high temperature factors can help you narrow the search. In SAMSON, the Node Specification Language (NSL) lets you describe those criteria as compact atom queries instead of selecting atoms one by one.

The goal is not to label an atom as wrong. These attributes are clues for triage: they help identify a subset of a structure for closer inspection, comparison, or follow-up. The right interpretation still depends on the structure and the question you are asking.

Start with occupancy

Occupancy is useful when you want to find atoms whose positions are represented with relatively low occupancy. For example:

  • a.oc < 0.3 selects atoms with occupancy below 0.3.
  • a.oc 0.6:0.7 selects atoms with occupancy between 0.6 and 0.7.

These queries can help you locate less-occupied positions without scanning every atom record. A range is useful when you want to inspect a particular band rather than set a single cutoff. If occupancy is missing or interpreted differently in your input, treat the result as a prompt to check the source data, not as a complete assessment of structural quality.

Look for elevated temperature factors

Temperature factors, also known as B factors, provide another way to identify atoms for review. In NSL, use a.tf. For example, a.tf > 75 matches atoms with temperature factors greater than 75, while a.tf 10:50 matches values between 10 and 50.

A high value can point you toward a region that is less well defined in the model, but it does not by itself explain why. Consider the local context and the conventions of the structure you are examining. Comparing nearby atoms or residues can be more informative than treating one threshold as a universal cutoff.

Combine signals to make a focused shortlist

One criterion may return a large set. Combining criteria can make the result more manageable. For example, a.oc < 0.3 and a.tf > 75 matches atoms that meet both conditions: low occupancy and a temperature factor above 75. This is a targeted shortlist for visual or data-level review—not a verdict that those atoms are incorrect.

You can also focus on non-hydrogen atoms by adding a.heavy, the long-form equivalent of a.nonH. For instance, a.heavy and a.oc < 0.3 narrows the occupancy search to heavy atoms. Adding conditions is most useful when each one answers a clear question; overly restrictive filters can hide atoms you intended to inspect.

Separate alternate locations

Some structures contain alternate atom locations, commonly identified by a location character. Use a.alt A to match atoms with alternate location A, or a.alt B, C to match atoms assigned B or C. This helps you inspect one alternate-location group at a time, or compare groups without mixing them into a single review.

Alternate locations are not automatically errors. They indicate that the structure records alternative positions. Keep that distinction in mind when using them as a filter, especially if you are combining alternate-location queries with occupancy checks.

A practical review sequence

  1. Start with one broad query, such as a.oc < 0.3 or a.tf > 75.
  2. Use a combined query if the initial result is too large, and note exactly which conditions are joined with and.
  3. Check whether alternate locations are present with a.alt A or a list of location characters.
  4. Inspect the selected atoms in context and consult the original structure data before drawing conclusions.

NSL atom attributes can also filter by residue sequence number, chain, element, and other properties, which can help you focus a review on a particular part of a model. For the complete attribute reference and more examples, see the SAMSON atom attributes documentation.

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

Comments are closed.