Attributes#

MolSysMT attributes describe non-exclusive layers of a molecular system. Stable topological attributes identify atoms and semantic hierarchy. Structural attributes describe geometry and trajectories. atom_index and n_atoms belong to both layers: they define the stable atom inventory and the atom axis shared by structural arrays. Mechanical attributes contain force-field data. Chemical-state attributes describe chemistry that may differ between states, including bonds, formal charge, aromaticity, radicals, implicit hydrogens, stereochemistry, and covalent components.

A molecular form does not need to contain every attribute. Use molsysmt.basic.has_attribute() to distinguish information stored in a particular object from information supported by its form. By default it reports instance presence, so an optional temperature, occupancy, component label, or chemical-state ID that is absent returns False; include_none=True asks only whether the form supports the attribute. For MolSys, this check composes its topology, structures, and molecular-mechanics form contracts rather than adding methods to the native component classes. Native objects resolve chemical-state attributes through chemical_state='reference', chemical_state='structure', or an explicit 0-based state index. The explicit index is execution-local: it does not mutate the stored reference. The 'structure' resolver uses the nullable structure_chemical_state_index association owned by MolSys and requires the selected structures to share one known state. State IDs are labels and are not selectors because duplicates are valid.

Attributes you can get#

The following table shows the list of attribute arguments you can use in molsysmt.basic.get(), together with their meaning and the list of elements they can be used with.

PropertyCategoryElements
allows_implicit_hydrogensChemical Stateatom
alternate_locationStructuralatom, system
atom_ff_typeMechanicalatom, system
atom_idTopologicalatom, group, component, molecule, chain, entity
atom_indexTopological, Structuralatom, group, component, molecule, chain, entity
atom_is_aromaticChemical Stateatom
atom_nameTopologicalatom, group, component, molecule, chain, entity
atom_stereochemistryChemical Stateatom
atom_typeTopologicalatom, group, component, molecule, chain, entity
b_factorStructuralatom, system
bioassemblyStructuralsystem
bond_acceptor_atom_indexChemical Statebond
bond_donor_atom_indexChemical Statebond
bond_evidenceChemical Statebond
bond_idTopological, Chemical Statebond
bond_indexTopological, Chemical Stateatom, bond, system
bond_is_aromaticChemical Statebond
bond_is_conjugatedChemical Statebond
bond_joins_componentsChemical Statebond
bond_orderTopological, Chemical Statebond
bond_stereo_atom_indicesChemical Statebond
bond_stereochemistryChemical Statebond
bond_typeTopological, Chemical Statebond
bonded_atom_pairsTopologicalatom, bond, system
bonded_atomsTopologicalatom, bond, system
boxStructuralsystem
box_anglesStructuralsystem
box_lengthsStructuralsystem
box_shapeStructuralsystem
box_volumeStructuralsystem
chain_idTopologicalatom, group, component, molecule, chain, entity
chain_indexTopologicalatom, group, component, molecule, chain, entity
chain_nameTopologicalatom, group, component, molecule, chain, entity
chain_typeTopologicalatom, group, component, molecule, chain, entity
chemical_state_idChemical Statesystem
chemical_state_indexChemical Statesystem
component_completenessChemical Statesystem
component_evidenceChemical Statesystem
component_idTopological, Chemical Stateatom, group, component, molecule, chain, entity
component_indexTopological, Chemical Stateatom, group, component, molecule, chain, entity
component_nameTopological, Chemical Stateatom, group, component, molecule, chain, entity
component_typeTopological, Chemical Stateatom, group, component, molecule, chain, entity
connectivity_completenessChemical Statesystem
constraintsMechanicalsystem
coordinatesStructuralatom, system
cutoff_distanceMechanicalsystem
dispersion_correctionMechanicalsystem
entity_idTopologicalatom, group, component, molecule, chain, entity
entity_indexTopologicalatom, group, component, molecule, chain, entity
entity_nameTopologicalatom, group, component, molecule, chain, entity
entity_typeTopologicalatom, group, component, molecule, chain, entity
ewald_error_toleranceMechanicalsystem
flexible_constraintsMechanicalsystem
forcefieldMechanicalsystem
formal_chargeChemical Stateatom, system
fractional_bond_orderChemical Statebond
frictionGeneralsystem
group_idTopologicalatom, group, component, molecule, chain, entity
group_indexTopologicalatom, group, component, molecule, chain, entity
group_nameTopologicalatom, group, component, molecule, chain, entity
group_typeTopologicalatom, group, component, molecule, chain, entity
hydrogen_massMechanicalsystem
implicit_solventMechanicalsystem
inner_bond_indexTopologicalatom, system
inner_bonded_atom_pairsTopologicalatom, system
inner_bonded_atomsTopologicalatom, system
integratorGeneralsystem
isotopeTopologicalatom
kappaMechanicalsystem
kinetic_energyStructuralsystem
molecule_idTopologicalatom, group, component, molecule, chain, entity
molecule_indexTopologicalatom, group, component, molecule, chain, entity
molecule_nameTopologicalatom, group, component, molecule, chain, entity
molecule_typeTopologicalatom, group, component, molecule, chain, entity
n_amino_acidsTopologicalatom, group, component, molecule, chain, entity, system
n_atomsTopological, Structuralatom, group, component, molecule, chain, entity, system
n_bioassembliesStructuralsystem
n_bondsTopologicalatom, group, component, molecule, chain, entity, system
n_chainsTopologicalatom, group, component, molecule, chain, entity, system
n_chemical_statesChemical Statesystem
n_componentsTopologicalatom, group, component, molecule, chain, entity, system
n_dnasTopologicalatom, group, component, molecule, chain, entity, system
n_entitiesTopologicalatom, group, component, molecule, chain, entity, system
n_groupsTopologicalatom, group, component, molecule, chain, entity, system
n_implicit_hydrogensChemical Stateatom
n_inner_bondsTopologicalatom, group, component, molecule, chain, entity, system
n_ionsTopologicalatom, group, component, molecule, chain, entity, system
n_lipidsTopologicalatom, group, component, molecule, chain, entity, system
n_moleculesTopologicalatom, group, component, molecule, chain, entity, system
n_nucleotidesTopologicalatom, group, component, molecule, chain, entity, system
n_peptidesTopologicalatom, group, component, molecule, chain, entity, system
n_polysaccharidesTopologicalatom, group, component, molecule, chain, entity, system
n_proteinsTopologicalatom, group, component, molecule, chain, entity, system
n_rnasTopologicalatom, group, component, molecule, chain, entity, system
n_saccharidesTopologicalatom, group, component, molecule, chain, entity, system
n_small_moleculesTopologicalatom, group, component, molecule, chain, entity, system
n_structuresStructuralsystem
n_unpaired_electronsChemical Stateatom
n_watersTopologicalatom, group, component, molecule, chain, entity, system
non_bonded_methodMechanicalsystem
occupancyStructuralatom
partial_chargeMechanicalatom, system
potential_energyStructuralsystem
reference_chemical_state_indexChemical Statesystem
rigid_waterMechanicalsystem
salt_concentrationMechanicalsystem
solute_dielectricMechanicalsystem
solvent_dielectricMechanicalsystem
structure_chemical_state_indexStructural, Chemical Statesystem
structure_idStructuralsystem
structure_indexStructural
switch_distanceMechanicalsystem
temperatureStructuralsystem
timeStructuralsystem
time_stepGeneralsystem
total_energyStructuralsystem
velocitiesStructuralatom, system
water_modelMechanicalsystem