Molecular modeling often requires precise filtering and organization of molecules for tasks such as simulation, visualization, and property analysis. If you’ve ever wondered how to efficiently categorize or interact with molecules based on specific characteristics, SAMSON’s Node Specification Language (NSL) can streamline your workflow through flexible molecule attributes.
Why Molecule Attributes Matter
In molecular modeling, distinguishing between molecules based on attributes such as visibility, atom count, or chain count can be a critical step. With the NSL in SAMSON, you can leverage a well-defined set of molecule attributes to target specific molecules or groups effectively. Whether you need to focus on carbon-rich molecules or filter out hidden molecules, understanding these attributes will allow you to customize your selection criteria easily.
Getting Started: Molecule Attributes in NSL
The molecule attribute space in NSL comes with various inherited and specific attributes. Here are a few to get you started:
- Inherited from Node Attribute Space:
- hasMaterial (short name: hm): Indicates whether a molecule has material. Possible values:
true,false. - hidden (short name: h): Indicates visibility. Example: To filter visible molecules, you can use
not mol.h. - name (short name: n): Targets molecules by name. Example:
mol.n "L*"matches molecules whose names start with ‘L’.
- hasMaterial (short name: hm): Indicates whether a molecule has material. Possible values:
- Inherited from Structural Group Attribute Space:
- numberOfAtoms (short name: nat): Identifies molecules based on the number of atoms. Examples:
mol.nat < 1000. - formalCharge (short name: fc): Filters based on integer charge values. Example:
mol.fc > 1.
- numberOfAtoms (short name: nat): Identifies molecules based on the number of atoms. Examples:
- Specific to Molecule Attribute Space:
- numberOfChains (short name: nc): Useful for segmenting molecules by chain count. Example:
mol.nc 2:4matches molecules with chains between 2 and 4. - numberOfResidues (short name: nr): Targets specific residue counts. Example:
mol.nr > 130matches molecules with more than 130 residues.
- numberOfChains (short name: nc): Useful for segmenting molecules by chain count. Example:
Examples of Molecule Attribute Usage
Here are a few real-world scenarios where you can harness the power of molecule attributes:
- Filter Hidden Molecules: To exclude molecules marked as hidden, you can use the expression
not mol.h. This allows you to focus only on visible entities in the modeling environment. - Select Large Molecules: If you’re working on macromolecules with a high number of atoms, you can quickly isolate them using
mol.nat > 500or any range likemol.nat 500:1000. - Target Specific Chains: For protein or polymer analysis, isolating molecules with a specific number of chains can save immense time. Example:
mol.nc < 3.
How to Apply this Knowledge
These attributes help you craft efficient queries tailored to your research objectives. SAMSON’s NSL provides this structured framework so you can bring precision to molecular selection and avoid time-consuming manual sorting. Whether you’re scripting complex systems or manually selecting molecules, understanding these attribute spaces empowers you to work faster and more accurately.
You can explore the full details of molecule attributes in the SAMSON documentation for further guidance and examples. View the full documentation here.
SAMSON and all SAMSON Extensions are free for non-commercial use. You can download SAMSON and start modeling today at SAMSON Connect.