When a project contains many structural models, the first challenge is often simple: finding the ones worth inspecting. A model’s name may not tell you whether it is a small ligand, a large assembly, or a structure with the composition you need. Opening models one by one turns a quick screening task into repetitive work.
SAMSON’s Node Specification Language (NSL) lets you describe structural models using properties such as atom count, residue count, chain count, and the number of selected element types. The structural-model attribute space uses the prefix sm. These queries can help you narrow a search by measurable features before spending time on visual inspection.
Start with the scale of the model
If you are looking for relatively small structures, filter by atom count. For example, sm.nat < 1000 matches structural models with fewer than 1,000 atoms. To focus on models within a specific size band, use a range: sm.nat 100:200 matches models with 100 to 200 atoms.
The same pattern applies to several other counts. Use sm.nr > 100 to find models with more than 100 residues, or sm.nc 2:4 to find models with between two and four chains. These criteria answer different questions: atom count is a broad measure of model size, while residues and chains can be more informative when screening biological structures.
Screen by elemental composition
Counts for carbon, hydrogen, nitrogen, oxygen, and sulfur can help distinguish models with different compositions. For instance, sm.nO < 10 selects structural models with fewer than 10 oxygen atoms, while sm.nN 10:20 uses a range for nitrogen count. The corresponding short names are nC, nH, nN, nO, and nS.
These counts are useful as screening clues, not as complete chemical descriptions. A matching oxygen count alone does not establish a molecule’s identity or function. Use the result to create a smaller set for closer examination, rather than treating a single count as a definitive classification.
Check charge when it matters
For charge-based screening, NSL provides sm.fc for total formal charge and sm.pc for total partial charge. For example, sm.fc 6:8 matches models with a formal charge between 6 and 8, while sm.pc 1.5:2.0 matches models with partial charge in that interval. Formal charge values are integers; partial charge values are real numbers.
Choose a filter that answers one question
A practical way to begin is to translate your screening goal into a single measurable question: “Is this model under a particular atom count?”, “Does it contain a certain number of residues?”, or “Is its total formal charge in this interval?” Then select the matching attribute and use either a comparison or range. This keeps a search easy to interpret and makes it simpler to adjust the threshold if the results are too broad or too narrow.
Remember that these attributes belong to the structuralModel attribute space, so they match structural model nodes. NSL also includes inherited node attributes such as name, visibility, and selection state, which can help describe models in other ways. For the full list of structural-model attributes and syntax examples, see the structural model attributes reference.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON.
