TPS Use-of-Force rate + type distribution

Compact callable mirroring morie.fn.tpsuof.tps_use_of_force. Computes a use-of-force rate over a known encounter denominator and returns a per-type count distribution, packaged as a rich-result list compatible with the morie_mrm_uof_result family in R/mrm_uof.R.

Usage

morie_tps_use_of_force(force_types, n_encounters)

morie_tpsuof(force_types, n_encounters)

Arguments

force_types

Character vector of use-of-force-type labels (one row per use-of-force incident).

n_encounters

Positive integer total number of police-public encounters in the denominator.

Value

A named list with classes morie_tps_use_of_force_result, morie_mrm_uof_result, morie_rich_result, list. Slots: rate, n, population, type_counts, n_types, interpretation.

Details

Formula

• rate = length(force_types) / n_encounters

• type_counts = table(force_types)

Examples

force_types <- c("Physical Control", "Physical Control", "CEW",
                 "Firearm", "OC Spray")
morie_tps_use_of_force(force_types, n_encounters = 1000L)
#> TPS use-of-force rate + type distribution
#> =========================================
#> Call: morie_tps_use_of_force(<5 force_types>, n_encounters=1000) 
#> 
#>   Use-of-force incidents    5
#>   Encounters (denominator)  1000
#>   Rate per encounter        0.005
#>   Distinct force types      4
#>   Most common type          Physical Control
#> 
#> Across 1000 encounter(s), 5 use-of-force incident(s) were recorded (0.005 use-of-force incident(s) per encounter (0.50 per 100 encounters)) spanning 4 distinct force-type categories.