For molecular modelers, organizing data efficiently is essential when dealing with complex molecular structures. SAMSON’s Node Specification Language (NSL) offers a robust way to manage and query folder attributes, enabling users to filter, locate, and analyze data with precision. If you’ve ever found yourself needing a clear way to query molecular data by attributes such as atom count, chain count, or even partial charge, this guide will walk you through the key features and use cases of folder attributes within SAMSON NSL.
Why Folder Attributes Matter
Molecular datasets can become overwhelmingly large and complicated. Whether you’re evaluating a molecule’s structure, filtering folders by specific elements, or analyzing datasets, folder attributes allow you to streamline these tasks through precise queries.
Folder attributes are defined in the folder attribute space (short name: f) and specifically match folder nodes. The attributes range from inherited ones such as visibility and ownership to folder-specific ones like the number of atoms or formal charge. Let’s dive into these features.
Inherited Attributes
Folder nodes inherit several key attributes from their parent node space. Below are some examples of inherited attributes:
- Visibility (
f.v): Lets you query whether a folder is visible (true) or not (false). - Selected (
f.selected): Checks if a folder has been selected. - Has Material (
f.hm): Filters folders containing material by specifyingtrueorfalse.
For example, to query folders that are visible and have material, you can use:
|
1 |
f.v true and f.hm true |
Folder-Specific Attributes
Folder-specific attributes offer even more flexibility by permitting queries on characteristics like the number of atoms, formal charges, and chains. Here are some of the most useful options:
- Number of Atoms (f.nat): Matches folders with a specific number of atoms.
- Formal Charge (f.fc): Filters folders based on total formal charge values.
- Number of Chains (f.nc): Limits results to specific chain counts.
- Partial Charge (f.pc): Targets total partial charge values within a folder.
For instance, to find folders where the number of atoms is greater than 100 and the formal charge ranges between 6 and 8, you’d use:
|
1 |
f.nat > 100 and f.fc 6:8 |
Practical Examples
Here are some example queries to help you understand how folder attributes can simplify your work:
f.nm < 3: Finds folders with fewer than 3 molecules.f.nC 10:20: Targets folders with 10 to 20 carbon atoms within their structures.f.nr > 130: Matches folders with more than 130 residues.
Efficiency in Molecular Modeling
Leveraging folder attributes greatly enhances efficiency in molecular modeling workflows. The ability to query folders using precision filters enables better organization and faster results. Whether you’re working on a single protein structure or vast molecular databases, these attributes are essential tools for modern modelers.
For more detailed examples and further explanations of folder attributes, visit the SAMSON Documentation on Folder Attributes.
SAMSON and all SAMSON Extensions are free for non-commercial use. To get started with this powerful integrative molecular design platform, download SAMSON at SAMSON Connect.