rmgpy.molecule.Bond

class rmgpy.molecule.Bond

A chemical bond. The attributes are:

Attribute

Type

Description

order

float

The bond type

atom1

Atom

An Atom object connecting to the bond

atom2

Atom

An Atom object connecting to the bond

apply_action(action)

Update the bond as a result of applying action, a tuple containing the name of the reaction recipe action along with any required parameters. The available actions can be found here.

copy()

Generate a deep copy of the current bond. Modifying the attributes of the copy will not affect the original.

decrement_order()

Update the bond as a result of applying a CHANGE_BOND action to decrease the order by one.

equivalent(other)

Return True if other is indistinguishable from this bond, or False otherwise. other can be either a Bond or a GroupBond object.

get_bde()

estimate the bond dissociation energy in J/mol of the bond based on the order of the bond and the atoms involved in the bond

get_bond_string()

Represent the bond object as a string (eg. ‘C#N’). The returned string is independent of the atom ordering, with the atom labels in alphabetical order (i.e. ‘C-H’ is possible but not ‘H-C’) :return: str

get_order_num()

returns the bond order as a number

get_order_str()

returns a string representing the bond order

get_other_vertex(vertex)

Given a vertex that makes up part of the edge, return the other vertex. Raise a ValueError if the given vertex is not part of the edge.

increment_order()

Update the bond as a result of applying a CHANGE_BOND action to increase the order by one.

is_benzene()

Return True if the bond represents a benzene bond or False if not.

is_double()

Return True if the bond represents a double bond or False if not.

is_double_or_triple()

Return True if the bond represents a double or triple bond or False if not.

is_hydrogen_bond()

Return True if the bond represents a hydrogen bond or False if not.

is_order(other_order)

Return True if the bond is of order other_order or False if not. This compares floats that takes into account floating point error

NOTE: we can replace the absolute value relation with math.isclose when we swtich to python 3.5+

is_quadruple()

Return True if the bond represents a quadruple bond or False if not.

is_reaction_bond()

Return True if the bond represents a reaction bond or False if not.

is_single()

Return True if the bond represents a single bond or False if not.

is_specific_case_of(other)

Return True if self is a specific case of other, or False otherwise. other can be either a Bond or a GroupBond object.

is_triple()

Return True if the bond represents a triple bond or False if not.

is_van_der_waals()

Return True if the bond represents a van der Waals bond or False if not.

set_order_num(new_order)

change the bond order with a number

set_order_str(new_order)

set the bond order using a valid bond-order character

sorting_key

Returns a sorting key for comparing Bond objects. Read-only

Bond types

The bond type simply indicates the order of a chemical bond. We define the following bond types:

Bond type

Description

S

a single bond

D

a double bond

T

a triple bond

B

a benzene bond