eon.superbasinscheme#

Module Contents#

Classes#

SuperbasinScheme

This poorly-named class handles keeping track of which states belong to which superbasins, the SuperBasin object of those superbasins, and superbasining criteria. It also expands and merges superbasins

TransitionCounting

Implements the transition counting scheme for superbasin detection

EnergyLevel

RateThreshold

Implements a superbasin scheme where states are merged if the transition rate between them is faster than a specified threshold.

Data#

API#

eon.superbasinscheme.logger#

‘getLogger(…)’

class eon.superbasinscheme.SuperbasinScheme(superbasin_path, states, kT)[source]#

This poorly-named class handles keeping track of which states belong to which superbasins, the SuperBasin object of those superbasins, and superbasining criteria. It also expands and merges superbasins

Initialization

get_containing_superbasin(state)[source]#
make_basin_from_sets(start_state, end_state)[source]#
make_basin(merge_states)[source]#
abstract register_transition(start_state, end_state)[source]#
abstract write_data()[source]#
abstract read_data()[source]#
class eon.superbasinscheme.TransitionCounting(superbasin_path, states, kT, num_transitions)[source]#

Bases: eon.superbasinscheme.SuperbasinScheme

Implements the transition counting scheme for superbasin detection

Initialization

register_transition(start_state, end_state)[source]#
write_data()[source]#
read_data()[source]#
get_count(state)[source]#
class eon.superbasinscheme.EnergyLevel(superbasin_path, states, kT, energy_increment)[source]#

Bases: eon.superbasinscheme.SuperbasinScheme

get_energy_increment(e_min, e_global_min, e_saddle)[source]#
get_statelist(state)[source]#
register_transition(start_state, end_state)[source]#

Increments the energy level of the end state or sets it equal to the energy of the end_state if it hasn’t been visited before.

read_data()[source]#
write_data()[source]#
class eon.superbasinscheme.RateThreshold(superbasin_path, states, kT, rate_threshold)[source]#

Bases: eon.superbasinscheme.SuperbasinScheme

Implements a superbasin scheme where states are merged if the transition rate between them is faster than a specified threshold.

Initialization

Initializes the RateThreshold scheme.

Args: superbasin_path (str): The path to the superbasin directory. states (States): The global states object. kT (float): The thermal energy (k_B * T) in the appropriate units. rate_threshold (float): The rate (in 1/time) above which states will be merged into a superbasin.

register_transition(start_state, end_state)[source]#

Checks if the transition rate between start_state and end_state exceeds the defined threshold. If it does, it merges them.

write_data()[source]#

This scheme is stateless, so no data needs to be written. The creation of superbasins is handled by the base class and the Superbasin objects, which persist their own state.

read_data()[source]#

This scheme is stateless, so no data needs to be read on startup.