motac
Getting started
Installation
Model overview
Parameter recovery (road Hawkes)
Likelihood and inference
Backtesting and benchmarks
Loaders
Tutorials
Tutorial: Synthetic quickstart (detailed)
Tutorial: POI features (baseline)
End-to-end: ingest → spatial join → query
Worked example: Chicago backtest (committed fixture)
Worked example: Gaza ACLED backtest (local cache)
API reference
Schema
Substrate
Model API
Neural kernels API
Evaluation
Command line interface
Project
Architecture
Contributing
motac
Index
Index
_
|
A
|
B
|
C
|
D
|
E
|
F
|
G
|
H
|
I
|
K
|
L
|
M
|
N
|
O
|
P
|
Q
|
R
|
S
|
T
|
V
|
W
|
X
|
Y
_
__init__() (motac.eval.backtest.BacktestResult method)
(motac.eval.BacktestConfig method)
(motac.eval.BacktestResult method)
(motac.eval.BenchmarkSuiteConfig method)
(motac.eval.EvalConfig method)
(motac.eval.ProfileResult method)
(motac.eval.profiling.ProfileResult method)
(motac.models.ExpDecayKernel method)
(motac.models.KernelFn method)
(motac.models.neural_kernels.ExpDecayKernel method)
(motac.models.neural_kernels.KernelFn method)
(motac.models.neural_kernels.SoftplusQuadraticKernel method)
(motac.models.NeuralIntensityBaseline method)
(motac.models.ParameterRecoverySummary method)
(motac.models.RoadHawkesConfig method)
(motac.models.SoftplusQuadraticKernel method)
(motac.models.stability.StabilityDiagnostics method)
(motac.models.StabilityDiagnostics method)
(motac.schema.Dataset method)
(motac.schema.EventRecord method)
(motac.schema.EventTable method)
(motac.spatial.Grid method)
(motac.spatial.GridCellLookup method)
(motac.spatial.LonLatBounds method)
(motac.spatial.NeighbourSets method)
(motac.spatial.POIFeatures method)
(motac.spatial.Substrate method)
(motac.spatial.substrate.SubstrateBuilder method)
(motac.spatial.substrate.SubstrateConfig method)
(motac.spatial.SubstrateBuilder method)
(motac.spatial.SubstrateConfig method)
(motac.spatial.types.Grid method)
(motac.spatial.types.NeighbourSets method)
(motac.spatial.types.POIFeatures method)
(motac.spatial.types.Substrate method)
A
a0 (motac.models.neural_kernels.SoftplusQuadraticKernel attribute)
(motac.models.SoftplusQuadraticKernel attribute)
a1 (motac.models.neural_kernels.SoftplusQuadraticKernel attribute)
(motac.models.SoftplusQuadraticKernel attribute)
a2 (motac.models.neural_kernels.SoftplusQuadraticKernel attribute)
(motac.models.SoftplusQuadraticKernel attribute)
acled_cell_size_m (motac.eval.BenchmarkSuiteConfig attribute)
acled_end (motac.eval.BenchmarkSuiteConfig attribute)
acled_events_path (motac.eval.BenchmarkSuiteConfig attribute)
acled_mode (motac.eval.BenchmarkSuiteConfig attribute)
acled_region (motac.eval.BenchmarkSuiteConfig attribute)
acled_start (motac.eval.BenchmarkSuiteConfig attribute)
alpha (motac.eval.EvalConfig attribute)
alpha_abs_err() (motac.models.ParameterRecoverySummary method)
alpha_hat (motac.models.ParameterRecoverySummary attribute)
alpha_true (motac.models.ParameterRecoverySummary attribute)
B
backtest_fit_forecast_nll() (in module motac.eval)
(in module motac.eval.backtest)
BacktestConfig (class in motac.eval)
BacktestResult (class in motac.eval)
(class in motac.eval.backtest)
baseline_metrics (motac.eval.backtest.BacktestResult attribute)
(motac.eval.BacktestResult attribute)
bbox() (motac.spatial.substrate.SubstrateConfig method)
(motac.spatial.SubstrateConfig method)
BenchmarkSuiteConfig (class in motac.eval)
beta (motac.eval.BacktestConfig attribute)
(motac.eval.EvalConfig attribute)
beta_abs_err() (motac.models.ParameterRecoverySummary method)
beta_hat (motac.models.ParameterRecoverySummary attribute)
beta_true (motac.models.ParameterRecoverySummary attribute)
bias (motac.models.NeuralIntensityBaseline attribute)
branching_bound (motac.models.stability.StabilityDiagnostics attribute)
(motac.models.StabilityDiagnostics attribute)
build() (motac.spatial.substrate.SubstrateBuilder method)
(motac.spatial.SubstrateBuilder method)
build_grid_from_lonlat_bounds() (in module motac.spatial)
(in module motac.spatial.substrate)
build_knn_travel_time_matrix() (in module motac.spatial)
build_regular_grid() (in module motac.spatial)
C
cache_dir (motac.spatial.substrate.SubstrateConfig attribute)
(motac.spatial.SubstrateConfig attribute)
CACHE_FORMAT_VERSION (motac.spatial.substrate.SubstrateBuilder attribute)
(motac.spatial.SubstrateBuilder attribute)
cell_id (motac.schema.EventRecord attribute)
(motac.schema.EventTable attribute)
cell_size_m (motac.spatial.Grid attribute)
(motac.spatial.GridCellLookup attribute)
(motac.spatial.substrate.SubstrateConfig attribute)
(motac.spatial.SubstrateConfig attribute)
(motac.spatial.types.Grid attribute)
chicago_cell_size_m (motac.eval.BenchmarkSuiteConfig attribute)
chicago_events_path (motac.eval.BenchmarkSuiteConfig attribute)
chicago_years (motac.eval.BenchmarkSuiteConfig attribute)
compute_stability_diagnostics() (in module motac.models)
(in module motac.models.stability)
counts (motac.schema.Dataset attribute)
counts_path (motac.eval.BacktestConfig attribute)
coverage (motac.eval.backtest.BacktestResult attribute)
(motac.eval.BacktestResult attribute)
D
Dataset (class in motac.schema)
disable_pois (motac.spatial.substrate.SubstrateConfig attribute)
(motac.spatial.SubstrateConfig attribute)
dispersion (motac.eval.BacktestConfig attribute)
E
east (motac.spatial.substrate.SubstrateConfig attribute)
(motac.spatial.SubstrateConfig attribute)
encode_categorical_marks_onehot() (in module motac.models)
(in module motac.models.marked_hawkes)
EvalConfig (class in motac.eval)
evaluate_synthetic() (in module motac.eval)
Event (in module motac.schema)
event_id (motac.schema.EventRecord attribute)
(motac.schema.EventTable attribute)
EventRecord (class in motac.schema)
events (motac.schema.Dataset attribute)
EventTable (class in motac.schema)
ExpDecayKernel (class in motac.models)
(class in motac.models.neural_kernels)
F
family (motac.eval.BacktestConfig attribute)
(motac.models.RoadHawkesConfig attribute)
feature_names (motac.spatial.POIFeatures attribute)
(motac.spatial.types.POIFeatures attribute)
fit() (in module motac.models)
fit_forecast_road_hawkes_mle() (in module motac.models)
fit_maxiter (motac.eval.EvalConfig attribute)
fit_road_hawkes_mle() (in module motac.models)
fit_time_s (motac.eval.ProfileResult attribute)
(motac.eval.profiling.ProfileResult attribute)
fold_metrics (motac.eval.backtest.BacktestResult attribute)
(motac.eval.BacktestResult attribute)
forecast_count_paths_horizon() (in module motac.models)
forecast_intensity_horizon() (in module motac.models)
forecast_probabilistic_horizon() (in module motac.models)
forecast_time_s (motac.eval.ProfileResult attribute)
(motac.eval.profiling.ProfileResult attribute)
from_grid() (motac.spatial.GridCellLookup class method)
from_json() (motac.eval.BacktestConfig static method)
(motac.eval.BenchmarkSuiteConfig static method)
(motac.eval.EvalConfig static method)
(motac.spatial.substrate.SubstrateConfig static method)
(motac.spatial.SubstrateConfig static method)
from_records() (motac.schema.EventTable static method)
G
graphml_path (motac.spatial.Substrate attribute)
(motac.spatial.substrate.SubstrateConfig attribute)
(motac.spatial.SubstrateConfig attribute)
(motac.spatial.types.Substrate attribute)
Grid (class in motac.spatial)
(class in motac.spatial.types)
grid (motac.spatial.Substrate attribute)
(motac.spatial.types.Substrate attribute)
GridCellLookup (class in motac.spatial)
H
horizon (motac.eval.backtest.BacktestResult attribute)
(motac.eval.BacktestConfig attribute)
(motac.eval.BacktestResult attribute)
(motac.eval.BenchmarkSuiteConfig attribute)
(motac.eval.EvalConfig attribute)
I
init_alpha (motac.eval.BacktestConfig attribute)
(motac.models.RoadHawkesConfig attribute)
init_beta (motac.eval.BacktestConfig attribute)
(motac.models.RoadHawkesConfig attribute)
init_dispersion (motac.models.RoadHawkesConfig attribute)
K
kernel (motac.eval.BacktestConfig attribute)
(motac.models.RoadHawkesConfig attribute)
kernel_beta (motac.eval.BenchmarkSuiteConfig attribute)
kernel_fn (motac.models.RoadHawkesConfig attribute)
kernel_mass (motac.models.stability.StabilityDiagnostics attribute)
(motac.models.StabilityDiagnostics attribute)
KernelFn (class in motac.models)
(class in motac.models.neural_kernels)
L
lat (motac.schema.EventRecord attribute)
(motac.schema.EventTable attribute)
(motac.spatial.Grid attribute)
(motac.spatial.types.Grid attribute)
lat_max (motac.spatial.LonLatBounds attribute)
lat_min (motac.spatial.LonLatBounds attribute)
lengthscale (motac.models.ExpDecayKernel attribute)
(motac.models.neural_kernels.ExpDecayKernel attribute)
local_cache_dir (motac.eval.BenchmarkSuiteConfig attribute)
loglik (motac.models.ParameterRecoverySummary attribute)
loglik() (in module motac.models)
loglik_init (motac.models.ParameterRecoverySummary attribute)
lon (motac.schema.EventRecord attribute)
(motac.schema.EventTable attribute)
(motac.spatial.Grid attribute)
(motac.spatial.types.Grid attribute)
lon_max (motac.spatial.LonLatBounds attribute)
lon_min (motac.spatial.LonLatBounds attribute)
lonlat_to_cell_id() (in module motac.spatial)
(motac.spatial.GridCellLookup method)
LonLatBounds (class in motac.spatial)
M
mae (motac.eval.backtest.BacktestResult attribute)
(motac.eval.BacktestResult attribute)
main() (in module motac.cli)
mark (motac.schema.EventRecord attribute)
(motac.schema.EventTable attribute)
max_folds (motac.eval.BacktestConfig attribute)
max_row_sum (motac.models.stability.StabilityDiagnostics attribute)
(motac.models.StabilityDiagnostics attribute)
max_travel_time_s (motac.eval.BacktestConfig attribute)
(motac.models.RoadHawkesConfig attribute)
(motac.spatial.substrate.SubstrateConfig attribute)
(motac.spatial.SubstrateConfig attribute)
maxiter (motac.eval.BacktestConfig attribute)
(motac.eval.BenchmarkSuiteConfig attribute)
(motac.models.RoadHawkesConfig attribute)
mean_negative_log_likelihood() (in module motac.models)
meta (motac.schema.Dataset attribute)
(motac.schema.EventRecord attribute)
(motac.schema.EventTable attribute)
min_travel_time_feature_matrix() (in module motac.spatial)
min_travel_time_to_mask() (in module motac.spatial)
module
motac.cli
motac.eval
motac.eval.backtest
motac.eval.profiling
motac.models
motac.models.marked_hawkes
motac.models.neural_kernels
motac.models.stability
motac.schema
motac.spatial
motac.spatial.substrate
motac.spatial.types
motac.cli
module
motac.eval
module
motac.eval.backtest
module
motac.eval.profiling
module
motac.models
module
motac.models.marked_hawkes
module
motac.models.neural_kernels
module
motac.models.stability
module
motac.schema
module
motac.spatial
module
motac.spatial.substrate
module
motac.spatial.types
module
mu (motac.eval.EvalConfig attribute)
mu_hat (motac.models.ParameterRecoverySummary attribute)
mu_laplacian (motac.eval.BacktestConfig attribute)
(motac.models.RoadHawkesConfig attribute)
mu_mae_per_seed() (motac.models.ParameterRecoverySummary method)
mu_ridge (motac.eval.BacktestConfig attribute)
(motac.models.RoadHawkesConfig attribute)
mu_true (motac.models.ParameterRecoverySummary attribute)
N
n_cells (motac.schema.Dataset property)
n_events (motac.schema.EventTable property)
n_folds (motac.eval.backtest.BacktestResult attribute)
(motac.eval.BacktestResult attribute)
n_lags (motac.eval.BacktestConfig attribute)
(motac.eval.BenchmarkSuiteConfig attribute)
(motac.eval.EvalConfig attribute)
n_locations (motac.eval.EvalConfig attribute)
n_marks (motac.schema.Dataset property)
n_paths (motac.eval.BacktestConfig attribute)
(motac.eval.BenchmarkSuiteConfig attribute)
(motac.eval.EvalConfig attribute)
n_seeds (motac.models.ParameterRecoverySummary property)
n_steps (motac.schema.Dataset property)
n_steps_train (motac.eval.EvalConfig attribute)
n_train (motac.eval.backtest.BacktestResult attribute)
(motac.eval.BacktestConfig attribute)
(motac.eval.BacktestResult attribute)
(motac.eval.BenchmarkSuiteConfig attribute)
neighbours (motac.spatial.Substrate attribute)
(motac.spatial.types.Substrate attribute)
NeighbourSets (class in motac.spatial)
(class in motac.spatial.types)
NeuralIntensityBaseline (class in motac.models)
nll (motac.eval.backtest.BacktestResult attribute)
(motac.eval.BacktestResult attribute)
north (motac.spatial.substrate.SubstrateConfig attribute)
(motac.spatial.SubstrateConfig attribute)
nx (motac.spatial.GridCellLookup attribute)
ny (motac.spatial.GridCellLookup attribute)
O
out_dir (motac.eval.BacktestConfig attribute)
(motac.eval.BenchmarkSuiteConfig attribute)
P
ParameterRecoverySummary (class in motac.models)
place (motac.spatial.substrate.SubstrateConfig attribute)
(motac.spatial.SubstrateConfig attribute)
poi (motac.spatial.Substrate attribute)
(motac.spatial.types.Substrate attribute)
poi_geojson_path (motac.spatial.substrate.SubstrateConfig attribute)
(motac.spatial.SubstrateConfig attribute)
poi_tags (motac.spatial.substrate.SubstrateConfig attribute)
(motac.spatial.SubstrateConfig attribute)
poi_travel_time_features (motac.spatial.substrate.SubstrateConfig attribute)
(motac.spatial.SubstrateConfig attribute)
POIFeatures (class in motac.spatial)
(class in motac.spatial.types)
predict() (in module motac.models)
predict_intensity() (motac.models.NeuralIntensityBaseline method)
predict_intensity_in_sample() (in module motac.models)
predict_intensity_next_step() (in module motac.models)
predict_intensity_one_step_road() (in module motac.models)
profile_fit_forecast() (in module motac.eval)
(in module motac.eval.profiling)
ProfileResult (class in motac.eval)
(class in motac.eval.profiling)
Q
q (motac.eval.BacktestConfig attribute)
(motac.eval.EvalConfig attribute)
R
rmse (motac.eval.backtest.BacktestResult attribute)
(motac.eval.BacktestResult attribute)
road_loglik() (in module motac.models)
RoadHawkesConfig (class in motac.models)
rolling_step (motac.eval.BacktestConfig attribute)
run_backtest_report() (in module motac.eval)
run_benchmark_suite() (in module motac.eval)
run_parameter_recovery_road_hawkes_poisson() (in module motac.models)
S
seasonal_period (motac.eval.BacktestConfig attribute)
seed (motac.eval.EvalConfig attribute)
seeds (motac.models.ParameterRecoverySummary attribute)
sim_alpha (motac.eval.BenchmarkSuiteConfig attribute)
sim_beta (motac.eval.BenchmarkSuiteConfig attribute)
sim_cells (motac.eval.BenchmarkSuiteConfig attribute)
sim_mu (motac.eval.BenchmarkSuiteConfig attribute)
sim_seed (motac.eval.BenchmarkSuiteConfig attribute)
sim_steps (motac.eval.BenchmarkSuiteConfig attribute)
simulate() (in module motac.models)
SoftplusQuadraticKernel (class in motac.models)
(class in motac.models.neural_kernels)
south (motac.spatial.substrate.SubstrateConfig attribute)
(motac.spatial.SubstrateConfig attribute)
speed_gate_smoothness_s (motac.eval.BacktestConfig attribute)
(motac.models.RoadHawkesConfig attribute)
stability_mode (motac.eval.BacktestConfig attribute)
(motac.models.RoadHawkesConfig attribute)
stability_penalty (motac.eval.BacktestConfig attribute)
(motac.models.RoadHawkesConfig attribute)
StabilityDiagnostics (class in motac.models)
(class in motac.models.stability)
stable_sufficient (motac.models.stability.StabilityDiagnostics attribute)
(motac.models.StabilityDiagnostics attribute)
Substrate (class in motac.spatial)
(class in motac.spatial.types)
substrate_cache_dir (motac.eval.BacktestConfig attribute)
SubstrateBuilder (class in motac.spatial)
(class in motac.spatial.substrate)
SubstrateConfig (class in motac.spatial)
(class in motac.spatial.substrate)
summarize_forecast_paths() (in module motac.models)
SUPPORTED_CACHE_FORMAT_VERSIONS (motac.spatial.substrate.SubstrateBuilder attribute)
(motac.spatial.SubstrateBuilder attribute)
T
t (motac.schema.EventRecord attribute)
(motac.schema.EventTable attribute)
tf (motac.spatial.GridCellLookup attribute)
to_json() (motac.eval.EvalConfig method)
to_records() (motac.schema.EventTable method)
total_time_s (motac.eval.ProfileResult attribute)
(motac.eval.profiling.ProfileResult attribute)
travel_time_s (motac.spatial.NeighbourSets attribute)
(motac.spatial.types.NeighbourSets attribute)
V
validate() (motac.schema.EventTable method)
validate_categorical_marks_matrix() (in module motac.models)
(in module motac.models.marked_hawkes)
validate_event_record() (in module motac.schema)
validate_event_table() (in module motac.schema)
validate_kernel (motac.models.RoadHawkesConfig attribute)
validate_kernel_fn() (in module motac.models)
(in module motac.models.neural_kernels)
value (motac.schema.EventRecord attribute)
(motac.schema.EventTable attribute)
W
weight (motac.models.NeuralIntensityBaseline attribute)
west (motac.spatial.substrate.SubstrateConfig attribute)
(motac.spatial.SubstrateConfig attribute)
window (motac.models.NeuralIntensityBaseline attribute)
X
x (motac.spatial.POIFeatures attribute)
(motac.spatial.types.POIFeatures attribute)
x0_edge (motac.spatial.GridCellLookup attribute)
Y
y0_edge (motac.spatial.GridCellLookup attribute)