For molecular modelers working with large datasets, organizing and querying molecular folders efficiently can be a major challenge. In SAMSON, the Node Specification Language (NSL) offers a versatile system to categorize and retrieve molecular data, and understanding folder attributes can significantly enhance workflow efficiencies. In this guide, we’ll demystify how to use folder attributes effectively, providing key details and examples to get you started.
Why Folder Attributes Matter
Folder attributes in NSL help you specify and query characteristics of molecular folders seamlessly. By using these attributes, you can filter structures based on properties such as the number of molecules, specific atom counts, or other structural details. This targeted approach saves time and enables precision in handling molecular models.
Core Folder Attribute Categories
The folder attribute space uses a standard format, with f as its shorthand prefix. The attributes can be broadly categorized into inherited attributes (shared with generic nodes) and folder-specific attributes. Below are some key ones worth exploring:
1. numberOfAtoms (f.nat)
This attribute helps you locate folders containing structures with a specific number of atoms. Whether you are analyzing small molecules or complex biomacromolecules, this provides a precise way to filter data.
Examples:
f.nat > 100matches folders with more than 100 atoms.f.nat 100:200matches folders with atom counts between 100 and 200.
2. numberOfCarbons (f.nC)
Focusing specifically on Carbon atoms, this attribute enables filtering for structures enriched in certain organic components.
Useful Application: For drug discovery projects focusing on hydrocarbon-based compounds, f.nC can be an invaluable tool to narrow down results efficiently.
3. numberOfMolecules (f.nm)
If your research involves multimeric complexes, f.nm allows you to isolate structures containing specific numbers of molecules.
Examples:
f.nm < 3: Matches folders with less than three molecules.f.nm 2:4: Matches folders with molecule counts between 2 and 4.
4. numberOfResidualSegments (f.ns)
This attribute evaluates the number of segments in each folder, aiding in the organization of various structural models in multichain proteins or systems.
f.ns > 2: Focus on folders with three or more segments.
Built-in Flexibility and Expression
One of the great features of folder attributes in NSL is the ability to define ranges or logical operators. For instance, by combining multiple expressions like f.nat > 100 and f.nm == 3, you can extract highly specific subsets of data for analysis.
How to Start
Folder attributes might take some practice if you’re unfamiliar with NSL’s syntax, but the investment pays off quickly. If you want to explore the entire range of folder-related filtering capabilities, the SAMSON documentation delivers detailed examples for every attribute covered here.
Learn more about folder attributes and how to enhance your workflows with SAMSON’s Node Specification Language.
SAMSON and all SAMSON Extensions are free for non-commercial use. You can download SAMSON here.