Augmented Modelling of Relational Events
Overview
An integrated workflow for relational event models, in which timestamped interactions among actors arrive in continuous time and the event rate depends on the history of the network itself. Event streams are simulated by an exact Gillespie kernel or an approximate tau-leap kernel; non-events are drawn by case-control sampling in the manner of Lerner and Lomi (2020) doi:10.1017/nws.2019.57, or from a time-shifted copy of the process so that covariates shared by all dyads at a given time remain estimable (Lembo et al. 2025, doi:10.1093/jrsssc/qlaf058); the timing- and closure-based endogenous statistics of Juozaitiene and Wit (2024) doi:10.1093/jrsssa/qnae132 are computed from that history; and one front-end fits the resulting case-control data by conditional-logistic partial likelihood, by penalised regression on its degenerate one-control binomial form (which admits smooth, time-varying and actor random effects), or by stochastic gradient descent, including the additive-spline construction of Filippi-Mazzola and Wit (2024) doi:10.1093/jrsssc/qlae023. Martingale-residual goodness-of-fit diagnostics are provided for the linear fit, together with simulation and statistic computation for relational hyper-events, a collection of documented event logs from published interaction networks, and a reconstructed El Nino index as a global covariate.
Bug fixes
rem(method = "gam")warns when rows with missing covariate values are left out of the fit, and records which rows it used (fit$rows, withfit$ncounting only those).gof_rem()keeps the same rows when given the full data; it stopped with "non-conformable arguments" before.sample_non_events(scope = "citation")always draws the citing paper and the cited papers from separate pools. Under themode = "one"default of 1.1.0 it pooled them, so most controls had a sender other than the citing paper.rem(method = "nn")andnn_uncertainty()no longer change the caller's random-number state when given a seed (CRAN policy); fitted results are unchanged.
Show all changes in 1.2.0Hide the rest of the changes in 1.2.0
- Partial-dependence curves of
plot()on neural fits and ofnn_uncertainty()span the 1st to 99th percentile of each feature instead of the mean ± 2 standard deviations, which reached below the data for skewed, non-negative statistics. - Concordance of neural fits splits a tied top score evenly between the tied candidates; it gave the whole stratum to the event.
simulate_relational_events(method = "tau_leap")stops with a message when a single step would draw more than ten million events, which happens when an effect grows without bound; it could exhaust memory.
New features
gof_rem()tests a model fitted withrem(method = "gam")with cumulative martingale residuals (Boschi & Wit 2025): over event time (test = "time"), over the quantiles of a covariate (test = "functional_form", which detects a wrong shape of the effect), or over the quantiles weighted by the term's basis (test = "functional_form_score"). It works on linear and smooth terms of the fitted model, and its null distribution is a multiplier bootstrap that subtracts the drift from estimating the coefficients. It hasprint()andplot()methods (plot()takesmainand alegendposition). The existinggof_univariate(),gof_multivariate(),gof_global()andgof_auxiliary()are unchanged.rem()fits store the name of theirtimecolumn.
Datasets
- New
alien_mammals: the risk table of the first records of alien mammals with the covariates of Juozaitienė et al. (2023) (distance to the nearest invaded region, trade, temperature difference, colonial ties, land use), and the never-at-risk pairs and species entry years as attributes; used in the species-invasion section of the software paper. - New event logs, all under licences that allow redistribution:
copenhagen_calls,copenhagen_smsandcopenhagen_actors(Copenhagen Networks Study, MIT);us_leader_visits(leader-to-leader visits to and from the United States, 1945-2019, CC0);football_results(men's international football matches since 1872, CC0);ucdp_dyads(UCDP armed-conflict dyads, 1946-2025, CC BY 4.0);alien_invasions(first records of alien species by region, 1880-2005, CC0). - New hyperevent log:
congress_bills_118, one sponsor and the cosponsors of each bill of the 118th US Congress, withcongress_members_118(public domain). - New global covariates:
oni(Oceanic Nino Index since 1950),daily_weather(NOAA daily temperature and precipitation for the cities of the bundled email and messaging logs) andpublic_holidays. radoslaw_emailis rebuilt from the authors' CC0 release (Nurek & Michalski 2020, doi:10.7910/DVN/6Z3CGX). It keeps the original employee ids, which match the newradoslaw_hierarchy(who reports to whom), and its timestamps are read as Warsaw local time. The previous copy, from Network Repository, read them as UTC, so it ignored daylight saving time: events sent during Polish summer time are now one hour earlier relative to the first event, andunix_originis one hour earlier. The number of events and each employee's activity are unchanged.- The pkgdown site has a data catalogue: licences, download code and structural profiles of 78 relational-event datasets and covariates, including the many whose licences do not allow amorem to redistribute them.
From NEWS.md in the release
Install
Health
- OK13 OK2026-09-08
- ERROR12 OK, 1 ERROR2026-09-07
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK7 OK2026-06-30
Documentation
The repository also keeps web-only articles.
- Help pages
- 53 (1 internal)includes a package overview page
- Examples that run
- 68%15 run in a plain check · 7 only when donttest examples are enabled (R CMD check --as-cran)
- Exported functions with examples
- 72%
- Documented parameters
- 80%
- Return-value docs
- 100%
- Help pages citing references
- 34%
Downloads
Repository
- PRs merged (all time)
- 90%
- Median days to close, 50 most recently updated closed issues
- 4
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Issues over time
Commits over time
8 development-tooling and community-health practices detected across 4 families in the upstream repository
Checks run against github.com/franciscorichter/amorem on 2026-10-18.
The R CMD check workflow runs on Linux
GitHub Pages site last deployed 2026-10-18 · The repository has a site deploy workflow
pkgdown site last built 2026-10-18
This repository shows signs of AI coding tools.
- Claude Codefirst seen 2026-05-14Named in .Rbuildignore: .claudeNamed in .gitignore: .claudePull request it wrote: opened by a project memberCommits: at least 15 crediting it in the message
- Claude Opus 4.88 commits · Jun 2026
- Claude Fable 54 commits · Jun 2026
- Claude Opus 4.73 commits · May 2026
Dependencies
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- 1.2.0Latest
- 1.1.02026-10-17 · diff ↗ ·
10 hours in CRAN's queue
Listed in CRAN's incoming queue from 2026-10-17 11:54 to 2026-10-17 21:55 UTC, in 5 readings. - 1.0.02026-06-29
- RR 4.6.0 released · 2026-04-24
Package metadata
- First published
- 2026-06-29
- Total releases
- 3 / 1 yrs
- License
- MIT + file LICENSE OSI
- Minimum R
- ≥ 4.2.0
- Bundled data
- 1.6 MB / 24 files
- Download size
- 2.5 MB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("amorem")This package has no citation file, so citation() returns this entry built from DESCRIPTION.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-22, which the citation names so these numbers can be found later. More on citing and the projects behind them.