Demystifying Property Model Attributes for Molecular Modelers

Molecular modeling often requires precise definitions and manipulations of structural and functional properties to ensure accurate simulations or visualizations. For those diving into SAMSON’s Node Specification Language (NSL), the propertyModel attribute space offers a powerful way to define and explore these property-specific attributes. However, understanding how these attributes work and how to use them can seem overwhelming. Here, we’ll break down the utility of propertyModel attributes and what they bring to the table.

What Are Property Model Attributes?

Property model attributes belong to the propertyModel namespace in NSL. These attributes are specifically tied to property model nodes, making them especially useful when dealing with attributes like visibility, selection, material properties, and naming conventions in your molecular models.

The propertyModel attribute space is represented by its short name, pm. This allows concise expressions to query or manipulate molecule-related properties. Here’s an overview of some key attributes and how they help molecular modelers:

Attribute	Short Name	Values	Example Usage
`hasMaterial`	`hm`	`true`, `false`	`pm.hm`, `not pm.hm`
`hidden`	`h`	`true`, `false`	`pm.h`, `not pm.h`
`name`	`n`	String (in quotes)	`pm.n "A"`, `pm.n "L*"`
`ownsMaterial`	`om`	`true`, `false`	`pm.om`
`visible`	`v`	`true`, `false`	`pm.v`, `not pm.v`

How Do These Attributes Help You?

Let’s look at how you can leverage these attributes in your molecular modeling workflows:

Control visibility: The hidden or visible attributes enable you to hide or display certain nodes in your molecular simulation. This is particularly useful for simplifying complex views or focusing on specific aspects of your model.
Query materials: The hasMaterial and ownsMaterial attributes allow you to check if a node is associated with specific material information. This is critical for creating simulations where materials influence molecular behavior.
Fine-grained selection: Attributes such as selected or selectionFlag are useful for pinpointing specific elements in your model, enhancing precision during structural analysis.
Custom naming: By using the name attribute, you can tag specific nodes with meaningful identifiers, enabling better organization and easier retrieval of elements in larger models.

Examples for Everyday Applications

Here are a couple of practical examples you might find useful:

To ensure only visible nodes are manipulated: pm.v
To identify all property model nodes with a material: pm.hm
To focus on elements with a specific name pattern: pm.n "L*"

These straightforward but powerful queries make the propertyModel namespace indispensable when working on molecular designs in SAMSON.

Access the Full Documentation

The propertyModel attribute space offers many utilities for molecular modeling, especially in terms of properties, visibilities, and attributes management. To explore the complete list of attributes, their definitions, and advanced examples, visit the official documentation page.

SAMSON and all SAMSON Extensions are free for non-commercial use. Download SAMSON at samson-connect.net.