msmbuilder.tpt.fraction_visited¶
-
msmbuilder.tpt.
fraction_visited
(source, sink, waypoint, msm)¶ Calculate the fraction of times a walker on tprob going from sources to sinks will travel through the set of states waypoints en route.
Computes the conditional committors q^{ABC^+} and uses them to find the fraction of paths mentioned above.
- Note that in the notation of Dickson et. al. this computes h_c(A,B), with
- sources = A sinks = B waypoint = C
Parameters: - source : int
The index of the source state
- sink : int
The index of the sink state
- waypoint : int
The index of the intermediate state
- msm : msmbuilder.MarkovStateModel
MSM to analyze.
Returns: - fraction_visited : float
The fraction of times a walker going from sources -> sinks stops by waypoints on its way.
See also
msmbuilder.tpt.conditional_committors
- Calculate the probability of visiting a waypoint while on a path between a source and sink.
msmbuilder.tpt.hub_scores
- function Compute the ‘hub score’, the weighted fraction of visits for an entire network.
References
[1] Dickson & Brooks (2012), J. Chem. Theory Comput., 8, 3044-3052.