For molecular modelers utilizing the SAMSON platform, efficiently accessing and organizing data is crucial to managing complex projects. One essential concept that can help with this is understanding file attributes in SAMSON’s Node Specification Language (NSL). These attributes define properties specific to file nodes within your project and are key to streamlining your workflows. Let’s break down what these attributes mean and how you can use them effectively.
What Are File Attributes in NSL?
File attributes are defined within the file attribute space (short name: fi) and are used specifically to interact with file nodes. They allow molecular modelers to filter, manipulate, and retrieve specific file data using structured expressions.
Core File Attributes
Three key file attributes inherited from the node attribute space are:
name: This attribute, inherited fromnode.name, allows you to refer to the name of a file node. For example, you might use the expressionfi.n "A"to locate a file with the name ‘A’. Pattern matching is supported, such asfi.n "L*", which matches all file names starting with ‘L’.selected: This attribute checks whether a node is selected (true) or not (false). For example, you can isolate selected files usingfi.selectedor exclude them withnot fi.selected.selectionFlag: Similar toselected, this attribute allows filtering based on a selection flag state. For instance,fi.sf falsefilters files with selectionFlag set tofalse.
Why Are File Attributes Important?
File attributes ensure granular control over file nodes in SAMSON, enabling tasks like precise filtering and categorization of molecular data. This is particularly useful in projects with numerous file nodes that need to be systematically managed. By using these attributes effectively, you can enhance productivity and maintain well-organized datasets.
Practical Examples for Everyday Use
Here are a few practical examples to help you understand how these file attributes can be used in real-world scenarios:
| Use Case | Expression |
|---|---|
| Find all files starting with ‘L’ | fi.n "L*" |
| Filter only selected files | fi.selected |
| Exclude files with a selection flag | not fi.sf |
Additional Notes
The name attribute is the most versatile for quickly locating nodes by name or by pattern matching, while selected and selectionFlag can help differentiate specific file nodes based on their status during a modeling task. By integrating these attributes into your workflow, you can vastly improve the precision and efficiency of your molecular modeling projects.
To explore more about file attributes and their use in SAMSON, visit the full documentation at https://documentation.samson-connect.net/users/latest/nsl/file/.
SAMSON and all SAMSON Extensions are free for non-commercial use. Access SAMSON at https://www.samson-connect.net.