Understanding Folder Attributes in SAMSON’s NSL

For molecular modelers, organization can often become a headache. Complex systems involve multiple structural components, and filtering or specifying specific folders within large molecular designs can be time-consuming. Fortunately, SAMSON’s integrative molecular design platform offers a powerful Node Specification Language (NSL), including a well-defined set of folder attributes, to simplify this process.

This blog post will provide a deep dive into the “folder” attribute space within SAMSON’s NSL. Whether you want to filter folders based on the number of molecules, formal charge, or even the number of carbons in their structure, this functionality can greatly ease your workflow.

Why Folder Attributes Matter

In molecular modeling, you often need to focus only on relevant components of your system. For example, if you’re working with a large system containing various molecular structures, filtering folders based on specific criteria can help you find exactly what you need without having to browse through all folders manually.

Folder Attributes: A Closer Look

In SAMSON’s NSL, folder attributes are organized in a specific namespace, with the short name f. This means that filters applied to f attributes apply solely to folder nodes. Here’s a breakdown of inherited and unique folder attributes you might find useful:

  • numberOfAtoms (f.nat): Matches folders based on the number of atoms they contain. For example: f.nat > 1000 will find folders with more than 1000 atoms.
  • numberOfMolecules (f.nm): Helps you find folders with a certain number of molecules. Example: f.nm 2:4 matches folders containing 2 to 4 molecules.
  • formalCharge (f.fc): Focuses on folders with a specific formal charge. Example: f.fc 6:8 matches folders with formal charge values between 6 and 8.
  • numberOfCarbons, numberOfNitrogens, numberOfHydrogens, numberOfOxygens, and numberOfSulfurs (f.nC, f.nN, f.nH, f.nO, and f.nS): Allow you to filter folders based on specific atomic components.
  • Additional attributes like hidden (f.h), visible (f.v), or ownsMaterial (f.om) help define the folder’s behavior or properties in the molecular hierarchy.

Practical Examples

Consider a scenario where you need to work with folders containing structures that have more than 100 atoms but fewer than 200 molecules. Using folder attributes, this becomes remarkably simple:

  • f.nat > 100 and f.nm < 200: Filters precisely those folders meeting these conditions.

Another example: Suppose you want to isolate folders where visibility is active (“visible” istrue). You can apply the simple filter:

  • f.v true

By combining attributes in SAMSON’s NSL, molecular modelers can save time and focus on their designs without digging through an overwhelming hierarchy.

Conclusion

The folder attributes available in SAMSON’s Node Specification Language are indispensable for those working on complex molecular systems. They simplify the process of focusing on specific folders based on node-specific criteria and atomic properties. By incorporating these tools into your workflow, you can significantly enhance the efficiency and precision of your molecular modeling projects.

To explore folder attributes and learn more, visit the official documentation at this page.

SAMSON and all SAMSON Extensions are free for non-commercial use. You can download SAMSON at samson-connect.net.

Comments are closed.