Skip to contents

Calibrate an interaction bound from two methodological shifts

Usage

masmr_bound_difference(term, shift_a, shift_b, divisor = 1, ...)

Arguments

term

Name of the departure coefficient.

shift_a, shift_b

Finite increasing lower/upper ranges for the methodological shift in substantive conditions A and B, in original units.

divisor

Positive fixed conversion divisor, e.g. a justified reference SD. The bounds are (shift_b - shift_a) / divisor, using interval arithmetic.

...

Metadata passed to masmr_bounds(). Explain transportability and the conversion in justification. Inputs are endorsed ranges, not automatically converted confidence intervals. Conversion assumes one-unit binary contrasts.

Value

A bounds object retaining the calibration inputs and formula.

Examples

masmr_bound_difference(
  "S:M", shift_a = c(.2, .6), shift_b = c(.6, 1.2), divisor = 10,
  meaning = "Assessment-by-group interaction", units = "SMD",
  justification = "Illustrative bounds on a binary interaction",
  source = "Constructed example", status = "elicited",
  analysis_scale = "standardized_mean_difference"
)
#> $table
#>   term lower upper                         meaning units
#> 1  S:M     0   0.1 Assessment-by-group interaction   SMD
#>                                 justification              source   status
#> 1 Illustrative bounds on a binary interaction Constructed example elicited
#>                 analysis_scale
#> 1 standardized_mean_difference
#> 
#> $calibration
#> $calibration$shift_a
#> [1] 0.2 0.6
#> 
#> $calibration$shift_b
#> [1] 0.6 1.2
#> 
#> $calibration$divisor
#> [1] 10
#> 
#> $calibration$rule
#> [1] "[B_lower - A_upper, B_upper - A_lower] / divisor"
#> 
#> 
#> $fixed
#> [1] TRUE
#> 
#> attr(,"class")
#> [1] "masmr_bounds"