Structural Features

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

Table with structural features

Feature (dict key)

Name

Function

Description

Data Type

cell_mask_area

Cell area [µm²]

sarcasm.Structure.analyze_cell_mask()

Area occupied by cells in image. NOT the area of individual cells. np.ndarray with value for each frame.

ndarray

cell_mask_area_ratio

Cell area ratio

sarcasm.Structure.analyze_cell_mask()

Area ratio of total image occupied by cells. np.ndarray with value for each frame.

list[ndarray]

cell_mask_intensity

Cell mask intensity

sarcasm.Structure.analyze_cell_mask()

Average intensity at cell mask. np.ndarray with value for each frame.

list[ndarray]

domain_area

Domain area [µm²]

sarcasm.Structure.analyze_sarcomere_domains()

Areas of individual sarcomere domains in µm^2. List with np.array for each frame.

list[ndarray]

domain_area_mean

Mean domain area [µm²]

sarcasm.Structure.analyze_sarcomere_domains()

Mean domain area in µm^2. np.array with value for each frame.

ndarray

domain_area_std

STD domain area [µm²]

sarcasm.Structure.analyze_sarcomere_domains()

Standard deviation of domain area in µm^2. np.array with value for each frame.

ndarray

domain_mask

Sarcomere domain mask

sarcasm.Structure.analyze_sarcomere_domains()

Masks of sarcomere domains, pixel values reflects domain indices, 0 is background. Stored as list of sparse arrays. For conversion to np.ndarray, use mask.toarray().

list[coo_matrix]

domain_oop

Domain OOP

sarcasm.Structure.analyze_sarcomere_domains()

Sarcomere orientational order parameter (OOP) of individual sarcomere domains. List with np.array for each frame.

list[ndarray]

domain_oop_mean

Mean domain OOP

sarcasm.Structure.analyze_sarcomere_domains()

Mean sarcomere orientational order parameter (OOP) of all sarcomere domains in image. np.array with value for each frame.

ndarray

domain_oop_std

Standard deviation of domain out-of-plane

sarcasm.Structure.analyze_sarcomere_domains()

Standard deviation of sarcomere orientational order parameter (OOP) of all sarcomere domains in image. np.array with value for each frame.

ndarray

domain_orientation

Domain orientation [rad]

sarcasm.Structure.analyze_sarcomere_domains()

Sarcomere orientation in radians of individual sarcomere domains.

list[ndarray]

domain_slen

Domain sarcomere length [µm]

sarcasm.Structure.analyze_sarcomere_domains()

Mean sarcomere length within each sarcomere domain. List with np.array for each frame.

list[ndarray]

domains

Sarcomere domains

sarcasm.Structure.analyze_sarcomere_domains()

Set of sarcomere vectors of each sarcomere domain. List with list of np.arrays for each frame, storing the indices of sarcomere vectors for each domain.

list[list]

max_score_vectors

Max score sarcomere vectors

sarcasm.Structure.analyze_sarcomere_vectors()

Wavelet score of each sarcomere vector. List with np.array for each frame.

list[ndarray]

midline_id_vectors

Midline ID sarcomere vectors

sarcasm.Structure.analyze_sarcomere_vectors()

Midline identifier of each sarcomere vector. Value reflects midline label, with unique label for each sarcomere midline. List with np.array for each frame.

list[ndarray]

midline_length_vectors

Midline length vectors [µm]

sarcasm.Structure.analyze_sarcomere_vectors()

Length of repsective sarcomere midline of each sarcomere vector. List with np.array for each frame.

list[ndarray]

myof_length

Myofibril lengths [µm]

sarcasm.Structure.analyze_myofibrils()

Length of myofibril lines. List with np.array for each frame.

list[ndarray]

myof_length_max

Max. myofibril length [µm]

sarcasm.Structure.analyze_myofibrils()

Maximum length of myofibril lines in each frame. np.array with value for each frame.

ndarray

myof_length_mean

Mean myofibril length [µm]

sarcasm.Structure.analyze_myofibrils()

Mean length of myofibril lines in each frame. np.array with value for each frame.

ndarray

myof_length_std

STD myofibril length [µm]

sarcasm.Structure.analyze_myofibrils()

Standard deviation of length of myofibril lines in each frame. np.array with value for each frame.

ndarray

myof_lines

Myofibril lines

sarcasm.Structure.analyze_myofibrils()

