Find the Right Molecular Folder Before You Open Everything

A crowded molecular scene can make a simple question surprisingly time-consuming: which folder contains the structure with the size, composition, or charge I need? Opening folders one by one is a slow way to screen candidates. SAMSON’s Node Specification Language (NSL) lets you describe folder-level properties in a compact query, so you can narrow the search before inspecting structures in detail.

The key distinction is that these attributes apply to folder nodes. The short name for the folder attribute space is f. A query such as f.nat < 1000 selects folders whose structures contain fewer than 1,000 atoms. For a bounded range, use f.nat 100:200 to match folders with 100 to 200 atoms. This is useful when you know roughly what scale of system you want, but do not know the folder name.

Folder attributes also let you screen by composition. For example, f.nC < 10 matches folders with fewer than 10 carbon atoms, while f.nH 10:20 checks for 10 to 20 hydrogen atoms. The corresponding short names include nC for carbon, nH for hydrogen, nN for nitrogen, nO for oxygen, and nS for sulfur. These counts can help distinguish folders with different elemental makeup without relying on labels or remembering where a structure was saved.

Other counts answer different screening questions. Use f.nc 2:4 for folders with 2 to 4 chains, f.nm < 3 for fewer than 3 molecules, or f.nr > 100 for more than 100 residues. For structural organization, f.ns < 3 checks the number of segments, f.nsg > 10 checks structural groups, and f.nsm > 4 checks structural models. The attribute names are descriptive; the short forms are convenient when writing queries repeatedly.

Charge can be another useful filter when comparing structures. f.fc 6:8 matches folders whose structures have a total formal charge between 6 and 8. For total partial charge, try f.pc 1.5:2.0. Formal charge accepts integers, while partial charge accepts real numbers. Keeping these two measures distinct matters: they are separate folder attributes and should not be treated as interchangeable.

A practical approach is to start with the property that most reduces the candidate set: perhaps atom count for a size-sensitive task, or residue count for a protein-focused search. Then check composition, chains, molecules, or charge as needed. This turns a vague search into a series of explicit questions. It also makes your search easier to repeat: a short expression such as f.nat 100:200 records the criterion you used, rather than leaving it buried in a sequence of manual inspections.

Folders also inherit general node attributes, including name, visibility, and selection state. For instance, f.n "A" searches by a name string, and f.v matches visible folders. These can be useful when the issue is not molecular composition but finding or managing folders in a busy scene.

For the complete list of folder attributes, inherited properties, and examples, see the SAMSON folder attributes reference.

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

Comments are closed.