A Faster First Pass: Find the Structural Models That Need Your Attention

A molecular project can contain several structural models, and it is easy to lose time opening them one by one just to answer basic questions: Which models are unusually large? Which contain many chains or residues? Which have a particular total charge? A quick first pass based on model-level properties can help narrow the field before you inspect individual atoms or residues.

In SAMSON, the Node Specification Language (NSL) provides attributes for querying structural models. The structuralModel attribute space, abbreviated sm, matches structural model nodes. Its attributes include counts such as atoms, chains, molecules, residues, and structural groups, as well as total formal and partial charge.

Start with the question you need to answer

If you are looking for models above a rough size threshold, query the atom count. For example, sm.nat > 100 matches structural models with more than 100 atoms. To focus on a bounded range, use sm.nat 100:200. These are useful starting points when you want to separate small models from larger ones without judging size by appearance in the viewport.

Counts can also help distinguish models with different organization. Use sm.nc < 3 to match models with fewer than three chains, or sm.nc 2:4 for models with two to four chains. To look at residue count, try sm.nr > 100 or sm.nr 100:120. For molecule count, sm.nm < 3 and sm.nm 2:4 provide the same kinds of threshold and range queries.

Use composition and charge as clues

When atom composition matters, structural-model attributes include counts of carbon, hydrogen, nitrogen, oxygen, and sulfur atoms. For instance, sm.nO < 10 can match models with fewer than ten oxygen atoms, while sm.nH 10:20 selects by a hydrogen-count range. Other available short names include sm.nC, sm.nN, and sm.nS. The documentation describes these elemental-count attributes as working similarly to the atom-count attribute.

Charge can be another useful sorting clue. sm.fc 1 matches models with a total formal charge of 1, and sm.fc 6:8 matches charges from 6 to 8. For total partial charge, use sm.pc 1 or a range such as sm.pc 1.5:2.0. Formal charge uses integer values; partial charge uses real values.

Make the query readable

Short names are convenient once you recognize them, but the full attribute names make a query easier to understand later. For example, structuralModel.numberOfResidues > 100 is equivalent to sm.nr > 100. Start with the full form if you are learning the vocabulary, then switch to short names when writing or reusing compact expressions.

A practical first-pass routine is to decide what “needs attention” means for your project, then choose the corresponding attribute: atom count for size, chain or molecule count for organization, residue count for model scale, composition counts for elemental content, or charge for electrostatic bookkeeping. The thresholds are yours to set; the examples above show the query patterns, not universal definitions of a large or unusual model.

These attributes describe structural models, so keep the scope in mind: sm queries structural model nodes, rather than being a general-purpose atom query. If you need to inspect a different kind of node, consult the relevant NSL attribute space.

For the complete attribute list and additional examples, see the structural model attributes reference.

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

Comments are closed.