Skip to contents

Applies region masks to a trial and computes summary parameters independently for each region. Returns one row per region.

Usage

pr_calc_regional(
  trial,
  masks = NULL,
  parameters = c("mpp", "mvp", "max_force", "contact_area", "pti_mean"),
  threshold = 0
)

Arguments

trial

A pr_trial object.

masks

Named list of pr_mask objects or logical matrices. If NULL (default), uses the layout's default regions.

parameters

Character vector. Parameters to compute. Supported values: "mpp", "mvp", "max_force", "mean_force", "contact_area", "pti_max", "pti_mean". Default c("mpp", "mvp", "max_force", "contact_area", "pti_mean").

threshold

Numeric. Default 0.

Value

A tibble::tibble with one column region plus one column per requested parameter.

Examples

trial <- pr_example_trial("saddle_horse")
pr_calc_regional(trial)
#> # A tibble: 6 × 6
#>   region          mpp   mvp max_force contact_area pti_mean
#>   <chr>         <dbl> <dbl>     <dbl>        <dbl>    <dbl>
#> 1 cranial_left   18.2  2.41     105.           320     17.7
#> 2 cranial_right  16.5  2.13      94.5          320     15.4
#> 3 middle_left    11.9  1.57      91.4          440     11.5
#> 4 middle_right   10.5  1.41      78.3          420     10.1
#> 5 caudal_left    18.3  2.27     106.           350     16.1
#> 6 caudal_right   15.4  2.00      91.5          360     14.1