Sarcomere vector IDs of myofibril lines. List with list of np.arrays for each frame.

list[list]

myof_bending

Myofibril bending

sarcasm.Structure.analyze_myofibrils()

Bending (mean squared curvature) of myofibril lines. List with np.array for each frame.

list[ndarray]

myof_bending_mean

Mean myofibril bending

sarcasm.Structure.analyze_myofibrils()

Mean of bending (mean squared curvature) of myofibril lines in each frame. np.array with value for each frame.

ndarray

myof_bending_std

STD myofibril bending

sarcasm.Structure.analyze_myofibrils()

Standard deviation of bending (mean squared curvature) of myofibril lines in each frame. np.array with value for each frame.

ndarray

myof_straightness

Myofibril straightness

sarcasm.Structure.analyze_myofibrils()

Frechet straightness (max. perpendicular distance to direct end-to-end line) of myofibril lines in each frame. List with np.ndarray for each frame.

list[list]

myof_straightness_mean

Mean myofibril straightness

sarcasm.Structure.analyze_myofibrils()

Mean of Frechet straightness (max. perpendicular distance to direct end-to-end line) of myofibril lines in each frame. np.ndarray with value for each frame.

ndarray

myof_straightness_std

STD myofibril straightness

sarcasm.Structure.analyze_myofibrils()

Standard deviation of Frechet straightness (max. perpendicular distance to direct end-to-end line) of myofibril lines in each frame. np.ndarray with value for each frame.

ndarray

n_domains

# Sarcomere domains

sarcasm.Structure.analyze_sarcomere_domains()

Number of sarcomere domains in each frame. np.array with value for each frame.

ndarray

n_mbands

# M-bands

sarcasm.Structure.analyze_sarcomere_vectors()

Number of estimated m-bands in each frame. np.array with value for each frame.

ndarray

n_vectors

# Sarcomere vectors

sarcasm.Structure.analyze_sarcomere_vectors()

Number of sarcomere vectors in each frame. np.array with value for each frame.

ndarray

n_zbands

# Z-bands

sarcasm.Structure.analyze_z_bands()

Number of Z-bands in each frame. np.array with value for each frame.

ndarray

pos_vectors

Sarcomere vector positions [px]

sarcasm.Structure.analyze_sarcomere_vectors()

Position of sarcomere vectors in each frame in pixels. List of np.ndarray for each frame

list[ndarray]

sarcomere_area

Sarcomere area [µm²]

sarcasm.Structure.analyze_sarcomere_vectors()

Area occupied by sarcomeres. np.ndarray with value for each frame.

ndarray

sarcomere_area_ratio

Sarcomere area ratio

sarcasm.Structure.analyze_sarcomere_vectors()

Ratio of image area occupied by sarcomeres. np.ndarray with value for each frame.

ndarray

sarcomere_length_mean

Mean sarcomere length [µm]

sarcasm.Structure.analyze_sarcomere_vectors()

Mean sarcomere length of sarcomere vectors in each frame. np.ndarray with value for each frame.

ndarray

sarcomere_length_vectors

Sarcomere length vectors [µm]

sarcasm.Structure.analyze_sarcomere_vectors()

Sarcomere length of sarcomere vectors in each frame. List of np.ndarray for each frame.

list[ndarray]

sarcomere_length_std

STD sarcomere length [µm]

sarcasm.Structure.analyze_sarcomere_vectors()

Standard deviation of sarcomere length of sarcomere vectors in each frame. np.ndarray with value for each frame.

ndarray

sarcomere_oop

Sarcomere OOP

sarcasm.Structure.analyze_sarcomere_vectors()

Sarcomere orientational order parameter (OOP) of all sarcomere vectors in frame. np.ndarray with value for each frame.

ndarray

sarcomere_orientation_mean

Mean sarcomere orientation [rad]

sarcasm.Structure.analyze_sarcomere_vectors()

Mean sarcomere orientation of all sarcomere vectors in each frame. np.ndarray with value for each frame.

ndarray

sarcomere_orientation_vectors

Sarcomere orientation vectors [rad]

sarcasm.Structure.analyze_sarcomere_vectors()

Sarcomere orientation of sarcomere vectors. List with np.ndarray for each frame.

list[ndarray]

sarcomere_orientation_std

STD sarcomere orientation [rad]

sarcasm.Structure.analyze_sarcomere_vectors()

