Skip to contents

Run a LANDIS-II simulation locally (synchronous)

landis_run_local.Rd

Runs LANDIS-II directly via dotnet, blocking until the simulation completes. Stdout and stderr are written to <scenario_dir>/log/local_stdout.log and local_stderr.log. Wall-clock elapsed time and peak memory use (polled every 2 s via the ps package) are reported on completion and written to <scenario_dir>/log/local_resources.log. Works on Linux, macOS, and Windows.

Usage

landis_run_local(scenario_dir, scenario_file = "scenario.txt", console = NULL)

Arguments

scenario_dir

Character. Path to the scenario directory (resolved to absolute before use).

scenario_file

Character. Scenario filename relative to scenario_dir.

console

Character or NULL. Path to Landis.Console.dll. Defaults to NULL, which calls landis_find() at run time.

Value

Named list with exit_code (integer), elapsed_sec (numeric), and peak_mem_bytes (numeric), returned invisibly.

See also

landis_find(), landis_find_docker(), landis_run(), landis_run_docker(), tar_landis()

Other LANDIS-II execution helpers: host_cpu_info(), landis_find(), landis_find_docker(), landis_pool_exec(), landis_pool_restart_one(), landis_pool_start(), landis_pool_stop(), landis_replicate(), landis_run_docker(), read_landis_resource_logs(), tar_landis(), write_landis_scenario_file()