A Beginner’s Guide to NSL File Attributes in SAMSON

For molecular modelers working with SAMSON, understanding and efficiently managing file attributes using Node Specification Language (NSL) can significantly improve your workflow. But what exactly are file attributes in the context of NSL, and how can they help?

Let’s delve into the basics of the file attribute space, explore the key attributes available for file nodes, and look at practical examples that will help you streamline your molecular modeling projects.

What Are File Attributes?

In the NSL of SAMSON, file attributes refer to properties belonging to file nodes. These are part of the file attribute space, which has the short name fi. File attributes allow users to query and manipulate properties specific to file data within their molecular models.

Some attributes are inherited from the general node attribute space, providing consistency and flexibility. Let’s break down the most important attributes:

Key File Attributes

Here are some of the most commonly used file attributes:

  • name: The name attribute allows you to work with the names of file nodes as strings. It is inherited from node.name. For instance, to query file nodes with specific names:
    or to fetch all file nodes that start with ‘A’:
  • selected: This is a Boolean attribute (true or false) for determining whether a file node is selected. You can query selected or unselected file nodes with:
    or:
  • selectionFlag: The selectionFlag attribute (short name: sf) is another Boolean property to identify and work with file nodes marked with specific selection flags:
    or to exclude flagged files:

Why Should You Use File Attributes?

For molecular modelers managing complex systems, file attributes bring order to the chaos. They allow you to precisely query and manipulate file nodes based on specific properties. Whether you are identifying critical datasets, organizing structures, or applying targeted operations, these attributes become valuable tools for refining and accelerating your tasks.

Quick Example

Suppose you are working on a modeling project involving multiple protein files, and you want to quickly isolate files with a specific name like “Ligand_A”. You can achieve that by simply running the NSL query:

This will return all file nodes with that name, saving you from manually sorting through the dataset.

Similarly, to focus on files you already pre-selected, you would use:

Efficient usage of these attributes can minimize manual overhead and enhance productivity!

Learn More

For a deeper dive into all available file attributes and their use cases, please visit the official documentation page.

*Note: SAMSON and all SAMSON Extensions are free for non-commercial use. You can get SAMSON at https://www.samson-connect.net.

Comments are closed.