Standard deviation of sarcomere orientation of all sarcomere vectors in each frame. np.ndarray with value for each frame.

ndarray

wavelet_bank

Wavelet bank

sarcasm.Structure.analyze_sarcomere_vectors()

Wavelet bank. Only stored if save_all=True.

ndarray

wavelet_max_score

Wavelet max score

sarcasm.Structure.analyze_sarcomere_vectors()

Spatial map of maximum wavelet score. Only stored if save_all=True.

ndarray

wavelet_sarcomere_length

Sarcomere length [µm]

sarcasm.Structure.analyze_sarcomere_vectors()

Spatial map of sarcomere length. Only stored if save_all=True.

ndarray

wavelet_sarcomere_orientation

Sarcomere orientation [rad]

sarcasm.Structure.analyze_sarcomere_vectors()

Spatial map of sarcomere orientation. Only stored if save_all=True.

ndarray

z_avg_intensity

Z-band intensity

sarcasm.Structure.analyze_z_bands()

Average intensity of Z-bands, i.e. average pixel values of all Z-bands. np.ndarray with value for each frame.

ndarray

z_ends

Z-band ends [px]

sarcasm.Structure.analyze_z_bands()

Position of Z-band ends in pixels.

list[ndarray]

z_intensity

Z-band intensity

sarcasm.Structure.analyze_z_bands()

Intensity of individual Z-band objects. List with np.ndarray for each frame.

list[ndarray]

z_intensity_mean

Mean Z-band intensity

sarcasm.Structure.analyze_z_bands()

Mean intensity of Z-band objects. np.ndarray with value for each frame.

ndarray

z_intensity_std

STD Z-band intensity

sarcasm.Structure.analyze_z_bands()

Standard devialtion of intensity of Z-band objects. np.ndarray with value for each frame.

ndarray

z_labels

Z-band labels

sarcasm.Structure.analyze_z_bands()

Z-band labels. Image with pixel values reflecting object labels. Stored as a sparse matrix, use labels.to_numpy() to convert to np.ndarray.

csr_matrix

z_lat_alignment

Z-band lateral alignment

sarcasm.Structure.analyze_z_bands()

Lateral alignment A of pairs of adjacent Z-bands. List with np.ndarray for each frame.

list[ndarray]

z_lat_alignment_groups

Z-band alignment lat. groups

sarcasm.Structure.analyze_z_bands()

Mean alignment of pairs of adjacent Z-bands in lateral groups. List with np.ndarray for each frame.

list[ndarray]

z_lat_alignment_groups_mean

Mean alignment in lateral Z-band groups

sarcasm.Structure.analyze_z_bands()

Frame-level average of mean alignment of pairs of Z-bands in lateral groups. np.ndarray with value for each frame.

ndarray

z_lat_alignment_groups_std

STD alignment in lateral Z-band groups

sarcasm.Structure.analyze_z_bands()

Frame-level standard deviation of mean alignment in lateral groups. np.ndarray with value for each frame.

ndarray

z_lat_alignment_mean

Mean Z-band lateral alignment

sarcasm.Structure.analyze_z_bands()

Mean lateral alignment of adjacent Z-bands. np.ndarray with value for each frame.

ndarray

z_lat_alignment_std

STD Z-band lateral alignment

sarcasm.Structure.analyze_z_bands()

Standard deviation of lateral alignment of adjacent Z-bands. np.ndarray with value for each frame.

ndarray

z_lat_dist

Z-band lateral distances [µm]

sarcasm.Structure.analyze_z_bands()

Distance of pairs of laterally adjacent Z-bands. List with np.ndarray for each frame.

list[ndarray]

z_lat_dist_mean

Mean Z-band lateral distance

sarcasm.Structure.analyze_z_bands()

Mean lateral distance of pairs of laterally adjacent Z-bands. np.ndarray with value for each frame.

ndarray

z_lat_dist_std

STD Z-band lateral distance

sarcasm.Structure.analyze_z_bands()

Standard deviation of lateral distance of pairs of laterally adjacent Z-bands. np.ndarray with value for each frame.

ndarray

z_lat_groups

Z-band lateral groups

sarcasm.Structure.analyze_z_bands()

Groups of laterally aligned Z-band objects. List with lists of Z-band indices for each frame.

list[list]

z_lat_length_groups

Lengths lat. Z-band groups [µm]

