A molecular model can be visually impressive and still be difficult to inspect. A structure may contain several chains, hundreds of residues, or far more atoms than you want to handle in a first-pass review. Before opening each object and counting by hand, use SAMSON’s Node Specification Language (NSL) to ask simple, targeted questions about the molecule.
This is especially useful when a document contains many molecules and you need to narrow the field: find small structures, locate molecules with a particular atom composition, or distinguish a multi-chain structure from a single-chain one. NSL makes those checks into readable expressions rather than a manual counting exercise.
Start with molecule-level counts
Molecule attributes use the molecule attribute space, abbreviated mol. For example, to find molecules with fewer than 1,000 atoms, use mol.nat < 1000. The full attribute name is molecule.numberOfAtoms; the short form is easier to type once you become familiar with it.
Other useful first-pass filters include:
mol.nc < 3to match molecules with fewer than three chains.mol.nr > 100to match molecules with more than 100 residues.mol.ns 1:3to match molecules with between one and three segments.mol.nsg > 10to match molecules with more than ten structural groups.
These counts answer different questions. Atoms describe the overall atom count; residues and chains help characterize molecular organization; segments and structural groups are separate counts. Choose the attribute that corresponds to the kind of complexity you need to assess instead of treating all counts as interchangeable.
Use composition to narrow candidates
When size alone is not enough, molecule attributes inherited from the structuralGroup space let you filter by elemental counts. For instance, mol.nC < 10 matches molecules with fewer than ten carbons, while mol.nO 10:20 matches molecules with between ten and twenty oxygens. The corresponding short names are nC and nO; similar attributes are available for hydrogen, nitrogen, and sulfur.
Charge can also be a useful screening property. Use mol.fc > 1 to match molecules whose formal charge is greater than one, or mol.pc > 1.5 to match molecules whose partial charge is greater than 1.5. Formal charge accepts integer values, while partial charge accepts floating-point values. These expressions help you find candidates to inspect; they do not replace checking whether a molecule is appropriate for a particular scientific question.
A practical first-pass routine
- Decide what “manageable” means for your task. If atom count is the constraint, start with
mol.nat. If you are comparing organization, inspect chains, residues, or segments instead. - Screen composition separately. Try an element count such as
mol.nN < 10ormol.nS 1:3when the presence or amount of an element matters. - Check the candidates in context. A count is a compact way to narrow a selection, not a description of connectivity, geometry, or molecular function.
Running these as separate searches keeps each result easy to interpret. The examples above use the abbreviated forms shown in the molecule attribute reference; the long attribute names are available too. The page also lists inherited node attributes, including molecule name, visibility, and selection state—for example, mol.n "A" matches a molecule named “A,” and not mol.visible refers to molecules that are not visible.
For the full list of molecule attributes and syntax examples, see the SAMSON molecule attributes reference.
Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON.
