msmbuilder.tpt.mfpts¶

msmbuilder.tpt.mfpts(msm, sinks=None, lag_time=1.0)¶

Gets the Mean First Passage Time (MFPT) for all states to a set of sinks.

Parameters:	msm (msmbuilder.MarkovStateModel) – MSM fit to the data. sinks (array_like, int, optional) – Indices of the sink states. There are two use-cases: None [default] : All MFPTs will be calculated, and the result is a matrix of the MFPT from state i to state j. This uses the fundamental matrix formalism. list of ints or int : Only the MFPTs into these sink states will be computed. The result is a vector, with entry i corresponding to the average time it takes to first get to any sink state from state i lag_time (float, optional) – Lag time for the model. The MFPT will be reported in whatever units are given here. Default is (1) which is in units of the lag time of the MSM.
Returns:	mfpts – MFPT in time units of lag_time, which depends on the input value of sinks: If sinks is None, then mfpts’s shape is (n_states, n_states). Where mfpts[i, j] is the mean first passage time to state j from state i. If sinks contains one or more states, then mfpts’s shape is (n_states,). Where mfpts[i] is the mean first passage time from state i to any state in sinks.
Return type:	np.ndarray, float

References

[1]	Grinstead, C. M. and Snell, J. L. Introduction to Probability. American Mathematical Soc., 1998.

As of November 2014, this chapter was available for free online:

http://www.dartmouth.edu/~chance/teaching_aids/books_articles/probability_book/Chapter11.pdf