From crowded scene to useful shortlist: filtering molecular folders by what they contain

A molecular project can accumulate folders that are difficult to distinguish at a glance. One may contain a large structure, another several chains, and another a collection of models. When folder names alone are not enough, searching by structural counts or charge can help turn a crowded scene into a more manageable shortlist.

SAMSON’s Node Specification Language (NSL) includes a folder attribute space, with the short prefix f. It matches folder nodes and lets you describe folders using properties of their contents. This is useful when you remember what a structure contains but not where it sits in the project.

Start with the question you need to answer

Before writing a filter, translate the task into a measurable property. Are you looking for a folder with a particular number of residues, a small number of chains, or a structure with a specified total charge? The folder attributes cover these kinds of counts and charge values.

  • To find folders with more than 100 residues, use f.nr > 100.
  • To find folders with fewer than three chains, use f.nc < 3.
  • To find folders with between two and four molecules, use f.nm 2:4.
  • To look for a total formal charge from 6 to 8, use f.fc 6:8.
  • To look for a total partial charge from 1.5 to 2.0, use f.pc 1.5:2.0.

The longer attribute names are also available. For example, folder.numberOfResidues > 100 is the long form of f.nr > 100. Short names are convenient for repeated use; long names can be easier to read when you are first learning the attribute set.

Use counts to narrow the search

Counts can be useful as an initial sorting principle. If you are trying to locate a larger protein structure, a residue-count filter such as f.nr > 130 can narrow the candidates. If you are looking for a folder containing a relatively small number of chains, f.nc < 3 expresses that criterion directly. For a range, the documentation gives examples such as f.nat 100:200 for the number of atoms and f.ns 1:3 for the number of segments.

You can also focus on elemental composition. For example, f.nC < 10 searches by number of carbon atoms, while f.nO 10:20 searches by number of oxygen atoms. Related attributes are available for hydrogen, nitrogen, and sulfur atoms, as well as coarse-grained atoms. These criteria describe counts; they do not by themselves identify a molecule or establish that a structure is chemically suitable for a particular experiment.

Choose charge criteria carefully

Formal charge and partial charge are separate folder attributes. f.fc refers to the total formal charge of structures in matching folders, and f.pc refers to total partial charge. For example, the documented expression f.fc 1 looks for a formal charge equal to 1, whereas f.pc 1 looks for a partial charge equal to 1. Keeping the distinction clear helps avoid treating these two different quantities as interchangeable.

A practical way to work

  1. Write down the property you remember: for example, residue count, chain count, or charge.
  2. Choose its folder attribute and express the value as an exact number, comparison, or range.
  3. Try a focused expression such as f.nr > 100 or f.nm 2:4.
  4. Review the matching folders and refine the criterion if the shortlist is still too broad.

This approach is most helpful when you have a useful structural clue but not a reliable folder name. It also makes the search criterion explicit, so you can understand why a folder was included. For the full list of folder attributes, short names, and examples, see the SAMSON folder attributes reference.

Note: SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON at samson-connect.net.

Comments are closed.