Motion Features

The following table describes the motion features analyzed by SarcAsM, stored in dictionary motion_obj.loi_data:

Table with structural features
Feature (dict key)	Name	Function	Description	Data Type
contr_max	Contr. \(\Delta SL_-\) [µm]	`sarcasm.Motion.analyze_trajectories()`	Maximal contraction/shortening of each individual sarcomeres in each contraction cycle. Array with shape (n_sarcomeres, n_contractions).	ndarray
contr_max_avg	Avg. Contr. \(\overline{\Delta SL}_-\) [µm]	`sarcasm.Motion.analyze_trajectories()`	Maximal contraction/shortening of sarcomere average in LOI. Array with shape (c_contractions)	ndarray
elong_max	Elong. \(\Delta SL_+\) [µm]	`sarcasm.Motion.analyze_trajectories()`	Maximal elongation of each individual sarcomeres in each contraction cycle. Array with shape (n_sarcomeres, n_contractions).	ndarray
elong_max_avg	Avg. Elong. \(\overline{\Delta SL}_+\) [µm]	`sarcasm.Motion.analyze_trajectories()`	Maximal elongation of sarcomere average in LOI. Array with shape (c_contractions)	ndarray
vel_contr_max	Vel. Contr. \(V_-\) [µm/s]	`sarcasm.Motion.analyze_trajectories()`	Maximal shortening velocity each individual sarcomeres in each contraction cycle. Array with shape (n_sarcomeres, n_contractions).	ndarray
vel_contr_max_avg	Avg. Vel. Contr. \(\overline{V}_-\) [µm/s]	`sarcasm.Motion.analyze_trajectories()`	Maximal shortening velocity of sarcomere average in LOI. Array with shape (n_contractions).	ndarray
vel_elong_max	Vel. Elong. \(V_+\) [µm/s]	`sarcasm.Motion.analyze_trajectories()`	Maximal elongation velocity of each individual sarcomeres in each contraction cycle. Array with shape (n_sarcomeres, n_contractions).	ndarray
vel_elong_max_avg	Avg. Vel. Elong. \(\overline{V}_+\) [µm/s]	`sarcasm.Motion.analyze_trajectories()`	Maximal elongation velocity of sarcomere average in LOI. Array with shape (n_contractions).	ndarray
equ	Rest. Length \(RL\) [µm]	`sarcasm.Motion.analyze_trajectories()`	Resting length of each individual sarcomere. Array with shape (n_sarcomeres).	ndarray
beating_rate	Beating Rate \(BR\) [Hz]	`sarcasm.Motion.detect_analyze_contractions()`	Beating rate of LOI.	float
beating_rate_variability	BR Variability \(BRV\) [s]	`sarcasm.Motion.detect_analyze_contractions()`	Beating rate variability. Standard deviation of time between contraction starts.	float
time_contr	Time Contr. \(T_C\) [s]	`sarcasm.Motion.analyze_trajectories()`	Duration of each individual contraction cycle.Array with shape (n_contractions).	ndarray
time_contr_avg	Avg. Time Contr. \(\overline{T}_C\) [s]	`sarcasm.Motion.analyze_trajectories()`	Average duration of contraction cycles.	float
time_quiet	Time quiet. \(T_Q\) [s]	`sarcasm.Motion.analyze_trajectories()`	Duration of each quiescent period between contraction cycles. Array with shape (n_contractions-1).	ndarray
time_quiet_avg	Time quiet. \(T_Q\) [s]	`sarcasm.Motion.analyze_trajectories()`	Average duration of quiescent periods between contraction cycles.	float
time_to_peak	Time to Peak \(T_P\) [s]	`sarcasm.Motion.analyze_trajectories()`	Time to maximal contraction of each individual sarcomere for each contraction cycle. Array with shape (n_sarcomeres, n_contractions).	ndarray
time_to_peak_avg	Avg. Time to Peak \(\overline{T}_P\) [s]	`sarcasm.Motion.analyze_trajectories()`	Time to maximal contraction of sarcomere average in LOI. Array with shape (n_contractions).	ndarray
time_to_relax	Time to Relax \(T_R\) [s]	`sarcasm.Motion.analyze_trajectories()`	Time from maximal to end of contraction of each individual sarcomere for each contraction cycle. Array with shape (n_sarcomeres, n_contractions).	ndarray
time_to_relax_avg	Avg. Time to Relax \(\overline{T}_R\) [s]	`sarcasm.Motion.analyze_trajectories()`	Time from maximal to end of contraction of sarcomere average in LOI. Array with shape (n_contractions).	ndarray
popping_events	Popping Events	`sarcasm.Motion.analyze_popping()`	Sarcomere popping events, extensions of sarcomeres far beyond resting length (e.g. 0.25 µm). Binary array with shape (n_sarcomeres, n_contractions) with 0 for no popping and 1 for popping.	ndarray
popping_rate	Popping Rate \(P\)	`sarcasm.Motion.analyze_popping()`	Average popping rate in LOI.	float
popping_rate_sarcomeres	Sarcomere Popping Rate \(P_s\)	`sarcasm.Motion.analyze_popping()`	Popping rate of each individual sarcomere.	ndarray
popping_rate_contr	Contraction Popping Rate \(P_c\)	`sarcasm.Motion.analyze_popping()`	Popping rate at each contraction cycle.	ndarray
ratio_delta_slen_mutual_serial	Ratio Mutual Serial \(R_{\Delta SL}\)	`sarcasm.Motion.analyze_sarcomere_correlations()`	Ratio of mutual to serial correlation for sarcomere length changes.	float
ratio_vel_mutual_serial	Ratio Mutual Serial \(R_{V}\)	`sarcasm.Motion.analyze_sarcomere_correlations()`	Ratio of mutual to serial correlation for sarcomere velocities.	float
corr_delta_slen_serial	Serial Corr. \(\Delta SL\)	`sarcasm.Motion.analyze_sarcomere_correlations()`	Average serial correlation for sarcomere length changes.	float
corr_delta_slen_mutual	Mutual Corr. \(\Delta SL\)	`sarcasm.Motion.analyze_sarcomere_correlations()`	Average mutual correlation for sarcomere length changes.	float
corr_vel_serial	Serial Corr. \(V\)	`sarcasm.Motion.analyze_sarcomere_correlations()`	Average serial correlation for sarcomere velocities.	float
corr_vel_mutual	Mutual Corr. \(V\)	`sarcasm.Motion.analyze_sarcomere_correlations()`	Average mutual correlation for sarcomere velocities.	float
corr_delta_slen	Corr. \(\Delta SL\)	`sarcasm.Motion.analyze_sarcomere_correlations()`	Correlation matrix for sarcomere length changes.	ndarray
corr_vel	Corr. \(V\)	`sarcasm.Motion.analyze_sarcomere_correlations()`	Correlation matrix for sarcomere velocities.	ndarray