assisted_specification: Run native Biogeme assisted specification

View source: R/results.R

assisted_specificationR Documentation

Run native Biogeme assisted specification

Description

The complete catalog search, quick-estimation objective evaluation, Pareto persistence, and final re-estimation are delegated to native Biogeme. The R interface accepts named objective and validity descriptors rather than exposing Python callback objects. The selected validity rule is created and executed inside the Python bridge between native estimates.

Usage

assisted_specification(
  model,
  objectives = "loglikelihood_dimension",
  pareto_file_name = NULL,
  model_name = "rbiogeme_assisted",
  controls = list(),
  force = TRUE,
  control = NULL,
  validity = NULL
)

run_assisted_specification(
  model,
  objectives = "loglikelihood_dimension",
  pareto_file_name = NULL,
  model_name = "rbiogeme_assisted",
  controls = list(),
  force = TRUE,
  control = NULL,
  validity = NULL
)

Arguments

model

A biogeme_model containing catalog expressions.

objectives

Native objective preset. Supported values are "loglikelihood_dimension" and "aic_bic_dimension".

pareto_file_name

Explicit path of the native Pareto checkpoint file. It has no default because native checkpoints are persistent files.

model_name

Native Biogeme model name prefix.

controls

Named list of native Biogeme controls.

force

Whether to remove the named Pareto checkpoint and start fresh.

control

Optional biogeme_control() object; an alias for controls.

validity

Optional native validity-rule name. Currently supported is "negative_time_cost", matching the predicate in the native assisted Swissmetro example.

Value

An object of class biogeme_assisted_fit containing native final results, the summary table, descriptions, and Pareto metadata.


rbiogeme documentation built on Sept. 29, 2026, 5:09 p.m.