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 isActinide(element: samson.Modeling.Element.Element.ElementType) → bool

Returns true if the element is actinide metal

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

Returns true if the element is alkali metal

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

Returns true if the element is alkaline earth metal

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

Returns true if the element is diatomic nonmetal

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

Returns true if the element is halogen

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

Returns true if the element is lanthanide metal

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

Returns true if the element is metal

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

Returns true if the element is metalloid

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

Returns true if the element is noble gas

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

Returns true if the element is polyatomic nonmetal

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

Returns true if the element is posttransition metal

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

Returns true if the element is reactive nonmetal

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

Returns true if the element is transition 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

property numberOfElements