Simulate a piecewise constant-rate Poisson Point Process over (t_min, t_max] (inversion method)
where the intervals have the same length (are "regular"), conditional on
the event count lying in [generate_at_least_K, generate_at_most_K]
(generate_at_least_K = 1 alone, the default, is the zero-truncated
process).
vztdraw_sc_step_regular_cpp(
lambda_matrix = NULL,
Lambda_matrix = NULL,
rate_matrix_t_min = NULL,
rate_matrix_t_max = NULL,
t_min = NULL,
t_max = NULL,
tol = 10^-6,
atmost1 = FALSE,
report_first_K = NULL,
report_last_K = NULL,
generate_at_least_K = 1,
generate_at_most_K = NULL,
budget_cap = NULL,
output = c("matrix", "long")
)a matrix of event times t, with rows corresponding to the sampled
point processes, or the long event format if output = "long".
(matrix) intensity rates, one per interval
(matrix) integrated intensity rates at the end of each interval
(scalar | vector | column matrix) is the lower bound of the time interval for each row of (Lambda|lambda)_maj_matrix. The length of this argument is the number of point processes that should be drawn.
(scalar | vector | column matrix) the upper bound of the time interval for each row of (Lambda|lambda)_maj_matrix. The length of this argument is the number of point processes that should be drawn.
(scalar | vector | column matrix) is the lower bound
of a subinterval of (rate_matrix_t_min, rate_matrix_t_max]. If set,
times are sampled from the subinterval.
If omitted, it is equivalent to rate_matrix_t_min.
(scalar | vector | column matrix) is the upper bound
of a subinterval of (rate_matrix_t_min, rate_matrix_t_max]. If set,
times are sampled from the subinterval.
If omitted, it is equivalent to rate_matrix_t_max.
(scalar, double) tolerance for the number of events
boolean, report at most 1 event time of the conditioned
process (alias for report_first_K = 1)
NULL or a positive integer: report only the
earliest K event times of the conditioned realization (never
affects the conditioned count itself). At most one of
report_first_K/report_last_K may be set.
NULL or a positive integer: report only the latest
K event times of the conditioned realization (ascending order).
non-negative integer: condition on at least K events in the sampled (sub)interval. The default 1 is the zero-truncated process.
NULL or a positive integer: condition on at
most K events. May be combined with generate_at_least_K
(K1 <= K2; K1 = K2 conditions on exactly K events).
NULL or a positive integer: cap the computational event
budget of the kernel (approximation knob; never truncates below
generate_at_least_K).
(string) "matrix" (default) returns the NA-padded event
matrix, one row per point process. "long" returns the long event
format list(id, time, n_draws) with one entry per event: id is
the 1-based point-process index (ascending; times ascending within
id). A point process with no events contributes no entries, so
its id is absent; n_draws distinguishes "no events" from "not
sampled". No NA is used. The long format is built without
allocating the dense matrix, so prefer it when event counts vary
widely across point processes.