sarcasm.Structure.analyze_z_bands()

Lengths of groups of laterally aligned Z-bands. List with np.ndarray for each frame.

list[ndarray]

z_lat_length_groups_mean

Mean length lat. Z-band groups [µm]

sarcasm.Structure.analyze_z_bands()

Mean length of groups of laterally aligned Z-bands. np.ndarray with value for each frame.

ndarray

z_lat_length_groups_std

STD length lat. Z-band groups [µm]

sarcasm.Structure.analyze_z_bands()

Standard deviation of lengths of groups of laterally aligned Z-bands. np.ndarray with value for each frame.

ndarray

z_lat_links

Z-band lateral links

sarcasm.Structure.analyze_z_bands()

Links between laterally aligned Z-band ends. List with np.ndarray for each frame.

list[ndarray]

z_lat_neighbors

Z-band lateral neighbors [#]

sarcasm.Structure.analyze_z_bands()

Number of lateral neighbors of each Z-band object (0, 1 or 2). List with np.ndarray for each frame.

list[ndarray]

z_lat_neighbors_mean

Mean Z-band lateral neighbors [#]

sarcasm.Structure.analyze_z_bands()

Mean number of lateral neighbors of each Z-band object for each frame. np.ndarray with value for each frame.

ndarray

z_lat_neighbors_std

STD Z-band lateral neighbors [#]

sarcasm.Structure.analyze_z_bands()

Standard deviation of number of lateral neighbors of each Z-band object for each frame. np.ndarray with value for each frame.

ndarray

z_lat_size_groups

Size of laterally aligned Z-band groups [#]

sarcasm.Structure.analyze_z_bands()

Size of groups of laterally aligned Z-band objects. List with np.ndarray for each frame.

list[ndarray]

z_lat_size_groups_mean

Mean size groups lat. aligned Z-band [#]

sarcasm.Structure.analyze_z_bands()

Mean size of groups of laterally aligned Z-band objects. np.ndarray with value for each frame.

ndarray

z_lat_size_groups_std

STD size lat. aligned Z-band [#]

sarcasm.Structure.analyze_z_bands()

Standard deviation of size of groups of laterally aligned Z-band objects. np.ndarray with value for each frame.

ndarray

z_length

Z-band length [µm]

sarcasm.Structure.analyze_z_bands()

Length of Z-band objects. List with np.ndarray of each frame.

list[ndarray]

z_length_max

Max Z length [µm]

sarcasm.Structure.analyze_z_bands()

here description

ndarray

z_length_mean

Mean Z-band length [µm]

sarcasm.Structure.analyze_z_bands()

Mean Z-band length in each frame. np.ndarray with value for each frame.

ndarray

z_length_std

STD Z-band length [µm]

sarcasm.Structure.analyze_z_bands()

Standard deviation of Z-band lengths in each frame. np.ndarray with value for each frame.

ndarray

z_oop

Z-band OOP

sarcasm.Structure.analyze_z_bands()

Z-band orientation order parameter. np.ndarray with value for each frame.

ndarray

z_orientation

Z-band orientation [rad]

sarcasm.Structure.analyze_z_bands()

Orientation of individual Z-band objects. List with np.ndarray for each frame.

list[ndarray]

z_mask_area

Z-band mask area

sarcasm.Structure.analyze_z_bands()

Total area occupied by Z-bands in each frame. np.ndarray with value for each frame.

ndarray

z_mask_area_ratio

Z-band mask area ratio

sarcasm.Structure.analyze_z_bands()

Ratio of area occupied by Z-bands to total cell area.np.ndarray with value for each frame.

ndarray

z_mask_intensity

Z-band mask intensity

sarcasm.Structure.analyze_z_bands()

Average intensity of Z-band mask.np.ndarray with value for each frame.

ndarray

z_straightness

Z-band straightness

sarcasm.Structure.analyze_z_bands()

Straightness of Z-band objects, measured by ratio of end-to-end length to contour length. List with np.ndarray of each frame.

list[ndarray]

z_straightness_mean

Mean Z-band straightness

sarcasm.Structure.analyze_z_bands()

Mean Z-band straightness for each frame. np.array with value for each frame.

ndarray

z_straightness_std

STD Z-band straightness

sarcasm.Structure.analyze_z_bands()

Standard deviation of Z-band straightness for each frame. np.array with value for each frame.

ndarray