Compose a Kernel Specification and a Residual Law

Create an experimental FRPP object containing an emhawkes kernel and a separate residual-law object. The result does not inherit from hspec.

Usage

fspec(kernel, residual)
frpp_spec(kernel, residual)
as_fspec(object, name = "legacy")
as_frpp(object, name = "legacy")
as_legacy_hspec(object)

Arguments

kernel: An hspec without residual-distribution slots.
residual: A law created by residual_law.
object: For conversion, an existing FRPP hspec or a frpp_spec. For the legacy adapter, a frpp_spec.
name: A descriptive name for a converted legacy law.

Details

The current model refreshes every dimension's candidate residual after every event in the combined process. It does not retain separate residual clocks. Conversion preserves callback functions and their default bindings without executing them. Captured environments remain references, as in emhawkes. The primary constructor is fspec, matching the hspec naming convention. frpp_spec and as_frpp remain compatibility names. New objects have S4 class fspec, with typed kernel, residual, refresh and version slots. The class composes an hspec; it does not inherit from it. The residual law retains its S3 representation. Use methods::is(model, "fspec") for class checks; new objects no longer inherit the old S3 frpp_spec class. Saved S3 objects with class frpp_spec or c("fspec", "frpp_spec") are upgraded by as_fspec; simulation, likelihood and fitting entry points also accept them. Fitted models restored from earlier fit objects are upgraded on extraction.

Use fkernel and fresidual for component access and replacement. List-style $kernel and $residual remain available for compatibility. Constructors and public operations validate the specification without running user callbacks. Validity checks include numeric kernel shapes, decay rates, mapping, residual structure and the supported global refresh rule. Function outputs, distribution-specific domains and stationarity are not established by object validation. Direct slot edits should be followed by methods::validObject. The adapter is transitional: it restores the old FRPP representation to use existing public emhawkes operations. It is not a pure Hawkes specification.

Value

frpp_spec and as_frpp return an S4 fspec composition object. as_legacy_hspec returns an hspec carrying the residual callbacks.

Examples

kernel <- methods::new("hspec", mu = .3, alpha = .2, beta = 1)
law <- residual_law(c(shape = 2, rate = 2), stats::dgamma,
                    stats::pgamma, stats::qgamma, stats::rgamma,
                    name = "Gamma(2,2)")
model <- fspec(kernel, law)
model
#> FRPP specification (S4 fspec)
#> Event types: 1
#> Residual law: Gamma(2,2)
#> Residual candidates refreshed after every global event.
stopifnot(!methods::is(model, "hspec"))