For molecular modelers working with SAMSON’s powerful integrative molecular design platform, efficiently leveraging property models can be a significant time-saver and improve your workflows. Understanding how to utilize propertyModel attributes in Node Specification Language (NSL) is key to controlling and customizing property model nodes. Here’s how you can use them, with examples to get you going.
What Are Property Model Attributes?
Property model attributes belong to the propertyModel attribute space, which has the short name pm. These attributes provide straightforward ways to filter or select nodes with specific properties you are looking for in your molecular models. They are designed to match only property model nodes, making them a focused and effective tool within SAMSON’s framework.
By using these attributes, you can craft expressions that specifically target nodes with the desired properties like visibility, material ownership, or selection states. This level of control can drastically simplify navigation and adjustments within complex models.
Key Attributes and How To Use Them
Below is a breakdown of the primary propertyModel attributes, their use cases, and examples.
- hasMaterial (
hm): Indicates whether the node has material. Possible values:true,false.
Example:
pm.hm(filters nodes that have a material). - hidden (
h): Helps manage the visibility of property model nodes. Possible values:true,false.
Example:
not pm.h(filters nodes that are not hidden). - name (
n): Targets property model nodes by their specific names. Use strings in quotes for specification.
Example:
pm.n "A"orpm.n "L*"(matches nodes with names starting with ‘L’). - ownsMaterial (
om): Identifies if the property model node owns a material. Possible values:true,false.
Example:
pm.om. - visibilityFlag (
vf): Helps to toggle the visibility state. Possible values:true,false.
Example:
pm.vf false(filters nodes with visibility flags turned off). - visible (
v): A direct attribute to check if nodes are visible. Possible values:true,false.
Example:
not pm.v(filters nodes that are not visible).
Why Use Property Model Attributes?
Molecular datasets and models can often become overwhelmingly complex with hundreds or thousands of interconnected nodes. Navigating through this data to find specific property models or applying changes quickly can lead to frustrations if not handled efficiently. By leveraging propertyModel attributes, you can:
- Save time through structured filtering of nodes based on properties.
- Increase accuracy in selecting and managing specific nodes.
- Simplify the process of analyzing, customizing, or visualizing molecular properties.
For example, if you need to target only nodes with specific material settings, using an expression like pm.hm can instantly match all such nodes without requiring manual inspection.
Explore More
To learn more about the full capabilities of property model attributes and how they integrate with SAMSON’s Node Specification Language, visit the official documentation page at: https://documentation.samson-connect.net/users/latest/nsl/propertyModel/.
SAMSON and all SAMSON Extensions are free for non-commercial use. Get SAMSON now at https://www.samson-connect.net.