msmbuilder.tpt.conditional_committors

msmbuilder.tpt.conditional_committors(source, sink, waypoint, msm)

Computes the conditional committors \(q^{ABC^+}\) which are is the probability of starting in one state and visiting state B before A while also visiting state C at some point.

Note that in the notation of Dickson et. al. this computes \(h_c(A,B)\), with sources = A, sinks = B, waypoint = C

Parameters:

waypoint : int

The index of the intermediate state

source : int

The index of the source state

sink : int

The index of the sink state

msm : msmbuilder.MarkovStateModel

MSM to analyze.

Returns:

cond_committors : np.ndarray

Conditional committors, i.e. the probability of visiting a waypoint when on a path between source and sink.

See also

msmbuilder.tpt.fraction_visited
function Calculate the fraction of visits to a waypoint from a given source to a sink.
msmbuilder.tpt.hub_scores
function Compute the ‘hub score’, the weighted fraction of visits for an entire network.

Notes

Employs dense linear algebra, memory use scales as N^2, and cycle use scales as N^3

References

[R60]Dickson & Brooks (2012), J. Chem. Theory Comput., 8, 3044-3052.