Learn R Programming

nhppp (version 1.1.0)

get_step_majorizer: Piecewise constant (step) majorizer for K-Lipschitz functions over an interval (vectorized over the breaks argument).

Description

Return a piecewise constant (step) majorizer for K-Lipschitz functions over an interval. The function is vectorized over the breaks argument. The returned object has the same dimensions as breaks.

Usage

get_step_majorizer(fun, breaks, is_monotone = TRUE, K = 0, fun_args = NULL)

Value

A vector of length M with the values of the piecewise constant majorizer

Arguments

fun

A function object with a single argument x. If x is a matrix, fun should be vectorized over it.

breaks

(vector or matrix) The set of M+1 boundaries for the M subintervals in x. If breaks is a matrix, each row is treated as a separate set of breaks.

is_monotone

(boolean) Is the function monotone? (Default is TRUE.)

K

(double) A non-negative number for the Lipschitz cone. (Default is 0.)

fun_args

(list) arguments for fun, with up to two elements: shared (named list of row-invariant arguments) and row_args (data.frame or data.table with one row per row of breaks). When non-NULL, the container is passed as fun's second positional argument — the same convention (and the same lambda) as the vectorized samplers.

Examples

Run this code
get_step_majorizer(fun = abs, breaks = -5:5, is_monotone = FALSE, K = 1)

# a lambda that takes the structured args container
get_step_majorizer(
  fun = function(t, a) a$shared$scale * abs(t),
  breaks = matrix(rep(-5:5, each = 3), nrow = 3),
  is_monotone = FALSE, K = 2,
  fun_args = list(shared = list(scale = 2))
)

Run the code above in your browser using DataLab