Molecular modelers often need granular control over different molecular components during their work. One recurring pain is efficiently targeting and distinguishing chain-specific properties within complex molecular structures. The chain attribute space in SAMSON’s Node Specification Language (NSL) offers an elegant solution to this challenge. It allows users to filter, analyze, and precisely manipulate chain-related attributes. Below, we delve into the basics of chain attributes and how they can be utilized in SAMSON.
The Chain Attribute Space
The chain attribute space, abbreviated as c, is specifically designed for chain nodes. It encapsulates a variety of properties that can help streamline your analysis or editing tasks. These attributes can be inherited from broader node and structural group spaces, or they can be specific to chains.
General Chain Attributes
Here are some of the commonly inherited attributes and their short names:
hasMaterial(c.hm): Detects whether a chain possesses material properties.hidden(c.h): Determines whether the chain is hidden or not.name(c.n): Matches chains based on their names.selected: Indicates whether a chain is currently selected in the workspace.
For example, you can use c.n "A" to target chains named “A,” or filter with expressions like not c.h to identify chains that are not hidden.
Structural Group-Based Attributes
Chains inherit several numeric attributes from the structural group space that are highly useful for molecular modeling:
numberOfAtoms(c.nat): The total atom count in a chain. E.g.,c.nat > 100filters chains with more than 100 atoms.numberOfCarbons(c.nC): Counts carbon atoms in chains, with expressions such asc.nC 10:20.numberOfHydrogens(c.nH): Matches chains containing specific numbers of hydrogen atoms.partialCharge(c.pc): Filters chains based on their partial charges, such asc.pc > 1.5.
These attributes simplify the targeting of specific molecular properties, enabling users to focus on relevant chains in their studies.
Chain-Specific Attributes
Unique to the chain space, these attributes provide deeper insights into each chain:
chainID(c.id): Filters chains based on their ID. For example,c.id 2:4,6matches chains with IDs 2 to 4 and 6.numberOfResidues(c.nr): Targets chains with specific lengths (e.g., residue counts). Usec.nr 100:130to filter chains with residue counts between 100 and 130.numberOfSegments(c.ns): Matches chains with specific segment counts. For instance,c.ns < 3filters chains containing fewer than three segments.
These attributes allow for highly refined selections, ensuring modelers can hone in on the exact chains they wish to study or modify.
Bringing It All Together
Understanding and leveraging chain attributes in SAMSON simplifies molecular modeling workflows and enhances productivity. Whether you’re modeling complex biomolecules, analyzing atomic compositions, or preparing publications, the targeted precision offered by the chain space is invaluable. By integrating inherited and specific attributes, SAMSON provides remarkable versatility for filtering and visualizing molecular chains.
To explore the full potential of NSL and dive deeper into chain attributes, visit the dedicated documentation page.
SAMSON and all SAMSON Extensions are free for non-commercial use. You can download SAMSON here.
