ElementTable¶

This class is used to describe the periodic table in SAMSON.

Typically, this class is used when accessing properties of periodic table elements:

from samson.Modeling.Element import Element, ElementTable

# print the covalent radius of the provided element type
ElementTable.getCovalentRadius(Element.Carbon)

Note that convenience functions exist in samson.Modeling.StructuralModel.Atom to access the properties of their element:

atom.getCovalentRadius();

See also

SAMSON API: sbmelementtable

class samson.Modeling.Element.ElementTable¶

Bases: pybind11_builtins.pybind11_object

This class is used to describe the periodic table.

static getAtomicWeight(element: samson.Modeling.Element.Element.ElementType) → samson.DataModel.Quantity.unitsSI¶

Returns the atomic weight of periodic table element

static getBlock(element: samson.Modeling.Element.Element.ElementType) → str¶

Returns the block of periodic table element

static getCovalentRadius(element: samson.Modeling.Element.Element.ElementType) → samson.DataModel.Quantity.unitsSI¶

Returns the covalent radius of periodic table element

static getElectronegativity(element: samson.Modeling.Element.Element.ElementType) → samson.DataModel.Quantity.unitsSI¶

Returns the electronegativity of periodic table element

static getElement(element: samson.Modeling.Element.Element.ElementType) → samson.Modeling.Element.Element¶

Returns a reference to periodic table element

static getElementName(element: samson.Modeling.Element.Element.ElementType) → str¶

Returns the name of periodic table element

static getElementSymbol(element: samson.Modeling.Element.Element.ElementType) → str¶

Returns the symbol of periodic table element

static getElementTypeByName(elementName: str) → samson.Modeling.Element.Element.ElementType¶

Returns the periodic table element type corresponding to a given name

static getElementTypeBySymbol(elementSymbol: str) → samson.Modeling.Element.Element.ElementType¶

Returns the periodic table element type corresponding to a given symbol

static getGroup(element: samson.Modeling.Element.Element.ElementType) → int¶

Returns the group of periodic table element

static getPeriod(element: samson.Modeling.Element.Element.ElementType) → str¶

Returns the period of periodic table element

static getVanDerWaalsRadius(element: samson.Modeling.Element.Element.ElementType) → samson.DataModel.Quantity.unitsSI¶

Returns the van der Waals radius of periodic table element

static hasOxidationState(element: samson.Modeling.Element.Element.ElementType, value: int) → bool¶

Returns true if the element has known oxidation state with the given integer value

static isMetal(element: samson.Modeling.Element.Element.ElementType) → bool¶

Returns true if the element is metal

static metalSubcategory(element: samson.Modeling.Element.Element.ElementType) → samson.Modeling.Element.Element.MetalSubcategory¶

Returns the element’s subcategory type in the metal–metalloid–nonmetal trend

static metalSubcategoryString(element: samson.Modeling.Element.Element.ElementType) → str¶

Returns the string representation of the element’s subcategory type in the metal–metalloid–nonmetal trend

numberOfElements¶